Solutions Choose your path
For individuals Build, learn, and create with simple usage-based access. For business Scale teams, billing, governance, and model workflows. More English 繁體中文 日本語 한국어 Français Deutsch Español Italiano Português Русский العربية ไทย Tiếng Việt Bahasa Indonesia Bahasa Melayu Türkçe Polski Nederlands Danish Norsk Қазақ اردو
免費開始 免費開始
500+ AI Model API, All In One API.
Just In CometAPI © 2026 CometAPI · All rights reserved
technology / CometAPI 研究
如何自行架設 n8n 並在本機執行 CometAPI 節點 對於構建本地自動化的人而言,一種實用的模式正在浮現:使用統一的模型網關(如 CometAPI)來存取多個模型,並將這些模型呼叫串接到自託管的自動化執行器(如 n8n)中,從而掌控資料、延遲與成本。本指南將逐步說明如何在本地開始使用 CometAPI + n8n、需要注意的事項,以及當情況不如預期時的疑難排解方法。
對於構建本地自動化的人而言,一種實用的模式正在浮現:使用統一的模型網關(如 CometAPI)來存取多個模型,並將這些模型呼叫串接到自託管的自動化執行器(如 n8n)中,從而掌控資料、延遲與成本。本指南將逐步說明如何在本地開始使用 CometAPI + n8n、需要注意的事項,以及當情況不如預期時的疑難排解方法。
先用這個摘要快速掌握答案,再閱讀指南取得背景、範例與實作細節。
複製from openai import OpenAI
client = OpenAI(
api_key="YOUR_COMETAPI_KEY",
base_url="https://api.cometapi.com/v1",
)
response = client.chat.completions.create(
model="gpt-5-mini",
messages=[{"role": "user", "content": "Build this workflow."}],
)
print(response.choices[0].message.content)AI 發展迅速:新的多模態模型與更強的即時 API 讓在自動化平台中嵌入強大的 AI 變得更容易;同時,圍繞安全性與可觀測性的討論也在重新塑造團隊如何運行生產系統。對於打造本地自動化的人而言,一個實用範式正浮現:使用統一的模型閘道(如 CometAPI )來存取多種模型,並將這些模型呼叫串接進自行託管的自動化執行器(如 n8n ),以便保有對資料、延遲與成本的掌控。本指南將一步步示範如何開始使用 CometAPI + n8n(本地) ,需要留意的事項,以及當情況不如預期時如何疑難排解。
什麼是 n8n?為何對 AI 自動化重要?
n8n 是一套開源的工作流程自動化工具,具備視覺化編輯器與龐大的節點(連接器)生態系。它旨在讓你把觸發器、轉換與外部 API 呼叫串成可重複的工作流程(webhooks、排程作業、檔案處理、聊天機器人等)。在本地自行託管 n8n 能讓你完全掌控資料駐留與執行,這在呼叫會處理敏感輸入的第三方 AI 模型時格外重要。
n8n 在實務上如何運作?
視覺畫布包含觸發器(Webhook、Cron)與動作節點(HTTP Request、資料庫節點、電子郵件)。
社群節點可擴充能力——你可以安裝社群套件並將其視為原生節點使用。
本地自行託管 n8n 可帶來:
完整資料掌控 ——工作流程與執行資料都留在你管理的基礎設施內。
客製化 ——新增私有節點或本地整合,無須等待雲端版功能上線。
成本可預期 ——對於內部密集自動化,不會有按次計費的雲端驚喜。
安全與合規 ——更容易符合內部政策與監管要求。
CometAPI 是一個統一的 API 閘道,透過單一、與 OpenAI 相容的介面與計費模型,匯聚數百種第三方 AI 模型(文字、embeddings、影像生成等)。這表示你無需為每個想嘗試的 LLM 或影像引擎各自新增整合,只要呼叫同一個 API,並在請求中選擇想要的模型即可。這簡化了試驗、成本控管與營運整合。
優點:
模型選擇: 以相同的程式路徑嘗試多家供應商/多種模型。
Token 池/免費額度: 許多統一閘道提供額度/層級可供試用。
基礎設施更簡單: 僅需管理一組驗證系統與一個 base URL。
在 CometAPI 網站(或供應商儀表板)註冊 。多數閘道提供免費層級以供測試。
從 CometAPI 儀表板取得 API 金鑰 ——一段長的祕密字串。請留意文件指示如何放置(CometAPI 使用 Bearer 授權,指向 https://api.cometapi.com/v1).
閱讀 API 文件 ,確認你要用的端點(chat completions、images、embeddings)。CometAPI 的端點如 /v1/chat/completions 與 /v1/images/generations。
此處的「綁定」指你的自動化執行器(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 模式與環境變數說明。
建立資料夾與 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:
```
造訪 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。
npm install -g n8n
n8n -v # verify version
export N8N_PORT=5679
n8n start
npm install -g pm2
pm2 start "n8n" --name n8n
pm2 save
pm2 status
n8n 同時支援已驗證的社群節點(GUI 安裝)與在自託管環境中從 npm 手動安裝。你有兩種方式整合 CometAPI 至 n8n:
在 n8n 開啟節點面板(按 + 或 Tab)。
CometAPI 是已驗證的社群節點,會出現在 “More from the community” 下。點擊安裝。
安裝後如提示請重新啟動 n8n。到 Settings → Credentials 建立新的 Credential (若節點提供對應類型)並貼上你的 CometAPI token。
方案 B — 手動安裝(當 GUI 安裝不可用時) 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.
重新啟動 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 。
結論: CometAPI 提供模型選擇與營運簡化;n8n 提供可視化編排與可擴充性。若要快速整合聊天/補全,可使用 OpenAI 憑證轉向的小技巧;在有可用且信任的情況下使用社群節點。為每個工作流程加入成本、延遲與安全的監測;對重要決策偏好人工覆核;讓你的模型選擇保持動態,以因應 AI 供應商生態的快速變化。n8n 與 CometAPI 的組合很強大,但如同所有強大的工具,它需要防護欄——觀測、測試並持續迭代。