Hướng dẫn cài đặt n8n trên Windows với Node.js và Docker

n8n là một công cụ tự động hóa quy trình làm việc (workflow automation) mã nguồn mở mạnh mẽ, cho phép bạn kết nối các ứng dụng và dịch vụ khác nhau mà không cần biết quá nhiều về lập trình. Bài viết này sẽ hướng dẫn bạn hai phương pháp phổ biến nhất để cài đặt n8n trên hệ điều hành Windows: sử dụng Node.js và sử dụng Docker.

Đây là phương pháp cài đặt trực tiếp, phù hợp cho những người dùng muốn chạy n8n trên môi trường máy tính cá nhân hoặc VPS Windows mà không cần qua lớp ảo hóa container.

Yêu cầu hệ thống

Để quá trình cài đặt diễn ra suôn sẻ, bạn cần đảm bảo máy tính đang sử dụng hệ điều hành Windows 10 trở lên. Các phiên bản Node.js mới (từ version 16 trở đi) không còn hỗ trợ Windows 7 hoặc 8, do đó việc cài đặt trên các hệ điều hành cũ sẽ rất phức tạp và dễ gặp lỗi.

Bước 1: Cài đặt Node Version Manager (NVM)

Việc quản lý phiên bản Node.js bằng NVM giúp bạn dễ dàng chuyển đổi giữa các phiên bản và tránh xung đột hệ thống.

Bạn hãy truy cập vào trang phát hành chính thức của nvm-windows trên GitHub: https://github.com/coreybutler/nvm-windows/releases. Tại đây, bạn tìm và tải xuống tệp cài đặt mới nhất, thường có tên là nvm-setup.exe.

Tiếp đó bạn chạy tệp nvm-setup.exe vừa tải về. Trong quá trình cài đặt, bạn hãy làm theo các hướng dẫn trên màn hình, bao gồm việc chọn thư mục cài đặt cho NVM và thư mục lưu trữ các phiên bản Node.js. Sau khi chọn xong, bạn nhấn Next để hoàn tất.

Để xác nhận NVM đã được cài đặt thành công, bạn hãy mở Command Prompt hoặc PowerShell bằng cách nhấn tổ hợp phím Windows + R, nhập cmd và nhấn Enter.

Tại cửa sổ dòng lệnh, bạn nhập lệnh sau:

nvm version

Nếu màn hình hiển thị số phiên bản (ví dụ: 1.2.2), nghĩa là bạn đã cài đặt NVM thành công.

Bước 2: Cài đặt Node.js thông qua NVM

Hiện tại, n8n hoạt động ổn định nhất trên các phiên bản Node.js từ 18.17 đến 22. Bạn không nên sử dụng phiên bản 23 để tránh lỗi tương thích. Để cài đặt Node.js phiên bản 22, bạn nhập lệnh:

nvm install 22

Sau khi cài đặt xong, bạn kích hoạt phiên bản này bằng lệnh:

nvm use 22

Bạn có thể kiểm tra lại phiên bản đang sử dụng bằng lệnh:

node -v

Bước 3: Cài đặt và khởi chạy n8n

Sau khi đã có môi trường Node.js, việc cài đặt n8n trở nên rất đơn giản chỉ với một câu lệnh. Tại cửa sổ Command Prompt, bạn nhập lệnh sau để cài đặt n8n trên toàn hệ thống:

npm install n8n -g

Quá trình này sẽ diễn ra tự động và có thể mất từ 5 đến 20 phút tùy thuộc vào tốc độ mạng của bạn. Sau khi quá trình cài đặt hoàn tất, bạn khởi động ứng dụng bằng cách gõ lệnh:

n8n

Hệ thống sẽ khởi động máy chủ n8n và lắng nghe tại cổng 5678. Bạn có thể truy cập vào giao diện làm việc bằng cách mở trình duyệt và nhập địa chỉ: http://localhost:5678.

Bước 4: Thiết lập tài khoản ban đầu

Khi truy cập vào địa chỉ localhost lần đầu tiên, bạn sẽ thấy màn hình thiết lập tài khoản chủ sở hữu (Owner).

Bạn cần điền đầy đủ các thông tin bao gồm: Địa chỉ email, Tên, Họ và Mật khẩu.

Sau khi truy cập vào hệ thống N8n, nếu bạn gặp cửa sổ này thì hãy chọn Skip để bỏ qua chúng vì đó đều là tính năng yêu cầu trả phí.

Cấu hình n8n truy cập từ xa qua Domain Public

Nếu bạn muốn truy cập n8n từ bên ngoài internet thông qua tên miền riêng thay vì localhost, bạn cần thực hiện thêm các bước sau:

Bước 1: Trỏ tên miền: Bạn cần cấu hình bản ghi DNS để trỏ tên miền về địa chỉ IP của VPS đang chạy n8n.

