Cấu hình Queue Mode n8n trên VPS là một bước quan trọng giúp tối ưu hiệu suất xử lý workflow, đặc biệt trong môi trường có khối lượng tác vụ lớn hoặc cần mở rộng quy mô. Trong bài viết này, bạn sẽ được hướng dẫn chi tiết cách kích hoạt và triển khai chế độ queue cho n8n trên VPS, từ việc chuẩn bị môi trường đến cấu hình Redis và Worker.
Những điểm chính
- Nắm rõ yêu cầu tiên quyết: Để kích hoạt Queue Mode: Redis, Docker, cấu hình VPS phù hợp.
- Biết cách cấu hình các biến môi trường: Quan trọng như
QUEUE_MODE
,EXECUTIONS_MODE
,REDIS_HOST
, v.v. - Triển khai Queue Mode bằng Docker Compose: Từ tạo file
docker-compose.yml
đến khởi chạy hệ thống. - Biết đến dịch vụ VPS Vietnix là một giải pháp mạnh mẽ cho tự động hóa chuyên sâu.
Yêu cầu tiên quyết
- Một n8n instance đang chạy Docker.
- Một Redis server đã được cài đặt và có thể truy cập được từ các tiến trình n8n.
- Một cơ sở dữ liệu dùng chung (khuyến nghị PostgreSQL) đã được cài đặt và có thể truy cập được. SQLite không được hỗ trợ cho Queue Mode phân tán.
- Quen thuộc với việc chỉnh sửa file
docker-compose.yml
. - Thời gian thực hiện: 15-45 phút (tùy thuộc vào hạ tầng hiện có).
Cách cấu hình queue mode n8n trên VPS
Các biến môi trường chính cho Queue Mode
Việc cấu hình Queue Mode chủ yếu được thực hiện thông qua các biến môi trường. Dưới đây là những biến quan trọng bạn cần thiết lập cho tất cả các tiến trình n8n (main, worker, webhook):
- Kích hoạt Queue Mode:
- EXECUTIONS_MODE=queue
- Đây là biến chính để bật chế độ hàng đợi.
- Kết nối Redis:
- QUEUE_BULL_REDIS_HOST: Địa chỉ host của Redis server (ví dụ: localhost, redis_service_name nếu trong Docker Compose, hoặc IP/domain).
- QUEUE_BULL_REDIS_PORT: Port của Redis (mặc định: 6379).
- QUEUE_BULL_REDIS_PASSWORD: Mật khẩu Redis (nếu có).
- QUEUE_BULL_REDIS_DB: Database Redis để sử dụng (mặc định: 0).
- Kết nối Cơ sở dữ liệu (Ví dụ với PostgreSQL):
- DB_TYPE=postgresdb
- DB_POSTGRESDB_HOST: Địa chỉ host của PostgreSQL server.
- DB_POSTGRESDB_PORT: Port của PostgreSQL (mặc định: 5432).
- DB_POSTGRESDB_DATABASE: Tên database n8n.
- DB_POSTGRESDB_USER: Tên người dùng database.
- DB_POSTGRESDB_PASSWORD: Mật khẩu người dùng database.
- DB_POSTGRESDB_SCHEMA: (Tùy chọn) Schema database (mặc định: public).
- Mã hóa Dữ liệu:
- N8N_ENCRYPTION_KEY: Phải giống hệt nhau trên tất cả các instance (main, workers, webhooks). Đây là khóa dùng để mã hóa credentials, vì vậy bạn cần tạo một chuỗi dài, ngẫu nhiên và bảo mật nó.

