Hướng Dẫn Cài n8n Trên VPS Ubuntu: Cần Chuẩn Bị Và Cấu Hình Gì?

Cài n8n trên VPS không chỉ là chạy một dòng lệnh rồi mở trình duyệt. Nếu mục tiêu là dùng thật cho công việc, bạn cần chuẩn bị domain, SSL, dữ liệu đăng nhập, backup, bảo mật và cách xử lý khi workflow lỗi.

Bài này là checklist thực tế trước khi cài n8n trên VPS. Nó giúp bạn tránh các lỗi phổ biến như webhook không nhận dữ liệu, Google OAuth không xác thực được, workflow dừng sau khi reboot VPS hoặc mất cấu hình khi cập nhật.

Nếu bạn đang tìm hướng dẫn cài n8n trên VPS Ubuntu, hãy đọc bài này như phần chuẩn bị trước khi chạy lệnh. Phần quan trọng không chỉ là cài được n8n, mà còn phải biết cấu hình domain, SSL, biến môi trường, backup, workflow JSON, file JSON và credentials JSON để sau này khôi phục hoặc chuyển VPS không bị mất dữ liệu.

Checklist chuẩn bị trước khi cài n8n trên VPS

Muốn cài n8n trên VPS nhưng không muốn tự xử lý domain, SSL, Docker và backup?

Gửi mình nhu cầu dùng n8n, VPS đang có hoặc ngân sách dự kiến. Mình sẽ tư vấn cấu hình phù hợp và các bước cần triển khai.

Liên hệ:

Telegram: @tivmii

Zalo/Số điện thoại: 0975996875

Website: https://congcukiemtienonline.com

1. Xác định mục tiêu trước khi thuê VPS

Trước khi cài, hãy trả lời rõ:

Bạn dùng n8n để học hay chạy workflow thật?
Workflow có cần chạy 24/7 không?
Có cần webhook public không?
Có kết nối Google Sheet, Telegram, email, CRM, website hay AI API không?
Dữ liệu có nhạy cảm không?
Ai sẽ bảo trì khi workflow lỗi?

Nếu chỉ học, bạn có thể dùng máy cá nhân hoặc VPS nhỏ. Nếu chạy thật cho lead, báo cáo, khách hàng hoặc đơn hàng, cần chuẩn bị kỹ hơn.

2. Chọn VPS đủ dùng

Không nên chọn VPS quá yếu nếu bạn định chạy nhiều workflow hoặc xử lý dữ liệu lớn.

Với người mới, VPS Ubuntu là lựa chọn phổ biến vì tài liệu nhiều, dễ cài Docker, dễ cấu hình Nginx/Caddy và dễ tìm hướng dẫn xử lý lỗi. Khi thuê VPS Ubuntu, nên ưu tiên bản LTS, ví dụ Ubuntu 22.04 hoặc 24.04, thay vì bản quá cũ.

Gợi ý ban đầu:

Mức dùng	Cấu hình tham khảo	Phù hợp
Học và test	1 CPU, 1 GB RAM	Workflow nhỏ, ít node
Dùng cá nhân ổn định	1-2 CPU, 2 GB RAM	Webhook, Telegram, Google Sheet
Team nhỏ hoặc nhiều workflow	2 CPU, 4 GB RAM trở lên	Nhiều workflow, AI API, báo cáo định kỳ

Ngoài CPU/RAM, cần để ý dung lượng ổ cứng, vị trí máy chủ, khả năng snapshot và chất lượng nhà cung cấp VPS.

Checklist nhanh cho VPS Ubuntu:

Hệ điều hành Ubuntu LTS.
Có quyền root hoặc user sudo.
Mở được cổng 80 và 443 nếu dùng domain/SSL.
Có snapshot hoặc backup của nhà cung cấp VPS.
Dung lượng ổ cứng đủ cho database, execution log và file upload nếu workflow có xử lý file.

3. Chuẩn bị domain hoặc subdomain

n8n self-host nên có domain riêng, ví dụ:

n8n.tenmiencuaban.com

Domain giúp:

Webhook có URL ổn định.
Google OAuth và nhiều API callback hoạt động đúng.
Dễ gắn SSL.
Dễ bàn giao cho team.

Không nên dùng IP trực tiếp cho môi trường chạy thật vì khó quản lý, khó cấu hình SSL và thiếu chuyên nghiệp khi kết nối với hệ thống bên ngoài.

4. Chuẩn bị SSL

SSL giúp n8n chạy qua HTTPS. Đây gần như là yêu cầu bắt buộc nếu bạn dùng webhook, form, OAuth hoặc API callback.

Nếu không có SSL, bạn có thể gặp lỗi:

Trình duyệt cảnh báo không an toàn.
Google OAuth không cho xác thực.
Webhook bị từ chối bởi một số nền tảng.
Credential dễ bị rủi ro khi thao tác qua mạng.

Thông thường SSL có thể cấu hình qua reverse proxy như Nginx, Caddy hoặc Traefik. Với người không chuyên kỹ thuật, đây là phần dễ sai nhất khi tự cài.

5. Chọn cách cài: Docker hay cài trực tiếp?

Với VPS, Docker thường là lựa chọn dễ quản lý hơn cho n8n.

Ưu điểm của Docker:

Dễ backup volume.
Dễ cập nhật phiên bản.
Dễ chạy kèm database.
Dễ tái tạo môi trường khi chuyển VPS.

Không nên cài theo cách tạm bợ nếu bạn muốn dùng lâu dài. Một workflow hoạt động tốt hôm nay có thể thành vấn đề nếu sau này bạn không biết dữ liệu đang nằm ở đâu, credential lưu ở đâu và backup thế nào.

Với hướng dẫn cài n8n trên VPS Ubuntu, cấu trúc thường gặp là:

