Все гайды

Подготовка и запуск

n8n на сервере — как подготовить проект к запуску

Что подготовить для self-hosted n8n — владельца, сервер, домен, HTTPS, обратный прокси, webhook URL, ключ шифрования и первую проверку.

  • 3 мин
  • обновлено 23 июля
  • настройка

n8n нужен, когда автоматизация должна постоянно принимать события, связывать несколько сервисов и оставлять понятный след в панели запусков. Например, заявка приходит с сайта, проверяется на дубль, попадает в CRM и дает менеджеру уведомление. Если задача сводится к одному короткому скрипту по расписанию, отдельный n8n может быть лишним слоем.

Этот гайд нужен для технической подготовки. Сценарий и ожидаемый результат лучше сначала собрать в маршруте автоматизации заявок или в карте выбора решения.

Что должно быть готово к концу

У проекта есть отдельный адрес панели n8n, например https://n8n.company.ru, подтвержденный владелец, резервная копия данных и один проверенный workflow. Внешние сервисы получают корректный HTTPS webhook, а ключи не лежат в открытых таблицах и исходниках.

Что подготовить до установки

  • VPS с доступом у владельца проекта;
  • домен или поддомен и доступ к DNS;
  • отдельный человек или роль, которая владеет учетной записью n8n, сервером и резервными копиями;
  • список сервисов и первый проверяемый сценарий;
  • защищенный канал для ключей и токенов.

Если домен уже обслуживает сайт, чаще достаточно отдельного поддомена. Так панель и webhook получают стабильный HTTPS-адрес, а основной сайт не приходится переносить.

Рабочий маршрут развертывания

  1. Разверните n8n через актуальный Docker-маршрут из official docs и закрепите понятную версию образа в проектной конфигурации.
  2. Поставьте n8n за reverse proxy с HTTPS. Внешний адрес панели и webhook должен совпадать с тем, что видят подключаемые сервисы.
  3. Если n8n находится за proxy, задайте публичный WEBHOOK_URL. При нескольких proxy hops их число настраивается в deployment-конфигурации, а не угадывается по старому примеру.
  4. Сохраните N8N_ENCRYPTION_KEY как deployment secret. Этот ключ нужен, чтобы credentials можно было расшифровать после перезапуска или переноса. Его нельзя менять или терять без плана миграции.
  5. Создайте нормальный владелецкий доступ в самой панели n8n и выдайте роли только тем, кому они нужны. Не копируйте старые рецепты с устаревшими Basic Auth переменными.
  6. Настройте бэкап persistent data и понятный способ восстановить его на новом сервере.

Как проверить до включения рабочего сценария

Соберите один безопасный тест без массовой отправки и без списания денег:

  1. Отправьте тестовую заявку или другой входной объект.
  2. Проверьте, что n8n получил его по правильному URL.
  3. Убедитесь, что запись появилась в нужной CRM, таблице или другом приемнике без дубля.
  4. Проверьте уведомление и понятный путь ошибки, если один из сервисов недоступен.
  5. Прочитайте результат тем же способом, которым им пользуется менеджер или клиент, а не только в интерфейсе n8n.

После этого можно включать production workflow. Для очередей, повторов и ограничений сервисов используйте гайд по лимитам API, а для передачи ключей — правила хранения env и доступов.

Что передать исполнителю

  • IP сервера, SSH-порт и способ безопасного входа;
  • домен или поддомен и доступ к DNS;
  • контакт владельца инфраструктуры;
  • первый сценарий, поля входа и ожидаемый readback;
  • ключи сервисов только защищенным способом.

Не отправляйте root-пароли, API-ключи или JSON-файлы в общий чат и не вставляйте их в текст workflow.

Первоисточники

Официальные документы