Triển khai n8n cục bộ

Triển khai n8n cục bộ trên Linux/macOS, cài đặt community node của CometAPI và cấu hình thông tin xác thực API để chạy các workflow tự động trên máy của bạn.

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.

   

   
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
   

   

   
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.

   
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.

   

   

   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.

   

   

   3. Thêm node Manual Trigger và kết nối nó với node CometAPI.
   4. 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.

   

   5. 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.

   6. Nhấp Execute step để chạy node. Bảng Output sẽ hiển thị phản hồi JSON.

   

Khắc phục sự cố

• 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.