跳转到主要内容
在你自己的机器上部署 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 并复制你的 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

创建你的 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。将你的 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 输出面板显示成功的 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。