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

Адрес и соединение
Общие настройки транспорта сохраняются в базе данных и входят в одну ревизию: публичный URL, режим работы сервиса, список CORS-источников и сертификат TLS. Эти значения не переопределяются ENV.
| Поле | Назначение и формат | Когда применяется |
|---|---|---|
| Публичный URL | Внешний адрес приложения для ссылок и настроек безопасности браузера. Укажите http:// или https://, имя узла и при необходимости порт, например https://salary.example.test. Не указывайте имя пользователя, пароль, запрос или путь; завершающий / допустим. Поле должно быть обязательно заполнено. |
Сохраняется в общей ревизии транспорта. Чтобы узлы использовали новое значение, запустите команду Перезапустить сервис. |
| Режим работы сервиса | Выберите HTTP или HTTPS для входящих соединений самого приложения. Это не режим восстановления узла. Если HTTPS завершается на доверенном обратном прокси, приложение может принимать соединения по HTTP. |
Сохраняется в общей ревизии и применяется при перезапуске узла. |
| CORS origins (по одному на строку) | Список веб-адресов, с которых открытые в браузере страницы отправляют запросы к приложению и читают ответы. Для каждого укажите схему и имя узла, а при необходимости порт: например https://salary.example.test или http://localhost:5173. Не указывайте путь, завершающий /, шаблон *, запрос, фрагмент или учётные данные. Разрешено укахывать до 32 источников, пустые строки игнорируются. |
Оставьте список пустым, если страницы и приложение открыты с одного источника. Добавьте точные адреса размещения страниц, если они загружаются с другого источника. Сервис не разрешает другие источники автоматически. Изменение применяется после перезапуска узлов. |
Поле Режим работы сервиса задаёт, на каком соединении приложение принимает запросы. Оно не определяет Режим работы узла в карточке узла. На этой странице режим и способ доступа к восстановлению показываются, когда узел находится в соответствующем состоянии.
Параметры контроллера
Контроллер следит за узлами и координирует команды перезапуска через общую базу данных. Длительность должна указываться с единицей измерения: s — секунды, m — минуты, h — часы. Например, 5s, 30s, 2m или 1m30s. Значение без единицы, например 30, не допускаются.
Интервалы связи с узлами
| Поле | Назначение и допустимое значение | Когда применяется |
|---|---|---|
| Интервал опроса | Как часто узел проверяет команды из очереди и отправляет подтверждение о своем состояния. По умолчанию 5s; значение должно быть больше нуля. |
Сохранённое значение начнёт действовать на узле после явного перезапуска. |
| Порог устаревшего узла | Период после которого состояние узла становится неизвестным (устаревшим). По умолчанию 30s; значение должно быть больше нуля. Неизвестное состояние не доказывает, что приложение остановлено. |
Сохранённое значение начнёт действовать на узле после явного перезапуска. |
Команды перезапуска
| Поле | Назначение и допустимое значение | Когда применяется |
|---|---|---|
| Срок начала команды | Сколько времени даётся узлу, чтобы начать выполнение принятой команды на перезапуск. По умолчанию 2m0s; значение должно быть больше нуля. При принятии команды срок её начала фиксируется из действующего тогда значения. |
Новое сохранённое значение действует для команд после перезапуска узла. Подробнее — срок начала команды. |
| Ожидание остановки | Сколько времени отводится на ожидание штатной остановки процессов узла перед перезапуском. По умолчанию 30s; значение должно быть больше нуля. Если остановка не завершилась, новый запуск ждёт фактического завершения прежней работы. Истечение этого срока само по себе не завершает процесс. |
Новое сохранённое значение действует после перезапуска узла. Подробнее — ход перезапуска. |
| Ожидание готовности кандидата | Сколько времени отводится на подготовку приложения на этом узле во время перезапуска: загрузку сохранённых настроек, создание необходимых компонентов, открытие HTTP- или HTTPS-службы и проверку её готовности. После успешной проверки приложение начинает принимать обычные запросы. По умолчанию 1m0s (допустимо от 5s до 10m). |
При следующем явном перезапуске это значение задаёт время подготовки приложения. После успешного перезапуска оно становится действующим на узле. Подробнее — ход перезапуска. |
Предупреждение TLS
| Поле | Назначение и допустимое значение | Когда применяется |
|---|---|---|
| Срок предупреждения TLS, дней | За сколько дней до окончания срока сертификата показывать предупреждение. По умолчанию 30; допустимо целое число от 1 до 365. Это только срок предупреждения: значение не продлевает сертификат. |
При сохранении это значение сразу используется для статуса ожидающего сертификата. После успешного явного перезапуска оно задаёт предупреждения для сертификатов работающих узлов. |
Сохранённые и действующие значения
Общие правила описаны в разделе Источники настроек и сохранение. Эти подписи относятся к параметрам контроллера, а не к общей ревизии транспорта. Поля контроллера при открытии формы показывают Сохранено:
- Сохранено — значение из базы данных; если его там нет, используется YAML-файл или значение по умолчанию.
- Действует — значение, которое узел использует сейчас.
- Будет действовать после перезапуска — следующее значение с учётом общего приоритета источников.
Для параметров контроллера значения из ENV и .env нельзя изменить в этой форме. Если источник — YAML, сохранение значения заменит его. Подпись источника показывается для ENV, .env и YAML; база данных и значение по умолчанию отдельной подписью не отмечаются. Строка со сравнением появляется, только когда введённое значение отличается от действующего.
Загрузить сертификат TLS
TLS — защищённое соединение HTTPS. Сертификат и закрытый ключ нужны, если приложение переключено в режим работы по HTTPS. Если HTTPS завершается на доверенном прокси, загрузка сертификата в приложение может быть не нужна.
| Поле или статус | Назначение и формат |
|---|---|
| Выбрать цепочку сертификатов PEM | Выберите файл .pem, .crt или .cer с цепочкой сертификатов. Размер — не более 262 144 байт (примерно 262 Кб) и не более 16 сертификатов. Сертификаты должны действовать сейчас и образовывать корректную цепочку. |
| Выбрать закрытый ключ PEM | Выберите соответствующий незашифрованный парольной фразой ключ в файле .pem или .key. Поддерживаются форматы PKCS#1, PKCS#8 и SEC1. Размер — не более 65 536 байт (примерно 66 Кб). Ключ должен соответствовать сертификату. |
| Я понимаю риск передачи закрытого ключа по HTTP | Подтверждение требуется, когда страница панели открыта по HTTP. Оно зависит от адреса страницы, а не от выбранного режима работы сервиса. Передача ключа по HTTP не защищена от перехвата; используйте HTTPS, особенно в публичной сети. |
| Сертификат ожидающей конфигурации | Показывает состояние сертификата в ожидающих настройках (которые будут применены после перезагрузки): Сертификат действует, Срок сертификата скоро истекает или Сертификат истёк, а также владельца и поле Действует до. Дата показана в часовом поясе браузера. Порог предупреждения берётся из параметра настроек Срок предупреждения TLS, дней. Это сведения для ожидающей к загрузке конфигурации, оно не отностится к сертификату, который используется узлом в данный момент. |
До выбора файла рядом с каждым полем отображается Файл не выбран. После выбора цепочки отображается её имя. Для закрытого ключа интерфейс показывает только Закрытый ключ выбран — имя и содержимое ключа не показывает.
Размер всей загрузки, включая оба файла, не может превышать 1 048 576 байт (примерно 1 Мб).
- Сначала сохраните нужные Публичный URL, Режим работы сервиса и CORS origins (по одному на строку) кнопкой Сохранить настройки.
- Выберите цепочку сертификатов и закрытый ключ. Если страница открыта по HTTP, подтвердите риск передачи ключа.
- Нажмите Загрузить TLS и дождитесь окончания загрузки. Во время отправки кнопка показывает Загрузка….
Загрузка сертификата сама сохраняет ожидающую конфигурацию TLS, но не включает HTTPS и не переключает узлы. Для загрузки сервис берёт URL, режим и CORS из уже сохранённых настроек; несохранённые изменения формы перечитываются и теряются. После завершения любой попытки загрузки выбор файлов и подтверждение HTTP сбрасываются.
Если ожидающий сертификат истёк, приложение не применит его, а выбранная конфигурация останется прежней. Проверьте сведения о сертификате в карточке узла, чтобы узнать о фактически используемом сертификате.
Сохранение транспорта и контроллера
Общие правила описаны в разделе Источники настроек и сохранение. Для транспорта действуют следующие особенности:
- Нажмите Сохранить настройки. Пока запрос выполняется, кнопка показывает Сохранение…. Она сохраняет общую ревизию транспорта и параметры контроллера, но не перезапускает узлы.
- Чтобы начать применение сохранённых настроек, используйте команду Перезапустить сервис над вкладками страницы Настройки. Она описана в инструкции перезапуска. Успешный явный перезапуск применяет новые настройки транспорта и следующие параметры контроллера на каждом перезапущенном узле.
- Если форма устарела после изменений другого администратора, появится сообщение Настройки были изменены. Обновите данные и повторите действие. Кнопки сохранения, отмены и загрузки TLS останутся недоступны, пока вы успешно не перечитаете настройки. Сохраните свои правки отдельно. Нажмите Перечитать настройки, затем внесите их заново.
Кнопка Перечитать настройки заменяет несохранённые изменения данными с сервера без дополнительного подтверждения. Общие правила перечитывания и применения внешних источников приведены в разделе Источники настроек и сохранение.
Отмена ожидающих изменений
Кнопка Отменить ожидающие изменения удаляет только отдельную ожидающую ревизию для настроек транспорта: URL, режим работы, CORS и TLS. Она не откатывает фактическую конфигурацию узлов и не меняет параметры контроллера. Если ревизия уже выбрана для применения командой перезапуска, отменить её нельзя.
Кнопка отображается, только если есть отдельная ожидающая ревизия транспорта с изменениями URL, режима работы, CORS или TLS, которая ещё не выбрана для применения. Если изменены только параметры контроллера, кнопка не отображается: введите прежние значения вручную и сохраните настройки. Если новые значения уже применены к узлам, для их замены также потребуется явный перезапуск.
Состояние восстановления узлов
В нижней части Настройки → Транспорт могут появляться справочные сообщения по отдельным узлам. Они показывают последнее полученное состояние восстановления и ошибки доступа; изменить их в этой форме нельзя. Набор полей зависит от состояния узла: часть сведений появляется только при обслуживании или ошибке.
Не путайте поле формы Режим работы сервиса, которое задаёт HTTP или HTTPS, и Режим работы узла, которое показывает состояние запущенного сервиса.
| Поле | Как читать |
|---|---|
| Режим работы узла | Показывает состояние обычного сервиса: Обычный сервис запущен, Только восстановление узла, Запуск, Перезапуск или Ошибка. Если состояние нельзя определить, рядом указывается причина: Нет актуального ответа от узла, Запись узла удалена, Полученные сведения не позволяют определить режим работы узла или Нет сведений об этом узле. |
| Способ доступа к восстановлению | Показывает, где узел открыл страницу восстановления: Прежние настройки соединения, Локальный аварийный вход или Прежние настройки соединения и локальный аварийный вход. При неизвестном способе отображается пояснение; остальные значения описаны в разделе режимы восстановления. |
| Причина восстановления | Показывает, какая проблема стала причиной перехода узла в режим восстановления, например неудачное применение настроек или истёкший сертификат TLS. |
| Ошибка открытия доступа к восстановлению | Поясняет, что помешало запустить режим восстановления для конкретного вызова. Эта ошибка сама по себе не означает, что недоступны все способы входа на всех узлах. |
Примеры сочетаний:
- Только восстановление узла и Прежние настройки соединения: обычные функции не запущены, а узел доступен только через страницу восстановления с прежними настройками HTTP/HTTPS-соединения. Порядок входа описан в разделе режим восстановления.
- Только восстановление узла и Локальный аварийный вход: обычные функции не запущены, страница восстановления доступна через локальный адрес (
127.0.0.1илиlocalhost) на хосте где запущен экземпляр узла. Это неlocalhostкомпьютера администратора. Точное значение адреса зависит от конкретной установки, например, от порта и сети контейнера. - Обычный сервис запущен и Локальный аварийный вход: такое сочетание возможно, например, если истёк сертификат работающего HTTPS-сервиса. Обычный сервис продолжает принимать HTTPS-соединения, но браузер может блокировать доступ панели управления. Локальный доступ к странице восстановления нужен для замены сертификата.
Нет актуального ответа от узла означает, что система не получила свежего подтверждения состояния от узла (
keep-aliveне получен вовремя). Это не означает, что процесс узла остановлен. Проверьте в карточке узла время последнего сигнала с обновлением и связь, а причины и адреса восстановления — в разделе режимы восстановления.