Home Ghiền WebQuản Trị Máy ChủCài n8n trên VPS bằng Docker từ A-Z (tự host, miễn phí)
Cài n8n trên VPS bằng Docker từ A-Z (tự host, miễn phí)

Cài n8n trên VPS bằng Docker từ A-Z (tự host, miễn phí)

Dai Hoang
0 comments 7 views

Cài n8n trên VPS bằng Docker từ A-Z (tự host, miễn phí)

Tôi đã từng trả phí cho bản cloud của n8n một thời gian, rồi quyết định tự host trên VPS. Lý do rất thực tế: workflow của tôi chạy nhiều dần, tiền thuê bao cứ tăng theo số lần chạy, trong khi một con VPS vài đô một tháng là đủ gánh. Bài này ghi lại đúng cách tôi đang chạy n8n trên VPS Ubuntu bằng Docker Compose — từ lúc VPS còn trắng tinh tới khi mở được giao diện n8n trên domain riêng có HTTPS, kèm mấy lỗi tôi đã tự vấp phải để bạn khỏi vấp lại.

Nói trước một câu cho rõ: tự host n8n là miễn phí thật, nhưng không phải là “không tốn gì”. Bạn đổi tiền thuê bao lấy công chăm sóc server: cập nhật, sao lưu, vá lỗi. Nếu bạn chỉ có hai ba workflow chạy chơi, bản cloud dùng thử có khi tiện hơn. Còn nếu bạn xác định gắn bó lâu dài với tự động hóa, tự host là lựa chọn đáng tiền nhất.

VPS nào chạy được n8n?

Tôi từng thử nhét n8n lên con VPS 1 GB RAM vì tiếc tiền, và kết quả là cứ vài hôm nó lại treo một lần, workflow chạy dở thì đứng hình. Sau này đọc kỹ tài liệu chính thức của n8n mới thấy họ ghi rõ: bản cài đặt Docker Compose đầy đủ cần tối thiểu 4 GB RAM và 2 vCPU, vì nó còn kéo theo bộ sandbox chạy code của trợ lý AI. Con số này tôi kiểm tra lại trên docs.n8n.io ngày 16/11/2026, vẫn còn nguyên.

Tuy vậy, 4 GB không phải là luật sắt. Nếu bạn chỉ cài n8n + Postgres gọn nhẹ, không bật sandbox của trợ lý AI, thì VPS 2 GB RAM, 2 vCPU vẫn chạy ổn cho nhu cầu cá nhân và nhóm nhỏ. Dưới mức đó thì đừng cố, n8n chạy được nhưng cứ chập chờn, mất công sửa hơn cả tiền tiết kiệm được.

Về hệ điều hành, tôi chọn Ubuntu 22.04 hoặc 24.04 LTS cho chắc ăn, vì tài liệu Docker viết cho Ubuntu là đầy đủ nhất. Nếu bạn chưa quen chọn hệ điều hành cho VPS, bài tổng hợp các hệ điều hành và nền tảng ảo hóa VPS phổ biến trên Ghiền sẽ giúp bạn cân nhắc. Ngoài VPS, bạn cần chuẩn bị một domain hoặc subdomain riêng cho n8n, ví dụ n8n.ten-mien-cua-ban.com, và trỏ bản ghi A của nó về IP của VPS trước khi bắt đầu. Cuối cùng, nhớ mở port 22 (SSH), 80 và 443 trên firewall của VPS.

Cài Docker lên VPS trước đã

Mọi thứ dưới đây đều chạy trên Docker, nên việc đầu tiên là cài Docker Engine và plugin Docker Compose v2. Tôi dùng cách cài từ kho chính thức của Docker, đừng cài bản docker.io trong kho mặc định của Ubuntu vì nó thường cũ hơn vài phiên bản.

sudo apt update && sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Cài xong thì kiểm tra nhanh hai lệnh này. Cả hai đều phải trả về số phiên bản, nếu lệnh thứ hai báo không tìm thấy thì plugin Compose chưa được cài đúng.

docker --version
docker compose version

Chạy thử nhanh trong hai phút, chỉ để biết mặt n8n

Trước khi dựng bản nghiêm túc, tôi hay chạy thử n8n bằng một lệnh duy nhất để xem giao diện của nó trông thế nào. Cách này chỉ để test, đừng dùng làm bản chạy thật vì dữ liệu lưu trong đó rất dễ mất.

