mac 部署 n8n

Mac 本地部署 n8n，建议使用 Docker Compose。环境隔离、升级和数据持久化都更方便，n8n 官方也推荐大多数自托管场景优先使用 Docker。

方案一：Docker Compose 部署

1. 安装 Docker Desktop

先安装并启动 Docker Desktop。注意区分：

• M1/M2/M3/M4：Apple Silicon 版本
• Intel Mac：Intel 版本

Docker Desktop 已经包含 Docker Engine 和 Docker Compose。

安装完成后检查：

docker --version
docker compose version

2. 创建 n8n 目录

mkdir -p ~/docker/n8n
cd ~/docker/n8n

3. 创建 docker-compose.yml

cat > docker-compose.yml <<'EOF'
services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    container_name: n8n
    restart: unless-stopped

    ports:
      - "5678:5678"

    environment:
      - TZ=Asia/Shanghai
      - GENERIC_TIMEZONE=Asia/Shanghai
      - N8N_ENCRYPTION_KEY=replace-with-your-random-secret-key
      - N8N_SECURE_COOKIE=false

    volumes:
      - ./n8n_data:/home/node/.n8n
EOF

N8N_ENCRYPTION_KEY 建议替换成随机密钥，可以执行：

openssl rand -hex 32

然后把生成的内容替换到配置中，例如：

- N8N_ENCRYPTION_KEY=8f97xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

这个密钥以后不要随意修改，否则已保存的账号凭证可能无法正常解密。

4. 启动 n8n

docker compose up -d

查看状态：

docker compose ps

查看日志：

docker compose logs -f n8n

浏览器访问：

http://localhost:5678

第一次进入时，按照页面提示创建管理员账号。

---

常用管理命令

停止：

docker compose stop

重新启动：

docker compose restart

停止并删除容器：

docker compose down

只要没有删除 ~/docker/n8n/n8n_data，工作流和配置仍然存在。

升级 n8n：

cd ~/docker/n8n

docker compose pull
docker compose down
docker compose up -d

升级前建议备份：

cp -R ~/docker/n8n/n8n_data \
  ~/docker/n8n/n8n_data_backup_$(date +%Y%m%d_%H%M%S)