Важнейшие переменные окружения объяснены (N8N_HOST, WEBHOOK_URL, GENERIC_TIMEZONE ...)

Тот, кто самостоятельно размещает экземпляр n8n, настраивает центральные параметры, такие как доступность, часовой пояс, база данных и безопасность, не через интерфейс, а через переменные окружения, которые задаются при запуске контейнера или процесса. Из более чем ста задокументированных переменных для большинства немецких self-hosting установок действительно важна лишь горстка, например N8N_HOST для имени хоста, WEBHOOK_URL для публичного доступа за reverse proxy или GENERIC_TIMEZONE, чтобы workflow по расписанию запускались в правильное время. Эта статья систематизирует наиболее практически значимые переменные по темам и показывает пример использования для каждой. По состоянию на: июль 2026.

Базовая конфигурация: доступность, URL и часовой пояс

Эти переменные определяют, как n8n доступен внутренне и внешне, а также в каком часовом поясе выполняются workflow по расписанию.

• N8N_HOST: Определяет имя хоста, по которому n8n доступен внутренне, значение по умолчанию localhost, для сервера с собственным доменом например n8n.вашакомпания.de.
• N8N_PORT: Порт, который прослушивает процесс n8n, значение по умолчанию 5678, актуально, если на одном сервере параллельно работает несколько служб.
• N8N_PROTOCOL: Определяет, обращается ли n8n внутренне через http или https, по умолчанию http, за reverse proxy, терминирующим TLS, внутри обычно остаётся http.
• N8N_EDITOR_BASE_URL: Публичный URL, по которому пользователи попадают в редактор, также используется для ссылок в email и переадресаций SAML, пример https://n8n.вашакомпания.de.
• WEBHOOK_URL: Устанавливается вручную, когда n8n работает за reverse proxy, чтобы входящие webhook использовали правильный публичный адрес, пример https://n8n.вашакомпания.de/.
• GENERIC_TIMEZONE: Часовой пояс экземпляра n8n, значение по умолчанию America/New_York, для немецких установок сюда практически всегда нужно указывать Europe/Berlin, иначе cron- и schedule-триггеры срабатывают в неверное время.

Безопасность и защита данных

Особенно для компаний, для которых важны немецкий суверенитет данных и контроль над собственными данными, стоит внимательно рассмотреть переменные, связанные с безопасностью.

• N8N_ENCRYPTION_KEY: Ключ, которым n8n шифрует учётные данные в базе данных, генерируется случайно, если не указан, в продуктивных установках его следует задать фиксированно и хранить надёжно, так как сохранённые учётные данные иначе больше нельзя расшифровать после пересоздания.
• N8N_SECURE_COOKIE: Обеспечивает передачу cookie только через HTTPS, значение по умолчанию true, следует устанавливать в false только при чисто HTTP-тестовом режиме без TLS.
• N8N_BLOCK_ENV_ACCESS_IN_NODE: Предотвращает доступ пользователей к переменным окружения сервера через выражения или узел Code, значение по умолчанию false, для многопользовательских экземпляров с чувствительными учётными данными рекомендуется true.
• N8N_DIAGNOSTICS_ENABLED: Управляет тем, отправляет ли n8n анонимизированные телеметрические данные производителю, значение по умолчанию true, кто хочет максимального суверенитета данных, устанавливает здесь false.

База данных и эксплуатация

Для продуктивной эксплуатации большинство установок переходят со встроенной базы данных SQLite на PostgreSQL, что настраивается через собственные переменные.

• DB_TYPE: Определяет используемую базу данных, значение по умолчанию sqlite, postgresdb является распространённым значением для продуктивных сред с несколькими одновременными пользователями.
• DB_POSTGRESDB_HOST: Имя хоста сервера PostgreSQL, значение по умолчанию localhost, для отдельной базы данных например внутреннее имя хоста контейнера базы данных.
• DB_POSTGRESDB_DATABASE: Имя базы данных PostgreSQL, значение по умолчанию n8n, может быть изменено при нескольких экземплярах на одном сервере.
• DB_POSTGRESDB_USER / DB_POSTGRESDB_PASSWORD: Учётные данные для подключения к PostgreSQL, без значения по умолчанию для пароля, как и любой пароль базы данных, не должны попадать в открытом виде в репозиторий, а должны управляться через secret.
• N8N_PROXY_HOPS: Указывает, за сколькими reverse proxy работает n8n, значение по умолчанию 0, обычно 1 при одном Nginx или Traefik перед ним, чтобы n8n корректно определял фактический IP клиента.

Большинство проблем при self-hosting n8n возникают не из-за отсутствующих переменных, а из-за неверно заданных URL или часового пояса, не соответствующего расположению сервера. Кто хочет настроить, обезопасить или перенести собственный экземпляр n8n на Postgres, найдёт у n8n-услуг NordFlux поддержку по настройке и конфигурации.

Часто задаваемые вопросы о переменных окружения n8n

Где задавать переменные окружения в n8n?

Это зависит от типа установки. В Docker это происходит через флаги -e или файл .env в docker-compose.yml, при классической установке как системные переменные окружения, которые задаются перед запуском процесса n8n.

Что произойдёт, если я не задам N8N_ENCRYPTION_KEY?

В этом случае n8n автоматически генерирует случайный ключ при первом запуске. Если он теряется, например при пересоздании контейнера без постоянного хранилища, уже сохранённые учётные данные больше нельзя расшифровать.

Всегда ли нужно задавать WEBHOOK_URL?

Только если n8n работает за reverse proxy или под другим публичным адресом, чем настроено внутренне. При прямом доступе через N8N_HOST и N8N_PORT переменная обычно не нужна.

Можно ли изменить переменные окружения впоследствии?

Да, большинство переменных вступают в силу только после перезапуска процесса n8n. Выполняющиеся workflow и уже сохранённые данные при этом не затрагиваются, пока не меняется подключение к базе данных.

Дополнительные подробности обо всех задокументированных переменных можно найти в документации n8n о переменных окружения, а также отдельно о настройке базы данных.