Docker 一键搭建 n8n 工作流引擎及升级指南-编程阁

Docker 一键搭建 n8n 工作流引擎及升级指南
Docker一键搭建n8n工作流引擎！零基础也能玩转自动化（含升级指南）
在这个追求效率的时代，重复的工作流程总能让人抓狂——比如定时同步数据、自动发送邮件、跨平台数据流转……而n8n这款开源工作流自动化工具，就能帮你把这些重复操作“一键自动化”！它支持2000+款应用集成（微信、Excel、数据库、API等），可视化拖拽就能搭建工作流，堪称开发者和运维的“效率神器”。

而用Docker搭建n8n，更是能实现“环境隔离、一键部署、轻松升级”，无需担心依赖冲突，零基础也能快速上手。本文就带你一步步用Docker Compose搭建n8n，还会附上官方推荐的升级方法，让你从部署到维护全搞定！

一、先搞懂：为什么用Docker搭n8n？

在开始操作前，先说说Docker搭建的核心优势：

环境隔离：不污染本地系统，n8n的依赖、配置都封装在容器内；
一键部署：无需手动安装Node.js、数据库等依赖，Docker Compose一键启动；
数据持久化：通过挂载目录，确保工作流数据不会因容器重启丢失；
轻松升级：后续更新n8n版本，只需几行命令，无需重新配置。

二、准备工作：安装Docker和Docker Compose

搭建前必须确保你的系统已安装 Docker 和 Docker Compose，以下是不同系统的快速安装指南：

Windows/Mac

直接安装 Docker Desktop（自带Docker Compose）：

下载地址：https://www.docker.com/products/docker-desktop/
安装后启动Docker，在终端输入 docker --version 和 docker-compose --version，能显示版本号即安装成功。

Linux（以Ubuntu为例）

安装Docker

sudo apt update
sudo apt install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker
sudo usermod -aG docker $USER # 免sudo使用Docker（需重启终端）

安装Docker Compose

sudo curl -L “https://github.com/docker/compose/releases/latest/download/docker-compose-(uname−s)−(uname -s)-(uname−s)−(uname -m)” -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

验证安装

docker --version
docker-compose --version

三、核心步骤：Docker Compose搭建n8n

官方推荐用Docker Compose部署n8n（支持数据持久化、自定义配置），步骤如下，每一步都有详细说明：

步骤1：创建工作目录（关键！数据持久化）

首先创建一个专门存放n8n配置和数据的目录，避免容器删除后数据丢失：

创建目录（可自定义路径，比如~/n8n或/data/n8n）

mkdir -p ~/n8n/data
cd ~/n8n # 进入工作目录

步骤2：编写docker-compose.yml配置文件

在~/n8n目录下创建docker-compose.yml文件，这是部署的核心配置，复制以下内容（附带详细注释）：

version: “3.8” # Docker Compose版本（需与Docker兼容）

services:
n8n:
image: n8nio/n8n:latest # 拉取最新版n8n镜像（可指定版本，如n8nio/n8n:1.28.0）
container_name: n8n # 容器名称（自定义）
restart: always # 容器异常时自动重启
ports:
- “5678:5678” # 端口映射：宿主机5678端口 -> 容器5678端口（可修改宿主机端口）
environment:
- TZ=Asia/Shanghai # 时区配置（关键！避免定时任务时间错乱）
- N8N_USER_ID=1000 # 运行n8n的用户ID（默认1000，Linux可通过id命令查看）
- N8N_GROUP_ID=1000 # 运行n8n的组ID（与用户ID一致）
- N8N_DIAGNOSTICS_ENABLED=false # 关闭诊断数据收集（可选）
- N8N_SECURE_COOKIE=false # 非HTTPS环境下设为false（HTTPS时设为true）
# - N8N_PASSWORD=你的密码 # 可选：设置访问密码（后续详细说）
volumes:
# 数据持久化：宿主机~/n8n/data目录 -> 容器内n8n数据目录
- ./data:/home/node/.n8n
# 可选：挂载本地目录（用于读取/写入本地文件，如Excel、CSV）
- ./local-files:/home/node/local-files

