Hướng dẫn cài đặt và sử dụng n8n trên Windows 11

[Saviba]

Tổng quan​

Bài này xin hướng dẫn các bạn cách cài local trên Windows 11 bằng Docker Desktop (khuyến nghị nhất vì ổn định, dễ quản lý, không mất dữ liệu khi restart).

Phần 1: Chuẩn bị và cài Docker Desktop​

1. Yêu cầu hệ thống: Windows 11 (Pro/Home đều ok), RAM ≥ 4GB (khuyến nghị 8GB+), kết nối internet.

• Tải từ trang chính thức:
• Chạy file .exe với quyền Run as administrator.

Trong quá trình cài:
Tick chọn Use WSL 2 instead of Hyper-V (backend mặc định, tốt nhất cho Windows).
Nếu hỏi cập nhật WSL, chấp nhận và restart máy nếu cần.

Sau cài xong: Mở Docker Desktop → chờ icon cá voi ở system tray chuyển sang xanh (Engine running).
Fix lỗi WSL nếu gặp (thường gặp lần đầu):
Bước 1: Khi khởi động lại và bạn chạy Docker Desktop thì thường sẽ yêu cầu người dùng update WSL. Đây là tình trạng phổ biến sau khi người dùng cài đặt Docker Destop. Để khắc phục bạn hãy sao chép dòng wsl --update đó.

Bước 2: Kế đến hãy mở PowerShell (Run as administrator) bằng cách bấm Search và điền PowerShell:
Dán wsl -- update và chọn Enter.

• Lệnh sẽ tải và cài kernel WSL mới nhất (có thể mất 1-2 phút, cần internet).
• Nếu thành công: Bạn sẽ thấy thông báo kiểu "The operation completed successfully" hoặc "Updating WSL... done".
• Nếu nó báo lỗi "already up to date" → vẫn tốt, nghĩa là đã mới rồi.
• Nếu lỗi "Class not registered" hoặc tương tự → thử lệnh thay thế:

wsl -- update -- web - download

• Nhiều trường hợp sau update, nó sẽ yêu cầu restart Windows. Hãy restart luôn để áp dụng thay đổi.

Bước 4: Tiếp tục cài Docker Desktop

• Sau khi restart (nếu có), mở lại Docker Desktop installer (file .exe bạn tải về).
• Chạy tiếp quá trình cài đặt (nếu đang giữa chừng thì nó sẽ resume).
• Tick chọn Use WSL 2 instead of Hyper-V nếu hỏi (đây là backend mặc định và tốt nhất).
• Hoàn tất cài đặt → Docker Desktop sẽ khởi động.

Bước 5: Kiểm tra WSL đã ok chưa Sau khi xong, mở PowerShell (admin) chạy:

wsl -- version

→ Nên thấy version khoảng 2.1.x hoặc mới hơn (ví dụ 2.2.4 hoặc cao hơn tùy thời điểm 2026).

Phần 2: Cài và chạy n8n bằng Docker Desktop GUI (không cần gõ lệnh nhiều)​

Mở Docker Desktop và chuyển sang tab Images (bên trái).

Trong ô search bạn hãy gõ n8n hoặc n8nio/n8n → Enter.
Tìm image n8nio/n8n (tag latest) → click Pull nếu chưa có (tải về ~2GB, mất 2-10 phút tùy mạng).

Sau khi pull xong → click nút Run (hoặc play ) trên image đó.
Trước khi thiết lập thông số chạy, bạn hãy tạo một thư mục dành cho dữ liệu của n8n.

Điền thông tin trong cửa sổ Run a new container bạn hãy chọn Optional settings (mở rộng)

Container name: Điền n8n (dễ quản lý).
Ports:

• Host port: 5678
• Container port: 5678 (tự map).

Volumes (để lưu workflow vĩnh viễn):

• Tạo volume trước: Tab Volumes → Create volume → chọn vào thư mục bạn đã tạo cho n8n → Create.
• Container path: /home/node/ .n8n

Environment variables (thêm để timezone VN và bảo mật):

• GENERIC_TIMEZONE → Asia/Ho_Chi_Minh

Khi hoàn tất điền thông tin trong Run a new cotainer hãy chọn Run.

Quay lại tab Containers → thấy container n8n status Running (xanh).

Phần 3: Truy cập và setup n8n lần đầu​

1. Mở trình duyệt (Chrome/Edge): Gõ

• Điền email (email thật để recover).
• Đặt password mạnh.
• Click Continue → skip onboarding nếu muốn.

Nếu không mở được localhost:5678:

• Kiểm tra container Running chưa → Restart nếu Exited.
• Tắt tạm Windows Firewall (Settings Windows Security Firewall Turn off Private/Public).
• Đổi port: Stop container → Remove → Run lại với Host port 5679 → truy cập localhost:5679.
• Xem Logs trong Docker Desktop (Containers → click container → Logs) để debug.

Phần 4: Sử dụng n8n cơ bản​

• Click + New (hoặc Add workflow).
• Kéo node Manual (trigger thủ công) hoặc Schedule Trigger (chạy định kỳ).
• Kết nối với node khác: Ví dụ HTTP Request (gọi API), Google Sheets (thêm dữ liệu), Telegram (gửi tin nhắn), AI Agent (dùng Grok/OpenAI).
• Click Execute Workflow để test → thấy output xanh là thành công.

• Click Save → bật Active (toggle trên cùng) để workflow chạy tự động.

• Trigger: Cron/Schedule, Webhook, Manual.
• Action: Set (chỉnh data), HTTP Request, Email Send, Code (JS/Python).
• App: Google, Telegram, Discord, Notion, Airtable, v.v. (hàng trăm tích hợp sẵn).

Phần 5: Quản lý và nâng cao​

• Dừng/Khởi động: Tab Containers → Stop/Start container.
• Cập nhật n8n: Tab Images → Pull lại n8nio/n8n:latest → Stop/Remove container cũ → Run mới.
• Warning Python runner (thường thấy trong logs): Bình thường nếu không dùng Code node Python. Nếu cần Python → setup external runners (mình hướng dẫn riêng nếu bạn muốn).
• Backup: Sao lưu folder/volume n8n_data (chứa workflow, credentials).
• Production nâng cao: Dùng (từ thêm PostgreSQL thay SQLite, HTTPS (Nginx/Reverse proxy), basic auth.

n8n không chỉ là một công cụ tự động hóa – nó là "siêu trợ lý" mã nguồn mở giúp bạn tiết kiệm hàng giờ mỗi ngày bằng cách biến các tác vụ lặp lại thành luồng công việc thông minh, an toàn và hoàn toàn kiểm soát được. Với khả năng tích hợp AI ngày càng mạnh mẽ, n8n đang trở thành lựa chọn hàng đầu cho ai muốn "làm việc thông minh hơn" thay vì "làm việc nhiều hơn".