close

Cách cài đặt n8n trên máy tính PC bằng Docker Desktop chi tiết A-Z

Tác giả: Đông Tùng Ngày đăng: 12/08/2025 Chuyên mục: n8n
Disclosure
Website Tino blog được cung cấp bởi Tino Group. Truy cập và sử dụng website đồng nghĩa với việc bạn đồng ý với các điều khoản và điều kiện trong chính sách bảo mật - điều khoản sử dụng nội dung. Tino Group có thể thay đổi điều khoản sử dụng bất cứ lúc nào. Việc bạn tiếp tục sử dụng Tino blog sau khi thay đổi có nghĩa là bạn chấp nhận những thay đổi đó.
Why Trust Us
Các bài viết với hàm lượng tri thức cao tại Tino blog được tạo ra bởi các chuyên viên Marketing vững chuyên môn và được kiểm duyệt nghiêm túc theo chính sách biên tập bởi đội ngũ biên tập viên dày dặn kinh nghiệm. Mọi nỗ lực của chúng tôi đều hướng đến mong muốn mang đến cho cộng đồng nguồn thông tin chất lượng, chính xác, khách quan, đồng thời tuân thủ các tiêu chuẩn cao nhất trong báo cáo và xuất bản.

n8n không còn bản Desktop chính thức: ứng dụng n8n Desktop đã ngừng phát triển và kho mã được lưu trữ (archive) từ 15/08/2025. Cách cài n8n trên máy tính hiện nay là chạy image n8nio/n8n bằng Docker Desktop, mở http://localhost:5678 rồi tạo tài khoản owner. Dữ liệu nằm trong volume n8n_data nên cập nhật không mất workflow.

Hướng dẫn dùng n8n 2.44.5, bản stable ngày 21/10/2026 (GitHub n8n-io/n8n), chạy được trên Windows, macOS và Linux. Muốn n8n chạy 24/7 thì xem cách cài đặt n8n trên VPS.

n8n Desktop còn không? Các cách chạy n8n trên máy tính

n8n Desktop là ứng dụng Electron cũ để chạy n8n trên máy tính; kho mã github.com/n8n-io/n8n-desktop-app đã được lưu trữ, chỉ còn đọc, và không nhận cập nhật (GitHub). Thay vào đó, n8n hướng dẫn chạy bản Community bằng Docker, hoặc dùng n8n Cloud nếu không muốn cài gì.

Cách chạyCần gìHợp khiLưu ý
Docker Desktop + docker runDocker DesktopHọc, thử workflow lâu dài trên máyCách chính của bài này
Lệnh một dòng get.n8n.ioDocker Desktop; Windows chạy trong WSLMuốn n8n tự tạo sẵn file cấu hìnhTheo One-line setup
npx n8nNode.js 20.19 đến 24.xThử nhanh vài phútn8n 3.0 không còn hỗ trợ
n8n CloudTài khoản n8n.ioKhông muốn cài đặtTrả phí sau thời gian dùng thử; xem cách đăng ký tài khoản n8n
Các cách chạy n8n trên máy tính, cập nhật 22/10/2026
Sơ đồ chọn cách cài n8n trên máy tính: nếu cài được Docker Desktop và muốn tự chỉnh tham số thì dùng lệnh docker run với image n8nio/n8n và volume n8n_data (khuyến nghị); nếu không cần chỉnh thì dùng lệnh một dòng curl get.n8n.io, Windows chạy trong WSL; nếu không cài được Docker thì npx n8n để thử nhanh, cần Node.js 20.19 đến 24.x, n8n 3.0 không còn hỗ trợ; muốn chạy 24/7 hoặc nhận webhook từ Internet thì đưa lên VPS hoặc dùng ngrok, Cloudflare Tunnel, lệnh n8n --tunnel đã bị gỡ từ 2.0

Có nên tải bản n8n Desktop cũ trên mạng về dùng không?

Không nên. Bản Desktop dừng ở phiên bản n8n rất cũ, không có bản vá bảo mật, và workflow tạo trên n8n 2.x có thể không mở được. Nếu bạn đang có dữ liệu trong n8n Desktop, hãy xuất workflow ra file JSON rồi nhập vào n8n chạy bằng Docker.

Chạy n8n trên máy tính có ưu nhược điểm gì?

Chạy n8n trên máy tính không tốn tiền máy chủ và hợp để học, thử workflow, nhưng n8n chỉ chạy khi máy đang bật. Webhook từ dịch vụ bên ngoài cũng không gọi vào được nếu không có tunnel.

Ưu nhược điểm khi chạy n8n trên máy tính cá nhân

