Posted inDocker

Hướng dẫn triển khai n8n với Docker Compose và PostgreSQL: Tự động hóa quy trình Self-hosted

Docker tutorial - IT technology blog
Docker tutorial - IT technology blog

So sánh các mô hình triển khai n8n workflow automation

Khi đội ngũ kỹ thuật cần kết nối liên thông GitLab, Jira, Slack và hệ thống CRM nội bộ mà không muốn trả từ $50 đến hàng trăm USD mỗi tháng cho Zapier hay Make, n8n luôn là ứng viên sáng giá. Tuy nhiên, chọn hạ tầng nào để vận hành n8n lại là câu hỏi cần tính toán kỹ trước khi đưa vào thực tế:

  • Mô hình 1: n8n Cloud (SaaS) — Trả phí thuê bao theo tháng (từ €20/tháng cho 2.500 lượt chạy), dùng ngay trên hạ tầng của hãng mà không phải bận tâm việc cấu hình server.
  • Mô hình 2: Single Docker Container với SQLite — Kéo image n8nio/n8n về, mount thư mục máy chủ và khởi chạy trực tiếp với cơ sở dữ liệu SQLite mặc định.
  • Mô hình 3: Cụm Docker Compose kết hợp PostgreSQL — Tách biệt n8n app và database PostgreSQL thành 2 container riêng biệt, quản lý tập trung qua biến môi trường và mạng nội bộ Docker.

Phân tích ưu và nhược điểm từng phương án

Mỗi lựa chọn giải quyết một bài toán cụ thể tùy thuộc vào lưu lượng xử lý và độ nhạy cảm của dữ liệu:

1. n8n Cloud

  • Ưu điểm: Không tốn công bảo trì hạ tầng. Phiên bản được nâng cấp tự động, tích hợp sẵn SSL và quản lý domain.
  • Nhược điểm: Chi phí tăng nhanh khi số lượng workflow bùng nổ. Dữ liệu nhạy cảm như API token hay thông tin khách hàng phải đi qua cụm máy chủ bên ngoài.

2. Single Docker Container (SQLite)

  • Ưu điểm: Dựng xong trong 30 giây với đúng một câu lệnh docker run. Lựa chọn này cực kỳ lý tưởng để vọc vạch tính năng hoặc demo cá nhân.
  • Nhược điểm: SQLite dễ nghẽn (database lock) khi có từ 10 đến 20 webhook kích hoạt cùng lúc. Ngoài ra, việc backup dữ liệu khi container gặp sự cố thường phức tạp và rủi ro.

3. Docker Compose + PostgreSQL

  • Ưu điểm: PostgreSQL xử lý mượt hàng trăm execution đồng thời. Bạn toàn quyền kiểm soát dữ liệu trên VPS, dễ dàng cấu hình backup tự động và sẵn sàng scale thêm n8n worker khi tải tăng.
  • Nhược điểm: Cần kiến thức cơ bản về quản trị Linux, Docker và cấu hình reverse proxy như Nginx.

Trong một dự án trước đây, team mình từng gặp sự cố container n8n dùng SQLite bị crash liên tục vào đợt flash sale chỉ vì nghẽn ghi file. Toàn bộ webhook từ cổng thanh toán bị treo trong hơn 3 tiếng. Bài học rút ra rất rõ ràng: với bất kỳ hệ thống nào phục vụ công việc thực tế, việc tách database ra một service PostgreSQL độc lập là yêu cầu bắt buộc để tránh tình trạng mất dữ liệu hoặc sập dịch vụ bất ngờ.

Tại sao Docker Compose + PostgreSQL là lựa chọn tối ưu cho production?

Nếu bạn muốn xây dựng hệ thống tự động hóa ổn định cho cả team, cặp đôi Docker Compose + PostgreSQL mang lại sự cân bằng tốt nhất giữa chi phí và độ tin cậy.

Một VPS cấu hình khiêm tốn (2 vCPU, 4GB RAM giá khoảng $10 – $15/tháng) hoàn toàn có thể gánh hàng chục nghìn lượt trigger mỗi ngày mà không bị nghẽn I/O. Toàn bộ cấu hình hệ thống cũng được lưu thành mã (IaC), giúp bạn dễ dàng đồng bộ và quản lý phiên bản qua Git.

