Cách cài n8n trên VPS được tài liệu n8n hướng dẫn là chạy bằng Docker Compose: cài Docker Engine và Compose v2, trỏ một tên miền phụ về IP VPS, tạo file .env và compose.yaml, rồi để reverse proxy cấp HTTPS. Bạn cần VPS Ubuntu 24.04 LTS, quyền sudo và khoảng 30 phút.
Hướng dẫn dưới đây viết cho n8n 2.x, bản stable 2.44.5 ngày 21/10/2026 (GitHub n8n-io/n8n). Nếu bạn mới làm quen, đọc trước n8n là gì. Nếu VPS là khái niệm mới, xem VPS là gì.
Cần chuẩn bị gì trước khi cài n8n trên VPS?
Để cài n8n trên VPS, bạn cần bốn thứ: một VPS chạy Ubuntu LTS còn được hỗ trợ, quyền sudo qua SSH, một tên miền phụ như n8n.example.com trỏ về IP VPS và Docker Engine kèm Compose v2. n8n không công bố một mức RAM cố định, vì bộ nhớ tăng theo dữ liệu mỗi lần chạy.
Thành phần Gợi ý Ghi chú VPS 2 vCPU, 4 GB RAM cho cá nhân hoặc nhóm nhỏ Mức tham khảo, không phải yêu cầu của n8n. Cách ước lượng: cấu hình tối thiểu để chạy n8n Hệ điều hành Ubuntu 24.04 LTS Docker hỗ trợ Ubuntu 22.04, 24.04 và 26.04 LTS (Docker Docs) Tên miền Bản ghi A: n8n → IP VPS Cần có trước khi xin chứng chỉ SSL Truy cập SSH bằng tài khoản có sudo Chưa quen SSH: cách kết nối VPS Phần mềm Docker Engine, plugin Compose v2, Caddy hoặc Nginx Cài ở các bước bên dưới 
Shared hosting không đủ điều kiện: n8n cần chạy tiến trình nền liên tục và cần Docker hoặc Node.js. Chi tiết ở bài n8n có chạy được trên hosting không.
Nên cài n8n bằng Docker Compose, npm, VPS cài sẵn hay n8n Cloud?
Docker Compose là cách n8n khuyến nghị để tự host: n8n và các thành phần đi kèm nằm trong container, cập nhật bằng cách đổi tag image. Cài bằng npm vẫn chạy ở n8n 2.x, nhưng n8n 3.0 sắp phát hành không còn hỗ trợ cách này (docs.n8n.io). Hai cách còn lại dành cho người không muốn quản trị máy chủ.
Cách chạy Hợp với ai Bạn tự lo Đọc thêm Docker Compose trên VPS Người quản trị được Linux, cần chạy 24/7 Cài đặt, SSL, cập nhật, sao lưu Bài này npm + pm2 trên VPS Đã có hệ thống chạy npm, chưa chuyển kịp Như trên, thêm Node.js 20.19–24.x Install with npm VPS cài sẵn n8n Muốn máy chủ riêng nhưng không tự cài Workflow, theo dõi phiên bản VPS n8n là gì n8n Cloud Không muốn quản trị máy chủ Workflow; trả phí theo lượt chạy so sánh n8n self-host và n8n Cloud 
Chỉ cần thử n8n trên laptop thì xem cách cài n8n trên máy tính PC bằng Docker Desktop. Phân vân có nên tự host không thì đọc ưu nhược điểm của n8n self-host và chi phí tự host n8n trên VPS.

Vì sao nên chạy n8n trên VPS thay vì máy tính cá nhân?
VPS chạy liên tục và có IP công khai, nên workflow theo lịch không dừng khi bạn tắt máy, còn webhook từ Telegram hay form web gọi vào được. Bạn có quyền root để cài Docker, chọn database, đặt tường lửa và tự sao lưu. Khi workflow nhiều lên, bạn nâng RAM, CPU mà không phải cài lại.
Các bước cài n8n trên VPS bằng Docker Compose
Quy trình gồm 8 bước, theo trang Use Docker Compose của n8n (docs.n8n.io): trỏ tên miền, cài Docker, mở tường lửa, tạo file cấu hình, khởi động n8n, cài reverse proxy lấy HTTPS, rồi tạo tài khoản owner. Ví dụ dùng tên miền n8n.example.com; thay bằng tên miền của bạn.

