WhitePrime / xraycheck

XRayCheck > **Технический анализ конфигураций VLESS, VMess, Trojan, Shadowsocks, Hysteria и MTProto с возможностью эмуляции сетевых ограничений** --- > ⚠️ **Данные предоставляются исключительно в информационных целях.** > > ⚠️ **Любое использование конфигураций возможно только с согласия их владельцев** > > ⚠️ **Настоящий инструмент выполняет только техническую валидацию доступности сетевых endpoint** > > ⚠️ **Инструмент не создаёт VPN-соединений и не маршрутизирует пользовательский трафик через третьи лица** --- | **Исходный код** | | **Локальный запуск** | | **Техническая информация** | | **DMCA Takedown** | > **Telegram** --- 📊 Статистика репозитория | Показатель | Значение | | ------------------------------------------------ | ---------------- | | Просмотры (14Д) | 4 874| | Уникальные посетители (14Д) | 1 284| | Клоны (14Д) | 17 012| | Уникальные клоны (14Д) | 3 285| | Звёзды | 51| | Форки | 4| --- --- 📮 DMCA Takedown Если вы являетесь владельцем сервера, чьи конфигурации были обнаружены в данном репозитории, и вы хотите их удалить: | Способ | Действие | |--------|----------| | **GitHub Issue** | Создайте Issue с тегом в заголовке | | **Telegram** | Напишите в Telegram-бот для обратной связи | Что нужно указать в запросе Обязательно: • [ ] Домен или IP-адрес сервера для удаления • [ ] Доказательство владения (одно из): • Запись WHOIS домена • Счёт от хостинг-провайдера (реквизиты и персональные данные можно скрыть) • DNS TXT-запись: • Письмо с корпоративного email на домене сервера Опционально: • Причина удаления (утечка, устаревшие данные, ошибочное добавление) • Предпочтительный способ связи для подтверждения Сроки обработки • **Первичный ответ**: в течение 48 часов • **Удаление из репозитория**: в течение 72 часов после подтверждения владения • **Обновление GitHub Pages**: до 24 часов после удаления из репозитория --- --- Техническая информация --- Поддерживаемые протоколы: **VLESS**, **VMess**, **Trojan**, **Shadowsocks**, **Hysteria**, **MTProto** Требования • **Python 3.8+** • **Xray-core** - при первом запуске, если xray не найден в PATH и не задан , скрипт **автоматически скачает** нужную сборку с GitHub Releases в папку рядом со скриптом. Ручная установка не обязательна. Установка Режимы работы • **single** - Валидация ключей из одной ссылки (аргумент командной строки или ). • **merge** - Объединение ключей из нескольких ссылок и валидация одной группы. Ссылки задаются в файле (по одной URL на строку). Имя файла задаётся в переменной . Режимы проверки ключей • **Обычный** ( ) - несколько тестовых URL (HTTP и/или HTTPS), повторные запросы, проверки стабильности. Настраивается через , , , , и др. • **Строгий** ( ) - один тестовый URL , один или два запроса подряд, без повторов. Ключ считается рабочим только при ответе 204, пустом теле и времени ответа не более секунд. Результаты ближе к поведению мобильных клиентов. Полный список переменных - в . --- --- Локальный запуск Запуск Список по умолчанию (режим single): Свой URL списка (режим single): Режим merge: положите ссылки в , в задайте : Запуск через Docker Для запуска проверки в изолированном окружении доступен режим через Docker. Рекомендуемый способ - использовать из репозитория (учитывает , CIDR whitelist и публикацию результатов в ). Быстрый старт с docker-compose • Скопируйте в и при необходимости скорректируйте настройки (режим, , и т.д.). • Убедитесь, что установлен Docker и Docker Compose. • Запустите: Результаты проверки (файлы , и отчёты speedtest при включённом ) будут в каталоге на хосте согласно настройкам в . Пример запуска одиночного контейнера При необходимости можно запустить контейнер вручную (например, для одноразовой проверки), используя локально собранный образ: А затем: Где: • передаёт все настройки проверки в контейнер; • монтирует локальную папку для сохранения результатов. Передача URL списка конфигов в Docker В качестве первого аргумента контейнер принимает URL списка конфигов (аналог при локальном запуске). Это работает как для , так и для : Или через docker-compose (использует сервис из ): В этом случае список ключей загружается по переданному URL, а все остальные параметры берутся из . Запуск через скрипты Для удобства запуска доступны интерактивные скрипты, которые предлагают выбор между обычной проверкой и проверкой в Docker, а также автоматически проверяют и устанавливают зависимости. Windows: bat-скрипт Для Windows доступен нативный bat-скрипт с интерактивным меню: • Дважды кликните на в проводнике Windows, или • Запустите из командной строки или PowerShell: **Использование:** • Используйте стрелки ↑↓ для навигации по меню • Нажмите Enter для выбора пункта • Нажмите Escape для выхода С передачей аргументов (например, URL списка): > **Примечание:** Скрипт использует встроенный PowerShell для интерактивного меню. Убедитесь, что PowerShell доступен в вашей системе (обычно установлен по умолчанию в Windows 10/11). Linux/macOS: bash скрипт Для Linux и macOS используйте bash скрипт с интерактивным меню: **Использование:** • Используйте стрелки ↑↓ для навигации по меню • Нажмите Enter для выбора пункта • Нажмите Escape или 'q' для выхода С передачей аргументов (например, URL списка): Настройки (файл ) Параметры задаются в ** ** в каталоге проекта (или через переменные окружения). Полный шаблон со значениями по умолчанию - ** **. Основные, вывод и комментарии | Переменная | Описание | |------------|----------| | | Режим: (одна ссылка) или (объединение списков из файла) | | | URL списка по умолчанию при | | | Файл со ссылками при (по одной URL на строку) | | | Имя файла для рабочих ключей без расширения (напр. ) | | | Директория для результатов ( ) | | | Добавлять дату и источник к имени файла ( / ) | | | Комментарий, который добавляется к проверенным конфигам (после флага страны) | | | URL CIDR whitelist для Docker-режима (ограничение исходящего доступа по подсетям) | Тестовые URL и валидация | Переменная | Описание | |------------|-…