N8n порт

N8n порт: детальное руководство по настройке, управлению и безопасности

N8n — это мощный инструмент автоматизации рабочих процессов с открытым исходным кодом, который работает как веб-приложение. Ключевым аспектом его развертывания и доступа является конфигурация сетевого порта. Порт в контексте n8n — это сетевой endpoint, через который веб-сервер приложения принимает входящие HTTP/HTTPS запросы. По умолчанию n8n использует порт 5678. Управление этим портом критически важно для установки, интеграции с обратным прокси (например, Nginx), обеспечения безопасности и работы в различных средах, таких как Docker, облачные сервисы или локальные серверы.

Конфигурация порта в n8n

Порт, который использует n8n, задается через переменные окружения или аргументы командной строки. Основной переменной является N8N_PORT. Приложение сначала читает аргументы командной строки, затем переменные окружения, и если ничего не задано, использует значение по умолчанию — 5678.

В Linux/macOS (через терминал): N8N_PORT=8080 n8n start
В Windows (через командную строку): set N8N_PORT=8080 && n8n start
В Docker: Указание в docker-compose.yml или через флаг -e.
Использование файла .env: Создайте файл в корневой директории n8n с содержанием N8N_PORT=8080.

Для проверки, на каком порту работает экземпляр n8n, можно посмотреть логи запуска. Первые строки лога будут содержать сообщение вида: «n8n ready on http://localhost:[PORT]» или «Webhook listener started on port [PORT]».

Таблица стандартных и альтернативных портов

Порт	Назначение и рекомендации по использованию
5678	Порт по умолчанию для n8n. Не требует запоминания, но может конфликтовать с другими службами.
80 (HTTP)	Стандартный порт для веб-трафика. Прямое использование не рекомендуется. Следует использовать обратный прокси.
443 (HTTPS)	Стандартный порт для защищенного HTTPS трафика. Настраивается через обратный прокси или встроенный сервер n8n с SSL-сертификатами.
8080, 3000, 5000	Распространенные альтернативные порты для веб-приложений в разработке и тестировании.
8443	Альтернативный порт для HTTPS, часто используемый, когда 443 занят или недоступен без прав root.

Настройка n8n за обратным прокси (Nginx, Apache)

В production-средах n8n почти никогда не открывают напрямую на стандартном порту. Вместо этого его запускают на localhost или внутреннем порту, а доступ организуют через обратный прокси-сервер. Это необходимо для:

Обработки HTTPS (SSL/TLS) терминации.
Использования стандартных портов 80/443.
Организации единой точки входа для нескольких сервисов.
Добавления дополнительных уровней безопасности (аутентификация, ограничение по IP).

Пример конфигурации Nginx для n8n

Предположим, n8n работает на порту 5678 на том же сервере. Задача — сделать его доступным по домену automation.example.com через HTTPS.

N8n запущен: http://127.0.0.1:5678
Цель: https://automation.example.com

Конфигурационный файл Nginx (/etc/nginx/sites-available/n8n):

server {
    listen 80;
    server_name automation.example.com;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name automation.example.com;

    ssl_certificate /path/to/your/certificate.crt;
    ssl_certificate_key /path/to/your/private.key;

    location / {
        proxy_pass http://127.0.0.1:5678;
        proxy_set_header Connection '';
        proxy_http_version 1.1;
        chunked_transfer_encoding off;
        proxy_buffering off;
        proxy_cache off;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        Важно для корректной работы вебхуков и WebSocket
        proxy_read_timeout 300s;
    }
}

После настройки необходимо проверить конфигурацию (nginx -t) и перезагрузить Nginx (systemctl reload nginx). Также в n8n необходимо установить переменные окружения для корректного формирования URL:
N8N_HOST=automation.example.com и N8N_PROTOCOL=https. Это гарантирует, что ссылки в интерфейсе и вебхуки будут создаваться с правильным доменом и протоколом.

Безопасность и управление портами

Неконтролируемое открытие порта n8n представляет серьезную угрозу безопасности, так как дает доступ к мощному инструменту автоматизации.

Файрвол: Обязательно настройте брандмауэр (UFW, firewalld, iptables, облачные Security Groups). Открывайте порт n8n (или прокси) только для необходимых IP-адресов (например, офисной сети или IP-адреса вашего VPN).
Аутентификация: Всегда включайте аутентификацию в n8n для production-развертываний через переменные N8N_BASIC_AUTH_ACTIVE=true, N8N_BASIC_AUTH_USER и N8N_BASIC_AUTH_PASSWORD.
Локальный биндинг: При запуске n8n на сервере без прокси используйте привязку к localhost: N8N_HOST=localhost. Это ограничит доступ только с самой машины. Для доступа извне потребуется SSH-туннель.
Регулярное обновление: Поддерживайте n8n и все сопутствующие компоненты (Nginx, ОС) в актуальном состоянии.

Особые случаи и смежные настройки

Webhook порт

N8n для приема входящих вебхуков использует тот же порт, что и основной веб-интерфейс. Однако в сложных сценариях (например, при работе за балансировщиком нагрузки) может потребоваться отдельная настройка. Ключевая переменная — WEBHOOK_URL. Она должна указывать на публичный адрес и порт, по которому внешние системы могут доставлять вебхуки. Например: WEBHOOK_URL=https://automation.example.com/. Если n8n слушает на нестандартном порте, его также нужно указать: WEBHOOK_URL=http://internal-server:5678/ для внутренней маршрутизации.

