VPN HAPP · VPN-сервис на VPS

# VPN HAPP · VPN-сервис на VPS

Плагин платформы [HuskyServer](https://huskynet.ru/4528/): управление WireGuard, Hysteria2 (HAPP) и VLESS REALITY через FastAPI и панель /vpn.

Возможности

• Dashboard /vpn: клиенты WG, Hysteria2, mobile REALITY.
• API с заголовком X-HAPP-Key: CRUD клиентов, конфиги/ссылки, start/stop/restart.
• Скрипты: setup-wireguard.sh, setup-hysteria2.sh, setup-mobile-reality.sh, backup.
• Health: GET /health.

Требования

• Ядро HuskyServer.
• Публичный IP/домен; для Hysteria2 — домен и TLS-параметры в .env.
• Права root для установки туннелей.

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

sudo bash /home/projects/plugins/vpn-happ/setup.sh
# при необходимости:
sudo bash /home/projects/plugins/vpn-happ/scripts/setup-wireguard.sh
sudo systemctl restart vpn-happ

Панель: http://<IP>/vpn · локально backend :51821.

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

1. Поднять WG (setup-wireguard.sh), прописать WG_ENDPOINT / ключ в .env.
2. В панели создать клиента и скачать конфиг.
3. Для HAPP/REALITY — соответствующие H2_* / mobile setup и блоки UI.

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

vpn-happ/
├── plugin.json · setup.sh
├── python/vpn_happ/     # FastAPI
├── scripts/ · systemd/
└── doc/

Технологии

Python, FastAPI, WireGuard, sing-box / Xray (по скриптам), systemd vpn-happ.

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

• Платформа: HuskyServer
• App Auth · Email Bot · Svetlana · TgFeed · VPN HAPP

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

# Changelog

[Unreleased]

Changed

• Документация приведена к шаблону HuskyServer; README с перелинковкой на платформу и соседние плагины.

2026-06-23

Added

• QR-код для импорта конфига WireGuard и AmneziaWG в мобильные приложения (вкладки WireGuard и AmneziaWG дашборда).
• API GET/POST /api/clients и GET/POST /api/awg-clients возвращают поле qr_data_uri (data URI PNG), как у HAPP и Mobile REALITY.

2026-06-08

• Исходники скопированы в /home/projects/plugins/vpn-happ/ как новый целевой дом плагина.
• Runtime-пути в service/scripts/env/docs переключены на /home/projects/plugins/vpn-happ/.
• Меню через nav-api; манифест в /home/projects/plugins/vpn-happ/.