人工智慧發展日新月異：新的多模態模型和改進的即時 API 使得將強大的人工智慧嵌入自動化平台變得更加容易，與此同時，關於安全性和可觀察性的爭論正在重塑團隊運行生產系統的方式。對於建立本地自動化系統的人來說，實用的模式正在興起：使用統一的模型網關（例如 彗星API）來存取許多模型，並將這些模型呼叫拼接到自託管自動化運行器中（例如 n8n)，讓您掌控資料、延遲和成本。本指南將逐步向您展示如何開始使用 CometAPI + n8n（本地）、需要注意什麼、當事情出現問題時如何排除故障。
什麼是 n8n 以及它為何對 AI 自動化如此重要？
n8n 是一款開源工作流程自動化工具，擁有視覺化編輯器和龐大的節點（連接器）生態系統。它旨在幫助您將觸發器、轉換和外部 API 呼叫串聯到可重複的工作流程中（例如 Webhook、排程作業、檔案處理、聊天機器人等）。本機自架 n8n 讓您能夠完全控制資料的駐留與執行，這在呼叫處理敏感輸入的第三方 AI 模型時尤其重要。
n8n 在實務上如何運作？
- 帶有觸發器（Webhook、Cron）和動作節點（HTTP 請求、資料庫節點、電子郵件）的視覺化畫布。
- 社群節點擴充功能－您可以安裝社群套件並將其視為本機節點。
自架 n8n 為您提供：
- 完全數據控制 — 工作流程和運作資料保留在您管理的基礎架構上。
- 定製 — 無需等待雲端功能即可新增私有節點或本機整合。
- 成本可預測性 — 對於大量內部自動化，無需為每個任務支付意外的雲端費用。
- 安全性與合規性 — 更容易滿足內部政策和監管需求。
什麼是 CometAPI 以及為什麼使用它作為模型網關？
彗星API 是一個統一的 API 網關，它透過一個與 OpenAI 相容的介面和計費模型，將數百個第三方 AI 模型（文字、嵌入、圖像生成等）公開。這意味著您無需為每個想要嘗試的 LLM 或圖像引擎添加定制集成，只需調用一個 API 並在請求中選擇所需的模型即可。這簡化了實驗、成本控制和營運整合。
好處：
- 模型選擇： 嘗試使用相同程式碼路徑的多個供應商/模型。
- 代幣池/免費配額： 許多統一網關提供信用/等級以供實驗。
- 更簡單的內容： 一個身份驗證系統和一個基本 URL 需要管理。
如何獲得 CometAPI 存取權限和金鑰？
- 立即註冊 在 CometAPI 網站（或供應商儀表板）上。大多數網關都有免費套餐可供測試。
- 取得 API 金鑰 從你的 CometAPI 儀錶板取得－一個很長的秘密字串。注意文件中告訴你把它放在哪裡（CometAPI 使用 Bearer 授權來針對
https://api.cometapi.com/v1). - 閱讀 API 文件 適用於您計劃使用的端點（聊天完成、圖像、嵌入）。 CometAPI 文件中的端點如下
/v1/chat/completions/v1/images/generations.
為什麼 n8n 和 CometAPI 之間的結合（整合）很重要？
這裡的「綁定」是指自動化運行器 (n8n) 和模型閘道之間可靠、安全的整合路徑。正確的綁定至關重要，因為：
- 它保存 上下文 跨通話（對話歷史、嵌入）。
- 它集中 證書 並將秘密集中到一處以實現更安全的輪換。
- 它透過使用可預測的端點和標準請求格式來減少延遲和錯誤表面。
- 它使 可觀察性 和故障排除——了解哪種模型、提示和回應導致了結果。
簡而言之：良好的黏合可降低操作風險並加快迭代速度。
如何在本地部署 n8n（快速實用指南）？
您可以在本地運行 n8n npm 或使用 Docker；對於大多數自託管場景，建議使用 Docker Compose（它可複現且隔離依賴項）。以下是一個 Docker Compose 的簡單範例和一些重要說明。
如何使用 Docker 自託管 n8n？
Docker（以及 Docker Compose）是在生產環境中運行 n8n 最強大、可重複的方式。它隔離了應用程序，簡化了升級，並與反向代理和編排器（Docker Swarm、Kubernetes）完美匹配。 n8n 的官方文件包含 Docker Compose 參考，我將在此遵循並進行調整。
對於生產，您通常會運行由以下內容組成的堆疊：
- n8n 服務（官方圖片：
docker.n8n.io/n8nio/n8norn8nio/n8n取決於標籤）。 - PostgreSQL（或其他支援的資料庫）。
- Redis（如果您打算使用佇列模式）。
- 用於 TLS、主機路由和速率限制規則的反向代理（Traefik、Caddy 或 nginx）。
此架構清楚地分離了各個關注點（資料庫持久化、佇列、Web 代理程式），並使擴充功能和備份變得簡單易行。 n8n 官方文件提供了 Docker Compose 模式和環境變數參考。
這是逐步指南：
- 建立一個資料夾和一個
docker-compose.yml使用規範的 n8n 服務。以下是一個實用的 docker-compose 範例，涵蓋了典型的生產需求：外部 Postgres、Redis（用於佇列/執行模式）、持久磁碟區以及處理 TLS 的 Nginx 反向代理：
```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:
2. 開始：
docker compose up -d
3. 親臨 `http://localhost:5678` 並建立管理員使用者。對於生產環境，你需要 Postgres、SSL 和合適的環境變數——請參閱 Docker Compose 官方文件。
**注意事項和強化：**
- Do **不會** 以明文形式儲存機密 `docker-compose.yml`；在生產中使用環境文件、Docker 機密或外部機密管理器。
- 更換 `WEBHOOK_URL` 使用您的真實公共 URL 並配置反向代理來路由 `n8n.example.com` 到 n8n 容器。
- 使用 `EXECUTIONS_MODE=queue` 為了實現強大的後台處理；它需要隊列工作者和 Redis。
## 如何使用 npm / Node.js 自託管 n8n？
透過 npm（或 pnpm）安裝可直接在主機上執行 n8n。這種方式更輕（無需容器層），可能對單用戶、低複雜度的安裝或開發者機器有幫助。然而，它會讓管理員承擔更多依賴管理、隔離和服務監管的責任。 n8n 官方文件包含 npm 安裝指南和注意事項。
### 所需的 OS 套件和 Node 版本：
- 使用穩定的 LTS Node.js（Node 18 或 Node 20+，符合 n8n 發布要求）。
- 安裝 `build-essential`, `git`以及進程管理器（建議使用 systemd）。
- 對於生產，仍然使用 PostgreSQL 和 Redis 作為外部服務（與 Docker 相同的理由）。
### 如何透過 npm 安裝和運行 n8n（一步一步）？
1.安裝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：未找到命令”，請重新啟動終端或確保 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/。
- 首次運行時，請按照精靈建立所有者帳戶（電子郵件+密碼）並登入。
## 如何在 n8n 中安裝或設定 CometAPI 社群節點？
n8n 支援已驗證的社群節點（GUI 安裝）以及自託管時從 npm 手動安裝。將 CometAPI 整合到 n8n 的方法有兩種：
### 選項 A — 使用 CometAPI 社群節點（如果在「節點」面板中可用）
1. 在 n8n 中開啟節點面板（按 `+` or `Tab`).
2. CometAPI 是一個經過驗證的社群節點，它出現在「更多來自社群」下。點擊並安裝。
3. 安裝完成後，如果出現提示，請重新啟動 n8n。創建一個新的 **憑據** 在設定 → 憑證（如果節點提供，請選擇 CometAPI 憑證類型）中並貼上您的 CometAPI 令牌。
### 選項 B — 手動安裝（當 GUI 安裝不可用時）
1.SSH 進入您的 n8n 主機/容器。
2. 在全域 n8n 中安裝套件 `node_modules` 或您的自訂資料夾：
- 前往“設定”（左下角）>“社區節點”點擊“
- 安裝社區節點”
- 在「npm 套件名稱」中輸入： `@cometapi-dev/n8n-nodes-cometapi`勾選風險確認框點選“
- 安裝」安裝完成後，您可以在節點面板中搜尋「CometAPI」。
3.重啟 n8n。如果您的執行個體以佇列模式執行，則必須按照文件中所述的手動安裝路徑進行操作。
### 如何檢查節點是否已安裝
- 重新啟動後，開啟節點面板並蒐索“CometAPI”或“Comet”。該節點將被標記為社群包。
- 如果您看不到節點：請驗證是否使用了您的實例擁有者帳戶（只有實例擁有者可以安裝），或者節點包是否在容器/映像日誌中安裝而沒有錯誤。
## 如何建立工作流程並配置 API
### 1. 建立新的工作流程
- 登入您的 n8n 執行個體（自架）。
- 每填寫完資料或做任何更動請務必點擊 **“新增工作流程”** 開始一個新的自動化畫布。
### 2.新增節點
- 新增觸發節點：搜尋「手動觸發」或「按一下『執行工作流程』時」。
- 點擊畫布右側的“+”，搜尋“CometAPI”新增節點。
- 您也可以從左側節點清單中搜尋「CometAPI」並將其拖曳到畫布上。
### 3.配置憑證（僅限第一次）：
- 在 CometAPI 節點的「連線憑證」下，選擇「新建」。
- 將您在 CometAPI 控制台中建立的令牌貼到「CometAPI Key」中。
- 保存。基本 URL 預設為 https://api.cometapi.com，通常無需更改。
### 4.配置模型和訊息：
型號：輸入支援的型號，例如， `gpt-4o` or `gpt-4o-mini`.
訊息：需要填寫角色和上下文，角色可以選擇使用者或系統
可選參數（根據需要）有：最大令牌數（例如 4096）；採樣溫度（例如 0.7）；PenaltyStream（啟用/禁用流）。具體參數文件及說明請參考 [CometAPI 文檔](https://api.cometapi.com/doc).
### 5.文字執行：
選擇 CometAPI 節點，點擊“執行步驟”，或點擊底部的“執行工作流程”。
右側的OUTPUT面板應顯示JSON回應（包括選擇、用法等）。
您現在已經透過 npm 在 Linux 本地安裝了 n8n（建議），安裝並配置了 CometAPI 社群節點，並且可以執行呼叫 gpt-4o 等模型來接收回應的工作流程。
## 常見問題有哪些？如何解決這些問題？
### 1）“401 未授權”或“無效 API 金鑰”
- 確認 CometAPI 儀表板中準確的令牌字串（可能存在名稱相似的令牌）。複製 → 貼上到 n8n 憑證中，並在必要時重新啟動節點。
- 確保授權標頭格式為 `Bearer sk-xxxxx`.
### 2）社區節點無法安裝/“排隊模式”
- 如果你的 n8n 運行 **隊列模式**，可以停用 GUI 安裝；請依照手動安裝文件透過 npm 安裝社群節點，或建立包含該節點的自訂鏡像。安裝完成後，請重新啟動 n8n。
### 3）安裝後未在調色盤中找到節點
- 重新啟動 n8n。
- 確保在正確的上下文中安裝了套件（在容器鏡像中或在 `.n8n/custom` 如果使用該模式，則路徑）。
- 檢查容器日誌中是否有模組解析錯誤。
### 4）速率限製或配額問題
- 檢查 CometAPI 儀表板以了解使用情況和配額。
- 當偵測到限制警告或 HTTP 429 時，實施指數退避並回退到更便宜的模型。
## 如果社群節點不可用或您想要更大的靈活性，還有其他選擇嗎？
是的 — 您可以隨時使用 **HTTP請求** 節點直接（完全控制）或 [帶有基本 URL 的 OpenAI 節點](https://apidoc.cometapi.com/n8n-965890m0) 重定向（實用快捷方式）。使用原始 HTTP 還可以直接採用新發布的 CometAPI 端點（例如，映像/視訊端點）。請參閱 [指南](https://apidoc.cometapi.com/n8n-965890m0).
**參見** [如何將 n8n 與 CometAPI 結合使用](https://www.cometapi.com/zh-TW/how-to-use-n8n-with-cometapi/?utm_source=chatgpt.com)
## 總結：
CometAPI 為您提供模型選擇和操作簡單性；n8n 為您提供視覺化編排和可擴充性。使用 OpenAI 憑證技巧快速整合聊天/完成任務，並在存在且受信任的社群節點上進行操作。為每個工作流程配備成本、延遲和安全性偵測；優先考慮在重要決策中使用人工回退方案；並保持模型選擇的動態性，以便您能夠適應 AI 供應商格局的快速變化。 n8n 和 CometAPI 的組合功能強大，但與所有強大的工具一樣，它需要護欄——觀察、測試和迭代。