Ưu điểm

  • Không tốn tiền máy chủ: bản Community miễn phí bản quyền, chỉ cần máy tính đủ RAM.
  • Thử nghiệm thoải mái: sửa, xóa workflow mà không ảnh hưởng hệ thống đang chạy thật.
  • Dữ liệu nằm trên máy: workflow và credentials lưu trong volume trên máy bạn.
  • Cùng giao diện với bản server: học trên máy tính rồi chuyển lên VPS không phải học lại.

Nhược điểm

  • Không chạy 24/7: máy ngủ, tắt hoặc mất mạng là workflow theo lịch dừng.
  • Khó nhận webhook: địa chỉ localhost không truy cập được từ Internet.
  • Phụ thuộc cấu hình máy: Docker Desktop cùng n8n dùng chung RAM, CPU với các ứng dụng khác.
  • Tự cập nhật: bạn tự kéo image mới khi có bản n8n mới.

Ai nên chạy n8n trên máy tính?

n8n trên máy tính hợp với ba nhóm: người mới học n8n, lập trình viên hoặc người kiểm thử cần môi trường thử trước khi đưa lên production, và người tự động hóa vài việc cá nhân chạy khi máy đang bật. Workflow phục vụ khách hàng hoặc cần chạy liên tục nên đặt trên máy chủ.

Ai nên chạy n8n trên máy tính cá nhân

Cần chuẩn bị gì trước khi cài n8n trên máy tính?

Bạn cần một máy cài được Docker Desktop. Theo Docker, Windows cần bản 10 64-bit 22H2 (build 19045) hoặc 11 64-bit 23H2 trở lên, WSL 2 và 8 GB RAM; macOS cần một trong ba bản lớn gần đây và tối thiểu 4 GB RAM (Docker Desktop cho Windows, cho Mac).

  • Ảo hóa: bật Virtualization trong BIOS/UEFI trên Windows.
  • Ổ đĩa trống: image n8n 2.44.5 nặng khoảng 280 MB khi tải về (Docker Hub), giải nén ra chiếm nhiều hơn; chừa vài GB cho dữ liệu.
  • Giấy phép Docker Desktop: miễn phí cho cá nhân, giáo dục và doanh nghiệp dưới 250 nhân viên và dưới 10 triệu USD doanh thu năm; tổ chức lớn hơn cần gói trả phí (Docker).
  • Internet: để tải Docker Desktop, image n8n và cho workflow gọi dịch vụ bên ngoài.

Các bước cài đặt n8n trên máy tính PC bằng Docker Desktop

Có 7 bước: cài Docker Desktop, tạo volume, chạy container n8n, tạo tài khoản owner, rồi các thao tác dừng, cập nhật và gỡ. Lệnh trong bài viết trên một dòng, chạy được trong Command Prompt, PowerShell trên Windows và Terminal trên macOS, Linux.

Bước 1: Cài đặt Docker Desktop

Vào trang tải Docker Desktop, chọn bản cho hệ điều hành của bạn. Trên Windows, chọn Download for Windows – AMD64 với máy Intel/AMD phổ biến.

Trang tải Docker Desktop với các lựa chọn cho Mac Apple Silicon, Mac Intel, Windows AMD64, Windows ARM64 và Linux

Chạy file cài đặt và làm theo hướng dẫn trên màn hình.

Trình cài đặt Docker Desktop trên Windows đang giải nén file

Cài xong, mở Docker Desktop. Đăng nhập tài khoản Docker là tùy chọn. Nếu Docker báo WSL cần cập nhật, chép lệnh wsl --update, bấm Restart, rồi chạy lệnh đó trong PowerShell.

Docker Desktop báo WSL cần cập nhật, kèm lệnh wsl --update và nút Restart
Giao diện chính của Docker Desktop, tab Containers

Mở Command Prompt hoặc PowerShell, kiểm tra Docker:

docker --version
Command Prompt hiện phiên bản Docker sau lệnh docker --version

Bước 2: Tạo volume lưu dữ liệu n8n

Volume giữ workflow, credentials và khóa mã hóa khi container bị xóa hoặc thay bằng bản mới. Tạo volume tên n8n_data và kiểm tra:

docker volume create n8n_data
docker volume ls
Command Prompt chạy lệnh docker volume create n8n_data

Bước 3: Chạy container n8n

Lệnh dưới tải image n8n, tạo container tên n8n chạy nền và tự khởi động lại cùng Docker Desktop. Lần đầu tải image mất vài phút.

