Перейти к содержанию

Установка за reverse proxy (Caddy / Nginx)

Настройка DNS

Перед настройкой reverse proxy необходимо привязать доменное имя к серверу, на котором установлен Инсайдер.

В панели управления DNS вашего домена создайте A-запись, указывающую на публичный IPv4-адрес сервера.

Например, для домена insider.your-domain.ru:

Тип Имя Значение
A insider 123.123.123.123

Где 123.123.123.123 — публичный IP-адрес вашего сервера.

После добавления записи проверьте её:

dig +short insider.your-domain.ru A

В ответ должен вернуться IP-адрес вашего сервера.

Важно: DNS-записи могут обновляться с задержкой. Перед выпуском TLS-сертификата убедитесь, что домен указывает на нужный сервер.

Для получения сертификата через стандартную HTTP-проверку Let's Encrypt порт 80 должен быть доступен извне. Для работы сервиса по HTTPS необходимо также открыть порт 443.

Настройка конфигурации сервиса

Перейдите в каталог установки Insider Service. По умолчанию:

cd /opt/InsiderNode/

Откройте конфигурационный файл:

sudo nano configuration.json

В разделе web установите следующие параметры:

"web": {
  "address": "127.0.0.1",
  "port": 8080,
  "https": null
}

Где:

  • address — локальный адрес сервиса. 127.0.0.1 ограничивает подключения текущим сервером.
  • port — внутренний HTTP-порт сервиса. Можно указать любой свободный порт, например 8080.
  • https — установите null, поскольку HTTPS будет обрабатываться reverse proxy.

Остальные параметры конфигурации изменять не требуется.

Для сохранения используйте Ctrl+X далее Y и подтвердите Enter

После сохранения файла перезапустите сервис:

sudo systemctl restart insider-service

Проверьте его состояние:

sudo systemctl status insider-service

Установка веб-сервера

Для настройки reverse proxy установите один из веб-серверов:

Установка выполняется в соответствии с вашей операционной системой.

Далее приведены примеры настройки обоих веб-серверов.

Используйте только один из вариантов

Конфигурация Nginx

Получение TLS-сертификата

Для работы по HTTPS необходим действующий TLS-сертификат.

Можно использовать существующий сертификат либо бесплатно выпустить новый через Let's Encrypt с помощью Certbot.

Если сертификат уже имеется, пропустите этот шаг и укажите пути к нему в конфигурации Nginx.

Для установки Certbot и выпуска сертификатов используйте официальную инструкцию Certbot.

После успешного выпуска сертификат будет доступен по путям:

/etc/letsencrypt/live/insider.your-domain.ru/fullchain.pem
/etc/letsencrypt/live/insider.your-domain.ru/privkey.pem

Настройка Nginx

Создайте/откройте файл конфигурации:

sudo nano /etc/nginx/sites-available/insider.your-domain.ru

Укажите следующую конфигурацию, указав свой домен и пути к сертификатам:

server {
    listen 80;
    server_name insider.your-domain.ru;

    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    http2 on;

    server_name insider.your-domain.ru;

    ssl_certificate /etc/letsencrypt/live/insider.your-domain.ru/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/insider.your-domain.ru/privkey.pem;

    large_client_header_buffers 4 16k;
    client_max_body_size 100M;

    location /assets/ {
        alias /opt/InsiderNode/extract/node/web/assets/;

        expires 1y;
        add_header Cache-Control "public, no-transform";
        access_log off;
    }

    location / {
        proxy_pass http://127.0.0.1:8080;
        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;

        proxy_http_version 1.1;
        proxy_set_header Connection "";

        proxy_request_buffering on;
        proxy_buffering on;
        proxy_read_timeout 300s;
        proxy_send_timeout 300s;
    }
}

Для сохранения используйте Ctrl+X далее Y и подтвердите Enter

Примечание: директива http2 on поддерживается в Nginx 1.25.1 и новее. Для более старых версий используйте listen 443 ssl http2; вместо http2 on.

Применение конфигурации

Проверьте корректность конфигурации:

sudo nginx -t

Если ошибок нет, примените изменения:

sudo systemctl reload nginx

После этого сервис должен быть доступен по адресу:

https://insider.your-domain.ru

Конфигурация Caddy

Caddy автоматически получает и продлевает TLS-сертификаты. Отдельная установка Certbot не требуется.

Для автоматического выпуска сертификата необходимо:

  • Настроить A-запись домена на IP-адрес сервера.
  • Обеспечить доступность сервера по портам 80 и 443.
  • Указать корректное доменное имя в конфигурации Caddy.

Настройка Caddyfile

Откройте конфигурационный файл:

sudo nano /etc/caddy/Caddyfile

Добавьте конфигурацию:

insider.your-domain.ru {
    handle_path /assets/* {
        root * /opt/InsiderNode/extract/node/web/assets
        file_server
        header Cache-Control "public, max-age=31536000"
    }

    reverse_proxy 127.0.0.1:8080
}

Где:

  • insider.your-domain.ru — ваш домен.
  • handle_path /assets/* — обработка запросов к статическим файлам.
  • root — путь к каталогу статических файлов.
  • reverse_proxy — локальный адрес Insider Service.

Для сохранения используйте Ctrl+X далее Y и подтвердите Enter

При первом запуске с корректным доменом Caddy самостоятельно получит TLS-сертификат от поддерживаемого центра сертификации и настроит HTTPS.

Применение конфигурации

Проверьте конфигурацию:

sudo caddy validate --config /etc/caddy/Caddyfile

Если ошибок нет, примените изменения:

sudo systemctl reload caddy

Проверьте состояние службы:

sudo systemctl status caddy

После настройки сервис будет доступен по адресу:

https://insider.your-domain.ru

Примечание: если вы используете собственный TLS-сертификат, его можно указать в Caddyfile с помощью директивы tls:

tls /path/to/certificate.crt /path/to/private.key

Проверка после установки

После завершения настройки откройте браузер и перейдите по адресу:

https://insider.your-domain.ru

Убедитесь, что интерфейс Инсайдер загружается и HTTPS работает без предупреждений о сертификате.

Дополнительно проверить доступность можно командой:

curl -I https://insider.your-domain.ru

Если сайт недоступен, проверьте журналы служб.

Инсайдер:

sudo journalctl -u insider-node -n 100 --no-pager

Nginx:

sudo journalctl -u nginx -n 100 --no-pager

Caddy:

sudo journalctl -u caddy -n 100 --no-pager