Cấu hình n8n dùng được cho công ty gồm năm phần thêm vào tệp Docker Compose mẫu: Postgres thay SQLite, SMTP để mời người dùng và đặt lại mật khẩu, dọn lịch sử chạy, task runner chạy riêng để cô lập mã, và chế độ hàng đợi với Redis cùng worker khi việc chạy đông.
Bài tự cài n8n trên máy chủ riêng: Docker, sao lưu và cập nhật đã đi qua tệp Compose có Traefik, cách thêm Postgres, các biến cơ bản, HTTPS sau reverse proxy, sao lưu và cập nhật. Bài này không lặp lại phần sao lưu, cập nhật. Tôi đi tiếp một bước: khi n8n thành hệ thống cả công ty dùng, tệp Compose cần thêm gì. Thứ tự: sơ đồ các khối, đọc tệp Compose từng phần, người dùng và SMTP, task runner, dọn lịch sử chạy, giới hạn chạy đồng thời và bộ nhớ, chế độ hàng đợi, theo dõi sức khoẻ, rồi các điểm bất lợi. Tên biến và mặc định lấy từ tài liệu tự dựng của n8n (docs.n8n.io), kiểm ngày 09/11/2026.
Sơ đồ các khối của bộ cấu hình n8n cho công ty
Một máy n8n cho công ty mười, hai mươi người dùng thường gồm các khối dưới đây. Cột cuối ghi khi nào thêm.