Ubuntu VPS -> Docker/Docker Compose -> n8n container -> database/volume -> reverse proxy SSL

Bạn nên lưu lại file cấu hình Docker Compose, biến môi trường và cách khởi động lại dịch vụ. Nếu chỉ copy một lệnh docker run rồi chạy, sau này rất dễ quên volume nằm ở đâu, port nào đang dùng và biến môi trường nào đã cấu hình.

6. Chuẩn bị database và nơi lưu dữ liệu

n8n có thể chạy với SQLite cho môi trường nhỏ, nhưng với môi trường dùng thật nên cân nhắc database rõ ràng hơn, đặc biệt khi workflow tăng lên.

Cần biết:

Workflow được lưu ở đâu?
Credential được mã hóa bằng key nào?
Execution log giữ bao lâu?
Có backup database không?
Khi chuyển VPS có khôi phục được không?

Một lỗi rất phổ biến là cài xong n8n chạy được, nhưng không có kế hoạch backup. Đến khi VPS lỗi hoặc cập nhật hỏng mới phát hiện không khôi phục được workflow.

7. Chuẩn bị workflow JSON, file JSON và credentials JSON

Khi cài n8n trên VPS để dùng thật, bạn nên hiểu rõ 3 loại dữ liệu dễ bị nhầm:

Loại file/dữ liệu	Dùng để làm gì	Lưu ý
Workflow JSON	File export cấu trúc workflow, node, kết nối và setting	Có thể import/export để chuyển workflow
File JSON dữ liệu	Dữ liệu đầu vào/đầu ra mà workflow xử lý	Không phải file cấu hình n8n
Credentials JSON	Dữ liệu credential khi export/import theo cơ chế phù hợp	Cần bảo mật, không public, phụ thuộc encryption key

Workflow JSON giúp bạn lưu lại cấu trúc workflow để backup hoặc chuyển sang môi trường khác. Tuy nhiên, workflow JSON không có nghĩa là toàn bộ credential sẽ dùng được ngay. Credential thường được mã hóa và phụ thuộc vào cấu hình hệ thống, đặc biệt là encryption key.

Trước khi đưa workflow lên VPS mới, nên chuẩn bị:

File workflow JSON đã export từ môi trường cũ nếu có.
Danh sách credential cần tạo lại: Google OAuth, Telegram bot, API key, email SMTP, webhook token.
File JSON dữ liệu mẫu để test workflow sau khi import.
Ghi chú workflow nào dùng credential nào.
Kiểm tra encryption key nếu cần khôi phục credential từ backup.

Không nên gửi workflow JSON hoặc credentials JSON qua chat công khai nếu trong đó có token, URL webhook nội bộ, API key hoặc dữ liệu khách hàng. Với workflow quan trọng, hãy lưu ở nơi riêng tư và có kiểm soát quyền truy cập.

8. Chuẩn bị biến môi trường quan trọng

Khi self-host n8n, một số cấu hình nền tảng cần rõ ngay từ đầu:

Nhóm cấu hình	Vì sao quan trọng
URL public của n8n	Giúp webhook và OAuth tạo callback đúng
Timezone	Giúp lịch chạy báo cáo đúng giờ Việt Nam
Encryption key	Bảo vệ credential và hỗ trợ khôi phục
Database config	Đảm bảo dữ liệu lưu đúng nơi
Execution/log settings	Tránh phình dung lượng ổ cứng
Encryption key	Cần cho việc mã hóa và khôi phục credentials
Nơi lưu file binary	Quan trọng nếu workflow xử lý file upload/download

Nếu cấu hình URL sai, workflow có thể chạy trong giao diện nhưng webhook hoặc OAuth lại lỗi.

9. Chuẩn bị bảo mật tối thiểu

n8n thường chứa credential quan trọng: token Telegram, Google OAuth, API key, webhook URL, dữ liệu khách hàng. Vì vậy cần tối thiểu:

Không public n8n editor bừa bãi.
Bật đăng nhập và mật khẩu mạnh.
Chỉ cấp quyền VPS cho người cần thiết.
Không chia sẻ file cấu hình có credential.
Không public workflow JSON hoặc credentials JSON nếu chưa rà soát dữ liệu nhạy cảm.
Backup có kiểm soát.
Theo dõi log bất thường.

Nếu workflow liên quan dữ liệu khách hàng, hãy xem n8n như một hệ thống vận hành thật, không phải chỉ là công cụ thử nghiệm.

10. Checklist trước khi bấm chạy thật

Trước khi đưa workflow vào vận hành:

Domain đã trỏ đúng về VPS.
SSL hoạt động qua HTTPS.
n8n editor đăng nhập được.
Webhook test nhận dữ liệu từ ngoài.
Timezone đúng.
Backup workflow và credential đã có.
Workflow JSON đã export dự phòng.
File JSON dữ liệu mẫu đã dùng để test import/chạy thử.
Credentials JSON hoặc backup credential được lưu an toàn, không public.
Có cách xem log khi lỗi.
Credential Google/Telegram/API đã test.
Workflow có nhánh xử lý lỗi hoặc thông báo lỗi.
Có tài liệu ngắn mô tả workflow dùng để làm gì.

11. Khi nào nên thuê cài đặt n8n?

Bạn nên cân nhắc thuê hỗ trợ nếu:

Bạn cần n8n chạy 24/7 cho công việc thật.
Bạn không quen Docker, SSL, domain, VPS.
Bạn cần kết nối webhook từ website hoặc chatbot.
Bạn muốn có backup và tài liệu bàn giao.
Bạn cần người kiểm tra workflow trước khi chạy thật.

Tự cài là cách học tốt. Thuê cài đặt là cách giảm rủi ro khi workflow đã ảnh hưởng đến công việc.