Add README.md with 3X-UI integration guide

This commit is contained in:
anten-ka
2026-03-08 13:33:19 +03:00
parent d97345d8c9
commit 387ba0d881

306
README.md Normal file
View File

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