docker volume create n8n_data
docker run -d --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n n8nio/n8n

Mở trình duyệt tới http://IP-cua-VPS:5678, tạo tài khoản quản trị (owner account) là bạn đã vào được giao diện kéo thả workflow. Nếu bạn chưa biết n8n là gì và nó làm được những việc nào, bài giới thiệu n8n từ A-Z cho người mới sẽ giúp bạn hình dung trước khi đầu tư thời gian dựng server. Xong bước test này thì dừng container lại, vì phần dưới đây mới là cách tôi chạy n8n thật.

docker stop n8n && docker rm n8n

Bản cài đặt nghiêm túc: Docker Compose với Postgres

Đây là phần chính của bài. Tôi chọn Docker Compose thay vì lệnh docker run dài ngoằng, vì toàn bộ cấu hình nằm gọn trong một file, lần sau cần sửa hay dời sang VPS khác chỉ việc copy file đi. Tôi cũng dùng Postgres thay cho SQLite mặc định, vì tài liệu n8n khuyên dùng Postgres cho bản chạy lâu dài, nhiều workflow chạy suốt ngày đêm.

Màn hình terminal cài đặt n8n bằng Docker trên VPS trong phòng máy chủ

Tạo một thư mục riêng cho n8n, rồi tạo file compose.yml bên trong:

mkdir ~/n8n && cd ~/n8n

Nội dung file compose.yml tôi đang dùng, bạn thay các chỗ mật khẩu và domain bằng giá trị của mình:

services:
  postgres:
    image: postgres:18
    restart: always
    environment:
      POSTGRES_USER: n8n
      POSTGRES_PASSWORD: doi-mat-khau-manh-o-day
      POSTGRES_DB: n8n
      PGDATA: /var/lib/postgresql/data
    volumes:
      - db-storage:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U n8n -d n8n"]
      interval: 5s
      timeout: 5s
      retries: 10

  n8n:
    image: n8nio/n8n:latest
    restart: always
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=doi-mat-khau-manh-o-day
      - N8N_HOST=n8n.ten-mien-cua-ban.com
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - N8N_WEBHOOK_URL=https://n8n.ten-mien-cua-ban.com/
      - N8N_ENCRYPTION_KEY=tao-mot-chuoi-ngau-nhien-dai-o-day
      - GENERIC_TIMEZONE=Asia/Ho_Chi_Minh
      - TZ=Asia/Ho_Chi_Minh
    ports:
      - "127.0.0.1:5678:5678"
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      postgres:
        condition: service_healthy

volumes:
  n8n_data:
  db-storage:

Có vài điểm trong file này đáng giải thích kỹ, vì tôi từng làm sai đúng ở những chỗ đó. Thứ nhất, N8N_ENCRYPTION_KEY phải tự đặt trước lần chạy đầu tiên, bằng một chuỗi ngẫu nhiên dài. Lệnh tạo nhanh là openssl rand -base64 32. Khóa này dùng để mã hóa toàn bộ thông tin đăng nhập (credential) lưu trong n8n. Mất nó coi như mất hết credential, phải nhập lại từ đầu, nên tôi lưu nó vào trình quản lý mật khẩu ngay sau khi tạo.

Thứ hai, Postgres 18 đổi thư mục dữ liệu mặc định, nên bắt buộc phải có dòng PGDATA như trên. Thiếu dòng này thì Postgres 18 ghi dữ liệu ra chỗ khác, volume không bao phủ tới, và database của bạn sẽ trống rỗng sau mỗi lần khởi động lại. Đây là lưu ý chính thức trong tài liệu n8n, tôi kiểm tra lại ngày 16/11/2026.

Thứ ba, tôi chỉ cho n8n nghe trên 127.0.0.1:5678, tức là chỉ truy cập được từ trong VPS, không phơi thẳng ra internet. Phần domain và HTTPS ở mục sau sẽ do Caddy đứng trước làm reverse proxy. Cách này an toàn hơn hẳn việc mở port 5678 cho cả thế giới vào.

