在 Amazon Web Services 上托管 n8n
本托管指南向您展示如何使用 Amazon Web Services (AWS) 自托管 n8n。它使用 n8n 和 Postgres 作为数据库后端,使用 Kubernetes 管理必要的资源和反向代理。
提示
想要生产级、高可用的设置?
对于带有托管 PostgreSQL、Redis 和自动扩缩 worker 的多 main 部署,请参阅使用 Terraform 部署到 AWS。
托管选项
AWS 提供了几种适合托管 n8n 的方式,包括 EC2(虚拟机)和 EKS(使用 Kubernetes 运行的容器)。
本指南使用 EKS{:target=_blank .external-link} 作为托管选项。使用 Kubernetes 需要一些额外的复杂性和配置,但这是随着需求变化扩展 n8n 的最佳方法。
先决条件
本指南中的步骤混合使用 AWS UI 和 eksctl CLI 工具用于 EKS{:target=_blank .external-link}。
虽然在 eksctl 的文档中没有提到,但您还需要安装 AWS CLI 工具{:target=_blank .external-link},并配置工具的身份验证{:target=_blank .external-link}。
提示
Self-hosting knowledge prerequisites 自托管知识先决条件
自托管 n8n 需要技术知识,包括:
- 设置和配置服务器和容器
- 管理应用程序资源和扩展
- 保护服务器和应用程序
- 配置 n8n
n8n 建议专家用户使用自托管。错误可能会导致数据丢失、安全问题和停机。如果您没有管理服务器的经验,n8n 推荐 n8n Cloud。
提示
稳定版和测试版
n8n 每周都会发布新的次要版本。 stable 版本用于生产用途。 beta 是最新版本。 beta版本可能不稳定。要报告问题,请使用 论坛。
当前 stable:2.47.7
当前 beta:2.48.4
创建集群
使用 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 部署在 n8n-deployment.yaml 清单的 volumes 部分挂载该声明。
…
volumes:
- name: n8n-claim0
persistentVolumeClaim:
claimName: n8n-claim0
…
Pod 资源
Kubernetes{:target=_blank .external-link} 允许您指定应用程序容器需要的最小资源和它们可以运行到的限制。上面克隆的示例 YAML 文件在 n8n-deployment.yaml 文件的 resources 部分包含以下内容:
…
resources:
requests:
memory: "250Mi"
limits:
memory: "500Mi"
…
这定义了每个容器最少 250mb,最多 500mb,并让 Kubernetes 处理 CPU。您可以更改这些值以匹配您自己的需求。作为参考,以下是 n8n Cloud 产品的资源值:
| 版本 | RAM | CPU |
|---|---|---|
| Starter 入门版 | 320mb | 10 millicore(可突发) |
| Pro 专业版(1 万次执行) | 640mb | 20 millicore(可突发) |
| Pro 专业版(5 万次执行) | 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 .
提示
Namespace error 命名空间错误
您可能会看到一条有关找不到“n8n”命名空间的错误消息,因为该资源尚未准备好。您可以再次运行相同的命令,或者首先使用以下命令应用命名空间清单:
kubectl apply -f namespace.yaml
设置 DNS
n8n 通常在子域上运行。请通过 DNS 提供商为该子域创建 DNS 记录,并将其指向实例的静态地址。
要查找在实例上运行的 n8n 服务的地址:
- 在 AWS 控制台中打开 Amazon Elastic Kubernetes Service 页面的 Clusters 部分。
- 选择集群的名称以打开其配置页面。
- 选择 Resources 选项卡,然后选择 Service and networking > Services。
- 选择 n8n 服务并复制 Load balancer URLs 值。使用此值加上 n8n 服务端口 (5678) 后缀用于 DNS。
提示
Use HTTP 使用HTTP
本指南对其定义的服务使用 HTTP 连接,例如在 n8n-deployment.yaml 中。但是,如果您单击 Load balancer URLs 负载均衡器 URL 值,EKS 会将您带到“HTTPS”URL,从而导致错误。要解决此问题,当您打开 n8n 子域时,请确保使用 HTTP。
删除资源
如果您需要删除设置,可以使用以下命令删除清单创建的资源:
kubectl delete -f .
后续步骤
- 了解更多关于 n8n 配置和扩展的信息。
- 或继续探索如何使用 n8n:试试 Quickstarts 快速入门。
相关资源
- 使用 Terraform 部署到 AWS
- 使用云提供商
- 部署到 DigitalOcean
- 部署到 Heroku
- 部署到 Hetzner
- 部署到 Azure
- 部署到 Google Cloud Run
- 部署到 Google Kubernetes
- 部署到 OpenShift Local (CRC)
- 使用 Docker Compose