n8n Docker 部署手册

一、n8n 简介

n8n 是一款专为技术团队打造的 开源工作流自动化平台(Workflow Automation Platform),兼具「低代码(No-code)」与「可编程(Pro-code)」双重特性。

它让你可以轻松地将不同系统、API 和服务连接起来,自动执行任务、数据同步、通知、集成 AI 模型等各种流程。
n8n 不仅能节省大量重复性工作,还能在团队内部构建稳定、安全的自动化体系。

🔑 核心功能亮点

功能 说明
🧠 可编程与可视化兼备 支持可视化拖拽节点,也能直接编写 JavaScript/Python 逻辑。
🤖 AI 原生支持 内置 LangChain、OpenAI 接口,可搭建自定义 AI Agent 流程。
🧩 400+ 集成节点 支持 GitHub、Slack、MySQL、Redis、Google Sheets、Telegram、OpenAI 等常用服务。
🔐 完全自托管 Fair-Code 许可协议,支持本地部署,数据完全掌控在自己手中。
🧱 企业级特性 提供权限管理、SSO、离线部署(Air-gapped)等企业功能。
🌍 活跃社区生态 超过 900+ 预制工作流模板,可快速复用。

简言之:n8n = 可编程的 Zapier + 自主可控的 Airflow + AI 工作流引擎


🧰 准备工作

若你的系统尚未安装 Docker,请先一键安装:

Linux Docker & Docker Compose 一键安装

一键安装配置脚本(推荐方案):
该脚本支持多种 Linux 发行版,支持一键安装 Docker、Docker Compose 并自动配置轩辕镜像加速源。

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

二、n8n Docker 镜像来源

你可以在 轩辕镜像 中找到官方同步

<think>我们根据提供的引用信息,总结n8n在Docker环境下进行汉化部署的步骤。引用中提到了几个关键点: 1. 需要将汉化包(即editor-ui-dist目录)映射到容器内的特定路径。 2. 需要设置环境变量N8N_DEFAULT_LOCALE为zh-CN(注意:引用[1]和[2]中变量名略有不同,但根据官方文档,应为N8N_DEFAULT_LOCALE)。 3. 其他可选配置,如加密密钥、安全Cookie、时区等。 步骤: 1. 获取汉化包:从引用[2]和[3]中可以看出,汉化包是一个目录(editor-ui-dist),需要先下载汉化包并放置到本地目录(如D:\n8n_zh\... 或 /opt/n8n_data/dist)。 2. 运行Docker容器,映射汉化包目录并设置环境变量。 注意:引用[2]和[3]提供了具体的docker run命令。我们综合引用信息,给出一个通用的命令: ```bash docker run -d \ --name n8n \ -p 5678:5678 \ -v /本地路径/editor-ui-dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist \ -v n8n_data:/home/node/.n8n \ -e N8N_DEFAULT_LOCALE=zh-CN \ -e N8N_ENCRYPTION_KEY=my-very-strong-password-123 \ # 建议替换为自己的强密码 -e N8N_SECURE_COOKIE=false \ # 如果使用HTTP,需要设置为false -e TZ="Asia/Shanghai" \ # 设置时区 --restart always \ n8nio/n8n ``` 解释: - `-v /本地路径/editor-ui-dist:...`:将汉化包目录映射到容器内对应位置(注意:容器内路径是固定的,不能更改)。 - `-v n8n_data:/home/node/.n8n`:创建卷n8n_data用于持久化数据(也可以使用本地目录替换,如`-v /本地数据目录:/home/node/.n8n`)。 - `-e N8N_DEFAULT_LOCALE=zh-CN`:设置默认语言为中文。 - `-e N8N_ENCRYPTION_KEY`:设置加密密钥,用于加密敏感数据(必须设置且足够复杂)。 - `-e N8N_SECURE_COOKIE=false`:如果通过HTTP访问,需要设置为false(如果是HTTPS,可以设置为true)。 - `-e TZ="Asia/Shanghai"`:设置时区为中国时区。 - `--restart always`:设置容器总是重启(保证服务持续运行)。 注意事项: 1. 汉化包的获取:需要从汉化项目(如n8n-i18n-chinese)中获取,通常是一个包含dist目录的文件夹。引用中没有直接提供下载链接,但用户需要自行下载汉化包并解压到本地目录。 2. 汉化包版本需要与n8n版本匹配,否则可能出现兼容性问题(引用中提到n8n-1.110.1,所以建议用户确认自己使用的n8n镜像版本,并下载对应汉化包)。 此外,引用[4]提到了一种快速体验的方法,即通过InsCode平台生成基础工作流模板,但这不涉及Docker部署,所以不作为本回答的重点。 §§相关问题§§ 1. 如何获取n8n的汉化包? 2. 汉化包版本与n8n版本不匹配怎么办? 3. 除了汉化,部署n8n还需要注意哪些安全设置? </think>### Docker环境下n8n汉化部署方法 根据引用信息,n8n在Docker环境下实现汉化部署需完成两个核心步骤: #### 1. 汉化文件映射 将本地汉化包目录映射到容器指定路径: ```bash -v /本地路径/editor-ui-dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist ``` *示例路径(Windows)*: `-v D:\n8n_zh\editor-ui-dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist` *示例路径(Linux)*: `-v /opt/n8n_data/dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist`[^1][^2][^3] #### 2. 环境变量配置 必须设置中文环境变量: ```bash -e N8N_DEFAULT_LOCALE=zh-CN ``` 同时建议配置以下辅助参数: ```bash -e TZ="Asia/Shanghai" # 时区设置 -e N8N_SECURE_COOKIE=false # HTTP访问时禁用安全Cookie -e N8N_ENCRYPTION_KEY=your-strong-password # 数据加密密钥 ``` #### 完整部署命令示例 ```bash docker run -d --name n8n \ -p 5678:5678 \ -v /your/local/path/dist:/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist \ -v n8n_data:/home/node/.n8n \ -e N8N_DEFAULT_LOCALE=zh-CN \ -e N8N_SECURE_COOKIE=false \ -e TZ="Asia/Shanghai" \ -e N8N_ENCRYPTION_KEY=mySecureKey123! \ --restart always \ n8nio/n8n ``` ### 验证要点 1. **路径映射验证**:确保容器内路径`/usr/local/lib/node_modules/n8n/node_modules/n8n-editor-ui/dist`包含汉化文件 2. **变量生效验证**:登录Web界面(127.0.0.1:5678)检查是否为中文界面 3. **常见故障排除**: - 汉化失败:检查映射路径是否包含完整汉化文件 - 时区错误:确认`TZ`变量值正确(如`Asia/Shanghai`) - 加密问题:首次启动需设置`N8N_ENCRYPTION_KEY`[^2][^3] > 注:如需快速体验基础功能,可使用InsCode平台生成工作流模板免部署预览[^4]。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值