Files
WARP-Web-UI-Relay-Beta/README.ru.md
Андрей Бобырев 4f4e85f810 feat: publish WARP Web UI with install scripts and docs
Sanitized panel from production: env-based auth, interactive install
prompts for SOCKS/Web UI ports, MIT license, EN/RU README.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-26 22:50:57 +03:00

84 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# WARP Web UI
Веб-панель для управления **Cloudflare WARP** на Linux: подключение/отключение, ключ WARP+, порт SOCKS-прокси и пресеты для **3x-ui** и **Amnezia Xray**.
## Возможности
- **WARP**: Connect / Disconnect, перезапуск `warp-svc`, статус и логи
- **Аккаунт**: тип регистрации (Free / WARP+), применение лицензионного ключа
- **Установка и удаление** пакета `cloudflare-warp` из браузера
- **SOCKS**: смена порта `warp-cli proxy` (например `40000` или `1024`)
- **3x-ui**: outbound `warp-socks``127.0.0.1:ПОРТ`, маршрут `geosite:google`
- **Amnezia**: мост Docker `172.17.0.1:11025` → SOCKS на хосте, WARP только для выбранных клиентов, понятные имена
## Требования
- Linux (рекомендуется Debian/Ubuntu)
- `python3` (только стандартная библиотека)
- `systemd`
- По желанию: `cloudflare-warp` (ставится из UI или `scripts/warp-install-cf.sh`)
- Для пресетов: `docker`, `socat`, `x-ui` / Amnezia
## Быстрый старт
### Установка одной командой
```bash
curl -fsSL https://raw.githubusercontent.com/andrey271192/WARP-Web-UI/main/install.sh | sudo bash
```
Скрипт **спрашивает**:
| Вопрос | По умолчанию | Пояснение |
|--------|--------------|-----------|
| Порт SOCKS | `40000` | Часто также `1024` у официального пакета |
| Порт веб-UI | `3030` | Откройте в firewall при необходимости |
| Логин админа | `warpadmin` | HTTP Basic Auth |
| Пароль админа | *(обязательно, ≥ 8 символов)* | Файл `/etc/default/warp-webui` |
### Клонирование
```bash
git clone https://github.com/andrey271192/WARP-Web-UI.git
cd WARP-Web-UI
sudo bash install.sh
```
Откройте `http://ВАШ_СЕРВЕР:3030/`. Если WARP ещё не установлен — кнопка **Install WARP** в интерфейсе.
### Удаление
```bash
curl -fsSL https://raw.githubusercontent.com/andrey271192/WARP-Web-UI/main/uninstall.sh | sudo bash
```
Или `sudo bash uninstall.sh` из клонированного репозитория. Можно удалить только панель или также пакет `cloudflare-warp` (подтверждение в конце).
## Структура репозитория
- `app.py` — веб-интерфейс и API
- `scripts/warp-install-cf.sh`, `warp-uninstall-cf.sh` — установка/удаление WARP
- `systemd/warp-webui.service` — шаблон unit
- `install.sh`, `uninstall.sh` — установка и снятие «в одну кнопку»
После установки: `/opt/warp-webui/`, настройки `/etc/default/warp-webui`.
## Настройка
См. [`.env.example`](.env.example). Имена клиентов Amnezia: `/etc/warp-webui/client-aliases.json`.
## Безопасность
- Только **Basic Auth по HTTP** — для продакшена используйте **HTTPS** (nginx/Caddy).
- **Firewall**: открывайте порт панели только для доверенных IP.
- Сервис работает от **root** (нужен для `warp-cli`, systemd, Docker). Не выставляйте панель в открытый интернет без защиты.
- Не публикуйте `/etc/default/warp-webui` и смените пароль после установки.
## English documentation
See [README.md](README.md).
## Лицензия
MIT — [LICENSE](LICENSE).