Безкоштовний урок

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 лише власноруч із надійним паролем і запишіть факт завершення без пароля. До приватного acceptance належить перевірка, що анонімний користувач не відкриває редактор як 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. Оновлення й приймання внутрішнього сервісу