使用 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和helmprovider。 - 一种 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 社区论坛。
本节内容
- 在 AWS 上部署您的第一个 n8n 实例:从空文件夹到运行中实例的分步演练。
- 在 AWS 上扩展并以高可用运行:配置多 main、worker 自动扩缩和 Redis 高可用。
- 在 AWS 上配置 Enterprise 功能:接入 S3 执行数据、Prometheus 指标、OpenTelemetry 跟踪、日志流式传输和外部密钥。
- 自定义 AWS 基础设施:使用您自己的 VPC、数据库、缓存或集群,拆分 ingress,或使用自定义 n8n 镜像。
- 维护并拆除 AWS 部署:管理加密密钥、验证数据库 TLS,并配置删除保护。
相关资源
- 使用云提供商
- 部署到 AWS
- DigitalOcean
- Heroku
- Hetzner Cloud
- Azure
- Google Cloud Run
- Google Kubernetes Engine
- OpenShift Local (CRC)
- 使用 Docker Compose
- 启用队列模式