Бесплатный урок

Compose и первый приватный вход

Compose и первый приватный вход — Свой n8n для внутренней работы. Минимальный core-only сервис; Конфигурация и readiness отдельно; Owner setup через приватный маршрут. Практическое задание: Практика: Compose и первый приватный вход.

Демо-версия. Материалы проходят редакторскую проверку.

Что рассмотрим

  • Минимальный core-only сервис
  • Конфигурация и readiness отдельно
  • Owner setup через приватный маршрут

Минимальный core-only сервис

Сохраните compose.yaml в новом каталоге и задайте N8N_IMAGE проверенным reference. Mapping ограничен 127.0.0.1:5678; том n8n_data монтирует /home/node/.n8n с SQLite и служебным config. TZ управляет системным временем контейнера, GENERIC_TIMEZONE — временными workflow-триггерами. В учебном примере Europe/Rome, поэтому учитывайте переход летнего времени. Не добавляйте сторонние community nodes, privileged mode или Docker socket. Дополнительные AI-функции и sandbox не нужны первому ручному внутреннему workflow и этим файлом не настраиваются.

name: n8n-lab
services:
  n8n:
    image: ${N8N_IMAGE:?Set a verified official n8n image reference}
    restart: unless-stopped
    ports:
      - "127.0.0.1:5678:5678"
    environment:
      TZ: Europe/Rome
      GENERIC_TIMEZONE: Europe/Rome
      N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS: "true"
    volumes:
      - n8n_data:/home/node/.n8n
volumes:
  n8n_data:

Конфигурация и readiness отдельно

Сначала config --quiet проверяет синтаксис и подстановки, затем отдельно up запускает сервис. На хосте проверьте /healthz и logs без печати секретов. Health endpoint показывает живость процесса, не корректность каждого workflow и не decrypt всех credentials. Если сервис не стартует, проверьте mount, права каталога и ошибку миграции, не создавайте новый пустой том ради сокрытия проблемы. Учебный запуск приведён для своей лаборатории; курс не заявляет выполнение команд или создание вашего аккаунта.

docker compose config --quiet
docker compose up -d n8n
docker compose ps
curl --fail --max-time 5 http://127.0.0.1:5678/healthz
docker compose logs --tail 40 n8n

Owner setup через приватный маршрут

Первый owner setup не оставляют доступным посторонним. Для VPS используйте SSH tunnel к loopback5678 и откройте соответствующий localhost на ноутбуке. Если n8n требует secure cookie и не принимает HTTP в конкретном браузере, настройте HTTPS следующим уроком; не отключайте защиту глобально ради удобства. Создайте owner самостоятельно с надёжным паролем и запишите факт завершения без пароля. Приватная приёмка включает проверку, что анонимный пользователь не открывает редактор с правами owner.

ssh -N -L 15678:127.0.0.1:5678 operator@lab.example
# Open the local forwarded address only after confirming the tunnel.

Практическое задание

Практика: Compose и первый приватный вход

Перейти к обучению

Программа курса

  1. Внутренняя установка и границы
  2. Compose и первый приватный вход
  3. Ключ шифрования и credentials
  4. HTTPS, editor и webhook
  5. Полная резервная копия и восстановление
  6. Обновление и приёмка внутреннего сервиса