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

n8n là một công cụ tự động hóa quy trình làm việc mạnh mẽ, cho phép bạn kết nối các ứng dụng và dịch vụ lại với nhau mà không cần viết quá nhiều mã lệnh. Việc cài đặt n8n trên Windows giúp bạn dễ dàng thử nghiệm, phát triển các quy trình tự động hóa trước khi triển khai lên môi trường sản phẩm. Bài viết này sẽ hướng dẫn bạn từng bước cách cài đặt n8n trên Windows thông qua Node.js và Docker, đồng thời hướng dẫn cách cấu hình để truy cập từ xa.

Những điểm chính

• Yêu cầu hệ thống: Máy tính cần chạy Windows 10 trở lên để hỗ trợ tốt nhất cho Node.js và Docker, cùng quyền quản trị Administrator để cài đặt, cấu hình phần mềm.
• Cài đặt n8n qua Node.js: Sử dụng NVM để quản lý phiên bản Node.js và cài đặt n8n thông qua npm.
• Cài đặt n8n qua Docker: Sử dụng Docker Compose để khởi tạo môi trường n8n nhanh chóng và biệt lập.
• Biết đến Vietnix là nhà cung cấp VPS cấu hình tối ưu cho cài đặt n8n.
  
• Giải đáp một số câu hỏi liên quan khi cài đặt n8n trên Windows.

Yêu cầu hệ thống trước khi cài đặt

Để quá trình cài đặt diễn ra suôn sẻ, máy tính của bạn cần đáp ứng các yêu cầu sau:

• Hệ điều hành: Bạn nên sử dụng Windows 10 hoặc Windows 11. Các phiên bản Windows 7, 8 hiện không còn hỗ trợ tốt các phiên bản Node.js mới (từ Node 16 trở lên), dẫn đến việc cài đặt rất phức tạp và dễ phát sinh lỗi.
• Quyền truy cập: Bạn cần có quyền Administrator để cài đặt phần mềm và cấu hình tường lửa.

Đâ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.

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

Tải 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ến hành cài đặt: 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í.

Bước 5: 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 port 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.

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.

Tối ưu hóa hiệu suất n8n với VPS Vietnix

Khi bạn chuyển từ môi trường thử nghiệm (Localhost) sang môi trường thực tế (Production), việc chạy n8n trên máy tính cá nhân sẽ gặp nhiều hạn chế về sự ổn định và kết nối mạng. VPS Vietnix là giải pháp lý tưởng để vận hành n8n 24/7.

Với hạ tầng VPS NVMe tốc độ cao và CPU hiệu năng mạnh mẽ, Vietnix đảm bảo các workflow phức tạp của bạn được xử lý mượt mà, không độ trễ. Bạn sẽ được toàn quyền quản trị để cài đặt Docker/Node.js và cấu hình bảo mật. Đặc biệt, đội ngũ kỹ thuật của Vietnix sẵn sàng 24/7 hỗ trợ bạn tối ưu hóa hệ thống để n8n hoạt động ổn định nhất.

Thông tin liên hệ:

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

Việc cài đặt n8n trên Windows với Node.js hay Docker đều là bước khởi đầu tuyệt vời để bạn làm quen với thế giới tự động hóa. Chỉ với vài câu lệnh đơn giản, bạn đã sở hữu một công cụ mạnh mẽ để kết nối và xử lý dữ liệu ngay trên máy tính cá nhân. Tuy nhiên, để phục vụ cho các quy trình công việc quan trọng và cần tính ổn định cao, bạn hãy cân nhắc việc chuyển đổi sang sử dụng Docker hoặc triển khai trên VPS chuyên dụng.