当前位置：首页 > news >正文

n8n中文版安装指南，使用Docker部署N8N中文版

news 来源：原创 2025/5/29 20:24:31

使用 Dify 差不多快一年时间了，讲真，我始终对它不太满意。一方面，它还不够成熟，存在各类迁移以及稳定性方面的问题；另一方面，虽说它可能旨在对非开发人员更友好，但工作流引擎的功能着实不强，好多功能都实现不了（我眼巴巴等了大半年，才终于盼来循环功能）。在身边两三个朋友的影响下，我也打算把更多精力投入到 n8n 这个更为成熟的自动化工作流项目上（它 2019 年启动，起初并非完全针对 AI 设计）。

n8n 工作流自动化开源项目，是海外的开源项目，对国内生态的支持力度不大，官方也没有推出中文版，这使得大家使用和学习的门槛比较高。此外，它有个关键的 WebHook 概念，非开发人员理解起来颇为困难，配置也相对繁琐。

本文档详细说明如何使用Docker部署n8n中文版，配置PostgreSQL数据库和Nginx反向代理，实现N8N的WebHook能力。

一、环境要求

这几样不是本次的重点，我就不展开说了，搞不明白的朋友可以看文后二维码加群交流。

• Docker 和 Docker Compose
• Nginx
• 域名，假设为http://n8n.yourdomain.com（已配置解析到服务器）

二、快速部署

1. 从Github下载代码

整个的安装脚本和配置文件，已经放在GitHub上

git clone https://github.com/rv192/CommonRepo.git && cd CommonRepo

克隆完成后，你会看到以下目录结构：

n8n/
├── docker/         # Docker相关配置文件
│   ├── build.basic.sh
│   ├── build.sh
│   ├── docker-compose.yaml
│   ├── docker-compose.basic.yaml
│   └── env.template
└── nginx/          # Nginx配置文件└── n8n.conf

如果选择最简化安装（基于SQLite，未启用HTTPS，中文界面），只需执行以下三行

这样就可以完成最简化的安装了，如果完整安装Postgre以及HTTPS支持，继续往下看。

2. 配置环境变量

2.1 复制环境变量模板：

cd n8n/docker
cp env.template .env
nano .env

2.2 修改环境变量（注意：需要先配置域名相关设置）：

 # 首先修改以下两项，确保使用HTTPS
N8N_HOST=n8n.yourdomain.com                    # 替换为你的域名
WEBHOOK_URL=https://n8n.yourdomain.com         # 替换为你的域名，必须使用HTTPS
# 其他配置项（一般不需要修改）
POSTGRES_USER=root                             # PostgreSQL用户名
POSTGRES_PASSWORD=n8n!yyds                     # PostgreSQL密码
POSTGRES_DB=n8n                                # PostgreSQL数据库名
N8N_DEFAULT_LOCALE=zh-CN                       # 中文界面的关键配置项
N8N_ENCRYPTION_KEY=                             # 首次运行build.sh时自动生成
N8N_USER_MANAGEMENT_JWT_SECRET=                 # 首次运行build.sh时自动生成

3. 构建和启动服务

3.1 设置build.sh脚本权限并执行：

chmod +x build.sh
./build.sh

3.2 检查服务状态，此时应该能看到n8n暴露了5678端口：

docker ps

4. 配置Nginx

4.1 修改Nginx配置文件：
首先修改 nginx/n8n.conf 中的域名，找到Server_name，将 http://n8n.yourdomain.com 替换为你的实际域名。

nano nginx/n8n.conf

4.2 部署Nginx配置：

 # 复制配置文件到Nginx目录
sudo cp nginx/n8n.conf /etc/nginx/sites-available/n8n.conf
# 创建软链接启用配置
sudo ln -s /etc/nginx/sites-available/n8n.conf /etc/nginx/sites-enabled/
# 验证Nginx配置
sudo nginx -t
# 如果配置正确，重启Nginx
sudo systemctl restart nginx

5. 配置HTTPS

5.1 安装certbot（如果未安装）：

sudo apt-get update
sudo apt-get install certbot python3-certbot-nginx

5.2 获取SSL证书：

sudo certbot --nginx -d n8n.yourdomain.com

5.3 确认Nginx配置：

Certbot会自动修改Nginx配置，添加SSL相关配置。完成后的配置文件应该包含以下内容：

 server {listen 443 ssl;server_name n8n.yourdomain.com;ssl_certificate /etc/letsencrypt/live/n8n.yourdomain.com/fullchain.pem;ssl_certificate_key /etc/letsencrypt/live/n8n.yourdomain.com/privkey.pem;location / {proxy_pass http://localhost:5678;proxy_http_version 1.1;proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection "upgrade";proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;proxy_set_header X-Forwarded-Proto $scheme;}
}
server {
listen80;
server_name n8n.yourdomain.com;
return301 https://$server_name$request_uri;
}

5.4 验证配置并重启Nginx：

sudo nginx -t && sudo systemctl restart nginx

5.5 验证安装效果
通过https://n8n.yourdomain.com访问，看是否已经成功，是否是中文界面。注意需要开放443端口，5678端口（可选）

5.5 验证WebHook是否配置成功

完成登录后，选择进入凭证Tab页，选择右上角：创建凭证，搜索并添加Google Calendar OAuth2 API，点继续

进入到配置页，注意看OAuth 重定向 URL，显示的URL是否是你当前n8n的HTTPS地址，这个是复制后提供给第三方服务的回调地址，在这个场景，是要提供给Google Cloud API的。

为什么一定要是HTTPS呢？因为第三方服务正式环境是强制要求的，如果只是开发测试，可以提供IP或HTTP方式的URL地址。

三、特性说明

1. 中文界面：已默认配置中文界面，无需额外设置
2. 数据持久化：

SQLite文件映射挂载在目录data下
PostgreSQL数据映射挂载在postgres-data下

3. 自动导入：安装脚本会自动导入backup目录下的凭证和工作流（如果有做过备份）

四、备份凭证和工作流

# 配置backup目录权限
sudochown 1000:1000 ./backup && sudochmod 775 ./backup
# 导出工作流和凭证
sudo docker compose exec n8n n8n export:workflow --all --output=/home/node/backup/workflows
sudo docker compose exec n8n n8n export:credentials --all --output=/home/node/backup/credentials

如果有需要可以考虑结合crontab做定时备份，这里就不展开了。