N8N v2 搭配工作进程与任务运行器 (create by SEAFOODHOLDHAND)

N8N v2 是一个强大的工作流程自动化平台，可以帮助你连接不同的服务并自动化任务。此模板包含：

• N8N v2 主实例用于工作流程管理（最新版本）
• N8N 工作进程用于处理后台任务
• 外部任务运行器用于安全执行 Code 节点（生产环境就绪设置）
• PostgreSQL 数据库用于数据存储
• Redis 用于队列管理

为什么使用外部任务运行器？

此模板使用外部任务运行器 - N8N 推荐的生产环境设置，用于在 Code 节点中执行代码：

• 🔒 增强安全性：代码在隔离容器中运行，与主 N8N 实例分开
• ⚡ 更佳性能：任务运行器可以根据工作负载独立扩展
• 🛡️ 沙盒执行：JavaScript 和 Python 代码在受控环境中执行
• 🔄 自动关闭：闲置的运行器会在 15 秒后自动关闭以节省资源
• 📊 生产就绪：遵循 N8N 生产部署的最佳实践

使用 N8N v2，你可以：

• 使用可视化编辑器创建自动化工作流程
• 连接数百种服务和 API
• 在 Code 节点中安全地执行自定义 JavaScript 和 Python 代码
• 使用可靠的后台工作进程处理数据并自动化任务
• 高效处理 Webhook 触发的工作流程

工作进程 + 任务运行器设置确保您的自动化任务得到可靠且安全的处理。

更新日志

2026-03-24

• 修复 Code 节点超时问题：任务运行器的 Broker URI 使用了硬编码的服务名称（http://N8N:5679、http://Worker:5679），在 Zeabur 内部网络中无法解析。改为使用 ${CONTAINER_HOSTNAME} 通过公开变量（N8N_BROKER_HOST、WORKER_BROKER_HOST），与 PostgreSQL 和 Redis 连接模式一致
• 为 N8N 和 Worker 服务新增 QUEUE_HEALTH_CHECK_ACTIVE=true（来自官方 docker-compose）

2026-03-23

• 修正服务依赖项位置，符合 Zeabur 模板规范（从 spec 内部移至服务层级）
• 移除已弃用的 N8N_RUNNERS_ENABLED 环境变量
• 修正任务运行器架构：将单一 Runners 拆分为 N8N-Runners 和 Worker-Runners，符合官方 n8n docker-compose 架构

2025-12-28

• 模板已更新以支持 N8N v2
• 升级到外部任务运行器（N8N_RUNNERS_MODE=external）
• 添加 TASK_RUNNERS_AUTH_TOKEN 用于安全的代理-运行器认证
• 添加 OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS=true 以兼容未来版本

2025-03-17

• 修复 n8n 主实例和工作进程之间的 N8N_ENCRYPTION_KEY 不匹配问题
• 添加手动设置 N8N_ENCRYPTION_KEY 的能力

了解更多关于任务执行器：https://docs.n8n.io/hosting/configuration/task-runners/

如在 Deploy 时遇到任何问题，可以到 Github issue 告诉我： https://github.com/glasschan/seafoodholdhand-zeabur-templates