Способы обновления сертификатов
clmBot поддерживает два способа обновления сертификатов — их можно выбирать в зависимости от сетевого окружения сервера:
| Способ обновления | Режим работы | Требования к портам | Подходящие сценарии |
|---|---|---|---|
| Отправка из облака | Обновление инициируется из панели управления, серверная часть clmBot принимает и применяет его | Требуется открыть входящий порт 8862/tcp | Когда сетевая политика это разрешает и обновление должно применяться немедленно |
| Получение по расписанию | clmBot периодически запускается через crontab или планировщик задач Windows и проверяет наличие обновлений | Открывать входящий порт не требуется | Серверы, на которых нельзя открыть входящий порт (рекомендуемый способ по умолчанию) |
Эти два способа не конфликтуют друг с другом: для части серверов можно использовать отправку из облака, а для другой части — получение по расписанию.
Способ 1: отправка из облака
Запуск серверной части clmBot на сервере
./clm-bot-linux-amd64 server -a="0.0.0.0:8862"
Параметр -a задаёт адрес и порт прослушивания; по умолчанию используется 0.0.0.0:8862. После запуска clmBot постоянно работает в серверном режиме и ожидает отправки данных из облака.
- Необходимо открыть входящий порт
8862/tcpв межсетевом экране сервера и облачной группе безопасности. - Серверная часть clmBot использует взаимную аутентификацию TLS для соединений отправки из облака и принимает сертификаты только для узлов, подключение и активация которых завершены.
Если вы не хотите открывать входящий порт, используйте способ 2: получение по расписанию。
Для приёма обновлений серверная часть clmBot должна постоянно работать. В рабочей среде рекомендуется зарегистрировать её как системную службу и настроить автоматический запуск при загрузке; см. Развёртывание в качестве службы и обновление。
Отправка сертификата из панели управления
Войдите в панель управления, откройте список точек установки, найдите нужную точку и нажмите 推送证书. После подтверждения система отправит на сервер последний сертификат и автоматически завершит обновление.
Способ 2: получение по расписанию
Получение по расписанию не требует открытия входящих портов и рекомендуется как способ по умолчанию. В clmBot нет встроенного планировщика: команду обновления необходимо периодически запускать через crontab, планировщик заданий Windows или имеющуюся систему планирования.
Linux: настройка crontab
Добавьте команду обновления clmBot в crontab:
crontab -e
Добавьте строку (запуск проверки обновления сертификата каждый день в 3 часа ночи):
0 3 * * * cd /opt/clm-bot && ./clm-bot-linux-amd64 update-certificate >> update.log 2>&1
- Перед выполнением команды необходимо сначала перейти
cdв каталог установки clmBot, так как clmBot по умолчанию читаетconfig.yamlиз текущего каталога. - Также можно не переключать каталог, а указать путь к файлу конфигурации с помощью параметра
-c:./clm-bot-linux-amd64 -c /opt/clm-bot/config.yaml update-certificate. - Пожалуйста, замените путь на фактический каталог установки.
Результат выполнения будет добавлен в update.log, при этом clmBot будет записывать журнал выполнения в logs/clm-bot.log в каталоге, где находится файл конфигурации.
Windows: настройка задания по расписанию
Создайте задание по расписанию на сервере Windows для запуска по таймеру:
cd /d C:\clm-bot && clm-bot-windows-amd64.exe update-certificate >> update.log 2>&1
После завершения создания можно щёлкнуть правой кнопкой мыши по задаче, выбрать «Выполнить» для проверки, а затем просмотреть журнал в каталоге установки, чтобы подтвердить результат выполнения.
Автоматическое перевыпуск и обновление сертификатов
Сертификаты, обновляемые clmBot, поступают из автоматического перевыпуска в облаке. Войдите в административную панель, перейдите на страницу сведений о SSL-сертификате, в настройках автоматического перевыпуска выберите или введите период перевыпуска (например, 30 дней) и сохраните.
Общий эффект после настройки:
- До истечения срока действия сертификата облако автоматически завершает перевыпуск в соответствии с заданным периодом и создаёт новый сертификат.
- clmBot получает новый сертификат настроенным способом (push или периодическое получение).
- clmBot выполняет обновление локального сертификата:
- Если локальный сертификат совпадает с последним сертификатом в облаке, обновление пропускается.
- В противном случае предпринимается попытка создать резервную копию с меткой времени
.bak, после чего последовательно выполняютсяbefore_script, запись нового сертификата и выполнениеafter_script. Если создание резервной копии не удалось, ошибка будет записана, но обновление продолжится; завершение перезагрузки службы следует оценивать по результату выполнения сценария и состоянию промежуточного ПО.
Если необходимо принудительно однократно выполнить after_script без обновления сертификата (например, для отладки сценария перезагрузки), можно использовать параметр --force-after.