如何自行架設 n8n 並在本機執行 CometAPI 節點

AI 發展迅速：新的多模態模型與更強的即時 API 讓在自動化平台中嵌入強大的 AI 變得更容易；同時，圍繞安全性與可觀測性的討論也在重新塑造團隊如何運行生產系統。對於打造本地自動化的人而言，一個實用範式正浮現：使用統一的模型閘道（如 CometAPI）來存取多種模型，並將這些模型呼叫串接進自行託管的自動化執行器（如 n8n），以便保有對資料、延遲與成本的掌控。本指南將一步步示範如何開始使用 CometAPI + n8n（本地），需要留意的事項，以及當情況不如預期時如何疑難排解。

什麼是 n8n？為何對 AI 自動化重要？

n8n 是一套開源的工作流程自動化工具，具備視覺化編輯器與龐大的節點（連接器）生態系。它旨在讓你把觸發器、轉換與外部 API 呼叫串成可重複的工作流程（webhooks、排程作業、檔案處理、聊天機器人等）。在本地自行託管 n8n 能讓你完全掌控資料駐留與執行，這在呼叫會處理敏感輸入的第三方 AI 模型時格外重要。

n8n 在實務上如何運作？

• 視覺畫布包含觸發器（Webhook、Cron）與動作節點（HTTP Request、資料庫節點、電子郵件）。
• 社群節點可擴充能力——你可以安裝社群套件並將其視為原生節點使用。

本地自行託管 n8n 可帶來：

• 完整資料掌控——工作流程與執行資料都留在你管理的基礎設施內。
• 客製化——新增私有節點或本地整合，無須等待雲端版功能上線。
• 成本可預期——對於內部密集自動化，不會有按次計費的雲端驚喜。
• 安全與合規——更容易符合內部政策與監管要求。

---

什麼是 CometAPI？為何要把它當作你的模型閘道？

CometAPI 是一個統一的 API 閘道，透過單一、與 OpenAI 相容的介面與計費模型，匯聚數百種第三方 AI 模型（文字、embeddings、影像生成等）。這表示你無需為每個想嘗試的 LLM 或影像引擎各自新增整合，只要呼叫同一個 API，並在請求中選擇想要的模型即可。這簡化了試驗、成本控管與營運整合。

優點：

• 模型選擇： 以相同的程式路徑嘗試多家供應商/多種模型。
• Token 池/免費額度： 許多統一閘道提供額度/層級可供試用。
• 基礎設施更簡單： 僅需管理一組驗證系統與一個 base URL。

如何取得 CometAPI 存取權與金鑰？

1. 在 CometAPI 網站（或供應商儀表板）註冊。多數閘道提供免費層級以供測試。
2. 從 CometAPI 儀表板取得 API 金鑰——一段長的祕密字串。請留意文件指示如何放置（CometAPI 使用 Bearer 授權，指向 https://api.cometapi.com/v1).
3. 閱讀 API 文件，確認你要用的端點（chat completions、images、embeddings）。CometAPI 的端點如 /v1/chat/completions 與 /v1/images/generations。

---

為什麼 n8n 與 CometAPI 的綁定（整合）很重要？

此處的「綁定」指你的自動化執行器（n8n）與模型閘道之間穩定、安全的整合路徑。妥善的綁定很重要，因為：

• 能維持跨呼叫的脈絡（對話歷史、embeddings）。
• 將憑證與祕密集中管理，便於安全輪替。
• 使用可預測的端點與標準請求格式，降低延遲與錯誤面。
• 提升可觀測性與疑難排解能力——清楚知道哪個模型、提示與回應導致了某結果。

總之：良好的綁定能降低營運風險並加速迭代。

我如何在本地部署 n8n（快速實用指南）？

你可以用 npm 或 Docker 來在本地執行 n8n；對多數自託管情境而言，推薦使用 Docker Compose（可重現且隔離相依性）。以下提供最小可行的 Docker Compose 範例與重點說明。

如何用 Docker 自行託管 n8n？

Docker（與 Docker Compose）是在生產環境中執行 n8n 最穩健、可重現的方式。它能隔離應用、簡化升級，並能與反向代理與編排器（Docker Swarm、Kubernetes）良好搭配。n8n 官方文件提供 Docker Compose 參考，以下沿用並調整。

在生產環境，你通常會執行以下組合：

• n8n 服務（官方鏡像：docker.n8n.io/n8nio/n8n 或依標籤使用 n8nio/n8n）。
• PostgreSQL（或其他支援的資料庫）。
• Redis（若你打算使用佇列模式）。
• 反向代理（Traefik、Caddy 或 nginx）負責 TLS、主機路由與頻率限制規則。

