在 Amazon Web Services 上托管 n8n

本指南介绍如何通过 Amazon Web Services（AWS）自托管 n8n，使用 Postgres 作为数据库后端，并通过 Kubernetes 管理所需资源和反向代理。

托管选项

AWS 提供多种适合托管 n8n 的方式，包括 EC2（虚拟机）和 EKS（使用 Kubernetes 运行的容器）。

本指南使用 EKS 托管。Kubernetes 会增加一些复杂性和配置，但最适合随需求变化扩展 n8n。

前提条件

本指南结合使用 AWS 界面和 EKS 的 eksctl CLI 工具。

虽然 eksctl 文档未提及，但还需要安装 AWS CLI 工具，并配置工具的身份验证。

信息

自托管的知识要求

自行托管 n8n 需要具备以下技术知识：

设置和配置服务器与容器
管理应用资源和扩展容量
保护服务器和应用的安全
配置 n8n

n8n 建议有经验的用户选择自托管。操作失误可能导致数据丢失、安全问题和停机。如果不熟悉服务器管理，n8n 建议使用 n8n Cloud。

信息

Stable 与 Beta 版本

n8n 通常每周发布一个新的次版本。stable 版本用于生产环境；beta 是最近发布的版本；beta 版本可能不稳定。如需报告问题，请使用论坛。

当前 stable：2.45.5 当前 beta：2.46.1

创建集群

使用 eksctl 工具运行以下命令，指定名称和区域以创建集群：

eksctl create cluster --name n8n --region <your-aws-region>

创建集群可能需要一段时间。

集群创建后，eksctl 会自动将 kubectl 上下文切换到该集群。

克隆配置仓库

Kubernetes 和 n8n 需要一系列配置文件，可以从此仓库克隆。以下步骤说明各文件用途，以及需要更改的设置。

使用以下命令克隆仓库：

git clone https://github.com/n8n-io/n8n-hosting.git

然后切换目录：

cd n8n-hosting/kubernetes

配置 Postgres

对于较大规模的 n8n 部署，Postgres 比 SQLite 提供更稳健的数据库后端。

配置持久存储卷

为在 Pod 重启后保留数据，Postgres 部署需要持久卷。AWS 默认存储类 gp3 适合此用途，由 postgres-claim0-persistentvolumeclaim.yaml 清单定义。

…
spec:
  storageClassName: gp3
  accessModes:
    - ReadWriteOnce
…

Postgres 环境变量

需要为 Postgres 设置一些环境变量，并传递给容器内运行的应用。

示例 postgres-secret.yaml 文件包含占位符，需要替换为你自己的用户信息和数据库值。

PostgreSQL 使用 root 用户（POSTGRES_USER）进行设置和管理，但最佳实践是为 n8n 创建独立的非 root 用户（POSTGRES_NON_ROOT_USER）。root 用户拥有完整控制权，n8n 运行只需非 root 用户权限。配置两者可提高安全性，防止意外更改数据库系统。

随后，postgres-deployment.yaml 清单使用此文件中的值，将其传递给应用 Pod。

配置 n8n

创建文件存储卷

虽然运行 n8n 并非必须使用持久卷，但它有助于保留使用 n8n 时上传的文件，也能在重启间保留手动设置的 n8n 加密密钥；启动时，密钥会写入文件存储中的一个文件。

n8n-claim0-persistentvolumeclaim.yaml 清单创建此存储卷声明，n8n Deployment 通过 volumes 部分挂载它，该部分位于 n8n-deployment.yaml 清单中。

…
volumes:
  - name: n8n-claim0
    persistentVolumeClaim:
      claimName: n8n-claim0
…

Pod 资源

Kubernetes 允许指定应用容器所需的最小资源和可使用的上限。前文克隆的示例 YAML 文件，其 resources 部分包含以下内容，位于 n8n-deployment.yaml 文件中：

…
resources:
  requests:
    memory: "250Mi"
  limits:
    memory: "500Mi"
…    

这为每个容器定义最少 250 MB、最多 500 MB 的内存，并由 Kubernetes 处理 CPU。可以按需更改。以下是 n8n Cloud 套餐的资源值，供参考：

套餐层级	RAM	CPU
Starter	320mb	10 millicore，可突发
Pro，10k 次执行	640mb	20 millicore，可突发
Pro，50k 次执行	1280mb	80 millicore，可突发

可选：环境变量

可以通过环境变量配置 n8n 设置和行为。

创建 n8n-secret.yaml 文件。n8n 环境变量详情请参阅环境变量。

部署

两个部署清单（n8n-deployment.yaml 和 postgres-deployment.yaml）向 Kubernetes 定义 n8n 和 Postgres 应用。

注意

这些清单运行 PostgreSQL 18，首次设置无需额外操作。

如果已有数据库运行较旧的 PostgreSQL 主版本，请勿直接对其应用这些清单。PostgreSQL 18 无法打开旧主版本写入的数据目录，移动文件夹也无济于事。Pod 会持续处于 CrashLoopBackOff，并报错 database files are incompatible with server。PostgreSQL 不会改动原数据，可以将镜像重新固定回先前版本。

要迁移现有数据库，请先按照官方 PostgreSQL 升级指南操作。

这些清单定义以下内容：

将定义的环境变量传递给各应用 Pod。
定义要使用的容器镜像。
设置资源消耗上限。
使用前文定义的 volumes 和 volumeMounts，指定容器中挂载卷的路径。
扩展和重启策略。示例清单为每种 Pod 定义一个实例，请按需调整。

服务

两个服务清单（postgres-service.yaml 和 n8n-service.yaml）通过 Kubernetes 负载均衡器向外提供服务，默认端口分别为 5432 和 5678。

发送到 Kubernetes 集群

在 n8n-kubernetes-hosting 目录中运行以下命令，将所有清单发送到集群：

kubectl apply -f .

信息

命名空间错误

资源尚未就绪时，可能出现找不到“n8n”命名空间的错误。可以再次运行相同命令，或先使用以下命令应用命名空间清单：

kubectl apply -f namespace.yaml

设置 DNS

n8n 通常运行在子域名上。请在 DNS 提供商处为该子域名创建记录，指向实例的静态地址。

查找实例上 n8n 服务的地址：

在 AWS 控制台的 Amazon Elastic Kubernetes Service 页面中，打开 Clusters（集群）区域。
选择集群名称，打开配置页面。
选择 Resources（资源）选项卡，再选择 Service and networking（服务与网络）> Services（服务）。
选择 n8n 服务，复制 Load balancer URLs（负载均衡器 URL）对应的主机名。DNS 记录应指向该主机名，不要在记录值中附加端口。浏览器访问 n8n 服务时，再在 URL 中使用端口 5678。

信息

使用 HTTP

本指南定义的服务使用 HTTP 连接，例如 n8n-deployment.yaml。但点击 Load balancer URLs 的值时，EKS 会打开 HTTPS URL，从而产生错误。打开 n8n 子域名时，请确保使用 HTTP。

删除资源

如需删除此部署，可使用以下命令移除清单创建的资源：

kubectl delete -f .

后续步骤

进一步了解如何配置和扩展 n8n。
或者开始探索 n8n 的使用方式，尝试快速入门。

托管选项 ​

前提条件 ​

创建集群 ​

克隆配置仓库 ​

配置 Postgres ​

配置持久存储卷 ​

Postgres 环境变量 ​

配置 n8n ​

创建文件存储卷 ​

Pod 资源 ​

可选：环境变量 ​

部署 ​

服务 ​

发送到 Kubernetes 集群 ​

设置 DNS ​

删除资源 ​

后续步骤 ​

相关资源 ​