Переменные окружения
Конфигурация n8n через переменные окружения
Основные
Заголовок раздела «Основные»| Переменная | Описание | Default |
|---|---|---|
N8N_HOST | Hostname для n8n | localhost |
N8N_PORT | Порт | 5678 |
N8N_PROTOCOL | Протокол (http/https) | http |
N8N_PATH | Base path | / |
WEBHOOK_URL | URL для webhooks | автоматически |
База данных
Заголовок раздела «База данных»SQLite (default)
Заголовок раздела «SQLite (default)»| Переменная | Описание |
|---|---|
DB_TYPE | sqlite |
DB_SQLITE_DATABASE | Путь к файлу DB |
PostgreSQL
Заголовок раздела «PostgreSQL»| Переменная | Описание |
|---|---|
DB_TYPE | postgresdb |
DB_POSTGRESDB_HOST | Хост PostgreSQL |
DB_POSTGRESDB_PORT | Порт (default: 5432) |
DB_POSTGRESDB_DATABASE | Имя базы данных |
DB_POSTGRESDB_USER | Пользователь |
DB_POSTGRESDB_PASSWORD | Пароль |
DB_POSTGRESDB_SSL_REJECT_UNAUTHORIZED | Валидация SSL cert |
| Переменная | Описание |
|---|---|
DB_TYPE | mysqldb |
DB_MYSQLDB_HOST | Хост MySQL |
DB_MYSQLDB_PORT | Порт (default: 3306) |
DB_MYSQLDB_DATABASE | Имя базы данных |
DB_MYSQLDB_USER | Пользователь |
DB_MYSQLDB_PASSWORD | Пароль |
Безопасность
Заголовок раздела «Безопасность»| Переменная | Описание |
|---|---|
N8N_ENCRYPTION_KEY | Ключ шифрования credentials (32+ символов) |
N8N_USER_MANAGEMENT_JWT_SECRET | Secret для JWT токенов |
N8N_BASIC_AUTH_ACTIVE | Включить Basic Auth |
N8N_BASIC_AUTH_USER | Логин для Basic Auth |
N8N_BASIC_AUTH_PASSWORD | Пароль для Basic Auth |
Выполнение
Заголовок раздела «Выполнение»| Переменная | Описание | Default |
|---|---|---|
EXECUTIONS_MODE | regular или queue | regular |
EXECUTIONS_TIMEOUT | Таймаут выполнения (секунды) | -1 |
EXECUTIONS_TIMEOUT_MAX | Максимальный таймаут | 3600 |
EXECUTIONS_DATA_SAVE_ON_ERROR | Сохранять при ошибке | all |
EXECUTIONS_DATA_SAVE_ON_SUCCESS | Сохранять при успехе | all |
EXECUTIONS_DATA_SAVE_ON_PROGRESS | Сохранять прогресс | false |
EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS | Сохранять manual | true |
EXECUTIONS_DATA_PRUNE | Автоочистка | true |
EXECUTIONS_DATA_MAX_AGE | Возраст для очистки (часы) | 336 (14 дней) |
Queue Mode
Заголовок раздела «Queue Mode»| Переменная | Описание |
|---|---|
EXECUTIONS_MODE | queue |
QUEUE_BULL_REDIS_HOST | Redis host |
QUEUE_BULL_REDIS_PORT | Redis port |
QUEUE_BULL_REDIS_PASSWORD | Redis password |
QUEUE_BULL_REDIS_DB | Redis DB number |
QUEUE_HEALTH_CHECK_ACTIVE | Health check для queue |
Логирование
Заголовок раздела «Логирование»| Переменная | Описание | Default |
|---|---|---|
N8N_LOG_LEVEL | error, warn, info, debug | info |
N8N_LOG_OUTPUT | console, file | console |
N8N_LOG_FILE_LOCATION | Путь к log файлу | |
N8N_LOG_FILE_SIZE_MAX | Макс размер файла | 16 (MB) |
Workflows
Заголовок раздела «Workflows»| Переменная | Описание |
|---|---|
WORKFLOWS_DEFAULT_NAME | Имя нового workflow |
N8N_ONBOARDING_FLOW_DISABLED | Отключить onboarding |
N8N_WORKFLOW_TAGS_DISABLED | Отключить теги |
Email (SMTP)
Заголовок раздела «Email (SMTP)»| Переменная | Описание |
|---|---|
N8N_EMAIL_MODE | smtp |
N8N_SMTP_HOST | SMTP сервер |
N8N_SMTP_PORT | Порт |
N8N_SMTP_USER | Пользователь |
N8N_SMTP_PASS | Пароль |
N8N_SMTP_SENDER | Email отправителя |
N8N_SMTP_SSL | Использовать SSL |
Внешние сервисы
Заголовок раздела «Внешние сервисы»| Переменная | Описание |
|---|---|
N8N_METRICS | Включить Prometheus metrics |
N8N_METRICS_PREFIX | Prefix для metrics |
EXTERNAL_FRONTEND_HOOKS_URLS | URL для frontend hooks |
EXTERNAL_BACKEND_HOOKS_URLS | URL для backend hooks |
Ограничения
Заголовок раздела «Ограничения»| Переменная | Описание | Default |
|---|---|---|
N8N_PAYLOAD_SIZE_MAX | Макс размер payload | 16 (MB) |
N8N_HIRING_BANNER_ENABLED | Баннер о найме | true |
N8N_PERSONALIZATION_ENABLED | Персонализация | true |
N8N_VERSION_NOTIFICATIONS_ENABLED | Уведомления о версиях | true |
N8N_TEMPLATES_ENABLED | Шаблоны | true |
| Переменная | Описание |
|---|---|
N8N_AI_ENABLED | Включить AI фичи |
N8N_AI_PROVIDER | Провайдер AI (openai) |
N8N_AI_OPENAI_API_KEY | API ключ OpenAI |
Пример .env
Заголовок раздела «Пример .env»# ОсновныеN8N_HOST=n8n.example.comN8N_PORT=5678N8N_PROTOCOL=httpsWEBHOOK_URL=https://n8n.example.com/
# База данныхDB_TYPE=postgresdbDB_POSTGRESDB_HOST=postgresDB_POSTGRESDB_PORT=5432DB_POSTGRESDB_DATABASE=n8nDB_POSTGRESDB_USER=n8nDB_POSTGRESDB_PASSWORD=secure_password_here
# БезопасностьN8N_ENCRYPTION_KEY=32_char_encryption_key_here_xxxN8N_USER_MANAGEMENT_JWT_SECRET=another_secret_key_here
# ВыполнениеEXECUTIONS_DATA_PRUNE=trueEXECUTIONS_DATA_MAX_AGE=168
# ЛогированиеN8N_LOG_LEVEL=info
# TimezoneGENERIC_TIMEZONE=Europe/MoscowПеременные в Workflows
Заголовок раздела «Переменные в Workflows»Глобальные переменные
Заголовок раздела «Глобальные переменные»В n8n UI: Settings → Variables
Доступ в expressions:
{{ $vars.MY_VARIABLE }}Переменные окружения в Expressions
Заголовок раздела «Переменные окружения в Expressions»{{ $env.MY_ENV_VAR }}Следующие шаги
Заголовок раздела «Следующие шаги»- Docker — настройка контейнера
- Масштабирование — queue mode
- Безопасность — SSL и auth