企業級 n8n 架構總覽

部署拓撲、憑證治理、資料管線與 AI Agent 編排

從主機環境到自主 AI 代理的四層落地路徑

部署拓撲：三種模式各有取捨

依成本、控制權、資料隱私與維運負擔選擇，需 24/7 觸發就要上雲端主機。

	官方 n8n Cloud	本機 Docker	自架雲端 VPS
成本	14 天試用；正式版 €20／月起	免費（自有設備）	約 $4.99／月起
控制權	SaaS 託管、多租戶	本機最高權限	完整 VPS 與容器 root
隱私與治理	受供應商區域限制	資料留在本機，隱私最高	選定區域內的專屬實例
維運與可用性	零維運，供應商持續維護	主機關機即停擺	全天候運行，不受本機影響

本機 Docker 適合開發沙盒；需要時間觸發、Webhook 與 SaaS 整合時，改用雲端 VPS 或 Cloud。

落地部署：Docker 三步驟與 VPS 啟用

容器隔離執行環境，並把工作流狀態與容器層分離，更新映像檔也不會遺失資料。

拉取映像檔docker pull n8nio/n8n

›

綁定參數命名容器、連接埠 5678:5678

›

掛載儲存本機目錄 → /home/node/.n8n

›

啟動完成localhost:5678

雲端 VPS

使用一鍵 n8n 範本（如 Hostinger）佈署
管理員密碼 12–50 字元；可開啟惡意程式掃描與快照備份
透過 Manage VPS → Manage App 進入實例

啟用企業功能

Settings 申請啟用金鑰（寄至管理員信箱）
Settings → Enter License Key 貼上並確認
解鎖執行歷史與營運監控

憑證治理：最小權限與祕密隔離

自架 n8n 對 Google 而言是未驗證的第三方應用，必須自建 OAuth 客戶端。

建立 GCP 專案啟用 Calendar 與 Gmail API

›

同意畫面類型選 External，必須加入測試使用者

›

OAuth 用戶端Web 應用程式，貼上 n8n 的 Redirect URI

›

授權綁定填入 Client ID／Secret；警告頁選「進階 → 繼續」

OpenAI 金鑰管理

預先儲值 $5–10，避免執行時被限流
依專案產生專用金鑰並命名（如 n8n-agent-prod）
金鑰存入憑證庫，靜態加密並遮罩

跨環境遷移

匯出 JSON 時，token 與 secret 會被刻意移除
匯入後節點出現黃色警告三角形
逐一開啟節點，重新綁定本環境的憑證

資料管線：精簡、聚合、再交給 LLM

先縮減 payload，再把多筆資料合併成一次執行，延遲與記憶體用量都會下降。

Edit Fields剔除多餘欄位，重新命名為「行程」「開始時間」

›

Aggregate多筆合併為單一陣列，只寄一封摘要信

›

OpenAISystem 定義角色與樣式，User 注入資料

›

GmailEmail Type 設為 HTML

開發安全

手動觸發節點使用 Set Mock Data
開啟 Lock Mock Data，測試不動到上游服務

輸出細節

日期用 Luxon 格式化
換行用 {{ $json.行程.join('\n\n') }}
Filter 分流、Merge 合併 RSS 與行事曆

觸發與可讀性

手動、Cron（如每日 07:30）、Webhook
節點用功能命名，便利貼以顏色分區

AI Agent：控制器、大腦與記憶

從寫死的分支改為由模型推理決定工具與參數。

控制器（Agent）

判斷意圖、協調推理、選擇工具並整理回覆。

大腦（Chat Model）

如 GPT-4.1 Mini 或 GPT-4o，負責意圖分類與參數擷取。

記憶（Simple Memory）

預設保留 5 輪對話。改用 Webhook 或 Telegram 觸發時，Session Key 必須手動寫死（如 memory）。

時間錨定：System Message 內加入 {{ $now }}，避免日期計算出錯；同時規定輸出語言（繁體中文）與會議預設時長（1 小時）。

工具	操作	交給 LLM 自行決定
Google Calendar	建立、刪除、取得、更新	開始與結束時間、事件 ID、標題
Gmail	寄送、回覆、草稿	主旨、內文、Thread ID（需設定 To Email）
Google Contacts	取得多筆	聯絡人搜尋字串（需啟用 Use Query）

多模態入口與語意路由

語音、聊天與信件都能進同一個 Agent，並由語意判斷而非關鍵字比對。

Siri 語音捷徑

聽寫文字 → URL 取得內容（POST）→ n8n Webhook → Agent → Respond to Webhook → 朗讀文字。回應需設 text/plain; charset=utf-8，並禁止 Markdown、網址與換行。

Telegram 機器人

以 BotFather 取得 token，接收訊息並綁定 Chat ID，再回傳文字。可在節點停用「附加 n8n 署名」。

Gmail 收信每分鐘輪詢

›

Text Classifier是否與會議有關

›

AI Agent掃描行事曆

›

行程空閒自動建立並通知

行程衝突Telegram 警示，依回覆改期

結論回覆信件可存為草稿供人工審閱，或直接送出，在自動化速度與治理之間取得平衡。