跳转到主要内容

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 以上内存、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> 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 账户（邮箱 + 密码）。完成后登录。
n8n 首次运行安装向导要求填写 Owner 账户信息
5

安装 CometAPI 社区节点

  1. 前往 Settings（左下角）→ Community nodes
  2. 点击 Install a community node
  3. 输入包名：@cometapi-dev/n8n-nodes-cometapi
  4. 勾选风险确认框并点击 Install
安装完成后，你可以在节点面板中搜索 CometAPI。
n8n Settings 面板中显示 Community nodes 部分
安装对话框中已输入 CometAPI 包名
如果看不到 Community Nodes 部分：请确认你是以 Owner 账户登录，并检查 Settings → Security 以确认已启用社区节点安装。
6

创建工作流并配置凭证

  1. 点击顶部的 + New 创建一个工作流。
  2. 点击画布上的 +，搜索 CometAPI 以添加该节点。
n8n 工作流画布中打开了 CometAPI 节点搜索
CometAPI 节点已添加到 n8n 画布中
  1. 添加一个 Manual Trigger 节点，并将其连接到 CometAPI 节点。
  2. 在 CometAPI 节点中，在 Credential to connect with 下选择 Create new。将你的 <COMETAPI_KEY> key 粘贴到 CometAPI Key 中，然后点击 Save。Base URL 默认为 https://api.cometapi.com，通常无需更改。
CometAPI 凭证对话框中已输入 API key
  1. 配置节点：
  • Model：输入你要使用的当前 model ID
  • Messages：将 Role 设为 user，Content 设为你的测试 Prompt（例如 Hello）
  • 可选：添加一条 system 消息，设置 Max Tokens、Temperature 等
  1. 点击 Execute step 运行该节点。Output 面板会显示 JSON 响应。
n8n 输出面板显示成功的 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 失败 —— 配置代理：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。