| Khối | Việc của nó | Khi nào cần |
|---|---|---|
| Proxy HTTPS (Traefik trong tệp mẫu) | Nhận cổng 80, 443, xin chứng chỉ, chuyển vào n8n | Ngay từ đầu |
| n8n chính (main) | Giao diện, API, nhận webhook, hẹn giờ | Ngay từ đầu |
| Postgres | Lưu workflow, thông tin đăng nhập đã mã hoá, lịch sử chạy | Ngay khi có nhiều người dùng |
Task runner (ảnh n8nio/runners) | Chạy mã JavaScript, Python của nút Code tách khỏi n8n | Khi có người viết nút Code |
| Redis và các worker | Hàng đợi việc; worker nhận việc và chạy | Khi một máy n8n không kịp chạy |
Đọc tệp Docker Compose từng khối
Tệp compose.yaml mẫu trong trang «Use Docker Compose» của n8n (kiểm 09/11/2026) có hai dịch vụ traefik và n8n, hai volume n8n_data và traefik_data. Những dòng tôi giữ nguyên khi làm cho công ty:
restart: alwaysở mọi dịch vụ.ports: "127.0.0.1:5678:5678": cổng 5678 chỉ mở cho chính máy chủ; người dùng vào qua cổng 443 của Traefik.- Volume
n8n_datagắn vào/home/node/.n8n: tài liệu ghi đây là nơi n8n lưu tệp SQLite và khoá mã hoá. - Thư mục
./local-filesgắn vào/filescùng biếnN8N_RESTRICT_FILE_ACCESS_TO=/files: nút đọc, ghi tệp chỉ đụng được thư mục này. NODE_ENV=productionvàN8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=truenhư tệp mẫu.
Phần thêm Postgres nằm ở trang «Install using Docker Compose». Điểm đáng chép là khối healthcheck của Postgres dùng lệnh pg_isready (chu kỳ 5 giây, chờ 5 giây, thử 10 lần), và n8n khai báo depends_on với condition: service_healthy. Nhờ vậy n8n chỉ khởi động khi cơ sở dữ liệu đã nhận kết nối, tránh lỗi lúc máy chủ vừa bật. Trang đó cũng nhắc giữ dòng PGDATA: /var/lib/postgresql/data với ảnh postgres:18, bỏ đi thì cơ sở dữ liệu khởi động rỗng.
Người dùng, vai trò và SMTP
Trang User management của n8n chia việc mở cho nhiều người thành ba bước: cấu hình SMTP, tạo tài khoản chủ (owner) trong giao diện, rồi mời người dùng. Mật khẩu chủ phải có ít nhất tám ký tự, có số và chữ hoa.
Biến SMTP cần đặt
N8N_EMAIL_MODE=smtpN8N_SMTP_HOST,N8N_SMTP_PORT,N8N_SMTP_USER,N8N_SMTP_PASS(dùng chỗ trống<MAT_KHAU>trong tệp mẫu, đừng đưa mật khẩu thật vào kho mã)N8N_SMTP_SENDER: địa chỉ người gửi, có thể kèm tênN8N_SMTP_SSLvàN8N_SMTP_STARTTLS, mặc định đều làtruetheo bảng biến môi trường
Tài liệu ghi SMTP là tuỳ chọn: không đặt thì chép link mời gửi tay, nhưng người dùng không tự đặt lại mật khẩu được. Đổi biến SMTP thì phải khởi động lại n8n.
Vai trò theo gói
Trang instance roles (kiểm 09/11/2026) có bốn vai trò dựng sẵn: Owner, Admin, Member và Chat user. Vai trò Admin và Chat user chỉ có ở bản tự dựng gói Enterprise (trên n8n Cloud là gói Pro, Enterprise). Owner và Admin xem được mọi workflow, xem và sửa mọi thông tin đăng nhập; Member chỉ quản workflow của mình. n8n khuyên chủ tài khoản tạo thêm một tài khoản Member cho chính mình để làm việc hằng ngày, vì n8n không cho biết ai tạo workflow nào và sửa bằng quyền Owner dễ đè việc của người khác. Xác thực hai bước bật sẵn qua N8N_MFA_ENABLED (mặc định true).
Task runner: chạy mã của nút Code cho an toàn
Trang Set up task runners (kiểm 09/11/2026) mở đầu bằng cảnh báo: ngoài task runner, không còn lớp cô lập nào khác giữa mã người dùng viết và n8n. Không có nó, hoặc dùng chế độ internal, ai sửa được workflow đều có thể đọc cơ sở dữ liệu, khoá mã hoá, thông tin đăng nhập và biến môi trường. Tài liệu khuyên dùng chế độ external cho môi trường thật.
Những gì tài liệu ghi cho chế độ external:
- Thêm một container chạy ảnh
n8nio/runnerscạnh n8n; phiên bản ảnh này phải khớp phiên bảnn8nio/n8n. - Trong n8n:
N8N_RUNNERS_ENABLED=true,N8N_RUNNERS_MODE=external,N8N_RUNNERS_BROKER_LISTEN_ADDRESS=0.0.0.0,N8N_RUNNERS_AUTH_TOKEN. - Trong container runner:
N8N_RUNNERS_TASK_BROKER_URItrỏ về n8n (tệp mẫu dùng cổng 5679) và cùngN8N_RUNNERS_AUTH_TOKEN. - Chế độ internal bị đánh dấu ngừng dùng từ n8n 3.0; n8n ghi cảnh báo khi khởi động nếu chưa đặt
N8N_RUNNERS_MODE. - Ở chế độ hàng đợi, mỗi worker cần container runner riêng.
Dọn lịch sử chạy để đĩa không đầy
Trang Manage execution data ghi cơ sở dữ liệu n8n có thể phình tới hết dung lượng nếu lưu mọi lần chạy. n8n bật dọn mặc định. Các biến và mặc định theo bảng biến Executions (kiểm 09/11/2026):
| Biến | Mặc định | Ý nghĩa |
|---|---|---|
EXECUTIONS_DATA_PRUNE | true | Bật dọn lịch sử chạy |
EXECUTIONS_DATA_MAX_AGE | 336 giờ (14 ngày) | Lần chạy cũ hơn sẽ bị xoá |
EXECUTIONS_DATA_PRUNE_MAX_COUNT | 10.000 | Số lần chạy giữ lại tối đa; 0 là không giới hạn |
EXECUTIONS_DATA_HARD_DELETE_BUFFER | 1 giờ | Giữ dữ liệu mới để người đang dựng workflow còn xem |
EXECUTIONS_DATA_SAVE_ON_SUCCESS | all | Đặt none để không lưu lần chạy thành công |
Ví dụ trong tài liệu: chỉ lưu lần chạy lỗi (EXECUTIONS_DATA_SAVE_ON_ERROR=all), không lưu lần chạy thành công, không lưu lần chạy tay (EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS=false). Lần chạy có gắn thẻ hoặc chấm điểm không bao giờ bị dọn. Nếu còn dùng SQLite, phần dung lượng đã dọn không tự trả lại cho đĩa mà được dùng lại; muốn trả lại thì đặt DB_SQLITE_VACUUM_ON_STARTUP.
Thêm giới hạn thời gian chạy: EXECUTIONS_TIMEOUT mặc định -1 (tắt), EXECUTIONS_TIMEOUT_MAX mặc định 3600 giây. Nên đặt EXECUTIONS_TIMEOUT để một workflow treo không giữ tài nguyên cả đêm.
Giới hạn chạy đồng thời và bộ nhớ
Ở chế độ thường, trang Control concurrency ghi n8n không giới hạn số lần chạy cùng lúc, nhiều quá có thể làm n8n chậm hoặc không phản hồi. Bật giới hạn bằng N8N_CONCURRENCY_PRODUCTION_LIMIT (tài liệu lấy ví dụ 20); mặc định -1 là tắt. Giới hạn này chỉ áp cho lần chạy từ webhook hoặc trigger, không áp cho lần chạy tay hay workflow con.
Về bộ nhớ, trang Fix memory issues ghi n8n không giới hạn lượng dữ liệu mỗi nút lấy về. Dấu hiệu thiếu bộ nhớ: lỗi 503, hoặc «JavaScript heap out of memory» trong log. Cách giảm theo tài liệu: chia dữ liệu thành phần nhỏ (ví dụ 200 dòng mỗi lần thay vì 10.000), hạn chế nút Code, tránh chạy tay với dữ liệu lớn, tách workflow con trả về ít dữ liệu. Có thể tăng bộ nhớ cho Node.js bằng --max-old-space-size qua biến NODE_OPTIONS.
Khi nào bật chế độ hàng đợi (queue mode)
Trang Enable queue mode mô tả luồng: n8n chính nhận hẹn giờ và webhook, tạo lần chạy nhưng không chạy, đẩy mã lần chạy vào Redis; worker rảnh nhận việc, đọc workflow từ cơ sở dữ liệu, chạy, ghi kết quả, báo lại qua Redis. Thêm worker là tăng sức chạy.
Cấu hình cần có theo tài liệu (kiểm 09/11/2026):
EXECUTIONS_MODE=queuetrên n8n chính và mọi worker.QUEUE_BULL_REDIS_HOST(mặc địnhlocalhost),QUEUE_BULL_REDIS_PORT(mặc định 6379), thêmQUEUE_BULL_REDIS_PASSWORDnếu Redis có mật khẩu.- Cùng một
N8N_ENCRYPTION_KEYtrên n8n chính, mọi worker và webhook processor, nếu không worker không đọc được thông tin đăng nhập. - Worker chạy bằng lệnh
n8n worker; cờ--concurrencymặc định 10, tài liệu khuyên từ 5 trở lên vì giá trị thấp với nhiều worker có thể làm cạn kết nối cơ sở dữ liệu. - Dùng Postgres. Tài liệu ghi chạy hàng đợi với SQLite là không được hỗ trợ.
- Không lưu dữ liệu nhị phân trên ổ đĩa (filesystem) ở chế độ này; tài liệu gợi ý lưu trữ ngoài S3.
Hai biến hay quên: OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS mặc định false, tức lần chạy tay vẫn chạy trên n8n chính; và webhook processor (lệnh n8n webhook) là lớp tách thêm, chỉ cần khi webhook vào rất nhiều. Chạy nhiều n8n chính cùng lúc (multi-main) chỉ có ở bản tự dựng gói Enterprise.
Khi nào cần: tài liệu không ghi ngưỡng cụ thể. Gợi ý của tôi: vài chục workflow chạy theo giờ thì chưa cần; nên tính tới khi giao diện chậm lúc nhiều workflow chạy cùng lúc, hoặc có workflow nặng làm trễ các webhook khác. Trước khi thêm Redis, thử giới hạn chạy đồng thời và dọn lịch sử chạy ở hai mục trên.
Theo dõi sức khoẻ và giờ hệ thống
Trang Monitor n8n liệt kê ba đường kiểm: /healthz trả 200 khi n8n còn chạy, /healthz/readiness trả 200 khi cơ sở dữ liệu đã kết nối và chạy xong migration, /metrics cho số liệu chi tiết (tắt mặc định, bật bằng N8N_METRICS=true). Trên worker, đường kiểm sức khoẻ tắt mặc định, bật bằng QUEUE_HEALTH_CHECK_ACTIVE=true. Nên trỏ công cụ giám sát vào /healthz/readiness, vì /healthz không cho biết cơ sở dữ liệu còn sống không.
Giờ hệ thống: đặt GENERIC_TIMEZONE và TZ như trong bài vận hành n8n ở trên, để hẹn giờ chạy theo giờ Việt Nam. Sao lưu và cập nhật cũng xem bài đó. Ai đang dựng thêm công cụ tự lưu trữ khác cạnh n8n có thể đọc bài Metabase tự dựng cho doanh nghiệp nhỏ hoặc RAG tự dựng với Ollama và LanceDB.
Điểm bất lợi của cấu hình nhiều khối
- Nhiều container hơn, nhiều chỗ hỏng hơn. Postgres, runner, Redis, worker đều phải giám sát, sao lưu (Postgres) và cập nhật cùng nhịp.
- Phiên bản phải khớp. Ảnh runner phải cùng phiên bản n8n; multi-main yêu cầu mọi n8n chính và worker cùng phiên bản. Kéo lẻ một ảnh là dễ lỗi.
- Một số tính năng quản trị cần gói trả phí. Vai trò Admin, xem danh sách worker trong giao diện, multi-main đều là Enterprise khi tự dựng. Trang queue mode không ghi giới hạn gói cho bản thân chế độ hàng đợi.
- Webhook qua hàng đợi chậm hơn một chút. Tài liệu ghi chuyển việc sang worker có thêm chi phí và độ trễ.
- Không có số đo sẵn cho máy của anh chị. Tài liệu không ghi bao nhiêu người dùng thì cần bao nhiêu worker; phải tự đo. Cách gợi ý chi phí tự dựng có trong bài n8n cho doanh nghiệp Việt: chi phí tự dựng.
Câu hỏi thường gặp về n8n Docker Compose cho công ty
Công ty nhỏ có cần chế độ hàng đợi ngay không?
Thường là chưa. Bắt đầu với n8n chính, Postgres và task runner. Bật N8N_CONCURRENCY_PRODUCTION_LIMIT và dọn lịch sử chạy trước; chỉ thêm Redis và worker khi một máy không kịp chạy.
Không cấu hình SMTP thì có mời người dùng được không?
Được. Tài liệu ghi SMTP là tuỳ chọn, quản trị viên chép link mời gửi tay. Nhưng không có SMTP thì người dùng không tự đặt lại mật khẩu được.
Có bắt buộc dùng task runner ở chế độ external không?
Tài liệu n8n khuyên dùng external cho môi trường thật và mọi máy giữ dữ liệu nhạy cảm. Chế độ internal bị đánh dấu ngừng dùng từ n8n 3.0 (kiểm 09/11/2026).
Lịch sử chạy n8n giữ bao lâu?
Mặc định 336 giờ, tức 14 ngày, và tối đa 10.000 lần chạy, xoá theo điều kiện nào tới trước. Đổi bằng EXECUTIONS_DATA_MAX_AGE và EXECUTIONS_DATA_PRUNE_MAX_COUNT.
Worker n8n chạy bao nhiêu việc cùng lúc?
Mặc định 10 việc mỗi worker, đổi bằng n8n worker --concurrency=5. Tài liệu khuyên giữ từ 5 trở lên và tăng số worker khi cần thêm sức chạy.
Nguồn: docs.n8n.io (Use Docker Compose; Install using Docker Compose; User management; User management and 2FA; Understand instance roles; Set up task runners; Manage execution data; Executions; Configure workflow timeouts; Control concurrency; Fix memory issues; Enable queue mode; Queue mode; Monitor n8n), kiểm ngày 09/11/2026.


