Skip to main content

Tự host n8n bằng npm

🎯 Ưu nhược điểm khi sử dụng cách này​

Cài đặt n8n bằng npm là phương pháp nhanh nhất để bắt đầu, đặc biệt phù hợp cho các nhà phát triển hoặc người dùng muốn thử nghiệm cục bộ trên máy tính cá nhân.

  • ✅ Nhanh chóng & Đơn giản: Cài đặt và khởi chạy chỉ bằng một vài dòng lệnh. 🚀
  • ✅ Linh hoạt: Toàn quyền kiểm soát phiên bản Node.js và n8n. 🎮
  • ✅ Miễn phí: Không tốn chi phí bản quyền phần mềm, chỉ trả tiền cho hạ tầng (nếu có). 💰
  • ✅ Lý tưởng để phát triển: Hoàn hảo cho việc xây dựng và gỡ lỗi workflow trên máy local. 👨‍💻
  • ❌ Không khuyến khích cho Production: Mặc định không tự khởi động lại khi có lỗi và không chạy dưới dạng tiến trình nền (background service). ⚠️
  • ❌ Quản lý thủ công: Việc cập nhật phiên bản, sao lưu dữ liệu đòi hỏi thao tác thủ công. 💾

⚙️ Yêu cầu cần thiết​

Để cài đặt n8n thành công qua npm, máy tính của bạn cần đáp ứng các yêu cầu sau:

  • 🖥️ Một máy tính hoặc Server: Có thể là máy tính cá nhân (Windows, macOS, Linux) hoặc một máy chủ ảo (VPS).
  • 📦 Node.js: Phiên bản LTS mới nhất được khuyến khích (tối thiểu v16+). npm được đi kèm sẵn khi cài đặt Node.js.
  • >_ Kiến thức dòng lệnh: Cần có hiểu biết cơ bản về cách sử dụng Terminal (trên macOS/Linux) hoặc Command Prompt/PowerShell (trên Windows).

📥 Hướng dẫn các bước​

Bước 1: Cài đặt Node.js​

Nếu chưa có Node.js, hãy truy cập trang chủ https://nodejs.org/ và tải về phiên bản LTS phù hợp với hệ điều hành của bạn và tiến hành cài đặt.

Để kiểm tra cài đặt thành công, mở Terminal và gõ:

node -v
npm -v

Nếu lệnh trả về phiên bản tương ứng, bạn đã sẵn sàng cho bước tiếp theo.

Bước 2: Cài đặt và khởi chạy n8n bằng npx​

npx là một công cụ đi kèm với npm giúp bạn thực thi các gói Node mà không cần cài đặt chúng một cách toàn cục (global). Đây là cách được khuyến khích để chạy n8n.

Mở Terminal và chạy lệnh sau:

npx n8n

Lần đầu tiên chạy, npx sẽ hỏi bạn có muốn cài đặt gói n8n không, hãy nhập y và nhấn Enter.

n8n sẽ khởi động và bạn sẽ thấy các thông báo trong Terminal, bao gồm cả địa chỉ để truy cập.

Bước 3: Truy cập giao diện n8n​

Sau khi khởi động thành công, hãy mở trình duyệt web và truy cập vào địa chỉ được cung cấp, thường là: http://localhost:5678

Bạn sẽ được chào mừng bởi màn hình thiết lập tài khoản quản trị. Hãy tạo tài khoản và bắt đầu hành trình tự động hóa của mình!

🎬 Video hướng dẫn trực quan​

Hướng dẫn cài đặt n8n bằng NPM

💡 Lưu ý​

  • Dữ liệu người dùng: Mặc định, tất cả dữ liệu (workflows, credentials) sẽ được lưu trong thư mục .n8n tại thư mục người dùng của bạn (ví dụ: /home/user/.n8n trên Linux hoặc C:\Users\YourUser\.n8n trên Windows).
  • Chỉ dành cho thử nghiệm: Phương pháp npx n8n rất tiện lợi nhưng khi bạn đóng cửa sổ Terminal, n8n cũng sẽ dừng lại. Nó không phù hợp để chạy các workflow quan trọng 24/7.
  • Để chạy trong môi trường Production: Nếu bạn muốn chạy n8n một cách ổn định, hãy xem xét việc sử dụng Docker hoặc một trình quản lý tiến trình như PM2.
  • Sử dụng PM2: Để n8n chạy nền và tự khởi động lại, bạn có thể dùng PM2: 
    # Cài đặt PM2
    npm install pm2 -g

    # Khởi chạy n8n với PM2
    pm2 start n8n

    # Lưu lại cấu hình để tự khởi động khi server reboot
    pm2 save
    pm2 startup
  • Cấu hình nâng cao: Bạn có thể tùy chỉnh cổng, cơ sở dữ liệu, và nhiều thiết lập khác thông qua các biến môi trường (Environment Variables). Tham khảo tài liệu chính thức của n8n để biết thêm chi tiết.