WARP-Web-UI/README.md

WARP Web UI

Веб-панель для управления Cloudflare WARP на Linux: подключение и отключение туннеля, активация WARP+, настройка SOCKS-прокси, готовые пресеты для 3x-ui/Amnezia Xray и beta-модуль WARP Relay.

Документация на английском (кратко): 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

Быстрый старт

Установка одной командой

curl -fsSL https://raw.githubusercontent.com/andrey271192/WARP-Web-UI/main/install.sh | sudo bash

Beta-репозиторий с WARP Relay:

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

Установка из клона репозитория

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).

Удаление

curl -fsSL https://raw.githubusercontent.com/andrey271192/WARP-Web-UI/main/uninstall.sh | sudo bash

Beta-репозиторий:

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. Основные переменные:

• 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.