Files
xlx/docs/ADMIN_DASHBOARD.md
T

66 строки
2.6 KiB
Markdown

# Админка и главный дашборд
## Главная
Главная страница доступна по адресу `/`.
На ней есть:
- краткое описание сервиса;
- карточки статуса DMR/YooKassa/Pi-Star;
- форма регистрации пользователя;
- вывод ссылки YooKassa и инструкции для перевода по чеку.
## Админка
Админка доступна по адресу `/admin`.
Чтобы загрузить или сохранить настройки, нужно ввести `X-Admin-Token` из `config/config.php`.
Форма меняет:
- имя reflector, например `XLX138`;
- домен сервера;
- sysop callsign и email;
- страну;
- DMR/YSF/dashboard порты;
- модуль по умолчанию;
- список активных модулей;
- пути установки, исходников и логов;
- имя systemd service;
- URL репозитория `xlxd`.
При сохранении с флагом `apply` API пытается обновить `/etc/xlx/xlxd.env`. Если PHP работает без прав записи в `/etc/xlx`, настройки все равно сохранятся в БД, а в админке будет виден готовый env-preview.
## Редактор файлов XLX
В админке есть отдельный блок для редактирования:
- `/xlxd/xlxd.blacklist`;
- `/xlxd/xlxd.whitelist`;
- `/xlxd/xlxd.interlink`;
- `/xlxd/xlxd.terminal`.
API открывает только эти четыре файла. Произвольный путь передать нельзя.
После изменения файлов при необходимости перезапусти reflector:
```bash
sudo systemctl restart xlxd
```
Установщик выдает группе `www-data` права записи на эти файлы, чтобы сохранение работало из веб-интерфейса.
## Управление сервисом
В админке есть блок `Управление reflector`:
- просмотр статуса `xlxd`;
- `start`;
- `stop`;
- `restart`;
- последние события из `/var/log/xlxd.log`;
- счетчики активных пользователей и оплат.
Для управления сервисом установщик создает `/etc/sudoers.d/xlx-panel` и разрешает пользователю `www-data` выполнять только команды `systemctl start/stop/restart/status xlxd`.