Một lưu ý về phiên bản: n8n ra bản mới gần như mỗi tuần, image n8nio/n8n:latest luôn trỏ tới bản mới nhất. Tôi dùng latest cho tiện, nhưng nếu bạn cần ổn định tuyệt đối thì nên ghim số phiên bản cụ thể, ví dụ n8nio/n8n:2.45.0, rồi chủ động nâng cấp khi rảnh. Ngoài ra, từ n8n 2.x, tài liệu chính thức còn có thêm container n8n-runner chạy riêng phần thực thi code, và biến WEBHOOK_URL cũ đã bị deprecated từ bản 2.35.0, thay bằng N8N_WEBHOOK_URL như trong file trên. Nếu bạn đọc phải hướng dẫn cũ dùng WEBHOOK_URL thì cứ đổi sang tên mới là xong. File mẫu đầy đủ chuẩn production của n8n nằm ở kho n8n-hosting trên GitHub, đáng để đối chiếu khi bạn muốn nâng cấp cấu hình.

Xong file thì khởi động:

docker compose up -d
docker compose ps
docker compose logs -f n8n

Chờ tới khi log báo n8n đã sẵn sàng, kiểm tra nhanh bằng lệnh curl -sf http://localhost:5678/healthz. Trả về 200 là n8n đã chạy, chỉ còn thiếu domain và HTTPS.

Gắn domain và HTTPS bằng Caddy

Tôi chọn Caddy làm reverse proxy vì nó tự xin và gia hạn chứng chỉ Let’s Encrypt, không phải gõ thêm lệnh certbot nào. Cài Caddy từ kho chính thức của họ:

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy

Sau đó sửa file /etc/caddy/Caddyfile, thêm đúng hai dòng này với domain của bạn:

n8n.ten-mien-cua-ban.com {
    reverse_proxy 127.0.0.1:5678
}

Chạy sudo systemctl reload caddy rồi mở https://n8n.ten-mien-cua-ban.com trên trình duyệt. Lần đầu vào, n8n sẽ hỏi tạo tài khoản quản trị, cứ làm theo hướng dẫn trên màn hình. Tới đây là bạn đã có n8n chạy trên domain riêng, có HTTPS đàng hoàng, không tốn đồng nào ngoài tiền VPS và tiền domain.

Một chi tiết nhỏ nhưng rất hay bị quên: biến N8N_WEBHOOK_URL trong file compose phải khớp đúng domain này, có https:// ở đầu và dấu / ở cuối. Webhook URL là địa chỉ n8n đưa cho các dịch vụ bên ngoài gọi ngược vào workflow của bạn, nên chỉ cần sai một ký tự là webhook im luôn, không báo lỗi gì rõ ràng. Tôi sẽ kể kỹ hơn ở mục lỗi bên dưới.

Những lỗi tôi từng gặp khi cài n8n

Phần này tôi viết riêng, vì đọc mười bài hướng dẫn cài đặt thì hết chín bài chỉ ghi các bước đúng, còn lỗi thì phải tự vấp mới biết. Dưới đây là những lần tôi vấp thật.

Cài đặt n8n trên VPS bằng Docker — gõ lệnh cấu hình trên laptop

Mất sạch workflow vì không gắn volume. Lần đầu tiên tôi chạy n8n bằng lệnh docker run không có tham số -v. Mọi thứ chạy ngon lành cả tuần, tới hôm cập nhật image thì container cũ bị xóa, dữ liệu bay theo. Từ đó tôi luôn gắn volume n8n_data vào /home/node/.n8n, và nhớ kỹ một câu thần chú: đừng bao giờ chạy docker compose down -v trên bản đang chạy thật, vì cờ -v xóa luôn volume chứa dữ liệu.

Webhook không chạy sau khi gắn proxy. Có lần tôi đổi từ chạy thẳng bằng IP sang domain có HTTPS, mọi workflow vẫn chạy tay bình thường nhưng webhook thì chết lặng. Nguyên nhân là N8N_WEBHOOK_URL còn trỏ về địa chỉ IP cũ, trong khi tôi đã quên sửa. Sửa lại thành https://domain-cua-ban/ rồi khởi động lại container là webhook chạy lại ngay. Nếu webhook của bạn tự nhiên im bặt sau khi đổi domain hay đổi proxy, kiểm tra biến này đầu tiên.

