在 Amazon Web Services 上托管 n8n#

本托管指南向您展示如何使用 Amazon Web Services (AWS) 自托管 n8n。它使用 n8n 和 Postgres 作为数据库后端，使用 Kubernetes 管理必要的资源和反向代理。

托管选项#

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

本指南使用 EKS 作为托管选项。使用 Kubernetes 需要一些额外的复杂性和配置，但这是随着需求变化扩展 n8n 的最佳方法。

先决条件#

本指南中的步骤混合使用 AWS UI 和 eksctl CLI 工具用于 EKS。

虽然在 eksctl 的文档中没有提到，但您还需要安装 AWS CLI 工具，并配置工具的身份验证。

自托管知识先决条件

自托管 n8n 需要技术知识，包括：

设置和配置服务器和容器
管理应用程序资源和扩展
保护服务器和应用程序
配置 n8n

n8n 建议专业用户进行自托管。错误可能导致数据丢失、安全问题和停机。如果您在管理服务器方面缺乏经验，n8n 建议使用 n8n Cloud。

Latest 和 Next 版本

n8n 每周发布一个新的次要版本。latest 版本用于生产环境。next 是最新的发布版本。您应该将 next 视为测试版：它可能不稳定。要报告问题，请使用论坛。

当前 latest：1.97.1
当前 next：1.98.1

创建集群#

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

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

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

集群创建完成后，eksctl 会自动将 kubectl 上下文设置为该集群。

克隆配置存储库#

Kubernetes 和 n8n 需要一系列配置文件。您可以从此存储库克隆这些文件。以下步骤告诉您每个文件的作用，以及您需要更改的设置。

使用以下命令克隆存储库：

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

并切换到您克隆的存储库的根目录：

1	`cd n8n-kubernetes-hosting`

配置 Postgres#

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

为持久存储配置卷#

为了在 pod 重启之间维护数据，Postgres 部署需要一个持久卷。默认的 AWS 存储类 gp2 适合此目的。这在 postgres-claaim0-persistentvolumeclaim.yaml 清单中定义。

…
spec:
  storageClassName: gp2
  accessModes:
    - ReadWriteOnce
…

Postgres 环境变量#

Postgres 需要设置一些环境变量传递给在容器中运行的应用程序。

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

然后 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 允许您指定应用程序容器需要的最小资源和它们可以运行到的限制。上面克隆的示例 YAML 文件在 n8n-deployment.yaml 文件的 resources 部分包含以下内容：

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

这定义了每个容器最少 250mb，最多 500mb，并让 Kubernetes 处理 CPU。您可以更改这些值以匹配您自己的需求。作为指导，以下是 n8n 云产品的资源值：

入门版: 320mb RAM，10 毫核 CPU 可突发
专业版 (10k 执行): 640mb RAM，20 毫核 CPU 可突发
专业版 (50k 执行): 1280mb RAM，80 毫核 CPU 可突发

可选：环境变量#

您可以使用环境变量配置 n8n 设置和行为。

创建一个 n8n-secret.yaml 文件。有关 n8n 环境变量详细信息，请参考环境变量。

部署#

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

清单定义以下内容：

将定义的环境变量发送到每个应用程序 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 值。使用此值加上 n8n 服务端口 (5678) 后缀用于 DNS。

使用 HTTP

本指南为其定义的服务使用 HTTP 连接，例如在 n8n-deployment.yaml 中。但是，如果您点击 Load balancer URLs 值，EKS 会将您带到一个 "HTTPS" URL，这会导致错误。要解决此问题，当您打开 n8n 子域时，请确保使用 HTTP。

删除资源#

如果您需要删除设置，可以使用以下命令删除清单创建的资源：

kubectl delete -f .

后续步骤#

了解更多关于配置和扩展 n8n 的信息。
或探索使用 n8n：尝试快速入门。