mirror of
https://github.com/andrey271192/WARP-Web-UI.git
synced 2026-09-20 11:55:34 +00:00
157 lines
9.8 KiB
Markdown
157 lines
9.8 KiB
Markdown
# WARP Web UI
|
||
|
||
Веб-панель для управления **Cloudflare WARP** на Linux: подключение и отключение туннеля, активация WARP+, настройка SOCKS-прокси, готовые пресеты для **3x-ui**/**Amnezia Xray** и beta-модуль **WARP Relay**.
|
||
|
||
|
||
|
||
|
||
|
||
Документация на английском (кратко): [README.en.md](README.en.md).
|
||
|
||
## Возможности
|
||
|
||
- **Управление WARP**: подключение, отключение, перезапуск `warp-svc`, просмотр статуса и логов
|
||
- **Аккаунт**: информация о регистрации, применение лицензионного ключа WARP+
|
||
- **Установка и удаление** пакета `cloudflare-warp` прямо из браузера (репозиторий Cloudflare для Debian/Ubuntu)
|
||
- **SOCKS-прокси**: смена порта `warp-cli proxy` (часто `40000` или `1024`)
|
||
- **WARP Relay beta**: UDP relay через `nftables`/`iptables` на выбранный WARP/WireGuard endpoint, single-port или Cloudflare multiport
|
||
- **Пресет 3x-ui**: outbound `warp-socks` → `127.0.0.1:ПОРТ` и правило маршрутизации `geosite:google`
|
||
- **Пресет Amnezia**: мост Docker `172.17.0.1:11025` → SOCKS на хосте, маршрутизация WARP для выбранных клиентов с понятными именами
|
||
|
||
## Требования
|
||
|
||
- Linux (рекомендуется Debian/Ubuntu)
|
||
- `python3` — только стандартная библиотека, без pip
|
||
- `systemd`
|
||
- `nftables` или `iptables` для WARP Relay beta
|
||
- По желанию: пакет `cloudflare-warp` (можно поставить из UI или скриптом `scripts/warp-install-cf.sh`)
|
||
- Для интеграций: `docker`, `socat`, панель **3x-ui** и/или **Amnezia**
|
||
|
||
## Быстрый старт
|
||
|
||
### Установка одной командой
|
||
|
||
```bash
|
||
curl -fsSL https://raw.githubusercontent.com/andrey271192/WARP-Web-UI/main/install.sh | sudo bash
|
||
```
|
||
|
||
Beta-репозиторий с WARP Relay:
|
||
|
||
```bash
|
||
curl -fsSL https://raw.githubusercontent.com/andrey271192/WARP-Web-UI-Relay-Beta/main/install.sh | sudo bash
|
||
```
|
||
|
||
Установщик **задаёт вопросы** (можно нажать Enter для значения по умолчанию):
|
||
|
||
| Вопрос | По умолчанию | Зачем это нужно |
|
||
|--------|--------------|-----------------|
|
||
| Порт SOCKS-прокси | `40000` | Локальный порт `warp-cli` в режиме proxy; для официального `cloudflare-warp` часто берут `1024` |
|
||
| Порт веб-панели | `3030` | HTTP-порт панели; при необходимости откройте его в firewall |
|
||
| Логин администратора | `warpadmin` | HTTP Basic Auth |
|
||
| Пароль администратора | *(обязательно, не короче 8 символов)* | Сохраняется в `/etc/default/warp-webui` с правами `chmod 600` |
|
||
|
||
### Установка из клона репозитория
|
||
|
||
```bash
|
||
git clone https://github.com/andrey271192/WARP-Web-UI.git
|
||
cd WARP-Web-UI
|
||
sudo bash install.sh
|
||
```
|
||
|
||
Откройте в браузере `http://АДРЕС_СЕРВЕРА:3030/` (подставьте выбранный порт). Войдите с логином и паролем, которые указали при установке.
|
||
|
||
Если WARP ещё не установлен — нажмите **Install WARP** в интерфейсе (или выполните `scripts/warp-install-cf.sh`, задав `WARP_PROXY_PORT`).
|
||
|
||
### Удаление
|
||
|
||
```bash
|
||
curl -fsSL https://raw.githubusercontent.com/andrey271192/WARP-Web-UI/main/uninstall.sh | sudo bash
|
||
```
|
||
|
||
Beta-репозиторий:
|
||
|
||
```bash
|
||
curl -fsSL https://raw.githubusercontent.com/andrey271192/WARP-Web-UI-Relay-Beta/main/uninstall.sh | sudo bash
|
||
```
|
||
|
||
Или из каталога клона: `sudo bash uninstall.sh` — останавливает сервис, по запросу удаляет файлы приложения, конфигурацию и при желании пакет `cloudflare-warp`.
|
||
|
||
## Структура репозитория
|
||
|
||
```
|
||
app.py # Веб-интерфейс и API (Python http.server)
|
||
scripts/warp-install-cf.sh # Установка cloudflare-warp из apt Cloudflare
|
||
scripts/warp-uninstall-cf.sh # Удаление пакета cloudflare-warp
|
||
systemd/warp-webui.service # Шаблон unit для systemd
|
||
install.sh / uninstall.sh # Установка и снятие «в одну команду»
|
||
.env.example # Справочник переменных окружения
|
||
```
|
||
|
||
После установки файлы лежат в `/opt/warp-webui/`, настройки — в `/etc/default/warp-webui`.
|
||
|
||
## Настройка
|
||
|
||
Подробности — в [`.env.example`](.env.example). Основные переменные:
|
||
|
||
- `WARP_WEBUI_USER`, `WARP_WEBUI_PASS` — Basic Auth для панели
|
||
- `WARP_WEBUI_PORT` — HTTP-порт (по умолчанию `3030`)
|
||
- `WARP_PROXY_PORT` — порт SOCKS при установке и при установке WARP из UI
|
||
- `WARP_PUBLIC_HOST` — публичный IP или hostname для подсказок в пресетах клиентов
|
||
|
||
Понятные имена клиентов Amnezia: `/etc/warp-webui/client-aliases.json`.
|
||
|
||
## Интеграция с 3x-ui (по желанию)
|
||
|
||
1. Установите и подключите WARP, включите режим proxy и задайте порт SOCKS (в панели или при `install.sh`).
|
||
2. В веб-панели используйте действие пресета **3x-ui** — будет предложен outbound на `127.0.0.1:ПОРТ` и правило для `geosite:google`.
|
||
3. Убедитесь, что конфиг x-ui указывает на тот же порт, что и `WARP_PROXY_PORT`.
|
||
|
||
Требуется установленная панель x-ui и доступ к её `config.json` (путь можно переопределить в `.env`).
|
||
|
||
## Интеграция с Amnezia (по желанию)
|
||
|
||
1. На хосте с Docker поднимите SOCKS WARP и при необходимости мост `socat` (панель может создать unit `warp-socks-bridge`).
|
||
2. В панели примените пресет **Amnezia** — маршрутизация через `172.17.0.1:11025` к SOCKS на хосте.
|
||
3. Назначайте WARP только нужным клиентам; имена удобно править в `client-aliases.json`.
|
||
|
||
Нужны `docker`, контейнер Amnezia Xray и переменные `AMNEZIA_*` при нестандартных путях — см. `.env.example`.
|
||
|
||
## WARP Relay beta
|
||
|
||
`openwarpkit/warp-relay` взят как идея и встроен без запуска внешнего интерактивного скрипта. Панель сама управляет только своими firewall rules с тегом `WR_WEBUI_RELAY`.
|
||
|
||
Что можно делать из UI:
|
||
|
||
- выбрать endpoint: `engage.cloudflareclient.com`, IPv4 или свой hostname;
|
||
- выбрать source IP сервера или оставить автоопределение;
|
||
- включить single UDP port, обычно `4500 -> 4500`;
|
||
- включить Cloudflare multiport mode;
|
||
- удалить только managed relay rules.
|
||
|
||
Важно: relay не гарантирует конкретный Cloudflare exit IP или страну. Он меняет WARP/WireGuard endpoint, через который клиент подключается. Для "желаемой точки" сейчас используйте ручной endpoint/IP; автоматический список точек и latency probe запланированы.
|
||
|
||
## Безопасность
|
||
|
||
- **Только HTTP Basic Auth** — учётные данные передаются с каждым запросом. В продакшене ставьте **HTTPS** (обратный прокси: nginx, Caddy + TLS).
|
||
- **Firewall**: открывайте порт панели только для доверенных IP, например: `ufw allow from ДОВЕРЕННЫЙ_IP to any port 3030`.
|
||
- **Права root**: панель работает от root, чтобы управлять `warp-cli`, systemd и Docker. Не выставляйте её в открытый интернет без защиты.
|
||
- **Секреты**: не коммитьте `/etc/default/warp-webui` в git. После установки смените пароль администратора.
|
||
- Ключи WARP+ вводятся в UI и передаются в `warp-cli`; в репозитории они не хранятся.
|
||
|
||
## API (требуется авторизация)
|
||
|
||
| Метод | Путь | Описание |
|
||
|-------|------|----------|
|
||
| GET | `/` | HTML-интерфейс |
|
||
| GET | `/status`, `/registration`, `/proxy`, `/logs` | Статус и диагностика |
|
||
| GET | `/relay` | Статус WARP Relay beta |
|
||
| POST | `/connect`, `/disconnect`, `/restart` | Управление WARP |
|
||
| POST | `/warp-install`, `/warp-uninstall` | Установка/удаление пакета |
|
||
| POST | `/relay-apply`, `/relay-remove` | Применить/удалить WARP Relay rules |
|
||
| POST | `/proxy-port`, `/license` | Порт SOCKS, ключ WARP+ |
|
||
| POST | `/xui-preset`, `/amnezia-preset`, `/amnezia-routing` | Пресеты интеграций |
|
||
|
||
## Лицензия
|
||
|
||
MIT — см. [LICENSE](LICENSE).
|