vpn-panel
83 lines
2.4 KiB
Markdown
83 lines
2.4 KiB
Markdown
# VPN Panel
|
||
|
||
Панель управления VPN на базе [Xray-core](https://github.com/XTLS/Xray-core).
|
||
|
||
**Репозиторий:** https://git.evilfox.cc/test/vpn-panel.git
|
||
|
||
**Стек:** Go · Docker · PostgreSQL 17
|
||
|
||
## Возможности
|
||
|
||
- Главная страница с обзором панели
|
||
- Регистрация **одного** администратора (при первом запуске)
|
||
- Интерактивный установщик (БД, домен, админ)
|
||
- Готовый `docker-compose` с PostgreSQL 17
|
||
|
||
## Требования
|
||
|
||
- Linux-сервер (Ubuntu 22.04+ / Debian 12+ рекомендуется)
|
||
- Docker 24+ и Docker Compose v2
|
||
- Домен (опционально, для HTTPS через reverse proxy)
|
||
- Git
|
||
|
||
## Развёртывание на сервере
|
||
|
||
Полная инструкция: **[DEPLOY.md](DEPLOY.md)**
|
||
|
||
### Кратко (без Go, только Docker)
|
||
|
||
```bash
|
||
git clone https://git.evilfox.cc/test/vpn-panel.git
|
||
cd vpn-panel
|
||
|
||
chmod +x scripts/setup.sh
|
||
./scripts/setup.sh
|
||
```
|
||
|
||
Или вручную:
|
||
|
||
```bash
|
||
docker compose up -d postgres
|
||
docker compose build install
|
||
docker compose --profile tools run --rm install # создаёт .env, хост БД: postgres
|
||
docker compose up -d --build panel
|
||
```
|
||
|
||
Панель: `http://ВАШ_ДОМЕН:8080`
|
||
|
||
## Локальная разработка
|
||
|
||
```bash
|
||
docker compose up -d postgres
|
||
go run ./cmd/install
|
||
go run ./cmd/panel
|
||
```
|
||
|
||
## Структура
|
||
|
||
```
|
||
cmd/panel/ — веб-сервер панели
|
||
cmd/install/ — CLI установщик
|
||
internal/ — конфиг, БД, handlers, auth
|
||
web/ — HTML шаблоны и CSS
|
||
docker-compose.yml
|
||
```
|
||
|
||
## Переменные окружения
|
||
|
||
| Переменная | Описание |
|
||
|----------------|-----------------------------------|
|
||
| `APP_PORT` | Порт HTTP (в Docker: 8080) |
|
||
| `APP_DOMAIN` | Домен панели |
|
||
| `DATABASE_URL` | Строка подключения PostgreSQL |
|
||
| `SECRET_KEY` | Ключ подписи сессий |
|
||
| `INSTALLED` | `true` после установки |
|
||
|
||
## Xray-core
|
||
|
||
Ядро прокси — [XTLS/Xray-core](https://github.com/XTLS/Xray-core). Интеграция управления нодами и конфигами — следующий этап.
|
||
|
||
## Лицензия
|
||
|
||
MIT
|