Chuyển đến nội dung chính
Triển khai n8n trên máy của bạn và kết nối với CometAPI thông qua community node để chạy các workflow AI tự động ngay trên máy 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 key sk-xxxxx của bạn.
Bảng điều khiển CometAPI hiển thị nút Add API Key
Chi tiết CometAPI API key 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 đảm bảo 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
Nhật ký 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 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 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 package: @cometapi-dev/n8n-nodes-cometapi
  4. Tích vào ô 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ị mục Community nodes
Hộp thoại cài đặt với tên package CometAPI đã được nhập
Nếu thiếu mục Community Nodes: hãy đảm bảo 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 của n8n
  1. Thêm 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 key sk-xxxxx 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 credentials 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 sử 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 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 cổng trống khác) trước khi chạy n8n start.
  • Thiếu mục Community Nodes — đăng nhập bằng tài khoản Owner và kiểm tra Settings → Security.
  • npm install thất bại trên 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à đảm bảo model có thể truy cập 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 nếu cần.
  • n8n dừng khi đóng terminal — dùng pm2: pm2 start "n8n" --name n8n && pm2 save.