Эксплуатация и диагностика

Цель

Предоставить распространенные команды эксплуатации после развертывания, методы проверки здоровья и типовые пути диагностики.

Частые команды

cd $INSTALL_PATH
docker compose ps
docker compose logs --tail 200 --follow
docker compose down
docker compose up -d

Просмотр журнала приложения:

tail -n 200 $INSTALL_PATH/logs/app/app.log

Обновление данных геолокации:

bash update_geolite2.sh

Проверка здоровья

Объект	Команда или вход	Нормальный результат
Состояние контейнеров	docker compose ps	Ключевые сервисы running/up
Здоровье приложения	https://<APP_DOMAIN>/status/health	Возвращается здоровый статус
Панель администрирования	/admin/login	Открывается страница входа
Пользовательский портал	/app/login	Открывается страница входа
HTTPS	Адресная строка браузера	Сертификат действителен или соответствует интранет-политике самоподписанного сертификата
Ресурсы воспроизведения	/__replay__/...	Ресурсы корпоративной версии загружаются

Типовые проблемы

Симптом	Возможная причина	Рекомендация
Страница не открывается	Домен не резолвится, порт закрыт, Caddy не запущен	Проверить DNS, 80/443, firewall и журналы контейнеров
Администратор не может войти	Неверный пароль, инициализация не завершена, кэш браузера	Использовать пароль system, заданный при установке, проверить журнал приложения
Пользователь не видит сайт	Группа не назначена, сайт отключен, категория пуста	Проверить SaaS-разрешения группы и статус сайта
Пользователь не видит рабочее пространство	Группе не назначено рабочее пространство	Добавить назначение в управлении рабочими пространствами группы
Ошибка входа на сайт	Изменилась категория аккаунта, скрипт или политика целевого сайта	Проверить настройки сайта, категорию аккаунта и URL совпадения скрипта
Автоматический сертификат не получен	Домен не указывает на публичный IP или порты недоступны	Проверить DNS и входящие правила 80/443
Воспроизведение недоступно	Развертывание не full или ресурсы хранилища недоступны	Проверить лицензию, тип развертывания и ресурсы /__replay__/

Рекомендации по изменениям

• Перед изменением скриптов, плагинов, прокси или рабочих пространств фиксируйте старую конфигурацию.
• Перед крупным обновлением сделайте резервные копии $INSTALL_PATH/volumes, $INSTALL_PATH/logs и данных базы.
• Перед внешней рассылкой ссылок совместного доступа полностью откройте ссылку тестовым пользователем без привилегий.
• После включения скриптов на рабочем сайте организуйте бизнес-приемку входа и ключевых страниц.