跳轉到主要內容
在你自己的電腦上部署 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，然後複製你的 sk-xxxxx 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

建立你的擁有者帳戶

在瀏覽器中開啟 http://localhost:5678/。首次執行時，設定精靈會要求你建立一個 Owner 帳戶（電子郵件 + 密碼）。完成後登入。
n8n 首次執行設定精靈要求輸入 Owner 帳戶資訊
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。將你的 sk-xxxxx key 貼到 CometAPI Key，然後點擊 Save。Base URL 預設為 https://api.cometapi.com，通常不需要變更。
已輸入 API key 的 CometAPI 憑證對話框
  1. 設定節點：
  • Model：輸入你想使用的目前模型 ID
  • Messages：將 Role 設為 user，Content 設為你的測試 Prompt（例如 Hello）
  • 選填：加入 system 訊息、設定 Max Tokens、Temperature 等。
  1. 點擊 Execute step 來執行節點。Output 面板會顯示 JSON 回應。
n8n Output 面板顯示成功的 CometAPI JSON 回應
  • 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。