Quên đặt N8N_ENCRYPTION_KEY trước lần chạy đầu. n8n sẽ tự sinh khóa mã hóa nếu bạn không đặt, và khóa đó nằm trong volume. Nghe thì tiện, nhưng tới lúc bạn dời n8n sang VPS khác mà quên mang theo volume cũ thì toàn bộ credential đã lưu không giải mã được nữa. Tôi phải nhập lại từng tài khoản Google Sheets, Telegram, Gmail một. Giờ thì tôi luôn đặt khóa ngay từ đầu và lưu nó ở nơi an toàn.

Postgres 18 khởi động rồi mà database trống. Lỗi này tôi kể ở trên rồi: thiếu dòng PGDATA. Triệu chứng rất khó chịu, container postgres chạy xanh lè, n8n cũng chạy, nhưng dữ liệu không lưu bền. Thêm PGDATA vào là xong.

Múi giờ lệch, workflow chạy sai giờ. n8n mặc định chạy theo giờ UTC. Workflow hẹn gửi báo cáo 8 giờ sáng mà cứ 15 giờ chiều mới chạy, chỉ vì tôi quên đặt GENERIC_TIMEZONE=Asia/Ho_Chi_Minh. Nếu workflow của bạn liên quan tới lịch hẹn, gửi tin nhắn theo giờ Việt Nam, nhớ đặt biến này ngay từ đầu.

Để n8n phơi trần ra internet. Hồi mới làm, tôi mở port 5678 cho cả thế giới chỉ để tiện truy cập. Vài ngày sau log đã đầy những lần đăng nhập thử từ các IP lạ. Từ đó tôi chỉ cho n8n nghe trên 127.0.0.1, mọi truy cập đi qua Caddy, và tài khoản quản trị thì đặt mật khẩu dài kèm xác thực hai lớp nếu có thể. N8n mà bị chiếm thì kẻ xấu chạy được workflow với toàn bộ credential của bạn, nên đừng coi nhẹ chuyện này.

Checklist trước khi giao workflow thật cho n8n

Cài chạy được mới là một nửa chặng đường. Trước khi bạn giao cho n8n những workflow quan trọng — gửi email cho khách, đồng bộ đơn hàng, sao lưu dữ liệu — hãy rà lại checklist này một lượt:

  • Volume n8n_data và db-storage đã được gắn đúng, dữ liệu còn nguyên sau một lần docker compose down rồi up -d lại.
  • N8N_ENCRYPTION_KEY đã lưu ở nơi an toàn, ngoài VPS.
  • Port 5678 chỉ nghe trên 127.0.0.1, firewall chỉ mở 22, 80, 443.
  • Webhook test chạy được qua domain HTTPS, không phải qua IP.
  • Múi giờ Asia/Ho_Chi_Minh đã đặt, workflow chạy thử đúng giờ hẹn.
  • Có lịch sao lưu: xuất workflow ra file JSON định kỳ, và sao lưu database Postgres bằng lệnh docker compose exec postgres pg_dump -U n8n n8n > backup.sql.
  • Biết cách cập nhật: docker compose pull && docker compose down && docker compose up -d, và không bao giờ thêm cờ -v vào lệnh đó.

Nếu bạn muốn dựng theo đúng file mẫu chính thức thay vì bản gọn nhẹ trong bài này, tài liệu cài đặt Docker Compose của n8n là nơi nên đối chiếu cuối cùng, vì n8n đổi hướng dẫn khá thường xuyên. Tôi đã kiểm tra lại toàn bộ số liệu và lệnh trong bài này theo tài liệu đó ngày 16/11/2026, nhưng nếu bạn đọc bài này muộn hơn vài tháng thì cứ mở tài liệu gốc ra đối chiếu một lượt cho chắc.

Về chi phí, phép tính của tôi thế này: một VPS 2 GB RAM khoảng 6 đô một tháng là đủ cho n8n cá nhân, rẻ hơn hẳn thuê bao cloud khi workflow chạy nhiều. Đổi lại, bạn phải tự lo sao lưu và cập nhật. Với tôi, cái giá đó xứng đáng, vì workflow chạy trên server của mình thì không lo bị giới hạn số lần chạy hay tăng giá bất ngờ. Còn bạn, nếu đã cài xong thì workflow đầu tiên bạn định tự động hóa là gì?

Cùng chuyên mục

Theo dõi
Thông báo của
guest
0 Góp ý
Phản hồi nội tuyến
Xem tất cả bình luận