配置说明（新手必看）：

image：指定n8n镜像版本，latest是最新版，如需稳定版可替换为具体版本号（如1.28.0）；
ports：默认端口5678，若宿主机5678已被占用，可修改为其他端口（如8080:5678）；
TZ：必须配置为Asia/Shanghai，否则n8n的定时任务（Cron）会用UTC时间，导致时间偏差；
volumes：./data挂载是核心，确保工作流、凭证等数据不会因容器删除丢失；./local-files是可选挂载，方便n8n读取本地文件。

步骤3：启动n8n容器

在~/n8n目录下执行以下命令，启动n8n：

docker-compose up -d # -d表示后台运行容器

验证启动状态：

docker ps # 查看容器是否运行

如果看到n8n容器的STATUS为Up，说明启动成功！

步骤4：访问并初始化n8n

打开浏览器，输入http://宿主机IP:5678（如本地部署则输入http://localhost:5678）；
首次访问会进入初始化页面，设置管理员邮箱和密码（重要！用于登录n8n）；
登录后，即可进入n8n可视化工作台，开始拖拽搭建工作流（比如“定时拉取数据→存入数据库→发送通知”）。

新手入门：创建第一个工作流

点击左侧“+”号→“Blank Workflow”；
拖拽左侧“Triggers”（触发条件，如“Schedule”定时触发）和“Actions”（操作，如“Send Email”发送邮件）；
双击节点配置参数（如定时时间、邮件内容）；
点击右上角“Execute Workflow”测试运行，成功后会显示绿色对勾！

四、关键优化：给n8n加访问密码（可选但推荐）

默认情况下，只要知道IP和端口就能访问n8n，存在安全风险。除了初始化时设置的登录密码，还可以通过环境变量直接设置访问密码：

编辑docker-compose.yml，在environment中添加密码配置：

environment:

N8N_PASSWORD=YourStrongPassword123! # 替换为你的强密码

重启n8n容器使配置生效：

docker-compose down && docker-compose up -d

再次访问http://IP:5678，会弹出密码验证框，输入设置的密码即可登录。

五、官方推荐：n8n升级方法（安全无数据丢失）

n8n更新频繁，新增功能和修复bug，升级步骤参考官方文档（核心是“备份数据→拉取新镜像→重启容器”）：

步骤1：备份数据（关键！避免升级失败丢失数据）

由于我们已经通过volumes挂载了数据目录，只要备份~/n8n/data即可：

压缩备份数据目录（可自定义备份文件名）

tar -zcvf n8n-backup-$(date +%Y%m%d).tar.gz ~/n8n/data

步骤2：拉取最新n8n镜像

cd ~/n8n # 进入工作目录
docker-compose pull # 拉取docker-compose.yml中指定的最新镜像

步骤3：重启n8n容器（应用新镜像）

docker-compose down && docker-compose up -d

步骤4：验证升级结果

访问http://IP:5678，登录后点击右上角“设置”→“About”；
查看版本号是否为最新版，同时检查已创建的工作流是否正常运行。

升级注意事项：

若指定了具体镜像版本（如n8nio/n8n:1.28.0），需先修改docker-compose.yml中的image为目标版本，再执行pull和restart；
升级前务必备份数据，若升级后出现兼容问题，可通过备份恢复数据，并用旧版本镜像重启。

六、常见问题排查（新手避坑）

浏览器访问不了n8n？

检查容器是否运行：docker ps | grep n8n，若未运行则执行docker-compose up -d；
检查端口是否占用：netstat -tuln | grep 5678（Linux）或netstat -ano | findstr 5678（Windows），占用则修改docker-compose.yml的宿主机端口；
检查防火墙：Linux需开放5678端口（sudo ufw allow 5678），云服务器需在安全组开放5678端口。