راهنمای جامع معماری توزیع‌شده نودهای Worker با Redis و بهینه‌سازی بار وب‌هوک در n8n Enterprise

                  ┌─────────────────────────────────────────┐
                  │       Traefik / Nginx Load Balancer     │
                  │             https://n8n.corp.local      │
                  └───────────────────┬─────────────────────┘
                                      │
            ┌─────────────────────────┴─────────────────────────┐
            │ Path: /webhook/*                                  │ Path: / (UI/Admin)
            ▼                                                   ▼
┌───────────────────────┐                           ┌───────────────────────┐
│ Webhook Instance 1&2  │                           │ Main Node (Editor/UI) │
│  Lightweight Receiver │                           │  Workflow Management  │
│     192.168.90.11     │                           │     192.168.90.10     │
└───────────┬───────────┘                           └───────────┬───────────┘
            │                                                   │
            ├─────────────────────────┬─────────────────────────┤
            │ Push Job Payloads       │ Subscribe Executions    │
            ▼                         ▼                         │
┌─────────────────────────────────────────┐                     │
│          Redis Sentinel Cluster         │                     │
│               Port: 6379                │                     │
└───────────────────┬─────────────────────┘                     │
                    │ Pop Jobs for Execution                    │
                    ▼                                           │
┌─────────────────────────────────────────┐                     │
│        Dynamic Worker Pool (N Nodes)    │                     │
│   Worker 1, Worker 2, Worker 3 ...      │                     │
└───────────────────┬─────────────────────┘                     │
                    │ Read/Write Workflows & Execution History  │
                    ▼                                           ▼
┌─────────────────────────────────────────────────────────────────────────┐
│                     PostgreSQL 16 High-Availability                     │
│                       with PgBouncer (Port: 6432)                       │
└─────────────────────────────────────────────────────────────────────────┘

version: '3.8'

services:
  redis:
    image: redis:7.2-alpine
    restart: always
    command: redis-server --appendonly yes --requirepass "StrongRedisSecretPass2026!"
    volumes:
      - redis_data:/data
    networks:
      - n8n_cluster

  postgres:
    image: postgres:16-alpine
    restart: always
    environment:
      POSTGRES_DB: n8n_enterprise
      POSTGRES_USER: n8n_admin
      POSTGRES_PASSWORD: "SuperSecurePostgresPass2026!"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - n8n_cluster

  n8n-main:
    image: n8nio/n8n:latest
    restart: always
    environment:
      - EXECUTIONS_MODE=queue
      - QUEUE_BULL_REDIS_HOST=redis
      - QUEUE_BULL_REDIS_PORT=6379
      - QUEUE_BULL_REDIS_PASSWORD=StrongRedisSecretPass2026!
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n_enterprise
      - DB_POSTGRESDB_USER=n8n_admin
      - DB_POSTGRESDB_PASSWORD=SuperSecurePostgresPass2026!
      - N8N_ENCRYPTION_KEY=d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2
      - WEBHOOK_URL=https://n8n.corp.local/
    ports:
      - "5678:5678"
    depends_on:
      - redis
      - postgres
    networks:
      - n8n_cluster

  n8n-webhook:
    image: n8nio/n8n:latest
    restart: always
    command: webhook
    environment:
      - EXECUTIONS_MODE=queue
      - QUEUE_BULL_REDIS_HOST=redis
      - QUEUE_BULL_REDIS_PORT=6379
      - QUEUE_BULL_REDIS_PASSWORD=StrongRedisSecretPass2026!
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n_enterprise
      - DB_POSTGRESDB_USER=n8n_admin
      - DB_POSTGRESDB_PASSWORD=SuperSecurePostgresPass2026!
      - N8N_ENCRYPTION_KEY=d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2
    depends_on:
      - redis
      - postgres
    networks:
      - n8n_cluster

  n8n-worker:
    image: n8nio/n8n:latest
    restart: always
    command: worker --concurrency=10
    deploy:
      replicas: 4
    environment:
      - EXECUTIONS_MODE=queue
      - QUEUE_BULL_REDIS_HOST=redis
      - QUEUE_BULL_REDIS_PORT=6379
      - QUEUE_BULL_REDIS_PASSWORD=StrongRedisSecretPass2026!
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n_enterprise
      - DB_POSTGRESDB_USER=n8n_admin
      - DB_POSTGRESDB_PASSWORD=SuperSecurePostgresPass2026!
      - N8N_ENCRYPTION_KEY=d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2
    depends_on:
      - redis
      - postgres
    networks:
      - n8n_cluster

networks:
  n8n_cluster:
    driver: bridge

volumes:
  redis_data:
  postgres_data:

# نگهداری لاگ‌ها حداکثر به مدت ۷ روز و حداکثر ۵۰۰۰ رکورد اخیر
EXECUTIONS_DATA_PRUNE=true
EXECUTIONS_DATA_MAX_AGE=168
EXECUTIONS_DATA_PRUNE_MAX_COUNT=50000

# ذخیره نکردن دیتای خروجی نودهای میانی برای جاب‌های موفق جهت کاهش ۹۵٪ مصرف رم و دیسک
EXECUTIONS_DATA_SAVE_ON_SUCCESS=none
EXECUTIONS_DATA_SAVE_ON_ERROR=all