n8n в Portainer: Stack, Docker Compose, обновления и безопасный деплой ¶

Обновлено: 2026-05-29

Portainer удобен, когда n8n ставит не DevOps-команда, а владелец сервера, интегратор или администратор малого бизнеса. Он даёт UI для Docker, stacks, volumes, env и логов. Но Portainer не отменяет дисциплину: compose-файл, .env, бэкапы, права доступа и rollback всё равно должны быть понятными.

Лучший способ запускать n8n в Portainer — не нажимать случайные кнопки “Deploy container”, а хранить stack как Docker Compose. Тогда конфигурацию можно перенести на другой сервер, сравнить в Git и восстановить после сбоя.

Когда Portainer подходит для n8n ¶

Минимальный Portainer для управления Docker ¶

services:
  portainer:
    image: portainer/portainer-ce:latest
    command: -H unix:///var/run/docker.sock
    ports:
      - "9443:9443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data
    restart: unless-stopped

volumes:
  portainer_data:

Публиковать Portainer в интернет без ограничений нельзя. Минимум: сильный пароль, 2FA, firewall allowlist/VPN, отдельный домен, обновления. Доступ к Docker socket фактически даёт контроль над сервером.

Stack для n8n: что должно быть внутри ¶

В Portainer откройте Stacks → Add stack, вставьте compose и добавьте environment variables. Для production не используйте SQLite как основную базу: берите PostgreSQL, а для queue mode — Redis и worker.

services:
  postgres:
    image: postgres:16-alpine
    environment:
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

  redis:
    image: redis:7-alpine
    command: redis-server --appendonly yes
    volumes:
      - redis_data:/data
    restart: unless-stopped

  n8n:
    image: n8nio/n8n:latest
    environment:
      DB_TYPE: postgresdb
      DB_POSTGRESDB_HOST: postgres
      DB_POSTGRESDB_DATABASE: ${POSTGRES_DB}
      DB_POSTGRESDB_USER: ${POSTGRES_USER}
      DB_POSTGRESDB_PASSWORD: ${POSTGRES_PASSWORD}
      N8N_ENCRYPTION_KEY: ${N8N_ENCRYPTION_KEY}
      WEBHOOK_URL: https://${N8N_HOST}/
      N8N_HOST: ${N8N_HOST}
      N8N_PROTOCOL: https
      GENERIC_TIMEZONE: Europe/Moscow
      EXECUTIONS_MODE: queue
      QUEUE_BULL_REDIS_HOST: redis
    depends_on: [postgres, redis]
    volumes:
      - n8n_data:/home/node/.n8n
    restart: unless-stopped

  n8n-worker:
    image: n8nio/n8n:latest
    command: worker
    environment:
      DB_TYPE: postgresdb
      DB_POSTGRESDB_HOST: postgres
      DB_POSTGRESDB_DATABASE: ${POSTGRES_DB}
      DB_POSTGRESDB_USER: ${POSTGRES_USER}
      DB_POSTGRESDB_PASSWORD: ${POSTGRES_PASSWORD}
      N8N_ENCRYPTION_KEY: ${N8N_ENCRYPTION_KEY}
      EXECUTIONS_MODE: queue
      QUEUE_BULL_REDIS_HOST: redis
    depends_on: [postgres, redis]
    volumes:
      - n8n_data:/home/node/.n8n
    restart: unless-stopped

volumes:
  postgres_data:
  redis_data:
  n8n_data:

Какие env не потерять ¶

• N8N_ENCRYPTION_KEY — без него можно потерять доступ к credentials после переноса.
• WEBHOOK_URL — внешний адрес для production webhooks.
• GENERIC_TIMEZONE — расписания и отчёты должны жить в понятном часовом поясе.
• DB_POSTGRESDB_* — лучше хранить в Portainer environment или внешнем секрет-хранилище, а не в открытом compose.

Обновление через Portainer без хаоса ¶

1. Сделайте backup PostgreSQL и экспорт важных workflows.
2. Сохраните текущий stack compose и список env.
3. Не обновляйте сразу все сервисы: сначала n8n, затем worker.
4. После redeploy проверьте UI, Webhook node, Schedule Trigger, credentials и очередь.
5. Если ошибка критичная, верните предыдущий image tag и восстановите базу из backup.

Для production лучше фиксировать image tag, например n8nio/n8n:1.x.y, а не всегда использовать latest. Так проще понять, что именно изменилось.

Smoke-test ¶

docker ps --format 'table {{.Names}}\t{{.Status}}\t{{.Ports}}'
docker logs --tail=100 STACKNAME-n8n-1
curl -I https://n8n.example.ru

Затем отправьте POST в тестовый webhook и убедитесь, что execution создался, а worker не завис в queued state.

Частые ошибки Portainer ¶

Связанные инструкции ¶

• Production kit n8n
• PostgreSQL для n8n
• Queue mode и Redis
• Backup и restore

{
  "request_id": "req_demo_001",
  "prompt_version": "2026-05-29",
  "input": "краткое нормализованное сообщение пользователя",
  "allowed_actions": ["read", "draft", "classify"],
  "forbidden_actions": ["send_without_review", "change_payment"],
  "expected_output": {
    "intent": "technical|support|sales|unknown",
    "confidence": 0.0,
    "needs_human_review": true,
    "sources": []
  }
}