Hướng dẫn triển khai n8n với Docker Compose và PostgreSQL từng bước

Bước 1: Chuẩn bị thư mục và phân quyền

Truy cập SSH vào VPS và tạo cấu trúc thư mục lưu trữ dữ liệu bền vững:

mkdir -p /opt/n8n-stack/n8n_data /opt/n8n-stack/postgres_data
cd /opt/n8n-stack
# Phân quyền cho user node bên trong container (UID 1000)
sudo chown -R 1000:1000 n8n_data

Bước 2: Tạo file cấu hình môi trường .env

Tách các thông tin nhạy cảm vào file .env để tiện quản lý và tránh lộ mật khẩu:

nano .env

Dán nội dung cấu hình sau vào file:

# Tên miền và múi giờ
DOMAIN_NAME=automation.yourdomain.com
GENERIC_TIMEZONE=Asia/Ho_Chi_Minh

# Thông tin cơ sở dữ liệu PostgreSQL
POSTGRES_USER=n8n_admin
POSTGRES_PASSWORD=MatKhauBaoMatCucManh_2026
POSTGRES_DB=n8n_db

# Khóa mã hóa thông tin xác thực (tạo chuỗi ngẫu nhiên 32 ký tự trở lên)
N8N_ENCRYPTION_KEY=b8f3e1a9c4d2095f8e7123456789abcd

Bước 3: Soạn thảo file docker-compose.yml

Tạo file docker-compose.yml để định nghĩa 2 service postgres và n8n:

services:
  postgres:
    image: postgres:16-alpine
    container_name: n8n_postgres
    restart: unless-stopped
    environment:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}
    volumes:
      - ./postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -h localhost -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      retries: 10
    networks:
      - n8n_network

  n8n:
    image: n8nio/n8n:latest
    container_name: n8n_app
    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_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
      - TZ=${GENERIC_TIMEZONE}
      - WEBHOOK_URL=https://${DOMAIN_NAME}/
      - N8N_HOST=${DOMAIN_NAME}
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
    volumes:
      - ./n8n_data:/home/node/.n8n
    depends_on:
      postgres:
        condition: service_healthy
    networks:
      - n8n_network

networks:
  n8n_network:
    driver: bridge

Bước 4: Khởi chạy và kiểm tra nhật ký

Khởi động cụm dịch vụ chạy ngầm:

docker compose up -d

Kiểm tra trạng thái container và theo dõi log khởi động:

docker compose ps
docker compose logs -f n8n

Khi log hiển thị thông báo sẵn sàng hoặc Editor is now accessible via..., ứng dụng đã kết nối database thành công.

Bước 5: Thiết lập Nginx Reverse Proxy và SSL

Do port 5678 chỉ mở trên 127.0.0.1 để đảm bảo an toàn, bạn cần Nginx làm reverse proxy chuyển tiếp traffic và xử lý chứng chỉ SSL. Cấu hình Nginx cần hỗ trợ WebSocket để giao diện kéo-thả n8n hiển thị trạng thái realtime:

server {
    server_name automation.yourdomain.com;

    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-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_buffering off;
        proxy_cache off;
    }
}

Cài đặt chứng chỉ SSL miễn phí qua Let’s Encrypt Certbot bằng lệnh: sudo certbot --nginx -d automation.yourdomain.com. Sau đó, bạn có thể truy cập domain để thiết lập tài khoản Owner đầu tiên.

Bước 6: Tự động hóa backup cơ sở dữ liệu hàng ngày

Để đảm bảo an toàn cho các workflow và credentials quan trọng, hãy thiết lập cronjob tự động xuất dữ liệu PostgreSQL mỗi đêm:

# Mở bảng cron
crontab -e

# Thêm dòng sau để backup vào 02:00 sáng mỗi ngày
0 2 * * * docker exec -t n8n_postgres pg_dump -U n8n_admin n8n_db | gzip > /opt/n8n-stack/backups/n8n_db_$(date +\%F).sql.gz

Cụm n8n của bạn hiện đã hoàn chỉnh, chạy an toàn sau reverse proxy và có cơ chế bảo vệ dữ liệu định kỳ, sẵn sàng phục vụ các luồng tự động hóa công việc cho toàn team.

Share:
Tags: