Если вы являетесь владельцем сервера, чьи конфигурации были обнаружены в данном репозитории, и вы хотите их удалить:

Обязательно:

• Домен или IP-адрес сервера для удаления
• Доказательство владения (одно из):
  • Запись WHOIS домена
  • Счёт от хостинг-провайдера (реквизиты и персональные данные можно скрыть)
  • DNS TXT-запись: v=removal-request-xraycheck
  • Письмо с корпоративного email на домене сервера

Опционально:

• Причина удаления (утечка, устаревшие данные, ошибочное добавление)
• Предпочтительный способ связи для подтверждения

• Первичный ответ: в течение 48 часов
• Удаление из репозитория: в течение 72 часов после подтверждения владения
• Обновление GitHub Pages: до 24 часов после удаления из репозитория

Поддерживаемые протоколы: VLESS, VMess, Trojan, Shadowsocks, Hysteria, MTProto

• Python 3.8+
• Xray-core - при первом запуске, если xray не найден в PATH и не заданXRAY_PATH, скрипт автоматически скачает нужную сборку с GitHub Releases в папкуxray_dist рядом со скриптом. Ручная установка не обязательна.

pip install -r requirements.txt

• single - Валидация ключей из одной ссылки (аргумент командной строки илиDEFAULT_LIST_URL).
• merge - Объединение ключей из нескольких ссылок и валидация одной группы. Ссылки задаются в файлеlinks.txt (по одной URL на строку). Имя файла задаётся в.env переменнойLINKS_FILE.

• Обычный (STRONG_STYLE_TEST=false) - несколько тестовых URL (HTTP и/или HTTPS), повторные запросы, проверки стабильности. Настраивается черезTEST_URLS,TEST_URLS_HTTPS,MIN_SUCCESSFUL_URLS,REQUIRE_HTTPS,STABILITY_CHECKS и др.
• Строгий (STRONG_STYLE_TEST=true) - один тестовый URLhttps://www.gstatic.com/generate_204, один или два запроса подряд, без повторов. Ключ считается рабочим только при ответе 204, пустом теле и времени ответа не болееSTRONG_MAX_RESPONSE_TIME секунд. Результаты ближе к поведению мобильных клиентов.

Полный список переменных - в .env.example.

Список по умолчанию (режим single):

python vless_checker.py

Свой URL списка (режим single):

python vless_checker.py "https://example.com/my-vless-list.txt"

Режим merge: положите ссылки в links.txt, в .env задайте MODE=merge:

# В links.txt по одной URL на строку, например:
# https://example.com/list1.txt
# https://example.com/list2.txt
python vless_checker.py

Для запуска проверки в изолированном окружении доступен режим через Docker.
Рекомендуемый способ - использовать docker-compose из репозитория (учитывает .env, CIDR whitelist и публикацию результатов в configs/).

1. Скопируйте .env.example в .env и при необходимости скорректируйте настройки (режим, LINKS_FILE, CIDR_WHITELIST_URL и т.д.).
2. Убедитесь, что установлен Docker и Docker Compose.
3. Запустите:

docker compose up --build

Результаты проверки (файлы available, available(top100) и отчёты speedtest при включённом SPEED_TEST_ENABLED) будут в каталоге configs/ на хосте согласно настройкам в .env.

При необходимости можно запустить контейнер вручную (например, для одноразовой проверки), используя локально собранный образ:

docker build -t xraycheck:latest .

А затем:

docker run --rm \
 --env-file .env \
 -v "$(pwd)/configs:/app/configs" \
 xraycheck:latest

Где:

• --env-file .env передаёт все настройки проверки в контейнер;
• -v "$(pwd)/configs:/app/configs" монтирует локальную папку configs для сохранения результатов.

В качестве первого аргумента контейнер принимает URL списка конфигов (аналог python vless_checker.py "https://..." при локальном запуске).
Это работает как для docker run, так и для docker compose run:

docker run --rm \
 --env-file .env \
 -v "$(pwd)/configs:/app/configs" \
 xraycheck:latest \
 "https://example.com/my-vless-list.txt"

Или через docker-compose (использует сервис vless-checker из docker-compose.yml):

docker compose run --rm vless-checker "https://example.com/my-vless-list.txt"

В этом случае список ключей загружается по переданному URL, а все остальные параметры берутся из .env.

Для удобства запуска доступны интерактивные скрипты, которые предлагают выбор между обычной проверкой и проверкой в Docker, а также автоматически проверяют и устанавливают зависимости.

Для Windows доступен нативный bat-скрипт run_check.bat с интерактивным меню:

1. Дважды кликните наrun_check.bat в проводнике Windows, или
2. Запустите из командной строки или PowerShell:

   run_check.bat

Использование:

• Используйте стрелки ↑↓ для навигации по меню
• Нажмите Enter для выбора пункта
• Нажмите Escape для выхода

С передачей аргументов (например, URL списка):

run_check.bat "https://example.com/my-list.txt"

Примечание: Скрипт использует встроенный PowerShell для интерактивного меню. Убедитесь, что PowerShell доступен в вашей системе (обычно установлен по умолчанию в Windows 10/11).

Для Linux и macOS используйте bash скрипт run_check.sh с интерактивным меню:

chmod +x run_check.sh
./run_check.sh

Использование:

• Используйте стрелки ↑↓ для навигации по меню
• Нажмите Enter для выбора пункта
• Нажмите Escape или 'q' для выхода

С передачей аргументов (например, URL списка):

./run_check.sh "https://example.com/my-list.txt"

Параметры задаются в .env в каталоге проекта (или через переменные окружения). Полный шаблон со значениями по умолчанию - .env.example.