GitHub VLESS XHTTP: как настроить прокси на Xray и обойти блокировки

Что такое VLESS и XHTTP: базовые понятия

VLESS — это легковесный прокси-протокол, разработанный для проекта Xray. Он не шифрует трафик сам по себе, а полагается на внешний транспорт (например, TLS), что снижает накладные расходы и упрощает маскировку. В отличие от более старого VMess, VLESS не требует идентификатора пользователя в каждом запросе и работает быстрее.

XHTTP — это транспортный механизм, который позволяет передавать данные внутри обычных HTTP/HTTPS-запросов. Он был создан как развитие идей транспорта meek из проекта Tor и более раннего SplitTunnel. Основная цель XHTTP — сделать трафик прокси неотличимым от обычного веб-серфинга, что особенно важно в условиях глубокой фильтрации трафика.

В контексте поискового запроса «github vless xhttp» обычно имеются в виду репозитории, которые автоматизируют установку и настройку Xray с поддержкой XHTTP. Такие проекты позволяют развернуть личный прокси-сервер без ручного редактирования конфигурационных файлов.

Зачем нужен XHTTP: преимущества перед другими транспортами

XHTTP решает несколько задач, с которыми сталкиваются пользователи VPN в странах с цензурой.

Маскировка под обычный веб-трафик. В отличие от WebSocket, который имеет характерные признаки в заголовках, XHTTP использует стандартные HTTP-запросы и ответы. Это затрудняет детектирование протокола по сигнатурам.

Работа через CDN. Многие CDN (например, Cloudflare) не поддерживают WebSocket или gRPC, но XHTTP в режиме packet-up работает через любой HTTP-прокси. Это позволяет подключаться к прокси через популярные сети доставки контента, скрывая реальный IP-адрес сервера.

Разделение потоков. В режимах packet-up и stream-up данные от клиента к серверу и обратно передаются по разным соединениям. Это ломает анализ трафика на основе TLS-in-TLS и делает практически невозможным выявление прокси по паттернам.

Гибкость настройки. Можно комбинировать разные протоколы и адреса для входящего и исходящего трафика. Например, отправлять запросы через QUIC, а получать ответы по HTTPS, или использовать разные IPv4/IPv6 адреса.

Режимы работы XHTTP: packet-up, stream-up, stream-one

XHTTP поддерживает три режима, каждый из которых имеет свои особенности.

packet-up — самый совместимый режим. Данные от клиента к серверу передаются множеством коротких POST-запросов, а обратно — одним длинным GET-запросом. Это работает через практически любой HTTP-прокси и CDN, включая те, которые не поддерживают потоковую передачу. Скорость ниже, чем у других режимов, но всё равно значительно выше, чем у meek. В тестах на бесплатном хостинге alwaysdata скорость достигала 75–80 Мбит/с на скачивание.

stream-up — более быстрый режим, использующий одно долгоживущее соединение для передачи в каждую сторону. Однако он требует, чтобы промежуточный прокси поддерживал потоковые запросы. Некоторые CDN и веб-серверы могут разрывать такие соединения (например, отправлять GOAWAY в HTTP/2).

stream-one — режим, в котором данные передаются в обе стороны по одному соединению. По сути это аналог старого VLESS с HTTP-заголовком. Работает только через Nginx с grpc_pass и Cloudflare с включённой поддержкой gRPC.

При настройке важно явно указывать режим в ссылке клиента, так как режим auto может выбрать неподдерживаемый вариант.

Как найти готовые решения на GitHub: обзор популярных репозиториев

GitHub — основной источник готовых скриптов и конфигураций для Xray. По запросу «vless xhttp» можно найти множество проектов, но важно уметь выбирать качественные.

Один из примеров — репозиторий alwaysdata-xray, который разворачивает VLESS-прокси на бесплатном хостинге alwaysdata одной командой. Он включает три скрипта: install.sh (запускается на вашем компьютере), setup.sh (выполняется на сервере) и start.sh (запускается хостингом). Скрипты автоматически устанавливают Xray, генерируют UUID и ссылку для клиента.

Другой пример — проект podkop-xhttp, который описывает установку Xray с VLESS+XHTTP+REALITY на роутере с OpenWrt. Там используется генератор конфигурации, доступный по ссылке в документации.

При выборе репозитория обращайте внимание на:

• Актуальность: проект должен поддерживаться и обновляться.
• Наличие инструкции по установке и настройке.
• Отзывы пользователей и количество звёзд.
• Совместимость с вашим оборудованием и операционной системой.

Пошаговая настройка Xray с XHTTP на VPS

Рассмотрим базовую настройку Xray с транспортом XHTTP на собственном VPS. Этот вариант наиболее надёжен, так как вы полностью контролируете сервер.

1. Установите Xray. На Debian/Ubuntu можно использовать официальный скрипт установки или скачать бинарник с GitHub. Убедитесь, что версия Xray на сервере и клиенте совпадает, иначе возможны проблемы с совместимостью.

1. Создайте конфигурационный файл. Пример конфигурации для сервера:

{
  "inbounds": [{
    "port": 443,
    "protocol": "vless",
    "settings": {
      "clients": [{"id": "UUID"}],
      "decryption": "none"
    },
    "streamSettings": {
      "network": "xhttp",
      "security": "tls",
      "xhttpSettings": {
        "mode": "packet-up",
        "path": "/secret-path"
      }
    }
  }],
  "outbounds": [{"protocol": "freedom"}]
}

