# WARP Web UI Веб-панель для управления **Cloudflare WARP** на Linux: подключение и отключение туннеля, активация WARP+, настройка SOCKS-прокси, готовые пресеты для **3x-ui**/**Amnezia Xray** и beta-модуль **WARP Relay**. ![WARP Web UI dashboard](docs/images/dashboard.png) ![WARP Relay beta](docs/images/warp-relay-beta.png) Документация на английском (кратко): [README.en.md](README.en.md). ## Возможности - **Управление WARP**: подключение, отключение, перезапуск `warp-svc`, просмотр статуса и логов - **Аккаунт**: информация о регистрации, применение лицензионного ключа WARP+ - **Установка и удаление** пакета `cloudflare-warp` прямо из браузера (репозиторий Cloudflare для Debian/Ubuntu) - **SOCKS-прокси**: смена порта `warp-cli proxy` (часто `40000` или `1024`) - **Маршрутизация WARP**: списки доменов/IP, JSON-подсказка для Xray, включение/выключение правил Amnezia/Xray, тест внешнего IP напрямую и через WARP - **WARP Relay beta**: UDP relay через `nftables`/`iptables` на выбранный WARP/WireGuard endpoint, single-port или Cloudflare multiport, DNS/ping probe endpoint-ов - **Пресет 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 ещё не установлен — нажмите **Установить 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`. ### Маршрутизация WARP В панели есть блок **Маршрутизация WARP**. Он нужен, когда не хочется отправлять весь трафик через WARP, а только выбранные сайты или IP-сети. Что можно указать: - домены: `openai.com`, `chatgpt.com`, `youtube.com`; - правила Xray: `geosite:google`, `geosite:youtube`, `domain:example.com`, `full:example.com`, `regexp:...`; - IP и сети: `1.1.1.1`, `8.8.8.0/24`; - geoip-правила Xray: `geoip:private`, `geoip:cn`. Кнопки: - **Сохранить список** — записывает настройки в `/etc/warp-webui/warp-routes.json`, но не трогает Xray. - **Включить в Amnezia/Xray** — добавляет outbound `warp-socks`, создаёт backup `server.json`, добавляет глобальное routing-правило и перезапускает контейнер Amnezia. - **Выключить правила** — убирает глобальные правила `warp-socks` из Amnezia/Xray, список остаётся сохранённым. - **JSON для Xray** — показывает готовые куски `outbound` и `routing_rule` для ручной настройки 3x-ui/Amnezia. - **Тест IP** — показывает внешний IP сервера напрямую и внешний IP через `127.0.0.1:WARP_PROXY_PORT`. Важно: обычный Cloudflare WARP не даёт выбрать конкретную страну или конкретный exit IP. Эта функция выбирает, **какие домены/IP пойдут через WARP**, а не страну выхода. Если нужен гарантированный регион, нужен отдельный VPN/proxy с выбранной страной или корпоративный Cloudflare egress. ### Смена логина и пароля В панели есть блок **Доступ к панели**: 1. Введите новый логин. Разрешены латиница, цифры и символы `._@-`. 2. Введите новый пароль, минимум 8 символов. Если поле пароля оставить пустым, изменится только логин. 3. Нажмите **Сохранить доступ**. 4. Панель сохранит настройки в `/etc/default/warp-webui`, создаст backup в `/var/backups/warp-webui/` и перезапустит сервис. 5. После перезапуска браузер попросит войти заново уже с новым логином и паролем. Важно: текущая версия использует HTTP Basic Auth. Для открытого сервера поставьте HTTPS через nginx/Caddy и ограничьте доступ firewall-ом. ## Интеграция с 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 сервера или оставить автоопределение; - включить режим одного UDP-порта, обычно `4500 -> 4500`; - включить Cloudflare multiport mode; - проверить endpoint через DNS/ping probe и подставить лучший IP в поле endpoint; - удалить только managed relay rules. Важно: relay не гарантирует конкретный Cloudflare exit IP или страну. Он меняет WARP/WireGuard endpoint, через который клиент подключается. Для "желаемой точки" сейчас используйте ручной endpoint/IP или кнопку **Найти endpoint**. ## Безопасность - **Только 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 | `/auth-config` | Текущий логин панели и путь к env-файлу | | GET | `/relay` | Статус WARP Relay beta | | GET | `/warp-routes` | Список доменов/IP для маршрутизации через WARP | | POST | `/connect`, `/disconnect`, `/restart` | Управление WARP | | POST | `/warp-install`, `/warp-uninstall` | Установка/удаление пакета | | POST | `/auth-config` | Смена логина/пароля веб-панели | | POST | `/relay-apply`, `/relay-remove`, `/relay-probe` | Применить/удалить WARP Relay rules, проверить endpoint | | POST | `/warp-routes-save`, `/warp-routes-enable`, `/warp-routes-disable`, `/warp-routes-test`, `/warp-routes-preview` | Сохранить/применить/выключить маршруты WARP, проверить внешний IP, показать JSON для Xray | | POST | `/proxy-port`, `/license` | Порт SOCKS, ключ WARP+ | | POST | `/xui-preset`, `/amnezia-preset`, `/amnezia-routing` | Пресеты интеграций | ## Лицензия MIT — см. [LICENSE](LICENSE).