n8n 是一款强大的开源自动化工具,能够通过可视化工作流连接各种应用和服务,实现高效的任务自动化。无论是个人效率提升,还是企业级流程管理,选择合适的部署方式都至关重要。
本文将详细介绍 n8n 自托管版的多种部署方案,涵盖本机、NAS 及服务器环境,并提供 Docker 部署的详细配置指南,帮助你快速搭建稳定、安全的 n8n 实例。
0. 版本选择前提
n8n 提供两种主要版本选择:
-
云服务版:
-
官方提供的 SaaS 服务
-
开箱即用,注册账号购买会员即可
-
适合:预算充足、追求便捷的用户
-
注意:技术测试和学习成本较高,建议日常使用转为自托管
-
-
自托管版:
-
官方开源版本(GitHub)
-
需要自行部署和维护
-
优势:完全控制、数据自主、成本可控
-
1. 自托管版部署环境选择
官方推荐使用 Docker 部署,实测 n8n 的 Docker 镜像环境适应性极强,可在包括群晖 DSM、极空间等任何支持 Docker 的平台一键部署。
1.1 本机 PC 部署(无公网 IP)
适用场景:
-
无需外部服务的本地批处理
-
快速体验和学习
-
开发测试环境
局限性:
-
无法接收公网第三方服务的回调
-
不能提供 Webhook 给外部服务调用
-
依赖本地计算机运行
技术要点:
-
最简单的部署方式
-
适合初次接触 n8n 的用户快速上手
-
无需考虑复杂的网络配置
详细指引参见【n8n 中文系列教程】专栏中的
n8n 中文系列教程_05.如何在本机部署/安装 n8n(详细图文教程)-CSDN博客
1.2 NAS 部署方案
适用场景:
-
已有 NAS 设备
-
希望低成本体验 n8n 全功能
-
需要 24/7 运行的自动化流程
局限性:
-
可能难以直接访问 Google 等国际服务
-
性能受限于 NAS 硬件
-
网络配置较复杂
常见问题:
-
NAS 部署存在一些特定坑点
-
建议使用 Docker Compose 管理容器
-
注意数据卷的持久化配置
1.3 服务器部署(推荐方案)
适用场景:
-
生产环境日常使用
-
需要完整功能支持
-
7×24 小时稳定运行
-
直接访问国际 API 服务
优势:
-
完整的公网访问能力
-
专业级稳定性和性能
-
可直接连接 GPT/Gemini 等 API
-
便于扩展和维护
成本分析:
-
推荐 CloudCone 等性价比 VPS
-
基础配置:2vCPU/2GB RAM
-
年成本约 30 美元(约合 200 元人民币)
-
对于常规 Workflow 足够使用
运维建议:
-
推荐使用 1Panel 管理面板
-
定期备份工作流和数据
-
设置监控和告警机制
资料推荐
2. 通用部署方法(Docker 方案)
对于从未使用过 n8n 的新手,建议先在本机部署体验,确认符合需求后再考虑生产环境部署。
2.1 安装 Docker 环境
各平台安装方法:
环境 | 安装方式 |
---|---|
本机 PC | 下载 Docker Desktop |
群晖 NAS | 套件中心安装 Container Manager |
极空间 NAS | 应用中心安装 Docker |
云服务器(2选1) |
|
自行安装 | 参考 Debian Docker 安装教程 |
2.2 部署 n8n 容器
基本步骤:
-
在 Docker 中搜索 n8n 镜像
-
拉取最新官方镜像
-
创建容器并配置
关键配置项:
环境变量设置(重要)
变量名 | 示例值 | 说明 |
---|---|---|
N8N_PORT | 5678 | Docker 内部端口 |
N8N_PROTOCOL | https | 启用 HTTPS 访问 |
N8N_HOST | yourdomain.com | 访问域名 |
N8N_WEBHOOK_URL | https://yourdomain.com:5680/ | Webhook 接收地址,必须带协议头 |
GENERIC_TIMEZONE | Asia/Shanghai | 设置默认时区 |
N8N_BASIC_AUTH_ACTIVE | true | 启用基础认证(生产环境强烈建议) |
N8N_BASIC_AUTH_USER | admin | 管理员用户名 |
N8N_BASIC_AUTH_PASSWORD | yourstrongpassword | 管理员密码 |
注意:
-
本机测试可暂不配置环境变量
-
生产环境必须配置认证和安全相关变量
-
时区设置影响定时任务的执行时间
数据持久化(关键)
必须将本地目录映射到容器内的 /home/node/.n8n/
路径,否则:
-
升级容器时会丢失所有工作流和数据
-
无法进行备份和恢复
-
生产环境存在严重风险
推荐做法:
-v /path/on/host:/home/node/.n8n
3. 常见问题与进阶配置
3.1 初次部署检查清单
-
Docker 服务是否正常运行?
-
端口映射是否正确?(建议主机端口与容器端口一致)
-
数据卷是否成功挂载?
-
必要的环境变量是否配置?
-
防火墙是否放行相关端口?
3.2 性能优化建议
-
对于复杂工作流,建议分配更多资源:
--memory=2g --cpus=2
-
高负载场景考虑使用数据库模式:
-e DB_TYPE=postgresdb -e DB_POSTGRESDB_DATABASE=n8n -e DB_POSTGRESDB_HOST=your_postgres -e DB_POSTGRESDB_PORT=5432 -e DB_POSTGRESDB_USER=username -e DB_POSTGRESDB_PASSWORD=password
3.3 安全加固措施
-
启用 HTTPS(可通过反向代理实现)
-
设置强密码认证
-
限制访问 IP(通过防火墙或反向代理)
-
定期更新 n8n 版本
-
配置定期备份策略
3.4 学习资源推荐
-
官方文档(建议遇到问题时查阅):
注意:官方文档信息较为分散,建议按需查阅而非通读。
4. 获取帮助
如果在部署过程中遇到问题:
-
先检查本文提到的关键配置点
-
查阅官方文档对应章节
-
在本文评论区留言(我会将常见问题补充到正文)
-
加入 n8n 中文社区讨论
有用的话记得点赞收藏噜!