n8n 中文文档

在 Azure 上托管 n8n

本托管指南向您展示如何在 Azure 上自托管 n8n。它使用 n8n 和 Postgres 作为数据库后端,使用 Kubernetes 管理必要的资源和反向代理。

先决条件

您需要 Azure 命令行工具{: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

托管选项

Azure 提供了几种适合托管 n8n 的方式,包括 Azure 容器实例(针对运行容器进行了优化)、Linux 虚拟机和 Azure Kubernetes 服务(使用 Kubernetes 运行的容器)。

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

本指南中的步骤混合使用 Azure UI 和命令行工具,但您可以使用其中任何一种来完成大多数任务。

打开 Azure Kubernetes 服务

从 Azure 门户{:target="_blank" .external-link}选择 Kubernetes services。

创建集群

从 Kubernetes 服务页面,选择 Create > Create a Kubernetes cluster。

您可以选择任何适合您需求的配置选项,完成后选择 Create。

设置 Kubectl 上下文

本指南中的其余步骤要求您将 Azure 实例设置为 Kubectl 上下文。您可以通过打开集群实例的详细信息页面,然后点击 Connect 按钮来找到集群实例的连接详细信息。生成的代码片段显示了要粘贴并运行到终端中的步骤,以更改您的本地 Kubernetes 设置以使用新集群。

克隆配置存储库

Kubernetes 和 n8n 需要一系列配置文件。您可以从此存储库克隆这些文件。以下步骤告诉您哪个文件配置什么以及您需要更改什么。

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

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

并更改目录:

cd n8n-hosting/kubernetes

配置 Postgres

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

配置持久存储卷

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

提示

Specialized storage classes 专门的存储类别

如果您对存储类有特殊或更高的要求,请阅读文档中有关 Azure 提供的选项的更多信息。

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 允许您{:target="_blank" .external-link}可选地指定应用程序容器需要的最小资源和它们可以运行到的限制。上面克隆的示例 YAML 文件在 n8n-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 地址。从 External IP 外部IP 列下要使用的集群的 Services & ingresses 服务和入口 菜单项中找到 n8n 服务的 IP 地址。您需要将 n8n 端口“5678”添加到 URL。

提示

Static IP addresses with AKS 使用 AKS 的静态 IP 地址

阅读本教程,了解有关如何将静态 IP 地址与 AKS 结合使用的更多详细信息。

删除资源

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

kubectl delete -f .

后续步骤

相关资源

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