Порт в Docker-контейнере

При развертывании через Docker важно различать порт внутри контейнера и порт на хосте. Внутри контейнера n8n по-прежнему работает на порту, заданном N8N_PORT (по умолчанию 5678). На хосте этот порт маппится на другой.

Docker run: docker run -it --rm --name n8n -p 8080:5678 n8nio/n8n (порт хоста:порт контейнера).

Docker Compose:

version: '3.8'
services:
  n8n:
    image: n8nio/n8n
    ports:
      - "8080:5678"
    environment:
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - N8N_HOST=localhost

Конфликты портов

Если порт 5678 занят другим приложением (например, другим экземпляром n8n или службой AMQP), n8n не запустится. В логах будет ошибка «EADDRINUSE». Решения:

Использовать другой порт через N8N_PORT.
Остановить службу, занимающую порт (проверить: sudo lsof -i :5678 или netstat -tulpn | grep :5678).
При запуске нескольких экземпляров n8n на одном хосте каждому назначить уникальный порт.

Диагностика проблем с портами

Приложение не запускается, ошибка EADDRINUSE: Порт занят. См. раздел «Конфликты портов».
Нет доступа из сети, хотя служба запущена: Проверьте брандмауэр и правила безопасности облачного провайдера. Убедитесь, что n8n слушает на всех интерфейсах (0.0.0.0), а не только на localhost (127.0.0.1). За это отвечает переменная N8N_HOST. Для доступа извне установите N8N_HOST=0.0.0.0 (с учетом рисков безопасности).
Вебхуки не доставляются: Убедитесь, что переменная WEBHOOK_URL задана правильно и указывает на адрес и порт, доступные отправителю вебхука извне. Проверьте настройки обратного прокси и время ожидания (timeout).
Проблемы с WebSocket (режим реального времени в редакторе): При использовании прокси убедитесь, что он корректно передает заголовки Upgrade для WebSocket-соединений. В Nginx нужны директивы proxy_set_header Upgrade $http_upgrade; и proxy_set_header Connection "upgrade";.

Ответы на часто задаваемые вопросы (FAQ)

Как изменить порт n8n на 80?

На Unix-системах порты ниже 1024 требуют прав суперпользователя. Не рекомендуется запускать n8n от root. Лучшее решение — оставить n8n на высоком порту (5678, 8080) и использовать обратный прокси-сервер (Nginx/Apache), который будет принимать запросы на порту 80 и перенаправлять их на n8n.

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

Да. Для этого каждый экземпляр должен быть запущен на уникальном порту. Задайте разные порты через переменную N8N_PORT (например, 5678, 5679, 5680) и, при необходимости, разные пути к данным (через N8N_USER_FOLDER или разные тома в Docker). Также убедитесь, что для каждого экземпляра настроен уникальный внешний адрес (домен или субдомен) в конфигурации обратного прокси.

Почему после настройки за Nginx перестали работать вебхуки?

Наиболее вероятные причины:

Неправильно задана переменная WEBHOOK_URL. Она должна указывать на публичный адрес, по которому доступен Nginx (например, https://automation.example.com), а не на внутренний адрес n8n.
В конфигурации Nginx не хватает настроек для длительных соединений (директива proxy_read_timeout).
Проблемы с SSL-сертификатом на стороне Nginx, из-за чего внешние сервисы не могут доставить вебхук.

Как полностью запретить доступ к n8n из интернета, оставив только локальный?

Есть несколько методов:

Запустить n8n с N8N_HOST=localhost. Это привяжет сервер только к loopback-интерфейсу.
Настроить файрвол на блокировку входящих соединений на порт n8n (или прокси) со всех адресов, кроме 127.0.0.1.
Не публиковать порт в Docker (убрать секцию ports в docker-compose). Доступ тогда будет возможен только через сеть Docker или если подключиться к контейнеру по SSH.

Для удаленного управления используйте SSH-туннель: ssh -L 5678:localhost:5678 user@your-server. После этого n8n будет доступен локально по http://localhost:5678.

Какие порты нужно открыть в облачном брандмауэре (Security Group) для развертывания n8n?

Зависит от архитектуры:

Прямой доступ к n8n: Откройте порт, указанный в N8N_PORT (например, TCP/5678) для доверенных IP-адресов.
Доступ через Nginx/Apache на стандартных портах: Откройте TCP/80 (HTTP) и TCP/443 (HTTPS) для всех (0.0.0.0/0) или для ограниченного списка IP. Порт n8n (5678) должен быть открыт только для внутреннего трафика (например, с IP самого сервера 127.0.0.1 или из внутренней подсети).
Доступ только через VPN: Откройте порты прокси или n8n только для IP-адресов вашей VPN-сети.

Как настроить HTTPS напрямую в n8n без обратного прокси?

N8n имеет встроенную поддержку SSL. Задайте следующие переменные окружения:

N8N_PROTOCOL=https
N8N_SSL_KEY=/path/to/your/key.key
N8N_SSL_CERT=/path/to/your/cert.crt

При этом приложение будет обслуживать HTTPS трафик напрямую на порту, указанном в N8N_PORT. Однако этот метод менее гибок, чем использование специализированного прокси-сервера, который лучше справляется с оптимизацией, кешированием и защитой.