xlx/docs/ADMIN_DASHBOARD.md

Админка и главный дашборд

Главная

Главная страница доступна по адресу /.

На ней есть:

• краткое описание сервиса;
• карточки статуса 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:

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.