Chuyển đến nội dung chính

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.

Triển khai n8n trên chính máy của bạn và kết nối nó với CometAPI thông qua community node để chạy các workflow AI tự động cục bộ.

​
Điều kiện tiên quyết

  • Linux (Ubuntu/Debian/CentOS, v.v.) hoặc macOS
  • RAM từ 2 GB trở lên, 10 GB trở lên dung lượng đĩa trống
  • Quyền truy cập shell có thể kết nối tới npm registry công khai
  • Node.js 18.x hoặc 20.x LTS (xem Bước 1)
  • Tài khoản CometAPI với API key đang hoạt động — lấy tại đây
1

Lấy CometAPI API key của bạn

Đăng nhập vào CometAPI console. Nhấp Add API Key và sao chép khóa <COMETAPI_KEY> của bạn.
Bảng điều khiển CometAPI hiển thị nút Add API Key
Chi tiết API key CometAPI với base URL
2

Cài đặt Node.js qua nvm

n8n 1.x yêu cầu Node.js 18.x hoặc 20.x. Cách được khuyến nghị là dùng 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
Nếu sau đó bạn thấy n8n: command not found, hãy khởi động lại terminal hoặc bảo đảm thư mục npm global bin do nvm quản lý đã có trong PATH của bạn.
3

Cài đặt và khởi động n8n

npm install -g n8n
n8n -v       # verify the installed version
n8n start    # runs on http://localhost:5678/
Nếu cổng 5678 đã được sử dụng:
export N8N_PORT=5679
n8n start
Để giữ n8n tiếp tục chạy sau khi đóng terminal:
npm install -g pm2
pm2 start "n8n" --name n8n
pm2 save
pm2 status
Terminal hiển thị n8n khởi động thành công
Log khởi động n8n trong terminal
4

Tạo tài khoản owner của bạn

Mở http://localhost:5678/ trong trình duyệt. Ở lần chạy đầu tiên, trình hướng dẫn thiết lập sẽ yêu cầu bạn tạo một tài khoản Owner (email + mật khẩu). Hoàn tất bước này và đăng nhập.
Trình hướng dẫn thiết lập lần đầu của n8n yêu cầu thông tin tài khoản Owner
5

Cài đặt community node của CometAPI

  1. Vào Settings (góc dưới bên trái) → Community nodes
  2. Nhấp Install a community node
  3. Nhập tên gói: @cometapi-dev/n8n-nodes-cometapi
  4. Chọn ô xác nhận rủi ro và nhấp Install
Sau khi cài đặt, bạn có thể tìm kiếm CometAPI trong bảng node.
Bảng Settings của n8n hiển thị phần Community nodes
Hộp thoại cài đặt với tên gói CometAPI đã được nhập
Nếu phần Community Nodes không xuất hiện: hãy chắc chắn rằng bạn đã đăng nhập bằng tài khoản Owner, và kiểm tra Settings → Security để xác nhận việc cài đặt community node đã được bật.
6

Tạo workflow và cấu hình credentials

  1. Nhấp + New ở phía trên để tạo một workflow.
  2. Nhấp + trên canvas và tìm CometAPI để thêm node.
Canvas workflow của n8n với ô tìm kiếm node CometAPI đang mở
Node CometAPI đã được thêm vào canvas n8n
  1. Thêm một node Manual Trigger và kết nối nó với node CometAPI.
  2. Trong node CometAPI, dưới Credential to connect with, chọn Create new. Dán khóa <COMETAPI_KEY> của bạn vào CometAPI Key và nhấp Save. Base URL mặc định là https://api.cometapi.com và thường không cần thay đổi.
Hộp thoại credential CometAPI với API key đã được nhập
  1. Cấu hình node:
  • Model: nhập model ID hiện tại mà bạn muốn dùng
  • Messages: đặt Role là user, Content là prompt thử nghiệm của bạn (ví dụ: Hello)
  • Tùy chọn: thêm một message system, đặt Max Tokens, Temperature, v.v.
  1. Nhấp Execute step để chạy node. Bảng Output sẽ hiển thị phản hồi JSON.
Bảng output của n8n hiển thị phản hồi JSON CometAPI thành công
  • Lỗi node-gyp hoặc lỗi build native — cài đặt build tools: sudo apt install build-essential python3 (Debian/Ubuntu) hoặc Xcode Command Line Tools (macOS).
  • Lỗi quyền npm (EACCES) — dùng nvm để cài Node.js ở cấp người dùng; không cần sudo.
  • Xung đột cổng (localhost:5678 không khả dụng) — đặt N8N_PORT=5679 (hoặc một cổng trống khác) trước khi chạy n8n start.
  • Thiếu phần Community Nodes — đăng nhập bằng tài khoản Owner và kiểm tra Settings → Security.
  • npm install thất bại trong mạng doanh nghiệp — cấu hình proxy: npm config set proxy http://user:pass@host:port
  • Node CometAPI trả về 401/403 — xác minh API key của bạn và model đó có thể truy cập được trong gói CometAPI của bạn.
  • Phản hồi rỗng hoặc lỗi giới hạn token — tăng Max Tokens; điều chỉnh Temperature và Top P khi cần.
  • n8n dừng khi đóng terminal — dùng pm2: pm2 start "n8n" --name n8n && pm2 save.