n8n self-hosted в production: docker-compose, nginx, ретраи и три грабли

services:
  # ──────────── Реверс-прокси + HTTPS (auto-config через labels)
  proxy:
    image: nginxproxy/nginx-proxy:alpine
    container_name: nginx-proxy
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - /var/run/docker.sock:/tmp/docker.sock:ro
      - nginx_certs:/etc/nginx/certs
      - nginx_vhost:/etc/nginx/vhost.d
      - nginx_html:/usr/share/nginx/html
    networks: [internal]
  letsencrypt:
    image: nginxproxy/acme-companion
    container_name: nginx-le
    restart: unless-stopped
    env_file: .env
    environment:
      - NGINX_PROXY_CONTAINER=nginx-proxy
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - nginx_certs:/etc/nginx/certs
      - nginx_vhost:/etc/nginx/vhost.d
      - nginx_html:/usr/share/nginx/html
    depends_on: [proxy]
    networks: [internal]
  # ──────────── PostgreSQL (доступен локально для SSH-туннеля)
  postgres:
    image: postgres:15-alpine
    container_name: n8n-postgres
    restart: unless-stopped
    env_file: .env
    environment:
      - POSTGRES_DB
      - POSTGRES_USER
      - POSTGRES_PASSWORD
    volumes:
      - pg_data:/var/lib/postgresql/data
    ports:
      - "127.0.0.1:5432:5432"
    networks: [internal]
  # ──────────── Redis (для queue mode)
  redis:
    image: redis:7-alpine
    container_name: n8n-redis
    restart: unless-stopped
    env_file: .env
    command: ["redis-server", "--requirepass", "${REDIS_PASSWORD}"]
    volumes:
      - redis_data:/data
    networks: [internal]
  # ──────────── n8n
  n8n:
    image: n8nio/n8n:latest
    container_name: n8n-app
    restart: unless-stopped
    env_file: .env
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE
      - DB_POSTGRESDB_USER
      - DB_POSTGRESDB_PASSWORD
      - N8N_ENCRYPTION_KEY
      - N8N_DEFAULT_BINARY_DATA_MODE=filesystem
      - N8N_PROTOCOL=https
      - N8N_EDITOR_BASE_URL=https://${DOMAIN_N8N}/
      - WEBHOOK_URL=https://${DOMAIN_N8N}/
      - N8N_PROXY_HOPS=1
      - N8N_SECURE_COOKIE=false
      - VIRTUAL_HOST=${DOMAIN_N8N}
      - VIRTUAL_PORT=5678
      - CLIENT_MAX_BODY_SIZE=64m
      - LETSENCRYPT_HOST=${DOMAIN_N8N}
      - LETSENCRYPT_EMAIL=${LE_EMAIL}
      - GENERIC_TIMEZONE=Europe/Moscow
      - TZ=Europe/Moscow
      - NODE_FUNCTION_ALLOW_BUILTIN=crypto
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on: [postgres, proxy]
    networks: [internal]
  # ──────────── Portainer (веб-GUI Docker)
  portainer:
    image: portainer/portainer-ce:latest
    container_name: portainer
    restart: unless-stopped
    env_file: .env
    environment:
      - VIRTUAL_HOST=${DOMAIN_PORTAINER}
      - LETSENCRYPT_HOST=${DOMAIN_PORTAINER}
      - LETSENCRYPT_EMAIL=${LE_EMAIL}
      - VIRTUAL_PORT=9000
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data
    depends_on: [proxy, letsencrypt]
    networks: [internal]
  # ──────────── Watchtower (авто-обновления контейнеров)
  watchtower:
    image: containrrr/watchtower
    container_name: watchtower
    restart: unless-stopped
    command: --schedule "0 0 3 * * *" --cleanup
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    networks: [internal]
volumes:
  pg_data:
  redis_data:
  n8n_data:
  nginx_certs:
  nginx_vhost:
  nginx_html:
  portainer_data:
networks:
  internal:
    driver: bridge

# n8n
DOMAIN_N8N=n8n.example.ru
DOMAIN_PORTAINER=portainer.example.ru
LE_EMAIL=you@example.com
N8N_ENCRYPTION_KEY=сгенерируйте_32_символа_случайных
# Postgres
POSTGRES_DB=n8n
POSTGRES_USER=n8n
POSTGRES_PASSWORD=сгенерируйте_сильный_пароль
# Redis
REDIS_PASSWORD=сгенерируйте_сильный_пароль