此架構能清楚分離關注點（資料庫持久化、佇列、網頁代理），也讓擴充與備份更直覺。官方文件提供 Docker Compose 模式與環境變數說明。

這是逐步指南：

1. 建立資料夾與 docker-compose.yml，放入標準的 n8n 服務。以下是一個實用的 docker-compose 範例，涵蓋常見的生產需求：外部 Postgres、Redis（佇列/執行模式）、持久化 volumes，以及由 Nginx 處理 TLS 的反向代理：

```yaml
version: "3.8"
services:
  n8n:
    image: n8nio/n8n:latest
    restart: unless-stopped
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=supersecretpassword
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=anothersecret
      - WEBHOOK_TUNNEL_URL=https://n8n.example.com
      - EXECUTIONS_MODE=queue
      - QUEUE_BULL_REDIS_HOST=redis
    ports:
      - "5678:5678"
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - postgres
      - redis

  postgres:
    image: postgres:15
    environment:
      POSTGRES_DB: n8n
      POSTGRES_USER: n8n
      POSTGRES_PASSWORD: supersecretpassword
    volumes:
      - pgdata:/var/lib/postgresql/data

  redis:
    image: redis:7
    volumes:
      - redisdata:/data

volumes:
  n8n_data:
  pgdata:
  redisdata:
```

1. 啟動：

docker compose up -d

1. 造訪 http://localhost:5678 並建立你的管理者帳號。生產環境請搭配 Postgres、SSL 與正確的環境變數——詳見官方 Docker Compose 文件。

注意與強化：

• 生產環境請勿在 docker-compose.yml 以明文儲存祕密；改用環境檔、Docker secrets，或外部祕密管理工具。
• 將 WEBHOOK_URL 替換為你的對外 URL，並設定反向代理將 n8n.example.com 轉送到 n8n 容器。
• 使用 EXECUTIONS_MODE=queue 以獲得更穩健的背景處理；此模式需要佇列工作者與 Redis。

如何用 npm / Node.js 自行託管 n8n？

透過 npm（或 pnpm）安裝會直接在主機上執行 n8n。這較為輕量（無容器層），對單一使用者、低複雜度的安裝或開發機器很實用。不過，系統相依、隔離與服務監管需由管理者自行負責。官方文件提供 npm 安裝指南與注意事項。

必要的作業系統套件與 Node 版本：

• 使用穩定 LTS 的 Node.js（Node 18 或 Node 20+，請符合 n8n 版本需求）。
• 安裝 build-essential、git，以及一個行程管理器（建議使用 systemd）。
• 生產環境仍建議使用外部 PostgreSQL 與 Redis（理由同 Docker）。

如何透過 npm 安裝並執行 n8n（步驟）？

1.Install Node.js（建議使用 nvm）

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Reload your shell (adjust to your shell startup file if needed)
source ~/.bashrc  # or ~/.zshrc

# Install and use the latest LTS (usually 18 or 20)
nvm install --lts
nvm use --lts

# Verify
node -v
npm -v

若之後出現 “n8n: command not found”，請重開終端機或確認 nvm 管理的 npm 全域 bin 路徑已加入 PATH。

---

2. 安裝與啟動 n8n（本機）

npm install -g n8n
n8n -v  # verify version

3. 前景啟動：

n8n start

預設網址：http://localhost:5678/ 若連接埠已被占用：

export N8N_PORT=5679
n8n start

選用：在背景持續執行（仍是本機）

npm install -g pm2
pm2 start "n8n" --name n8n
pm2 save
pm2 status

4 .第一次存取與登入：

• 在瀏覽器開啟 http://localhost:5678/
• 第一次啟動時，依精靈建立 Owner 帳號（email + 密碼）並登入。

如何在 n8n 安裝或設定 CometAPI 社群節點？

n8n 同時支援已驗證的社群節點（GUI 安裝）與在自託管環境中從 npm 手動安裝。你有兩種方式整合 CometAPI 至 n8n：

方案 A — 使用 CometAPI 社群節點（若在節點面板可見）

1. 在 n8n 開啟節點面板（按 + 或 Tab）。
2. CometAPI 是已驗證的社群節點，會出現在 “More from the community” 下。點擊安裝。
3. 安裝後如提示請重新啟動 n8n。到 Settings → Credentials 建立新的 Credential（若節點提供對應類型）並貼上你的 CometAPI token。