Bước 1: Trỏ tên miền phụ về IP VPS
Tại nơi quản lý DNS, tạo bản ghi A tên n8n trỏ về IP VPS. Kiểm tra bằng lệnh dưới đây; kết quả phải là IP VPS của bạn. DNS có thể mất vài phút đến vài giờ để cập nhật.
dig +short n8n.example.com
Bước 2: Cài Docker Engine và Docker Compose v2
Cài Docker từ kho chính thức của Docker, không dùng gói docker.io cũ của Ubuntu. Các lệnh dưới đây chép từ hướng dẫn cài Docker trên Ubuntu (truy cập 22/10/2026). Compose v2 là plugin, gọi bằng docker compose (có dấu cách).
# Thêm khóa GPG và kho apt của Docker
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
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt update
# Cài Docker Engine và plugin Compose v2
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
# Kiểm tra
docker --version
docker compose version
Bước 3: Mở tường lửa cho SSH, HTTP và HTTPS
Mở cổng SSH trước rồi mới bật UFW, nếu không bạn có thể tự khóa mình ngoài VPS. Không mở cổng 5678: n8n chỉ nhận kết nối qua reverse proxy.
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status
Lưu ý: cổng Docker publish ra mọi địa chỉ (ví dụ "5678:5678") vẫn truy cập được từ Internet dù UFW chặn, vì Docker tự thêm luật tường lửa trước UFW (Docker Docs, Docker and ufw). Vì vậy file compose ở bước 5 gắn cổng vào 127.0.0.1.
Bước 4: Tạo thư mục dự án và file .env
File .env giữ tên miền, múi giờ và khóa mã hóa. n8n dùng khóa này để mã hóa credentials trong database (Set a custom encryption key). Tự đặt khóa giúp bạn khôi phục được credentials khi chuyển máy chủ; chép khóa ra nơi an toàn ngoài VPS.
mkdir -p ~/n8n-compose/local-files
cd ~/n8n-compose
sudo chown 1000:1000 local-files
cat > .env <<'EOF'
N8N_DOMAIN=n8n.example.com
GENERIC_TIMEZONE=Asia/Ho_Chi_Minh
EOF
echo "N8N_ENCRYPTION_KEY=$(openssl rand -hex 32)" >> .env
chmod 600 .env
cat .env
Thư mục local-files là nơi node Read/Write Files được phép đọc ghi. Từ n8n 2.0, các node này chỉ truy cập thư mục được cho phép, nên file compose đặt N8N_RESTRICT_FILE_ACCESS_TO=/files. Lệnh chown 1000:1000 trao quyền cho user node trong container.
Bước 5: Tạo file compose.yaml
File dưới đây rút từ mẫu của n8n, bỏ Traefik vì dùng Caddy hoặc Nginx ở bước 7. Không có dòng version: vì Compose v2 không cần. Ghim phiên bản cụ thể thay vì latest; từ n8n 2.0, n8n khuyên ghim phiên bản (v2.0 breaking changes).
services:
n8n:
image: n8nio/n8n:2.44.5
restart: unless-stopped
ports:
- "127.0.0.1:5678:5678"
environment:
- N8N_HOST=${N8N_DOMAIN}
- N8N_PORT=5678
- N8N_PROTOCOL=https
- N8N_WEBHOOK_URL=https://${N8N_DOMAIN}/
- N8N_PROXY_HOPS=1
- N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
- N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
- N8N_RESTRICT_FILE_ACCESS_TO=/files
- NODE_ENV=production
- GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
- TZ=${GENERIC_TIMEZONE}
volumes:
- n8n_data:/home/node/.n8n
- ./local-files:/files
volumes:
n8n_data:
| Biến | Tác dụng |
|---|---|
N8N_WEBHOOK_URL | URL gốc của webhook khi chạy sau reverse proxy. Có từ n8n 2.30.0; biến cũ WEBHOOK_URL bị deprecated từ 2.35.0, vẫn chạy nhưng n8n ghi cảnh báo (Endpoints) |
N8N_PROXY_HOPS=1 | Báo n8n có một proxy đứng trước, để đọc đúng IP và giao thức từ header X-Forwarded (Configure webhook URLs with reverse proxy) |
N8N_ENCRYPTION_KEY | Khóa mã hóa credentials. Đặt một lần, không đổi về sau |
127.0.0.1:5678:5678 | Chỉ reverse proxy trên chính VPS gọi được n8n |
GENERIC_TIMEZONE, TZ | Múi giờ cho Schedule Trigger và cho lệnh trong container |
Bản cũ của bài này dùng nhóm biến Basic Auth để đặt mật khẩu. Nhóm biến đó đã bị gỡ từ n8n 1.0; nay n8n bắt buộc tạo tài khoản owner ở lần mở đầu tiên.
Bước 6: Khởi động n8n và kiểm tra
Chạy lệnh docker compose config trước để Compose báo lỗi cú pháp nếu có, rồi khởi động. Khi log hiện dòng “Editor is now accessible via”, n8n đã chạy.
cd ~/n8n-compose
docker compose config --quiet && echo "compose.yaml hợp lệ"
docker compose up -d
docker compose ps
docker compose logs -f n8n # Ctrl + C để thoát
curl -I http://127.0.0.1:5678

