n8n 中文文档

使用 Terraform 部署到 AWS

terraform-aws-n8n 是一个 Terraform 模块,用于在 AWS 上部署生产级、多 main 的 n8n 实例。它会置备一个运行 n8n Helm chart 的 Amazon EKS 集群,并配备托管 PostgreSQL(RDS)、Redis(ElastiCache),以及用于共享文件存储的 S3。

这与 n8n 在其他文档中介绍的手动 Kubernetes 部署不同:那份指南带您用手写清单部署单个 n8n 实例。本模块自动完成高可用、自动扩缩的部署,并由 n8n Solutions 团队独立维护。

警告

预发布模块

terraform-aws-n8n 处于预发布阶段。在模块达到第一个稳定版(1.0)之前,预计会出现重大变更。

提示

功能可用性

本模块默认部署的多 main 拓扑适用于:

  • Self-hosted: Enterprise

把 n8n_main_hpa_min_replicas 设为 1 时,模块改为运行单个 main Pod,此时只需要 Business 计划许可证。在该模式下,main Pod 的自动扩缩上限会被强制设为 1,升级使用 Recreate 策略。升级和维护期间,编辑器、REST API 和定时触发器会出现停机。

架构

用户和入站 webhook 到达位于 EKS 集群前面的 Application Load Balancer。集群内,n8n Helm chart 运行三个独立的 Deployment:

  • Main Pod: 处理领导者选举、编辑器 UI 和 REST API。
  • Webhook 处理器 Pod: 处理入站触发器。
  • Worker Pod: 运行工作流执行,并使用 KEDA 根据 Redis 队列深度进行扩缩。

状态保存在集群外的托管服务中:RDS PostgreSQL 保存工作流数据,ElastiCache Redis 用于领导者选举和 worker 队列,S3 保存二进制数据。AWS Certificate Manager(ACM)为负载均衡器签发 TLS 证书。

AWS 通过 EKS Pod Identity 向 Pod 授予权限(用于 Load Balancer Controller、Cluster Autoscaler、EBS CSI driver,以及 n8n 自身的 S3 访问)。

先决条件

  • n8n 许可证密钥:默认多 main 拓扑需要 Enterprise 许可证;如果设置 n8n_main_hpa_min_replicas = 1,则使用 Business 许可证。
  • 预先存在的 VPC,其中公有子网和私有子网已为 EKS 和 ALB 打上标签。本模块不会创建 VPC。请参阅自定义 AWS 基础设施。
  • Terraform CLI 1.11 或更高版本,并已配置 aws、kubernetes 和 helm provider。
  • 一种 DNS 方案:要么提供 Route 53 托管区(route53_zone_id),让模块自行签发 ACM 证书并管理 DNS 记录;要么提供来自其他提供商、已经验证的证书(certificate_arn)。

用法

如需从空文件夹到运行中实例的分步演练,请参阅在 AWS 上部署您的第一个 n8n 实例。下面是最少的一组输入:

module "n8n" {
  source  = "n8n-io/n8n/aws"
  version = "~> 0.5.0"

  aws_region      = "us-east-1"
  cluster_name    = "n8n-cluster"
  n8n_domain      = "n8n.example.com"
  n8n_license_key = var.n8n_license_key

  # 使用您自己的 VPC。
  vpc_id          = module.vpc.vpc_id
  private_subnets = module.vpc.private_subnets
  public_subnets  = module.vpc.public_subnets
  vpc_cidr_block  = module.vpc.vpc_cidr_block

  # EKS 节点组自动扩缩的上下限。您始终要为 node_min 个节点付费。
  node_min = 3
  node_max = 6

  # DNS 和 TLS 只能设置其中一项。
  route53_zone_id = "Z0123456789ABCDEFGHIJ"
  # certificate_arn = aws_acm_certificate_validation.n8n.certificate_arn
}

请通过密钥管理器传入 n8n_license_key 等敏感值,并将 Terraform state 存放在加密且受访问控制的 backend 中,因为模块会把该密钥写入 Helm release。切勿把密钥硬编码进会提交到版本控制的 .tfvars 文件。

选择起始规模

模块附带三种规模示例。先选一种作为起点,再据此调整节点类型、数量和数据库规模。

small(默认) medium large
目标规模 开发或小型团队 约 500 万–1500 万次执行/天 约 5000 万–6000 万以上次执行/天
节点类型 t3.xlarge m6i.2xlarge m7i.4xlarge
节点数(最小/最大) 3/6 5/15 10/50
数据库 RDS db.t3.small RDS db.m6g.2xlarge Aurora PostgreSQL I/O-Optimized
Redis cache.t3.medium cache.r6g.large cache.r6g.large
估算月费用(按需) 约 $440 约 $2,000 约 $21,000+

另外还有两种拓扑变体示例:split-ingress(请参阅自定义 AWS 基础设施)和 worker-pools。后者是一项 alpha 阶段的 n8n 功能,用于运行彼此分开且带有标签的 worker 池。

支持

本模块是开源的,由 n8n Solutions 团队维护,独立于 n8n 的 Enterprise 支持服务。请在 GitHub issues 上报告缺陷或请求功能;维护者会尽力分拣,不提供 SLA。与模块无关的一般 n8n 问题,请使用 n8n 社区论坛。

本节内容

相关资源

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