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 觸發的工作流程

工作程序 + 任務執行器設置確保您的自動化任務得到可靠且安全的處理。

更新日誌

2025-12-28

• 重要：模板已更新以支援 N8N v2
• 升級至外部任務執行器（生產環境推薦設置）
• 添加了獨立的 task-runners 服務作為 n8n-worker 的 sidecar 容器
• 配置了 N8N_RUNNERS_MODE=external 以提供更好的安全性和性能
• 任務執行器現在在隔離容器中執行 Code 節點的 JavaScript/Python 代碼
• 添加了 TASK_RUNNERS_AUTH_TOKEN 變數用於安全的中介-執行器認證

此更新確保您的 N8N v2 工作流程使用外部任務執行器安全運行，遵循 N8N 生產部署的最佳實踐。

2025-03-17

• 修復了 n8n 主實例和工作程序之間的 N8N_ENCRYPTION_KEY 不匹配問題
• 確保工作程序使用與主實例相同的加密密鑰，提高系統穩定性
• 添加了手動設置 N8N_ENCRYPTION_KEY 的能力，以確保主實例和工作程序的加密密鑰同步

⚠️ 重要：如果您正在使用此模板的舊版本，請更新到此版本以避免可能的加密密鑰同步問題。

注意：此模板啟用了關鍵的環境變數以防止未來的相容性問題：

• N8N_RUNNERS_ENABLED=true：啟用任務執行器以安全執行 Code 節點代碼。Code 節點中的 JavaScript 和 Python 代碼執行需要任務執行器。

• N8N_RUNNERS_MODE=external：使用外部任務執行器容器（生產環境推薦）而非內部子進程。

• OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS=true：在擴展模式下於主實例執行手動工作流程的方式已被棄用。未來版本中，手動執行將轉由工作程序處理。此設定為此變更做好準備。

了解更多關於任務執行器的信息：https://docs.n8n.io/hosting/configuration/task-runners/

如在 Deploy 時遇到任何問題，可以到 Github issue 告訴我，我會盡力解決： https://github.com/glasschan/seafoodholdhand-zeabur-templates