3.4 KiB
Remediation API (хост, порт 5000)
Разобрано и приведено в порядок 28.10.2026.
Что это
FastAPI-сервис remediation-api.service (/opt/remediation-api/api.py).
Единственный маршрут — POST /api/v1/remediate, заголовок x-api-key,
тело {"action": "restart_service", "target": "<служба>"}.
Действие restart_service выполняет pct exec <CT> -- systemctl reboot,
то есть перезагружает целый контейнер, а не отдельный процесс.
Фактически это удалённая перезагрузка любой CT по ключу.
Что было не так
/opt/buryan-hub/config/remediation.conf— файл от 28.09 с URL и токеном. Его никто не читал (поиск по/opt,/root,/etc— без ссылок), а токен внутри уже недействителен: проверкаPOST /api/v1/remediateс ним давала401 Invalid API Key, тогда как живой ключ из/opt/remediation-api/.envпроходит авторизацию (ответ400 Action not allowedна тестовое действие). Файл убран; копия —/root/.remediation-conf.removed-20261028(600).- Сервис слушал
0.0.0.0:5000и был доступен из любой CT:GET /docsотдавал 200 и с хоста, и из CT108/CT110. Токен — единственная защита от перезагрузки контейнеров. Переведён на127.0.0.1:5000; проверено: локально/docs→ 200, из CT108 → нет соединения. Бэкап юнита:/root/remediation-api.service.bak-*. - Неверный адрес у потребителя: в
/opt/telegram-bot/.envбылоREMEDIATION_API_URL=http://192.168.1.1:5000— это роутер, а не хост (правильный192.168.1.10). Исправлено наhttp://127.0.0.1:5000.
Где ключ
/opt/remediation-api/.env(600) — тот, что читает сервис./opt/telegram-bot/.env(600) — дубль того же значения; этот файл использует/root/vps-watchdog.shкак источник для Telegram.- Оба значения — в экспорте Vaultwarden (
infra: «Remediation API — ключ»).
Как безопасно проверить ключ
curl -s -X POST http://127.0.0.1:5000/api/v1/remediate -H "Content-Type: application/json" -H "x-api-key: <ключ>" -d '{"action":"noop","target":"nothing"}'
# 400 Action not allowed — ключ верный, ничего не выполняется
# 401 Invalid API Key — ключ неверный
Замечание на будущее
В bot.py (хаб и telegram-admin-bot) функция ремедиации читает
REMEDIATION_API_URL и REMEDIATION_API_KEY из окружения, но в
/etc/hub-bots/bots.env этих переменных нет — то есть из ботов действие пока
не включено. Если включать: ключ передавать через EnvironmentFile, а не
литералом, и помнить, что действие перезагружает контейнер целиком.