1. Настройте TLS. Для работы по HTTPS необходим сертификат. Можно использовать Let's Encrypt или уже имеющийся сертификат вашего домена.

1. Запустите Xray и проверьте статус: systemctl start xray.

1. Настройте клиент. Импортируйте ссылку вида vless://UUID@server:443?encryption=none&security=tls&type=xhttp&mode=packet-up#name в v2rayNG или другой клиент на ядре Xray.

Использование XHTTP на бесплатном хостинге: возможности и ограничения

Бесплатные хостинги привлекательны тем, что не требуют оплаты и банковской карты. Однако у них есть серьёзные ограничения.

Например, alwaysdata предоставляет 100 МБ дискового пространства, доступ по SSH и возможность запускать пользовательские программы. Но правила бесплатного тарифа запрещают использование прокси, поэтому аккаунт могут заблокировать в любой момент. Это стоит рассматривать только как временное решение.

Другие бесплатные площадки часто разрешают только HTTP-трафик, что исключает использование WireGuard и других протоколов, работающих поверх UDP. XHTTP в режиме packet-up — единственный вариант, который может работать через такие ограничения.

При использовании бесплатного хостинга важно:

• Регулярно заходить в панель управления, чтобы аккаунт не был приостановлен (например, раз в 120 дней на alwaysdata).
• Иметь запасной вариант, так как блокировка может произойти внезапно.
• Учитывать, что исходящий IP будет общим для многих пользователей, что может снизить скорость и надёжность.

Настройка XHTTP на роутере OpenWrt с Podkop

Использование роутера с OpenWrt позволяет организовать проксирование для всей домашней сети без настройки каждого устройства отдельно. Проект podkop-xhttp описывает установку Xray с VLESS+XHTTP+REALITY на OpenWrt 24.10.4.

Процесс установки включает:

1. Установку пакетов xray-core и nano через opkg.
2. Генерацию конфигурации Xray с помощью онлайн-генератора.
3. Редактирование файла /etc/xray/config.json.
4. Создание init-скрипта для автозапуска Xray.
5. Настройку Podkop для маршрутизации трафика через локальный SOCKS-прокси на порту 10808.

После настройки можно проверить работу командой curl --socks5 127.0.0.1:10808 https://ifconfig.me, которая должна показать IP-адрес прокси-сервера.

Этот подход удобен для пользователей, которые хотят защитить все устройства в доме, включая Smart TV, игровые консоли и IoT-устройства.

Совместимость XHTTP с клиентами и другими инструментами

XHTTP поддерживается только клиентами на ядре Xray. Популярные приложения: v2rayNG, Happ, v2RayTun, Streisand. Они работают на Android, iOS, Windows и macOS.

Клиенты на основе sing-box (например, Hiddify, NekoBox) не поддерживают XHTTP, поэтому при выборе клиента обращайте внимание на используемое ядро.

Важно, чтобы версии Xray на сервере и клиенте совпадали. XHTTP активно развивается, и изменения в формате конфигурации могут привести к неработоспособности при использовании разных версий.

Также стоит учитывать, что XHTTP нельзя использовать вместе с XTLS-Vision, но можно с XTLS-Reality. При использовании Reality по умолчанию выбирается режим stream-one, если не указано иное.

Безопасность и обход блокировок: практические советы

XHTTP предоставляет хорошую маскировку, но не является панацеей. Для повышения устойчивости к блокировкам рекомендуется:

• Использовать домен с реальным сертификатом и настраивать TLS с fingerprint'ом настоящего веб-сервера (например, Nginx).
• Применять browser dialer, чтобы клиентский трафик выглядел как исходящий из браузера.
• Комбинировать разные протоколы и транспорты: например, использовать XHTTP для обхода DPI, а для дополнительной защиты — цепочку прокси.
• Рассмотреть использование отечественного VPS в качестве первого узла, так как трафик внутри страны часто не фильтруется.
• Использовать CDN, в том числе российские, для маскировки реального IP-адреса сервера.

Важно помнить, что ни один метод не даёт 100% гарантии. Регулярно обновляйте Xray и следите за изменениями в законодательстве и методах блокировок.

Частые ошибки при настройке и способы их решения

При настройке XHTTP пользователи часто сталкиваются с типичными проблемами.

Неверный порт. На некоторых хостингах порт назначается динамически. Используйте переменные окружения IP и PORT, если они предоставляются, вместо жёстко заданных значений.

Проблемы с режимом. Если клиент в режиме auto выбирает stream-up, а сервер или прокси его не поддерживают, соединение может разрываться. Явно указывайте режим packet-up в ссылке.

Предупреждения в логах. Заголовок X-Forwarded-For может вызывать предупреждения в Xray. Добавьте настройку sockopt.trustedXForwardedFor, чтобы их устранить.

Устаревшая версия Xray. Используйте последнюю версию, включая pre-release, если стабильная не поддерживает новые поля конфигурации. Проверяйте совместимость версий клиента и сервера.

Недостаточно места на диске. Логи могут быстро заполнить небольшой объём. Отключите ведение журнала соединений (access: none) и регулярно очищайте логи.

Вопросы и ответы