Bước 7: Cài Caddy để có HTTPS
Caddy tự xin và gia hạn chứng chỉ Let’s Encrypt khi biết tên miền, và tự gửi các header X-Forwarded-For, X-Forwarded-Host, X-Forwarded-Proto mà n8n cần. Lệnh cài theo trang cài đặt của Caddy.
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 chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install -y caddy
Thay toàn bộ nội dung /etc/caddy/Caddyfile bằng hai dòng sau, rồi nạp lại Caddy:
n8n.example.com {
reverse_proxy 127.0.0.1:5678
}
sudo caddy validate --config /etc/caddy/Caddyfile
sudo systemctl reload caddy
Bước 8: Mở n8n và tạo tài khoản owner
Truy cập https://n8n.example.com, tạo tài khoản owner bằng email và mật khẩu mạnh. Sau đó bật xác thực hai lớp cho tài khoản này. Thêm người dùng và phân quyền xem cách thêm, xóa và phân quyền user trong n8n. Workflow đầu tiên: cách tạo workflow n8n cơ bản.
Dùng Nginx và Certbot thay cho Caddy được không?
Nginx và Certbot dùng được thay Caddy, phù hợp khi VPS đã chạy Nginx cho website khác. Khác biệt là Nginx không tự gửi header X-Forwarded và không tự xin chứng chỉ, nên bạn phải khai báo đủ header rồi chạy Certbot. Cấu hình chi tiết có ở bài cấu hình Nginx reverse proxy và SSL cho n8n.
server {
listen 80;
server_name n8n.example.com;
client_max_body_size 16m;
location / {
proxy_pass http://127.0.0.1:5678;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_buffering off;
}
}
Lưu file vào /etc/nginx/sites-available/n8n, bật site, kiểm tra cú pháp, rồi xin chứng chỉ theo hướng dẫn của Certbot. client_max_body_size 16m khớp giới hạn payload mặc định 16 MB của n8n. Hai dòng Upgrade, Connection giữ kết nối WebSocket cho trình soạn workflow.
sudo ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/local/bin/certbot
sudo certbot --nginx -d n8n.example.com
Trên VPS chưa có web server nào, Caddy gọn hơn. Cách cấp SSL nói chung: cài SSL trên VPS.
Khi nào nên dùng PostgreSQL thay cho SQLite?
n8n mặc định lưu dữ liệu bằng SQLite trong volume n8n_data, đủ cho cá nhân và nhóm nhỏ. Nên chọn PostgreSQL khi lượt chạy nhiều, lịch sử chạy lớn hoặc định bật queue mode. n8n hỗ trợ PostgreSQL 16, 17 và 18 tính đến 07/2026; MySQL và MariaDB không còn được hỗ trợ làm database từ 2.0 (Choose n8n’s database).
Nên chọn database ngay lúc cài. Đổi về sau không tự chuyển dữ liệu: bạn phải xuất bằng n8n export:entities rồi nhập lại. Thêm vào .env:
POSTGRES_USER=n8n
POSTGRES_PASSWORD=doi-mat-khau-manh
POSTGRES_DB=n8n
Rồi dùng file compose.yaml sau. Phần n8n giữ nguyên các biến ở bước 5, chỉ thêm nhóm biến DB_* và depends_on:
services:
postgres:
image: postgres:17
restart: unless-stopped
environment:
- POSTGRES_USER=${POSTGRES_USER}
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
- POSTGRES_DB=${POSTGRES_DB}
volumes:
- db_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
interval: 10s
timeout: 5s
retries: 5
n8n:
image: n8nio/n8n:2.44.5
restart: unless-stopped
ports:
- "127.0.0.1:5678:5678"
environment:
- DB_TYPE=postgresdb
- DB_POSTGRESDB_HOST=postgres
- DB_POSTGRESDB_PORT=5432
- DB_POSTGRESDB_DATABASE=${POSTGRES_DB}
- DB_POSTGRESDB_USER=${POSTGRES_USER}
- DB_POSTGRESDB_PASSWORD=${POSTGRES_PASSWORD}
- N8N_HOST=${N8N_DOMAIN}
- N8N_PORT=5678
- N8N_PROTOCOL=https
- N8N_WEBHOOK_URL=https://${N8N_DOMAIN}/
- N8N_PROXY_HOPS=1
- N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
- N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
- N8N_RESTRICT_FILE_ACCESS_TO=/files
- NODE_ENV=production
- GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
- TZ=${GENERIC_TIMEZONE}
volumes:
- n8n_data:/home/node/.n8n
- ./local-files:/files
depends_on:
postgres:
condition: service_healthy
volumes:
n8n_data:
db_data:
Image postgres:17 lưu dữ liệu ở /var/lib/postgresql/data. Bản 18 đổi đường dẫn này, nên đọc ghi chú của image trước khi dùng. Chuyển một n8n đang chạy SQLite sang PostgreSQL: đổi database n8n từ SQLite sang PostgreSQL. Queue mode và tinh chỉnh hiệu năng: kinh nghiệm tối ưu hiệu suất self-host n8n.
Sao lưu và cập nhật n8n sau khi cài thế nào?
Bản sao lưu n8n đầy đủ gồm volume n8n_data (chứa khóa mã hóa và file SQLite), database PostgreSQL nếu có, và file .env. Lệnh export của n8n chỉ lấy workflow và credentials, không thay được bản sao lưu đầy đủ (Back up and restore). Mọi bản sao phải được chép ra ngoài VPS.

