跳到主内容

n8n 下载与部署:Cloud、npm、Docker 与队列模式

版本 以官网当前版本为准(以官网为准)

无需自行维护服务器的官方云服务

自托管安装、端口与持久化

本机试用与 Node.js 要求

Redis、worker 与共享密钥配置

自托管与商业用途边界

源码、许可证与版本记录

n8n 是 n8n GmbH 维护的工作流自动化平台,可连接业务应用、数据库、代码和 AI 服务。它提供官方 Cloud,也可通过 npm 或 Docker 自托管;源码可见,但主体采用 Sustainable Use License,并非普通开源许可证。

n8n Cloud npm 与 Docker 部署步骤示意图
n8n 可使用云服务或自托管,自托管时必须配置数据持久化和访问保护。

Cloud、npm、Docker 怎么选

  • n8n Cloud:适合不想维护服务器、数据库、升级和备份的用户。
  • npx/npm:适合本机试用,官方当前要求 Node.js 20.19 至 24.x。
  • Docker:官方推荐用于多数自托管场景,环境更易隔离和迁移。
  • 源码仓库:适合贡献和深度开发,不是一键安装包。

端口、数据库和持久化

n8n 默认从 5678 端口访问,Docker 默认用 SQLite,也支持 PostgreSQL。改用 PostgreSQL 后仍应持久化 .n8n 目录,其中还可能有加密密钥和实例数据。

凭据备份不能少什么

n8n 会用加密密钥保护保存的凭据。迁移前要同时备份数据库、二进制文件和 N8N_ENCRYPTION_KEY;只恢复数据库却丢失原密钥,旧凭据可能无法解密。队列模式下主实例和所有 worker 必须使用同一个密钥。

Webhook 公网地址如何配置

反向代理后应按官方文档设置 N8N_WEBHOOK_URL 和代理层数,让第三方服务获得正确回调地址;旧变量 WEBHOOK_URL 已弃用,测试隧道不能用于生产。

什么时候需要队列模式

单机业务先做好备份和并发限制即可。执行量上升后,队列模式用 Redis 传递任务,由 worker 执行,并把数据写入共享数据库;官方建议队列模式使用 PostgreSQL。它增加了 Redis、worker、共享密钥和监控的维护成本,不是安装后自动提速的开关。

社区节点有什么风险

从 npm 安装的社区节点属于第三方代码,官方文档说明它们能完整访问 n8n 所在主机,也可能读取工作流数据。优先使用内置或已验证节点;不需要时关闭社区节点,升级前检查维护者、版本变化和源码。

许可证与商用边界

n8n 主体使用 Sustainable Use License,企业文件适用 Enterprise License。内部自动化与把 n8n 作为收费托管、白标或面向客户的核心服务不是同一用途;商业方案上线前应阅读官方许可说明,必要时向 n8n 确认。

部署结论

快速体验选 Cloud 或 npx,长期自托管选官方 Docker 文档。上线前完成 HTTPS、账号权限、固定加密密钥、数据库和文件备份、Webhook 校验及执行费用限制;GitHub 主要用于查看源码、许可证和版本记录。

反馈页面信息

请描述需要更正的地方,页面标题和网址会自动附上。

也可以发邮件至 [email protected]