跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

在你自己的機器上部署 n8n，並透過社群節點將其連接到 CometAPI，以在本機執行自動化 AI 工作流程。

​
先決條件

  • Linux（Ubuntu/Debian/CentOS 等）或 macOS
  • 2 GB 以上 RAM、10 GB 以上可用磁碟空間
  • 可連線到公開 npm registry 的 Shell 存取權限
  • Node.js 18.x 或 20.x LTS（請參閱步驟 1）
  • 一個已啟用 API key 的 CometAPI 帳戶 — 在此取得
1

取得你的 CometAPI API key

登入 CometAPI 主控台。點擊 Add API Key，並複製你的 $COMETAPI_KEY 金鑰。
顯示 Add API Key 按鈕的 CometAPI 控制台
包含 base URL 的 CometAPI API key 詳細資訊
2

透過 nvm 安裝 Node.js

n8n 1.x 需要 Node.js 18.x 或 20.x。建議的方法是使用 nvm：
# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Reload your shell profile
source ~/.bashrc   # or ~/.zshrc on macOS

# Install and activate the LTS version
nvm install --lts
nvm use --lts

# Verify
node -v
npm -v
如果之後你看到 n8n: command not found，請重新啟動終端機，或確認由 nvm 管理的 npm 全域 bin 目錄已加入你的 PATH。
3

安裝並啟動 n8n

npm install -g n8n
n8n -v       # verify the installed version
n8n start    # runs on http://localhost:5678/
如果連接埠 5678 已被使用：
export N8N_PORT=5679
n8n start
若要在關閉終端機後仍持續執行 n8n：
npm install -g pm2
pm2 start "n8n" --name n8n
pm2 save
pm2 status
顯示 n8n 成功啟動的終端機
終端機中的 n8n 啟動日誌
4

建立你的 owner 帳戶

在瀏覽器中開啟 http://localhost:5678/。首次執行時，設定精靈會要求你建立一個 Owner 帳戶（電子郵件 + 密碼）。完成後登入。
要求輸入 Owner 帳戶詳細資料的 n8n 首次執行設定精靈
5

安裝 CometAPI 社群節點

  1. 前往 Settings（左下角）→ Community nodes
  2. 點擊 Install a community node
  3. 輸入套件名稱：@cometapi-dev/n8n-nodes-cometapi
  4. 勾選風險確認方塊，然後點擊 Install
安裝完成後，你就可以在節點面板中搜尋 CometAPI。
顯示 Community nodes 區段的 n8n Settings 面板
已輸入 CometAPI 套件名稱的安裝對話框
如果找不到 Community Nodes 區段：請確認你是以 Owner 帳戶登入，並檢查 Settings → Security 以確認已啟用社群節點安裝功能。
6

建立工作流程並設定認證

  1. 點擊頂部的 + New 以建立工作流程。
  2. 點擊畫布上的 +，搜尋 CometAPI 以加入該節點。
開啟 CometAPI 節點搜尋的 n8n 工作流程畫布
已加入 n8n 畫布的 CometAPI 節點
  1. 新增一個 Manual Trigger 節點，並將它連接到 CometAPI 節點。
  2. 在 CometAPI 節點中，於 Credential to connect with 下選擇 Create new。將你的 $COMETAPI_KEY 金鑰貼到 CometAPI Key，然後點擊 Save。Base URL 預設為 https://api.cometapi.com，通常不需要更改。
已輸入 API key 的 CometAPI 認證對話框
  1. 設定節點：
  • Model：輸入你想使用的目前 model ID
  • Messages：將 Role 設為 user，Content 設為你的測試 Prompt（例如 Hello）
  • 選填：新增 system 訊息，設定 Max Tokens、Temperature 等
  1. 點擊 Execute step 以執行節點。Output 面板會顯示 JSON 回應。
顯示成功 CometAPI JSON 回應的 n8n 輸出面板
  • node-gyp 或原生建置錯誤 — 安裝建置工具：sudo apt install build-essential python3（Debian/Ubuntu）或 Xcode Command Line Tools（macOS）。
  • npm 權限錯誤（EACCES） — 使用 nvm 進行使用者層級的 Node.js 安裝；不需要 sudo。
  • 連接埠衝突（localhost:5678 無法使用） — 在執行 n8n start 前設定 N8N_PORT=5679（或其他可用連接埠）。
  • 找不到 Community Nodes 區段 — 請以 Owner 帳戶登入，並檢查 Settings → Security。
  • 公司網路中 npm install 失敗 — 設定 proxy：npm config set proxy http://user:pass@host:port
  • CometAPI 節點回傳 401/403 — 驗證你的 API key，並確認你的 CometAPI 方案可存取該模型。
  • 空白回應或 Token 限制錯誤 — 提高 Max Tokens；並視需要調整 Temperature 和 Top P。
  • 終端機關閉後 n8n 停止執行 — 使用 pm2：pm2 start "n8n" --name n8n && pm2 save。