HuskyServer · Админка и плагины VPS

# HuskyServer · Админка и плагины VPS

Платформа управления выделенным сервером: PHP-админка, registry плагинов и сайтов, bootstrap-установка Ubuntu, резервные копии. Публичное имя продукта — HuskyServer (каталог репозитория на диске может называться иначе).

Код ядра и плагинов: home/projects/. Плагины — самостоятельные дополнения с отдельными карточками в админке и отдельными страницами на huskynet.

Возможности

• Единая админка — дашборд, auth, метрики CPU/RAM/диск, карточки сервисов и сайтов.
• Registry — плагины из plugins/<id>/plugin.json, сайты из sites/<id>/site.json.
• Активация плагинов — setup.sh или кнопка «Активировать» в GUI.
• Сайты — маршрутизация (subdomain / path / port), nginx, SSL, UFW, MariaDB, phpMyAdmin, просмотр S3.
• Backup / перенос — БД и файлы на ПК, S3 или удалённый SSH/rsync.
• Общее меню — shared/admin_nav.py + nav-api.php для Python-панелей плагинов.

Плагины платформы

Страница платформы на huskynet: https://huskynet.ru/4528/

| Плагин | Назначение | Пост | Каталог |
|———|————|——|———|
| App Auth | Регистрация FlowNote / OmniDrive | https://huskynet.ru/4531/ | plugins/app-auth |
| Email Bot | IMAP/SMTP-бот для EmailInterface | https://huskynet.ru/4534/ | plugins/email-bot |
| Svetlana | Telegram-бот напоминаний | https://huskynet.ru/4537/ | plugins/svetlana |
| TgFeed | MTProto API ленты для Husky Social Feed | https://huskynet.ru/4540/ | plugins/tgfeed |
| VPN HAPP | WireGuard / Hysteria2 / REALITY | https://huskynet.ru/4543/ | plugins/vpn-happ |

На huskynet у каждого плагина — отдельная запись PRO со ссылкой обратно на эту страницу платформы.

Требования

• Ubuntu 22.04+ (целевой bootstrap).
• Права root/sudo для deploy/setup-ubuntu22.sh.
• Python 3.8+ для плагинов, PHP-FPM + Nginx для ядра.
• Не копировать с ПК plugins/*/.venv, .activated, __pycache__.

Установка и запуск

1. Залить home/projects/ на сервер в /home/projects/.
2. При заливке с Windows: sudo bash /home/projects/deploy/fix-crlf.sh.
3. Ядро:

sudo bash /home/projects/deploy/setup-ubuntu22.sh

1. Открыть http://IP_СЕРВЕРА/ — логин admin / admin, сразу сменить пароль.
2. Активировать нужные плагины:

sudo bash /home/projects/plugins/<id>/setup.sh

Пошагово и troubleshooting: home/projects/deploy/INSTALL.md.

Обновление уже установленной админки (без переустановки плагинов):

sudo bash /home/projects/web/scripts/deploy-admin-panel.sh

Использование

Админка

Главная — карточки плагинов и сайтов. Плагин без .activated — «Не активирован». После setup — health-check («Активен» / «Неактивен»).

Сайт без домена

Режим routing.mode=port (например :8081), пока админка занимает порт 80. Пример: sites/README.md.

Добавить плагин

Каталог plugins/<id>/ с plugin.json, setup.sh, README.md, doc/; location в web/nginx-configs/admin-panel.conf.

Структура проекта

EuropaServer/                    # репозиторий на диске
├── README.md                    # этот файл (продукт HuskyServer)
├── doc/
└── home/projects/
    ├── deploy/                  # bootstrap Ubuntu
    ├── web/php/admin-panel/     # ядро PHP
    ├── plugins/                 # дополнения
    ├── sites/                   # манифесты сайтов (не отдельные продукты)
    └── shared/                  # admin_nav.py

Слои и потоки — в doc/ARCHITECTURE.md.

Технологии

• PHP + PHP-FPM — ядро админки.
• Nginx — default_server, reverse proxy плагинов, сайты.
• MariaDB + phpMyAdmin — БД сайтов.
• Python (Flask / FastAPI / Telethon) — сервисы плагинов + systemd.
• awscli — просмотр и backup в S3.

Разрешения и секреты

Секреты — в .env плагинов и sites/<id>/.env, не в site.json и не в git. Пароль админки — bcrypt в auth.php.

История изменений

Формат Keep a Changelog.

[Unreleased]

Changed

• Публичное имя продукта: HuskyServer (вместо EuropaServer в пользовательских текстах).
• README и doc/ приведены к шаблону четвёрки; плагины описаны как дополнения платформы.

[2026-08-11]

Added

• Плагин App Auth (plugins/app-auth/): регистрация FlowNote / OmniDrive.

[2026-07-21]

Fixed

• Сохранение карточки сайта (валидация скрытого listen_port).
• CRLF в deploy/*.sh после заливки с Windows (fix-crlf.sh).
• Nginx deploy name для site id с заглавными буквами.

[2026-06-11]

Added

• Backup/перенос сайтов: ПК, S3, SSH/rsync.
• Маршрутизация сайтов, SSL/DNS из панели, MariaDB + phpMyAdmin, просмотр S3.

[2026-06-09]

Added

• Чистая установка setup-ubuntu22.sh, deploy/INSTALL.md, страница site.php.

[2026-06-08]

Added

• Registry плагинов и сайтов; каталоги plugins/<id>/; общее меню nav-api / admin_nav.py.

Подробности ядра: admin-panel/doc/CHANGELOG.md.