方案 B — 手動安裝（當 GUI 安裝不可用時）

1.SSH 到你的 n8n 主機/容器。

2. 在全域 n8n node_modules 或你的自訂資料夾安裝套件：

• 前往 Settings（左下）> Community nodesClick “
• Install a community node”
• 在 “npm Package Name” 輸入：@cometapi-dev/n8n-nodes-cometapiCheck the risk acknowledgment boxClick “
• Install”After installation, you can search for “CometAPI” in the node panel.

3. 重新啟動 n8n。若你的執行個體在 queue 模式，請依文件中的手動安裝流程操作。

如何確認節點已安裝

• 重新啟動後，開啟節點面板並搜尋 “CometAPI” 或 “Comet”。該節點會標示為社群套件。
• 若找不到節點：確認你使用的是執行個體 Owner 帳號（只有 Owner 可安裝），或檢查容器/映像檔日誌中是否有套件解析錯誤。

如何建立工作流程並設定 API

1. 建立新工作流程

• 登入你的 n8n（自託管）執行個體。
• 點選 "Add Workflow" 開始新的自動化畫布。

2.Add Node

• 新增觸發節點：搜尋 “Manual Trigger” 或 “When clicking ‘Execute workflow’”。
• 點選畫布右側的 “+”，搜尋 “CometAPI” 並加入節點。
• 你也可以從左側節點清單搜尋 “CometAPI” 並拖曳到畫布。

3.首次設定憑證：

• 在 CometAPI 節點的 “Credential to connect with” 中選擇 “Create new”。
• 將你在 CometAPI 主控台建立的 token 貼入 “CometAPI Key”。
• 儲存。Base URL 預設為 https://api.cometapi.com，通常不需更改。

4. 設定模型與訊息：

Model：輸入支援的模型，例如 gpt-4o 或 gpt-4o-mini。

Messages：你需要填寫角色與脈絡，Role 可選 user 或 system。

選用參數（視需要）：Maximum Number of Tokens（例如 4096）；Sampling Temperature（例如 0.7）；PenaltyStream（啟用/停用串流）。各參數的具體文件與說明，請參見 CometAPI 文件。

5. 文字執行：

選取 CometAPI 節點並點擊 “Execute step”，或點擊底部的 “Execute workflow”。
右側 OUTPUT 面板應顯示 JSON 回應（含 choices、usage 等）。

至此，你已在 Linux 上透過 npm 本地安裝 n8n（Recommend）、完成 CometAPI 社群節點的安裝與設定，並可執行呼叫如 gpt-4o 等模型且取得回應的工作流程。

常見問題與疑難排解

1) “401 Unauthorized” 或 “Invalid API key”

• 到 CometAPI 儀表板再次確認正確的 token 字串（可能有名稱相近的 token）。複製→貼到 n8n 憑證，必要時重啟節點。
• 確認 Authorization 標頭格式為 Bearer sk-xxxxx。

2) 無法安裝社群節點 / “queue mode”

• 若你的 n8n 在 queue 模式，GUI 安裝可能被停用；請依手動安裝文件透過 npm 安裝社群節點，或建立包含該節點的客製映像檔。安裝後重新啟動 n8n。

3) 安裝後在面板找不到節點

• 重新啟動 n8n。
• 確認你把套件安裝在正確位置（容器映像內或使用 .n8n/custom 路徑的做法）。
• 檢查容器日誌中是否出現模組解析錯誤。

4) 速率限制或額度問題

• 到 CometAPI 儀表板查看使用量與額度。
• 實作指數退避，並在偵測到限制警示或 HTTP 429 時回退至較便宜的模型。

若社群節點不可用或你想要更多彈性，有替代方案嗎？

有——你可以直接使用 HTTP Request 節點（完全掌控），或使用 OpenAI 節點搭配 base URL 轉向（務實捷徑）。使用原生 HTTP 也便於採用 CometAPI 新推出的端點（例如影像/影音端點）。請參考 Guide。

延伸閱讀 How to Use n8n with CometAPI

結論：

CometAPI 提供模型選擇與營運簡化；n8n 提供可視化編排與可擴充性。若要快速整合聊天/補全，可使用 OpenAI 憑證轉向的小技巧；在有可用且信任的情況下使用社群節點。為每個工作流程加入成本、延遲與安全的監測；對重要決策偏好人工覆核；讓你的模型選擇保持動態，以因應 AI 供應商生態的快速變化。n8n 與 CometAPI 的組合很強大，但如同所有強大的工具，它需要防護欄——觀測、測試並持續迭代。