Bước 2: Mở port trên tường lửa: Bạn mở Command Prompt với quyền Administrator và chạy lệnh sau để cho phép kết nối qua cổng 5678:

netsh advfirewall firewall add rule name="n8n HTTPS" dir=in action=allow protocol=TCP localport=5678

Bước 3: Cấu hình biến môi trường:

Bạn truy cập vào thư mục C:\Users\Tên_User_Của_Bạn\.n8n, tạo hoặc chỉnh sửa file cấu hình (ví dụ .env hoặc thiết lập biến môi trường hệ thống) với nội dung sau để n8n lắng nghe mọi IP thay vì chỉ localhost:

set N8N_HOST=0.0.0.0
set N8N_PORT=5678
set N8N_SECURE_COOKIE=false

Bước 4: Khởi động lại n8n: Cuối cùng bạn tắt và chạy lại lệnh n8n trong CMD để áp dụng thay đổi.

Phương pháp này phù hợp nếu bạn muốn môi trường n8n được cách ly và dễ dàng quản lý, đặc biệt là trên môi trường VPS. Trước khi bắt đầu, bạn cần đảm bảo máy tính đã được cài đặt Docker Desktop cho Windows và đã bật tính năng ảo hóa (Virtualization) trong BIOS.

Bước 1: Thiết lập File Docker Compose

Bạn cần tạo một thư mục để lưu trữ dữ liệu n8n. Trong thư mục này, bạn tạo hai file quan trọng là .env (chứa biến môi trường) và docker-compose.yml (chứa cấu hình container). Nội dung file sẽ tuân theo cấu hình chuẩn của n8n dành cho Docker.

Nội dung mẫu cho file docker-compose.yml:

version: '3'
services:
  n8n:
    image: n8nio/n8n:latest # Sử dụng image n8n mới nhất
    restart: always # Luôn khởi động lại trừ khi bị dừng chủ động
    ports:
      - "5678:5678" # Ánh xạ port 5678 của host vào container
    environment:
      - NODE_ENV=production # Chạy ở chế độ production
      - GENERIC_TIMEZONE=Asia/Ho_Chi_Minh # Cấu hình múi giờ (thay đổi nếu cần)
      - N8N_HOST=localhost # Tên host (thay đổi nếu dùng domain)
      - N8N_PORT=5678 # Cổng n8n chạy
      - N8N_PROTOCOL=http # Giao thức (http/https)
      - WEBHOOK_URL=http://localhost:5678/ # URL để truy cập webhook
    volumes:
- ~/.n8n:/home/node/.n8n # Lưu trữ dữ liệu n8n

Bước 2: Khởi tạo n8n trên Docker

Bạn mở CMD hoặc PowerShell và di chuyển (cd) vào thư mục chứa file docker-compose.yml vừa tạo. Sau đó bạn chạy lệnh dưới đây để tải và khởi chạy container n8n dưới nền:

docker-compose up -d

Bạn chờ một lát để Docker tải image và khởi động dịch vụ. Khi lệnh chạy xong và không báo lỗi, quá trình cài đặt đã thành công.

Bước 3: Thiết lập và cấu hình tài khoản quản trị

Tương tự như phương pháp cài đặt n8n bằng Node.js, sau khi container chạy, bạn truy cập vào http://localhost:5678 để thiết lập tài khoản quản trị viên.

Bước 4: Cấu hình truy cập Public (Tùy chọn)

Nếu muốn public n8n ra internet thông qua Docker, bạn cũng cần thực hiện trỏ tên miền về IP máy chủ. Docker đã map port, nhưng Windows Firewall vẫn cần cho phép kết nối. Bạn chạy lệnh CMD sau với quyền Admin:

netsh advfirewall firewall add rule name="n8n" dir=in action=allow protocol=TCP localport=5678

Cuối cùng bạn chạy lại n8n và kiểm tra.

Như vậy, bạn đã hoàn tất việc cài đặt n8n trên Windows bằng hai phương pháp phổ biến. Bây giờ bạn có thể bắt đầu xây dựng các quy trình tự động hóa đầu tiên của mình. Nếu bạn gặp bất kỳ khó khăn nào trong quá trình thao tác hoặc cần tư vấn chuyên sâu hơn về vấn đề kỹ thuật, đừng ngần ngại liên hệ với đội ngũ kỹ thuật của Vietnix để được hỗ trợ nhanh chóng và hiệu quả nhất.

VIETNIX – DỊCH VỤ HOSTING, VPS TỐC ĐỘ CAO, ỔN ĐỊNH, BẢO MẬT

• Địa chỉ: 265 Hồng Lạc, Phường Bảy Hiền, Thành Phố Hồ Chí Minh
• Điện thoại: 1800 1093
• Email liên hệ: sales@vietnix.com.vn
• Website: https://vietnix.vn/