第 1 部分:规划您的 n8n 服务器
在输入任何命令之前,先准备好基础条件,判断自托管是否适合您,并选好服务器配置。
准备好以下五样东西,后面的步骤就会很顺利。
- 一台持续在线的 Linux 服务器。 本教程的命令适用于 Ubuntu,任何当前的 LTS 版本都可以。一台纯净的 Ubuntu VPS就是很好的起点。
- 通过 SSH 获得 root 或 sudo 权限。 如果您还不熟悉,我们的VPS 配置教程介绍了如何连接、更新系统以及最初的安全设置。
- 一个可以指向服务器的域名或子域名,例如
n8n.your-domain.com。启用 HTTPS 以及让其他服务调用 webhook 地址都需要它。 - 足够的内存。 学习用 1 GB 就够了;对于您所依赖的工作流,请按 2 GB 或以上来规划。下文会讲到如何选择配置。
- 一个存放备份的地方,而且不能是服务器本身:可以是您自己的电脑、对象存储或另一台服务器。
须知: n8n 是采用 Sustainable Use License 的 fair-code 软件。当构建工作流的人都属于您自己的组织时,Community Edition 可以免费自托管。如果您想把 n8n 作为服务提供给他人,或以白标方式提供,n8n 要求购买其商业许可。
2
第 2 步
自托管 n8n 意味着什么,什么时候更适合 n8n Cloud
n8n 是一款工作流自动化工具。当某件事发生时,例如一次 webhook 调用、一个定时任务或表格中新增一行,n8n 就会让数据流经一串节点,这些节点与您的应用、API、数据库和 AI 模型交互。自托管意味着这个引擎运行在您掌控的机器上,而不是 n8n 的托管服务上。
两种方式的编辑器完全相同,不同的是由谁来维护服务器。在自己的服务器上,您可以自行选择版本、数据库、域名以及数据所在的城市。相应地,更新、备份和安全都由您负责,没有人会替您打补丁。
适合自托管的情况
- 工作流运行频繁,您宁愿为服务器支付固定费用,也不想时刻盯着套餐限额。
- 凭据、客户数据或文件应当保存在您掌控的服务器上。
- 您需要社区节点、在 Code 节点中使用额外的 npm 包,或访问私有网络中的数据库和服务。
适合 n8n Cloud 的情况
- 团队里没有人愿意维护 Linux 服务器。
- 您希望更新、备份和服务器本身都有人代为照管。
- 您只是想先了解 n8n,暂时不想做任何部署。
自托管是用托管服务换取掌控权。服务器、数据和日常维护都归您所有。
我们不在这里列出 n8n Cloud 的价格,因为它会不时调整。请到 n8n 官方网站查看其当前套餐。
n8n 空闲时很安静,运行大型工作流时则很吃资源。n8n 文档中的四点事实基本决定了配置的选择:
- 内存比 CPU 更重要。 n8n 会把运行中工作流的数据放在内存中,因此大数据量、文件和大量并行运行首先需要的是内存。
- SQLite 是默认数据库, 而 n8n 推荐在生产环境中使用 PostgreSQL。
- 队列模式(queue mode),即由多个 worker 分担负载,需要 PostgreSQL 和 Redis。
- AI Assistant: n8n 的 Docker 指南要求使用它时至少配备 2 个 vCPU 和 4 GB 内存。
n8n 服务器最先耗尽的通常是内存,而不是 CPU。
我们的经验法则:1 GB 内存足以学习 n8n 并运行几个测试工作流。生产环境从 2 GB 起步。使用 AI 节点或处理大文件时选 4 GB 或以上,大量并行工作流或队列模式则选 8 GB 或以上。只有当繁重的 Code 节点全天运行时,CPU 才会成为瓶颈,这时独享核心就物有所值了。
想要一台已选好配置并装好 n8n 的服务器?我们的n8n VPS 套餐预装 n8n,按年付费低至 $6.39/月。如需对比所有配置和机房,请查看 VPS 价格页面。
提示: 工作流历史会随时间增长。n8n 默认会清理旧的执行数据,请确认清理设置符合您希望保留运行日志的时长,并在工作流成为业务关键之前迁移到 PostgreSQL。
第 2 部分:安装 n8n
两条路任选其一:在下单时一键为您安装 n8n,或在任意 Ubuntu 服务器上自己用 Docker 和 PostgreSQL 安装。
4
第 4 步
方案 A:在 VPSPulse 上一键安装 n8n
如果您不想折腾 Docker 和 Compose,就让下单流程替您完成安装。n8n 已预先选中,服务器启动后即在 Ubuntu 22.04 上运行 n8n。
选择套餐和城市
点击下方按钮打开下单页面,参照上一节选择配置,并选择离您或离工作流所调用 API 最近的城市。共有 12 个国家的 12 个城市可选。
付款并等待几分钟
可用银行卡、PayPal、银行转账或加密货币付款,按月或按年付费均可(按年付费省 20%)。服务器几分钟内即可就绪,您会收到它的独立 IPv4 地址和登录信息。
打开 n8n 并创建所有者账户
在浏览器中打开 n8n,设置所有者账户,也就是您这个实例的管理员登录。
完成设置
按照后面的章节添加域名和 HTTPS、关闭不用的端口并设置备份。这是一台拥有完整 root 权限的普通 Linux 服务器,因此本教程的所有内容都适用。
部署 n8n
按年付费低至 $6.39/月 · 新客户享 7 天退款
须知: 修改一键安装的 n8n 之前,请先确认它在该服务器上的运行方式(例如 docker ps 会列出正在运行的 Docker 容器),确保改动落在正确的位置。
其他工具也可以同样方式安装。请浏览完整的一键应用列表。
5
第 5 步
方案 B:用 Docker 手动安装 n8n
n8n 文档建议大多数自托管场景使用 Docker:每台服务器上都是同一个镜像,与系统其他部分隔离,更新也很简单。这些步骤适用于任何 Ubuntu 服务器,无论是我们的还是其他公司的。
图 1. 您将搭建的架构:反向代理接收 HTTPS 流量,n8n 只在服务器本机监听,PostgreSQL 和一个 Docker 卷负责保存数据。
按照 Docker 官方的 Ubuntu 安装指南操作。它会添加 Docker 自己的软件包仓库,并包含 Compose 插件。然后检查两者是否正常:
docker --versiondocker compose version
为 n8n 的数据创建一个卷,然后用官方镜像启动容器。这就是 n8n Docker 指南中的快速入门:
docker volume create n8n_data docker run -it --rm --name n8n -p 5678:5678 \ -v n8n_data:/home/node/.n8n \ docker.n8n.io/n8nio/n8n
n8n 现在监听 5678 端口,即使删除容器,卷中也会保留您的工作流、凭据和加密密钥。按 Ctrl+C 停止。这适合初次体验,但它使用 SQLite、没有 HTTPS,并且关闭终端就会停止。从另一台电脑通过普通 http 打开时,还会出现安全 cookie 警告(见故障排查)。
8
第 8 步
编写带 PostgreSQL 的 Docker Compose 文件
生产环境中,n8n 推荐使用 PostgreSQL。创建一个文件夹,例如 ~/n8n,并把以下内容写入 docker-compose.yml。替换 n8n.your-domain.com、时区、两处 <version> 占位符和密码,并使用一个足够长的随机密码。
docker-compose.yml
services: postgres: image: postgres:<version> restart: unless-stopped environment: - POSTGRES_USER=n8n - POSTGRES_PASSWORD=change-me - POSTGRES_DB=n8n volumes: - db_data:/var/lib/postgresql/data n8n: image: docker.n8n.io/n8nio/n8n:<version> restart: unless-stopped ports: - "127.0.0.1:5678:5678" environment: - DB_TYPE=postgresdb - DB_POSTGRESDB_HOST=postgres - DB_POSTGRESDB_PORT=5432 - DB_POSTGRESDB_DATABASE=n8n - DB_POSTGRESDB_USER=n8n - DB_POSTGRESDB_PASSWORD=change-me - N8N_HOST=n8n.your-domain.com - N8N_PROTOCOL=https # n8n older than 2.30: use WEBHOOK_URL instead - N8N_WEBHOOK_URL=https://n8n.your-domain.com/ - GENERIC_TIMEZONE=Europe/Berlin - TZ=Europe/Berlin volumes: - n8n_data:/home/node/.n8n depends_on: - postgres volumes: db_data: n8n_data:
端口特意绑定到 127.0.0.1:只有同一台服务器上的反向代理能访问 n8n,而不是整个互联网。
在 Compose 文件所在的文件夹中,在后台启动两个容器并跟踪 n8n 的日志:
cd ~/n8ndocker compose up -ddocker compose logs -f n8n
当日志显示编辑器已可访问时,n8n 就运行起来了。按 Ctrl+C 退出日志;容器会继续运行,restart: unless-stopped 会在重启后让它们自动恢复。
自托管 n8n 的大多数问题都出在少数几个环境变量上。下面是文件中每个变量的作用:
Docker Compose 部署中 n8n 的关键环境变量
| 变量 | 作用 |
N8N_HOST | n8n 运行所用的域名,例如 n8n.your-domain.com。 |
N8N_PROTOCOL | n8n 位于反向代理之后时设为 https。 |
N8N_WEBHOOK_URL | n8n 用来生成 webhook 地址的公网地址。较新的版本(2.30 及以上)读取这个名称,旧版本读取 WEBHOOK_URL。 |
GENERIC_TIMEZONE | Schedule 触发器和其他基于时间的节点所用的时区。 |
DB_TYPE | 设为 postgresdb 可将 n8n 从默认的 SQLite 切换到 PostgreSQL。 |
DB_POSTGRESDB_* | PostgreSQL 服务器的主机、端口、数据库、用户名和密码(如需使用非默认 schema,还有 DB_POSTGRESDB_SCHEMA)。 |
N8N_ENCRYPTION_KEY | 可选。n8n 用来加密已保存凭据的密钥。如果不设置,n8n 会在首次启动时随机生成一个,并保存在它的数据卷中。 |
注意: 固定您选择的版本:把 <version> 替换为当前的 n8n 版本标签和 n8n 支持的 PostgreSQL 主版本,这样只有在您决定时才会更新。若不想把密码写在 YAML 里,Compose 可以从同一文件夹中的 .env 文件读取(在文件中写 ${POSTGRES_PASSWORD} 代替具体值)。
第 3 部分:域名、HTTPS 和首次登录
Webhook、OAuth 登录和 n8n 的安全 cookie 都需要 HTTPS。常见做法是在同一台服务器上运行反向代理:它在 80 和 443 端口上响应,获取免费的 TLS 证书,并把请求转发给 5678 端口上的 n8n。
在您域名的 DNS 管理面板中,为 n8n.your-domain.com 创建一条 A 记录,指向服务器的 IPv4 地址。等域名解析生效后再申请证书。
Caddy 是最省事的方式,因为它会自动申请和续期证书。从 Caddy 的官方软件包安装,然后把 /etc/caddy/Caddyfile 的内容替换为:
/etc/caddy/Caddyfile
n8n.your-domain.com { reverse_proxy localhost:5678}
用 sudo systemctl reload caddy 重新加载 Caddy。大约一分钟后,https://n8n.your-domain.com 就应该能打开 n8n 编辑器。
提示: Caddy 也运行在 Docker 中?那么 localhost 指的是 Caddy 容器本身。请把 Caddy 放进同一个 Compose 文件,并改为指向服务名:reverse_proxy n8n:5678。
13
第 13 步
更喜欢 Nginx?思路相同,只是多几行
把站点代理到 http://127.0.0.1:5678,使用 HTTP/1.1 并传递 Upgrade 和 Connection 请求头,因为编辑器会保持一个实时的 WebSocket 连接。然后用 Certbot 获取证书。
Compose 文件中的 N8N_HOST、N8N_PROTOCOL=https 和 webhook 地址必须与域名一致。每次修改后,都要再次运行 docker compose up -d,让容器应用新设置。
打开 https://n8n.your-domain.com。首次访问时,n8n 会请您设置所有者账户,即该实例的管理员用户。请使用密码管理器生成一个足够长且唯一的密码,然后进入 Settings > Profile & preferences(设置 > 个人资料与偏好)开启双因素认证。
要检查整条链路,可以搭建一个极简工作流:一个 Webhook 触发器,后面接任意一个节点。查看 n8n 为该 webhook 显示的生产环境地址,它应以 https://n8n.your-domain.com 开头,而不是 localhost:5678。启用工作流,然后在浏览器中或用 curl 调用该地址。如果执行列表中出现了这次运行,说明服务器、代理和 n8n 都已正确连通。
第 4 部分:加固、备份和更新 n8n
自托管的 n8n 掌握着它所连接的每个应用的钥匙。请像对待密码保险库一样对待这台服务器。
保持 SSH(22)、HTTP(80)和 HTTPS(443)开放,关闭其他所有端口。在 Ubuntu 上使用 UFW:
sudo ufw allow OpenSSHsudo ufw allow 80/tcpsudo ufw allow 443/tcpsudo ufw enable
注意: Docker 通过写入自己的防火墙规则来发布端口,而这些规则会绕过 UFW。用 -p 5678:5678 启动的容器,即使 UFW 拦截了 5678 端口,仍然可以从互联网访问。请像上面的 Compose 文件那样绑定到 127.0.0.1:5678:5678。
- 使用 SSH 密钥登录,并关闭密码登录。我们的VPS 配置教程介绍了具体做法。
- 及时为 Ubuntu 打补丁。 定期安装更新;Ubuntu 的
unattended-upgrades 软件包可以自动为您安装安全更新。 - 按计划更新 n8n, 而不是等出了问题才更新。下一节会介绍方法。
- 保管好加密密钥。 一旦丢失,已保存的凭据就无法解密;如果它和数据库一起泄露,任何人都能读取这些凭据。请把一份副本保存在服务器之外的安全位置。
- 为每个人单独创建 n8n 账户并开启双因素认证,不要共用所有者登录。
- 谨慎选择社区节点。 它们会在您的服务器上运行代码,因此只安装您信任的节点。
须知: 每台 VPSPulse 服务器都包含 DDoS 防护,当有人用流量冲击服务器时,它有助于保持您的 webhook 可访问。它是上述步骤的补充,不能替代它们。
n8n_data 卷: n8n 的设置和加密密钥;如果您仍在使用 SQLite,数据库本身也在这里。- PostgreSQL 数据库, 在 Compose 部署中,工作流、凭据和执行历史都保存在这里。
- 您的
docker-compose.yml 和 .env 文件, 以便原样重建服务器。
n8n 的命令行工具可以把所有内容导出为 JSON。在容器内运行,然后把文件复制出来:
cd ~/n8ndocker compose exec -u node n8n n8n export:workflow --all --output=/home/node/.n8n/workflows.jsondocker compose exec -u node n8n n8n export:credentials --all --output=/home/node/.n8n/credentials.jsondocker compose cp n8n:/home/node/.n8n/workflows.json ./docker compose cp n8n:/home/node/.n8n/credentials.json ./
须知: 凭据导出时会用您实例的密钥加密,因此文件只有配合该密钥才能使用。两者都要保留,但请分开存放。(n8n 也可以用 --decrypted 导出解密后的凭据,此时文件会以明文包含所有机密信息。)
数据库转储会完整保存所有内容,包括执行历史:
docker compose exec -T postgres pg_dump -U n8n n8n > n8n-$(date +%F).sql
把转储文件和导出文件复制到服务器之外,例如使用 scp 或 rsync,并在一台备用服务器上演练一次恢复,确认备份可用。
阅读版本说明
n8n 会为每个版本发布说明。在大版本跨越之前,先查看有没有不兼容的变更。
先备份
执行上面的导出和数据库转储。更新可能会修改数据库,所以备份是您可靠的退路。
拉取新镜像并重建容器
如果您固定了版本标签,先在 docker-compose.yml 中修改它,然后运行下面的命令。
检查结果
跟踪日志直到编辑器可以访问,然后打开几个工作流,并手动运行其中一个。
cd ~/n8ndocker compose pulldocker compose downdocker compose up -d
如果您是用普通的 docker run 启动 n8n 的:先用 docker pull docker.n8n.io/n8nio/n8n 拉取新镜像,停止并删除旧容器,再用同样的命令重新启动。数据都在卷里,所以不会丢失任何内容。
提示: 小步、定期的更新比一次跳过多个版本更容易测试,也更容易回退。