Установка за 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