n8n 本地部署

在 Linux/macOS 上本地部署 n8n，安装 CometAPI 社区节点，并配置 API 凭证，以便在你的机器上运行自动化工作流。

在你自己的机器上部署 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。

   

   
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
   

   

   
4. 创建你的 owner 账户

   在浏览器中打开 http://localhost:5678/。首次运行时，安装向导会要求你创建一个 Owner 账户（邮箱 + 密码）。完成后登录。

   
5. 安装 CometAPI 社区节点

   1. 前往 Settings（左下角）→ Community nodes
   2. 点击 Install a community node
   3. 输入包名：@cometapi-dev/n8n-nodes-cometapi
   4. 勾选风险确认框并点击 Install

   安装完成后，你就可以在节点面板中搜索 CometAPI。

   

   

   如果没有看到 Community Nodes 区域：请确认你当前登录的是 Owner 账户，并检查 Settings → Security 以确认已启用社区节点安装。

6. 创建工作流并配置凭据

   1. 点击顶部的 + New 创建一个工作流。
   2. 点击画布上的 +，搜索 CometAPI 并添加该节点。

   

   

   3. 添加一个 Manual Trigger 节点，并将其连接到 CometAPI 节点。
   4. 在 CometAPI 节点中，在 Credential to connect with 下选择 Create new。将你的 sk-xxxxx key 粘贴到 CometAPI Key 中，然后点击 Save。Base URL 默认为 https://api.cometapi.com，通常无需修改。

   

   5. 配置该节点：

   • Model：输入你想使用的当前模型 ID
   • Messages：将 Role 设为 user，Content 设为你的测试 Prompt（例如 Hello）
   • 可选：添加一条 system 消息，设置 Max Tokens、Temperature 等

   6. 点击 Execute step 运行该节点。Output 面板会显示 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。