docker run -d --name n8n --restart unless-stopped -p 5678:5678 -e GENERIC_TIMEZONE="Asia/Ho_Chi_Minh" -e TZ="Asia/Ho_Chi_Minh" -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true -v n8n_data:/home/node/.n8n n8nio/n8n:2.44.5
Tham sốÝ nghĩa
-d, --restart unless-stoppedChạy nền; tự bật lại khi Docker khởi động, trừ khi bạn chủ động dừng
-p 5678:5678Mở n8n ở http://localhost:5678; cổng bị chiếm thì đổi số bên trái, ví dụ 5679:5678
GENERIC_TIMEZONE, TZMúi giờ Việt Nam cho Schedule Trigger và cho lệnh trong container
N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=trueBắt file cấu hình dùng quyền chặt; có trong lệnh mẫu của n8n
-v n8n_data:/home/node/.n8nGắn volume ở bước 2; mọi lệnh sau phải dùng đúng volume này
n8nio/n8n:2.44.5Image chính thức, ghim số phiên bản thay vì latest
Giải thích lệnh docker run

Lệnh dựa trên mẫu ở Install with Docker của n8n, chỉ đổi sang chạy nền và ghim phiên bản. Xem log khởi động bằng docker logs -f n8n; khi thấy dòng dưới, n8n đã sẵn sàng.

Log container n8n báo Editor is now accessible via http://localhost:5678

Bước 4: Mở n8n và tạo tài khoản owner

Mở trình duyệt, truy cập http://localhost:5678. Lần đầu, n8n yêu cầu tạo tài khoản owner gồm email, họ tên và mật khẩu.

Màn hình Set up owner account của n8n tại localhost:5678 với các ô email, họ tên, mật khẩu

Sau đó n8n đề nghị nhận license miễn phí cho bản Community bằng email. Bản đăng ký mở thêm thư mục (Folders), Debug in editor và Custom execution data, vẫn miễn phí (docs.n8n.io). Nhập email, chọn Send me a free license key, rồi bấm link kích hoạt trong thư. Bạn có thể bỏ qua và kích hoạt sau trong Settings > Usage and plan.

Đây là trang Overview của n8n sau khi đăng nhập:

Trang Overview của n8n chạy tại localhost:5678 với các thẻ Workflows, Credentials, Executions và nút Create Workflow

Bước 5: Dừng và khởi động lại n8n

Container chạy nền nên đóng cửa sổ lệnh không làm n8n tắt. Dừng và bật lại bằng hai lệnh sau, hoặc bấm nút trong tab Containers của Docker Desktop:

docker stop n8n
docker start n8n
Tab Containers của Docker Desktop hiện container n8n đang chạy từ image n8nio/n8n ở cổng 5678

Bước 6: Cập nhật phiên bản n8n

Kéo image bản mới, xóa container cũ, rồi chạy lại lệnh ở bước 3 với tag mới. Dữ liệu vẫn còn vì nằm trong volume n8n_data. Trước khi lên bản lớn, đọc thay đổi và sao lưu: cách cập nhật n8n.

Ví dụ máy đang chạy 2.43.8 và bản stable mới là 2.44.5:

docker pull n8nio/n8n:2.44.5
docker stop n8n
docker rm n8n

Sau đó chạy lại lệnh docker run ở bước 3 với tag của bản mới. Giữ nguyên phần -v n8n_data:/home/node/.n8n.

Bước 7: Gỡ n8n khỏi máy tính

Lệnh cuối xóa volume, tức xóa hết workflow và credentials. Xuất workflow ra file JSON trước nếu còn cần.

docker stop n8n
docker rm n8n
docker rmi n8nio/n8n:2.44.5
docker volume rm n8n_data

Cũng có thể xóa trong Docker Desktop: lần lượt mở tab Containers, Images, Volumes và bấm biểu tượng thùng rác. Không dùng Docker nữa thì gỡ Docker Desktop như một ứng dụng thông thường.

Tab Images của Docker Desktop liệt kê image n8n (hai tên n8nio/n8n và docker.n8n.io/n8nio/n8n cùng một Image ID) với nút thùng rác để xóa
Tab Volumes của Docker Desktop hiện volume n8n_data với nút xóa

Cài n8n bằng npx, không cần Docker được không?

Được, nhưng chỉ nên để thử nhanh. Lệnh npx n8n tải n8n và chạy ở http://localhost:5678, cần Node.js từ 20.19 đến 24.x (Install with npm). Cài bằng npm đã bị đánh dấu deprecated, và n8n 3.0 sắp phát hành không còn chạy bằng npm hay npx (v3.0 breaking changes).

node -v
npx n8n

Khi chạy bằng npx, dữ liệu nằm trong thư mục .n8n ở thư mục người dùng (ví dụ C:\Users\<tên>\.n8n trên Windows). Muốn dùng lâu dài, chuyển sang Docker để lên 3.0 không phải cài lại.

Muốn nhận webhook hoặc chạy n8n 24/7 thì làm sao?