Với SQLite, dừng n8n trước khi nén volume để file database không bị chép dở. Tên volume do Compose đặt theo tên thư mục, kiểm bằng docker volume ls:
cd ~/n8n-compose
docker compose stop n8n
docker run --rm -v n8n-compose_n8n_data:/data -v "$PWD":/backup alpine \
tar czf /backup/n8n_data-$(date +%F).tar.gz -C /data .
docker compose start n8n
# Nếu dùng PostgreSQL
docker compose exec -T postgres pg_dump -U n8n -d n8n > n8n-db-$(date +%F).sql
Quy trình đầy đủ, kèm khôi phục: cách backup và restore workflow n8n. Cập nhật n8n cài bằng Compose gồm: sao lưu, đổi tag image trong compose.yaml, rồi chạy ba lệnh dưới.
docker compose pull
docker compose down
docker compose up -d
Trước khi lên bản lớn, đọc thay đổi trong release notes. n8n khuyên cập nhật tối thiểu mỗi tháng một lần để không phải nhảy nhiều phiên bản. Các lưu ý khi từ 1.x lên 2.x và khi sắp lên 3.0 nằm ở cách cập nhật n8n.
Cần làm gì để n8n tự host an toàn hơn?
n8n tự host an toàn hơn khi chỉ lộ cổng 80 và 443 qua reverse proxy, chạy bản được vá thường xuyên và giữ khóa mã hóa ngoài VPS. n8n 2.0 đã bật sẵn vài lớp bảo vệ: chặn Code node đọc biến môi trường, tắt node Execute Command và Local File Trigger (v2.0 breaking changes).
- Đăng nhập SSH bằng khóa, tắt đăng nhập mật khẩu; xem thêm cách bảo mật VPS.
- Không đổi cổng về dạng
"5678:5678"; giữ127.0.0.1. - Bật xác thực hai lớp cho owner, không dùng chung tài khoản.
- Lưu API key trong mục Credentials, không ghi thẳng vào node Code; xem bảo mật credentials và API key trong n8n.
- Chỉ bật lại Execute Command (qua biến
NODES_EXCLUDE) khi thật cần và đã giới hạn người dùng.
Lỗi thường gặp khi cài n8n trên VPS và cách sửa
Phần lớn lỗi khi cài n8n trên VPS nằm ở ba chỗ: quyền thư mục, cấu hình URL sau reverse proxy và tên miền chưa trỏ đúng. Đọc log trước khi sửa: docker compose logs --tail=100 n8n.
Container khởi động lại liên tục, log báo “permission denied”
Thư mục gắn vào container không thuộc user 1000. Chạy sudo chown -R 1000:1000 ./local-files rồi docker compose up -d. Lệnh docker compose up không có tùy chọn đổi user; đừng chạy container bằng root để né lỗi.
URL webhook trong n8n hiện localhost:5678
Thiếu N8N_WEBHOOK_URL hoặc đặt sai. Sửa trong compose.yaml thành https://n8n.example.com/, chạy docker compose up -d để tạo lại container. Nếu log báo WEBHOOK_URL deprecated, đổi tên biến sang N8N_WEBHOOK_URL.
Trình duyệt báo 502 Bad Gateway
Reverse proxy chạy nhưng n8n chưa sẵn sàng hoặc đã dừng. Kiểm tra docker compose ps và curl -I http://127.0.0.1:5678. Nếu container thoát vì thiếu RAM, xem tối ưu RAM và CPU cho n8n Docker.
Caddy hoặc Certbot không cấp được chứng chỉ
Bản ghi A chưa trỏ về IP VPS, hoặc cổng 80 bị chặn. Kiểm tra lại bằng dig +short n8n.example.com và sudo ufw status. Lỗi khi workflow gọi API bên ngoài là chuyện khác, xem lỗi kết nối API thường gặp trong n8n.
Khi nào nên dùng VPS cài sẵn n8n thay vì tự cài?
VPS cài sẵn n8n hợp với người cần n8n chạy trên máy chủ riêng nhưng không muốn tự làm 8 bước ở trên, hoặc không có người trực khi máy chủ lỗi. Bạn vẫn phải tự lo workflow, theo dõi phiên bản và sao lưu dữ liệu quan trọng. Khái niệm và cách chọn: VPS n8n là gì.

