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