n8n 中文文档

在 Google Kubernetes Engine 上托管 n8n

Google Cloud 提供了几种适合托管 n8n 的选项,包括 Cloud Run(优化用于运行容器)、Compute Engine(虚拟机)和 Kubernetes Engine(使用 Kubernetes 运行容器)。

本指南使用 Google Kubernetes Engine (GKE) 作为托管选项。如果您想使用 Cloud Run,请参阅这些说明。

本指南中的大多数步骤使用 Google Cloud UI,但你也可以使用 gcloud 命令行工具来完成所有步骤。

先决条件

提示

Self-hosting knowledge prerequisites 自托管知识先决条件

自托管 n8n 需要技术知识,包括:

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

n8n 建议专家用户使用自托管。错误可能会导致数据丢失、安全问题和停机。如果您没有管理服务器的经验,n8n 推荐 n8n Cloud。

提示

稳定版和测试版

n8n 每周都会发布新的次要版本。 stable 版本用于生产用途。 beta 是最新版本。 beta版本可能不稳定。要报告问题,请使用 论坛。

当前 stable:2.47.7 当前 beta:2.48.4

创建项目

GCP 鼓励您创建项目来逻辑地组织资源和配置。从您的 Google Cloud 控制台为您的 n8n 部署创建一个新项目:选择项目下拉菜单,然后选择 NEW PROJECT 按钮。然后选择新创建的项目。在您按照本指南中的其他步骤时,请确保您选择了正确的项目。

启用 Kubernetes Engine API

GKE 默认情况下未启用。在顶部搜索栏中搜索 "Kubernetes",并从结果中选择 "Kubernetes Engine"。

选择 ENABLE 为此项目启用 Kubernetes Engine API。

创建集群

从 GKE 服务页面{:target=_blank .external-link},选择 Clusters > CREATE。确保您选择 "Standard" 集群选项,n8n 不适用于 "Autopilot" 集群。除非有您需要特别更改的内容(如位置),否则您可以将集群配置保留为默认值。

设置 Kubectl 上下文

本指南中的其余步骤要求您将 GCP 实例设置为 Kubectl 上下文。您可以通过打开集群实例的详细信息页面并选择 CONNECT 来找到集群实例的连接详细信息。显示的代码片段显示了 gcloud CLI 工具的连接字符串。在 gcloud CLI 中粘贴并运行代码片段,以更改您的本地 Kubernetes 设置以使用新的 gcloud 集群。

克隆配置存储库

Kubernetes 和 n8n 需要一系列配置文件。您可以在本地从此存储库克隆这些文件。以下步骤解释了文件配置以及如何添加您的信息。

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

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

并更改目录:

cd n8n-hosting/kubernetes

配置 Postgres

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

创建持久存储卷

为了在 pod 重启之间维护数据,Postgres 部署需要一个持久卷。在 GCP 上运行 Postgres 需要特定的 Kubernetes 存储类。您可以阅读此指南{:target="_blank" .external-link}了解具体信息,但 storage.yaml 清单为您创建了它。您可能希望在 allowedTopologies > matchedLabelExpressions > values 键下更改要在其中创建存储的区域。默认情况下,它们设置为 us-central。

…
allowedTopologies:
  - matchLabelExpressions:
      - key: failure-domain.beta.kubernetes.io/zone
        values:
          - us-central1-b
          - us-central1-c

Postgres环境变量

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

示例 postgres-secret.yaml 文件包含占位符,您需要将其替换为您自己的值。Postgres 将在创建数据库时使用这些详细信息。

然后 postgres-deployment.yaml 清单使用此清单文件中的值发送到应用程序 pod。

配置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 和 postgres-deployment.yaml 文件的 resources 部分包含以下内容:

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

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

版本 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
  • 定义要使用的容器镜像
  • 使用 resources 对象设置资源消耗限制
  • 前面定义的 volumes 和 volumeMounts 定义容器中挂载卷的路径。
  • 扩展和重启策略。示例清单定义每个 pod 的一个实例。您应该更改此设置以满足您的需求。

服务

两个服务清单(postgres-service.yaml 和 n8n-service.yaml)使用 Kubernetes 负载均衡器分别在端口 5432 和 5678 上向外部世界公开服务。

发送到 Kubernetes 集群

使用以下命令将所有清单发送到集群:

kubectl apply -f .

提示

Namespace error 命名空间错误

您可能会看到一条有关找不到“n8n”命名空间的错误消息,因为该资源尚未准备好。您可以再次运行相同的命令,或者首先使用以下命令应用命名空间清单:

kubectl apply -f namespace.yaml

设置 DNS

n8n 通常在子域上运行。与您的子域提供商一起创建 DNS 记录,并将其指向 n8n 服务的 IP 地址。从 Endpoints 端点 列下要使用的集群的 Services & Ingress 服务与入口 菜单项中找到 n8n 服务的 IP 地址。

提示

GKE and IP addresses GKE 和 IP 地址

阅读此 GKE 教程,详细了解预留 IP 地址如何与 GKE 和 Kubernetes 资源配合使用。

删除资源

使用以下命令删除清单创建的资源:

kubectl delete -f .

后续步骤

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。