Cấu hình với Docker Compose
Nếu đang sử dụng Docker Compose, bạn sẽ cần định nghĩa các services cho redis, postgres (nếu chưa có), n8n (main process), và một hoặc nhiều n8n_worker services. Ví dụ các cập nhật ở file docker-compose.yml
:
version: '3.8'
services:
postgres:
image: postgres:16
restart: always
environment:
- POSTGRES_USER=n8n
- POSTGRES_PASSWORD=strongpassword
- POSTGRES_DB=n8n
volumes:
- ./postgres-data:/var/lib/postgresql/data
redis:
image: redis:last
restart: always
ports:
- "6379:6379"
volumes:
- ./redis-data:/data
command: ["redis-server", "--appendonly", "yes"]
n8n:
image: n8nio/n8n:latest
restart: always
ports:
- "127.0.0.1:5678:5678"
depends_on:
- postgres
- redis
environment:
- DB_TYPE=postgresdb
- DB_POSTGRESDB_HOST=postgres
- DB_POSTGRESDB_PORT=5432
- DB_POSTGRESDB_DATABASE=n8n
- DB_POSTGRESDB_USER=n8n
- DB_POSTGRESDB_PASSWORD=strongpassword
- N8N_ENCRYPTION_KEY=longsecretkeychangeit
- N8N_HOST=n8n.local
- N8N_PROTOCOL=http
- WEBHOOK_URL=http://n8n.local:5678/
# Queue Mode
- N8N_QUEUE_MODE=true
- EXECUTIONS_MODE=queue
- N8N_RUNNERS_ENABLED=true
- OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS=true
- QUEUE_MODE=redis
- QUEUE_BULL_REDIS_HOST=redis
- QUEUE_BULL_REDIS_PORT=6379
volumes:
- ./n8n-data:/home/node/.n8n
n8n-worker:
image: n8nio/n8n:latest
restart: always
depends_on:
- postgres
- redis
command: worker
environment:
- DB_TYPE=postgresdb
- DB_POSTGRESDB_HOST=postgres
- DB_POSTGRESDB_PORT=5432
- DB_POSTGRESDB_DATABASE=n8n
- DB_POSTGRESDB_USER=n8n
- DB_POSTGRESDB_PASSWORD=strongpassword
- N8N_QUEUE_MODE=true
- N8N_RUNNERS_ENABLED=true
- QUEUE_MODE=redis
- QUEUE_BULL_REDIS_HOST=redis
- QUEUE_BULL_REDIS_PORT=6379
- EXECUTIONS_PROCESS_CONCURRENCY=10 # Mỗi worker xử lý 10 job song song
volumes:
- ./n8n-data:/home/node/.n8n
volumes:
postgres-data:
redis-data:
n8n-data:
Để chạy lệnh bạn thực theo hướng dẫn sau:
Bước 1: Bạn muốn lưu file docker-compose.yml
, hãy chạy lệnh:
docker compose up -d
Bước 2: Để scale số lượng worker (nếu không dùng deploy: replicas:), bạn có thể định nghĩa thêm các services n8n_worker_2, n8n_worker_3,… với cấu hình tương tự n8n_worker.
docker compose up -d --scale n8n-worker=3

Bước 3: Kiểm tra worker có thật sự hoạt động không bạn nhập lệnh sau:
docker logs n8n-n8n-worker-1 -f

Dịch vụ VPS Vietnix – Giải pháp mạnh mẽ cho tự động hóa chuyên sâu
Với nền tảng hạ tầng tối ưu, dịch vụ thuê VPS tại Vietnix mang đến hiệu suất vượt trội cho mọi nhu cầu từ doanh nghiệp đến cá nhân. Hệ thống sử dụng ổ cứng SSD Enterprise RAID 10 và CPU hiệu năng cao, đảm bảo tốc độ xử lý nhanh, độ ổn định lên tới 99.9% và khả năng hoạt động liên tục trong mọi điều kiện. Ngoài ra, dịch vụ cam kết bảo mật dữ liệu tuyệt đối, hỗ trợ kỹ thuật 24/7 cùng mức giá linh hoạt phù hợp với mọi quy mô khi mua VPS tại Vietnix.
Được thiết kế riêng để đáp ứng nhu cầu của các công cụ tự động hóa như n8n, dịch vụ VPS n8n tại Vietnix là lựa chọn lý tưởng cho những ai muốn triển khai workflow ổn định và tiết kiệm. Mỗi gói VPS đều được cấu hình sẵn sàng cho n8n với khả năng mở rộng dễ dàng, xử lý nhanh các quy trình tích hợp phức tạp mà vẫn giữ được chi phí vận hành hợp lý. Kết hợp với khả năng kiểm soát toàn diện môi trường máy chủ, bạn hoàn toàn có thể yên tâm triển khai các giải pháp tự động hóa chuyên nghiệp mà không cần lo ngại về hạ tầng hay gián đoạn kỹ thuật.
Thông tin liên hệ:
- Hotline: 18001093
- Email: sales@vietnix.com.vn
- Địa chỉ: 265 Hồng Lạc, Phường 10, Quận Tân Bình, Thành Phố Hồ Chí Minh.
- Website: https://vietnix.vn/
Bài viết trên đã hướng dẫn chi tiết cách cấu hình queue mode cho n8n trên VPS, giúp bạn tối ưu quy trình xử lý workflow khi triển khai ở môi trường thực tế. Việc áp dụng queue mode cùng Redis không chỉ tăng hiệu suất mà còn cải thiện khả năng mở rộng, đặc biệt phù hợp với các hệ thống tự động hóa phức tạp.