Đã có VPS cài sẵn n8n của Tino, xem cách đăng nhập và cấu hình VPS n8n.
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.
Sau khi cài xong, đọc tiếp gì?
Các bài dưới đây đi tiếp từng việc vận hành n8n tự host, theo thứ tự thường gặp:
- Cấu hình VPS tối thiểu cho n8n và tối ưu RAM, CPU cho n8n Docker
- Nginx reverse proxy và SSL cho n8n, chạy nhiều instance n8n trên một VPS
- Backup và restore workflow n8n, cập nhật n8n
- Đổi SQLite sang PostgreSQL, tối ưu hiệu suất self-host
- Thử webhook trên máy tính bằng ngrok, đăng ký tài khoản n8n Cloud
Câu hỏi thường gặp
n8n có miễn phí không?
Bản Community tự host không mất phí bản quyền; bạn trả tiền VPS và tự quản trị. n8n Cloud chỉ có bản dùng thử, sau đó trả phí theo gói. So sánh chi tiết ở bài n8n có miễn phí không và ưu nhược điểm self-host.
VPS cần bao nhiêu RAM để chạy n8n?
n8n không công bố mức cố định; RAM phụ thuộc dữ liệu mỗi lần chạy, node Code và số workflow chạy cùng lúc. Cách ước lượng theo nhu cầu có ở bài cấu hình tối thiểu.
Có chạy n8n trên shared hosting được không?
Thường là không, vì shared hosting không cho chạy tiến trình nền và không có Docker. Các trường hợp ngoại lệ và lý do có ở bài n8n có chạy được trên hosting không.
Muốn thử webhook trước khi lên VPS thì làm sao?
Chạy n8n trên máy tính rồi dùng ngrok hoặc Cloudflare Tunnel để có URL công khai tạm thời. Lệnh tunnel tích hợp cũ của n8n đã bị gỡ ở 2.0. Hướng dẫn: cài ngrok và tích hợp n8n trên localhost.
Một VPS chạy được nhiều n8n không?
Được, mỗi instance cần thư mục, volume, cổng nội bộ và tên miền phụ riêng, cùng đi qua một reverse proxy. Cách làm ở bài chạy nhiều instance n8n trên cùng VPS.
