From 387ba0d881b1a044e2804de236208459e31d8af5 Mon Sep 17 00:00:00 2001 From: anten-ka Date: Sun, 8 Mar 2026 13:33:19 +0300 Subject: [PATCH] Add README.md with 3X-UI integration guide --- README.md | 306 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 306 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..ee6de32 --- /dev/null +++ b/README.md @@ -0,0 +1,306 @@ +# WARP Manager v1.1 + +**Cloudflare WARP SOCKS5 Proxy для 3X-UI** + +Автоматическая установка и управление Cloudflare WARP на VPS-сервере. +WARP даёт «чистый» IP от Cloudflare, который не заблокирован популярными сервисами (ChatGPT, Netflix, Spotify и др.). + +> Канал: [YouTube @antenkaru](https://www.youtube.com/@antenkaru) + +--- + +## Возможности + +- Установка Cloudflare WARP в один клик +- Работа в режиме SOCKS5-прокси (только локальный трафик, не затрагивает основной IP сервера) +- Интерактивное SSH-меню с полным управлением +- Telegram-бот для удалённого мониторинга и управления +- Автоперезапуск через systemd +- Готовые JSON-конфигурации для 3X-UI +- Перевыпуск ключа (смена WARP IP) +- Полное удаление в одну команду + +--- + +## Установка + +```bash +bash <(curl -sL https://raw.githubusercontent.com/anten-ka/go_warp_pro/main/warp.sh) +``` + +После установки скрипт доступен по команде: + +```bash +gowarp +``` + +--- + +## Схема работы + +``` +Клиент → 3X-UI (Xray) → SOCKS5 (WARP 127.0.0.1:40000) → Cloudflare → Интернет +``` + +1. Скрипт устанавливает `cloudflare-warp` на сервер +2. WARP работает в режиме **SOCKS5-прокси** на `127.0.0.1:40000` +3. В 3X-UI добавляется **outbound** типа SOCKS с тегом `warp` +4. В маршрутизации указываете, какие сайты направлять через WARP + +Основной IP сервера **не меняется**. Через WARP идёт только тот трафик, который вы настроите в маршрутизации 3X-UI. + +--- + +## Интеграция с 3X-UI — пошаговая инструкция + +После установки WARP и подтверждения статуса «Подключён» выполните следующие шаги в панели 3X-UI. + +### Шаг 1. Добавление Outbound (исходящее подключение) + +1. Откройте панель **3X-UI** в браузере +2. Перейдите в **Настройки Xray** (Xray Settings) +3. Найдите раздел **Outbounds** (Исходящие подключения) +4. Нажмите **Добавить Outbound** (Add Outbound) +5. Вставьте следующий JSON: + +```json +{ + "tag": "warp", + "protocol": "socks", + "settings": { + "servers": [ + { + "address": "127.0.0.1", + "port": 40000 + } + ] + } +} +``` + +> **Важно:** порт `40000` — это порт по умолчанию. Если вы меняли порт через меню WARP Manager (пункт 7), укажите ваш порт. + +6. Нажмите **Сохранить** (Save) + +### Шаг 2. Настройка маршрутизации (Routing) + +Теперь нужно указать, какой трафик направлять через WARP. + +#### Вариант А: Определённые сайты через WARP (рекомендуется) + +1. Перейдите в **Настройки Xray** → **Routing** (Маршрутизация) +2. Нажмите **Добавить правило** (Add Rule) +3. Заполните: + - **Outbound Tag**: `warp` + - **Domain**: добавьте домены, которые хотите направить через WARP + +Либо вставьте JSON-правило напрямую: + +```json +{ + "type": "field", + "outboundTag": "warp", + "domain": [ + "geosite:openai", + "geosite:netflix", + "geosite:disney", + "geosite:spotify", + "domain:chat.openai.com", + "domain:claude.ai", + "domain:openai.com", + "domain:netflix.com", + "domain:disneyplus.com", + "domain:spotify.com" + ] +} +``` + +> Это направит трафик к ChatGPT, Netflix, Disney+, Spotify и Claude через WARP. Остальной трафик пойдёт напрямую через основной IP сервера. + +#### Вариант Б: Весь трафик через WARP + +Если хотите направить **весь** клиентский трафик через WARP: + +1. В разделе **Routing** добавьте правило: + - **Outbound Tag**: `warp` + - **Network**: `tcp,udp` + +Или JSON: + +```json +{ + "type": "field", + "outboundTag": "warp", + "network": "tcp,udp" +} +``` + +> **Внимание:** при этом варианте весь трафик пойдёт через Cloudflare. Скорость может незначительно снизиться. + +#### Вариант В: По IP-адресам + +Можно направить через WARP трафик к определённым IP-диапазонам: + +```json +{ + "type": "field", + "outboundTag": "warp", + "ip": [ + "geoip:us", + "geoip:gb" + ] +} +``` + +> Трафик в США и Великобританию пойдёт через WARP. + +### Шаг 3. Перезапуск Xray + +После сохранения настроек: + +1. Нажмите **Перезапустить Xray** (Restart Xray) в панели 3X-UI +2. Или выполните в SSH: + +```bash +x-ui restart +``` + +### Шаг 4. Проверка + +Убедитесь, что всё работает: + +1. Подключитесь к VPN через клиент (v2rayN, Hiddify, NekoBox и т.д.) +2. Откройте [https://whoer.net](https://whoer.net) или [https://ifconfig.me](https://ifconfig.me) +3. Если вы настроили маршрутизацию по доменам: + - Обычные сайты покажут **основной IP** сервера + - Сайты из списка (ChatGPT, Netflix и др.) покажут **IP Cloudflare** +4. Попробуйте открыть [https://chat.openai.com](https://chat.openai.com) — если раньше был заблокирован, теперь должен работать + +### Проверка через SSH + +На сервере можно проверить WARP IP командой: + +```bash +curl -s --proxy socks5h://127.0.0.1:40000 ifconfig.me +``` + +Эта команда покажет IP, который видят сайты при маршрутизации через WARP. + +--- + +## Меню WARP Manager + +| Пункт | Действие | +|-------|----------| +| 1 | Установить WARP | +| 2 | Запустить WARP | +| 3 | Остановить WARP | +| 4 | Статус и конфигурация | +| 5 | JSON для 3X-UI (готовые конфиги) | +| 6 | Перевыпуск ключа (новый WARP IP) | +| 7 | Изменить порт SOCKS5 | +| 8 | Telegram Bot (настройка и управление) | +| 9 | PROMO | +| 10 | Инструкция | +| 11 | Полное удаление | +| 0 | Выход | + +--- + +## Telegram-бот + +WARP Manager включает встроенный Telegram-бот для удалённого управления. + +### Настройка бота + +1. Откройте [@BotFather](https://t.me/BotFather) в Telegram +2. Отправьте `/newbot` +3. Задайте имя и username бота +4. Скопируйте полученный **токен** +5. На сервере выполните `gowarp` → пункт **8** (Telegram Bot) +6. Выберите **1) Токен бота** — вставьте токен +7. Выберите **2) Chat ID (авто)**: + - Откройте вашего бота в Telegram + - Отправьте ему любое сообщение + - Вернитесь в SSH и нажмите Enter + - Скрипт автоматически определит ваш Chat ID +8. Выберите **4) Запустить** + +### Команды бота + +- `/start` или `/menu` — главное меню + +### Кнопки меню + +- **Статус** — текущий статус WARP, порт, IP +- **IP адреса** — реальный IP сервера и WARP IP +- **Запустить / Остановить** — управление WARP +- **Перевыпуск ключа** — получить новый WARP IP +- **JSON для 3X-UI** — готовая конфигурация для копирования +- **Система** — CPU, RAM, диск, uptime +- **Хостинг** — промо-материалы + +### Безопасность + +Если задан Chat ID, бот отвечает **только** владельцу. Остальные пользователи получат сообщение «Нет доступа» с указанием их Chat ID. + +Бот работает как systemd-сервис `warp-bot` с автоперезапуском. + +--- + +## Автоперезапуск + +- Служба `warp-svc` настроена с `Restart=always` — WARP автоматически перезапускается при сбое +- Служба `warp-bot` (Telegram-бот) также имеет `Restart=always` +- При перезагрузке сервера оба сервиса запускаются автоматически + +--- + +## Часто задаваемые вопросы + +### WARP не подключается + +```bash +warp-cli --accept-tos status +journalctl -u warp-svc --no-pager -n 20 +``` + +Попробуйте перевыпустить ключ (пункт 6 в меню). + +### Сайт всё ещё заблокирован после настройки + +1. Убедитесь, что WARP в статусе «Подключён» (`gowarp` → пункт 4) +2. Проверьте, что домен добавлен в routing-правило в 3X-UI +3. Перезапустите Xray: `x-ui restart` +4. Очистите DNS-кэш в браузере или используйте режим инкогнито + +### Как сменить WARP IP + +В SSH: `gowarp` → пункт **6** (Перевыпуск ключа) +В Telegram: кнопка **Перевыпуск ключа** + +### Как изменить порт SOCKS5 + +`gowarp` → пункт **7** — введите новый порт. Не забудьте обновить порт в outbound-настройках 3X-UI. + +--- + +## Удаление + +```bash +gowarp +``` + +Выберите пункт **11** — Полное удаление. + +Будут удалены: cloudflare-warp, конфигурация, Telegram-бот, команда `gowarp`, логи. + +**Не забудьте** вручную удалить outbound `warp` и связанные routing-правила из настроек 3X-UI. + +--- + +## Лицензия + +Только для личного использования. Распространение без согласия запрещено. + +**anten-ka** · [YouTube](https://www.youtube.com/@antenkaru)