n8n Docker Compose 部署指南：官方与中文镜像配置详解

2. 中文汉化版

如果你更习惯中文操作界面，可以使用社区维护的镜像。配置逻辑基本一致，主要区别在于镜像源和语言设置。

services:
  n8n:
    image: blowsnow/n8n-chinese
    container_name: n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - GENERIC_TIMEZONE=Asia/Shanghai
      - NODE_ENV=production
      - N8N_DEFAULT_LOCALE=zh-CN
      - N8N_SECURE_COOKIE=false
      - N8N_HOST=<your-hostname>
      - WEBHOOK_URL=http://<your-hostname>:5678/
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
    volumes:
      - /opt/n8n/data:/home/node/.n8n

执行部署步骤

准备好配置文件后，按顺序在服务器上执行以下操作即可启动服务。

首先创建专用的部署目录和数据存储目录，并赋予当前用户读写权限，避免后续出现权限错误。

mkdir ~/n8n-deploy
cd ~/n8n-deploy
sudo mkdir -p /opt/n8n/data
sudo chown $(id -u):$(id -g) /opt/n8n/data

接着创建 docker-compose.yml 文件。你可以直接使用文本编辑器打开该文件，将上方对应的 YAML 内容粘贴进去并保存。

vim docker-compose.yml
# 或者使用 nano docker-compose.yml

确认文件无误后，启动容器。Docker Compose 会自动拉取镜像并在后台运行。

docker-compose up -d

此时可以通过浏览器访问 http://<your-hostname>:5678 进入初始化向导。

常用管理命令

所有管理操作建议在 ~/n8n-deploy 目录下进行。以下是日常运维中最高频的几个指令。

• 查看实时日志：排查启动失败或运行异常时非常有用，按 Ctrl + C 退出。

  docker-compose logs -f
  

• 重启服务：修改配置后生效，或临时停止服务后恢复。

  docker-compose restart
  

• 更新版本：拉取最新镜像并重建容器，保留现有数据。

  docker-compose pull
  

docker-compose up -d

- **停止服务**：仅停止容器进程，不删除容器对象。
```bash
docker-compose stop

• 完全清理：警告此操作不可逆，会删除容器及本地数据卷。

  docker-compose down
  sudo rm -rf /opt/n8n/data
  docker rmi n8nio/n8n # 或 blowsnow/n8n-chinese
  

通过上述配置，你可以快速拥有一个稳定运行的 n8n 实例。后续只需关注工作流的编排与集成，无需再为环境依赖操心。