n8n trên máy tính chỉ nghe ở localhost, nên Telegram, GitHub hay form web không gọi vào được. Để thử, dùng ngrok hoặc Cloudflare Tunnel tạo URL công khai tạm thời và đặt N8N_WEBHOOK_URL bằng URL đó. Lệnh n8n --tunnel cũ đã bị gỡ ở n8n 2.0 (v2.0 breaking changes).

Vì sao dịch vụ bên ngoài không gọi được n8n trên máy tính: không có tunnel thì URL webhook là localhost:5678, router và NAT chặn kết nối từ Internet nên n8n trong Docker Desktop không nhận được sự kiện; có tunnel ngrok hoặc Cloudflare Tunnel thì dịch vụ gửi tới URL công khai HTTPS, tunnel chuyển về localhost:5678, cần đặt N8N_WEBHOOK_URL bằng URL tunnel và chỉ chạy khi máy, Docker, tunnel cùng bật; cần nhận webhook 24/7 thì đưa n8n lên VPS có tên miền và HTTPS

Hướng dẫn chi tiết: cài ngrok và tích hợp n8n trên localhost. Khi workflow cần chạy liên tục, đưa n8n lên máy chủ theo hướng dẫn cài đặt n8n trên VPS.

Chuyển workflow từ máy tính lên VPS thế nào?

Xuất workflow ra file JSON (mở workflow, chọn menu ba chấm > Download) rồi nhập vào n8n trên VPS. Credentials được mã hóa bằng khóa riêng của mỗi máy, nên trên máy mới bạn nhập lại credentials, hoặc chuyển cả khóa mã hóa theo Back up and restore. Cách làm bằng lệnh: backup và restore workflow n8n.

Không muốn tự cài: dùng VPS cài sẵn n8n

Nếu bạn cần n8n chạy 24/7 nhưng không muốn tự cài Docker, tên miền và SSL, VPS cài sẵn n8n là lựa chọn ở giữa máy tính và tự cài trên VPS. Khái niệm và cách chọn: VPS n8n là gì.

Muốn chạy n8n 24/7 mà không tự cài? VPS n8n của Tino cài sẵn n8n trên VPS NVMe đặt tại Việt Nam; bạn vẫn có quyền root để cấu hình. Xem cấu hình và giá trên trang sản phẩm.

Chính sách hoàn tiền của Tino: hoàn toàn bộ phí nếu bạn không hài lòng trong 30 ngày đầu (chính sách hoàn tiền).

Câu hỏi thường gặp

Chạy n8n trên máy tính có mất phí không?

n8n bản Community không mất phí bản quyền. Docker Desktop miễn phí cho cá nhân, giáo dục và doanh nghiệp nhỏ theo điều khoản của Docker; tổ chức lớn cần gói trả phí. Chi tiết các gói n8n: n8n có miễn phí không.

Dữ liệu n8n trên máy tính lưu ở đâu?

Chạy bằng Docker thì dữ liệu nằm trong volume n8n_data, xem trong tab Volumes của Docker Desktop. Chạy bằng npx thì nằm trong thư mục .n8n ở thư mục người dùng.

n8n trên máy tính có cần Internet không?

Không bắt buộc với workflow chỉ xử lý dữ liệu trên máy. Workflow gửi email, gọi API hay dùng mô hình AI thì cần Internet.

Có cần Docker Compose khi chạy n8n trên máy tính không?

Không bắt buộc; một lệnh docker run là đủ. Compose có ích khi bạn muốn lưu cấu hình trong file hoặc chạy thêm PostgreSQL.

Báo lỗi "port is already allocated" thì sửa thế nào?

Cổng 5678 đang bị ứng dụng khác dùng. Xóa container vừa tạo bằng docker rm n8n, rồi chạy lại với -p 5679:5678 và mở http://localhost:5679.

Lỗi "permission denied" khi gắn thư mục dữ liệu thì sao?

Lỗi thường gặp khi gắn một thư mục trên Windows thay vì volume. Dùng volume n8n_data như bước 2, hoặc cấp quyền chia sẻ ổ đĩa cho Docker Desktop trong Settings > Resources.

Đông Tùng

Senior Technology Writer

Là cử nhân Quản trị kinh doanh của Trường Đại học Tài chính - Marketing, Tùng bắt đầu làm việc tại Tino Group từ năm 2021 ở vị trí Content Marketing để thỏa mãn niềm đam mê viết lách của bản thân. Sở hữu khả năng sáng tạo đặc biệt, anh cùng đội ngũ của mình đã tạo nên những chiến dịch quảng cáo độc đáo cùng vô số bài viết hữu ích về nhiều chủ đề khác nhau. Sự tỉ mỉ, kiên trì và tinh thần sáng tạo của Tùng đã góp phần lớn vào thành công của Tino Group trong lĩnh vực marketing trực tuyến.

Xem thêm bài viết

Bài viết liên quan

Xem nhiều