• n8n релизит обновления часто (2-4 раза в месяц), и в подавляющем большинстве это патчи интеграций, фиксы багов, плюс security
  
• Breaking changes в minor-релизах внутри одной major-серии (2.x) практически отсутствуют - конфиги, env-переменные, API стабильны
  
• Watchtower обновляет только если в Docker Hub появился новый image - не дёргает контейнер просто так
  
• --cleanup удаляет старые образы после успешного обновления - диск не забивается на 100 ГБ за полгода

image: n8nio/n8n:2-latest

curl -s https://n8n.example.ru/healthz
# {"status":"ok"}

N8N_EDITOR_BASE_URL=https://n8n.example.ru/
WEBHOOK_URL=https://tg.example.ru/

# /etc/cron.d/n8n-backup
0 3 * * * root docker exec -t n8n-postgres pg_dumpall -c -U n8n | gzip > /var/backups/n8n/n8n-$(date +\%F).sql.gz
0 4 * * 0 root find /var/backups/n8n/ -name "*.sql.gz" -mtime +30 -delete

gunzip < /var/backups/n8n/n8n-2026-05-08.sql.gz | docker exec -i n8n-postgres psql -U n8n

EXECUTIONS_DATA_PRUNE: "true"
EXECUTIONS_DATA_MAX_AGE: 168       # часов = 7 дней
EXECUTIONS_DATA_PRUNE_MAX_COUNT: 10000

EXECUTIONS_MODE: queue
QUEUE_BULL_REDIS_HOST: redis
QUEUE_BULL_REDIS_PORT: 6379

#!/bin/bash
docker compose up -d
sleep 5
for i in {1..10}; do
  curl -fs https://n8n.example.ru/healthz && break
  sleep 2
done
echo "n8n ready"

# добавить в docker-compose.yml
  cloudflared:
    image: cloudflare/cloudflared:latest
    container_name: cloudflared
    restart: unless-stopped
    command: tunnel --no-autoupdate run
    environment:
      - TUNNEL_TOKEN=${CLOUDFLARED_TOKEN}
    networks: [internal]
    depends_on: [n8n]

N8N_EDITOR_BASE_URL=https://n8n.example.ru/   # прямой через nginx-proxy
WEBHOOK_URL=https://tg.example.ru/             # через CF Tunnel

HTTP Request settings:
  Retry On Fail: ON
  Max Tries: 3
  Wait Between Tries: 5000   # ms

[HTTP Request] → [If: status >= 500]
                   ↓ true
                 [Wait 30s] → [HTTP Request retry] → [Postgres: log]
                   ↓ false
                 [Continue normal flow]

CREATE TABLE n8n_failures (
    id BIGSERIAL PRIMARY KEY,
    workflow_id TEXT NOT NULL,
    node_name TEXT NOT NULL,
    error_text TEXT,
    payload JSONB,
    occurred_at TIMESTAMPTZ DEFAULT NOW()
);
CREATE INDEX ON n8n_failures (occurred_at DESC);
CREATE INDEX ON n8n_failures (workflow_id);

# docker-compose.monitoring.yml
prometheus:
  image: prom/prometheus
  volumes:
    - ./prometheus.yml:/etc/prometheus/prometheus.yml
  ports:
    - "127.0.0.1:9090:9090"
grafana:
  image: grafana/grafana
  ports:
    - "127.0.0.1:3000:3000"
  environment:
    GF_AUTH_ANONYMOUS_ENABLED: "true"

scrape_configs:
  - job_name: n8n
    static_configs:
      - targets: ["n8n:5678"]
    metrics_path: /metrics

• n8n_active_workflows - если упало до 0, что-то сломалось
  
• n8n_workflow_failed_total - рост говорит о проблеме с интеграцией
  
• Высокий n8n_node_running_time_seconds на конкретных узлах - узкое место

• Объём операций превышает 1000 в день - расходы на cloud начинают расти быстрее, чем VPS
  
• Есть требование 152-ФЗ - данные клиентов должны физически быть в РФ
  
• У вас есть инженер на 1-2 часа в неделю на поддержку
  
• Нужна интеграция с внутренней инфраструктурой (private API, базы данных за корпоративным VPN)

• Официальная документация: docs.n8n.io
  
• Список интеграций: n8n.io/integrations
  
• Community-форум: community.n8n.io
  
• Шаблоны workflow: n8n.io/workflows
  
• Production checklist в официальной доке: docs.n8n.io/hosting/scaling/