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

Скрипт загружает список прокси-ключей по URL и выполняет end-to-end проверку каждого ключа:

1. Запускает локальный прокси (xray) с этим ключом (SOCKS на 127.0.0.1).
2. Делает HTTP(S)-запрос к тестовому URL через прокси.
3. По ответу (статус, время, при необходимости несколько URL и повторные запросы) ключ считается рабочим или мёртвым.

Рабочие ключи сохраняются в директории configs/ без расширения: available, available(top100). При запуске через Docker — configs/white-list_available, configs/white-list_available(top100). Ссылки на скачивание с GitHub Pages: https://whiteprime.github.io/xraycheck/configs/... (то же имя файла без расширения).

• 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) - один тестовый URL https://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, а также автоматически проверяют и устанавливают зависимости.

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

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

   run_check.bat

Особенности:

• Интерактивное меню с выбором стрелками ↑↓ и подтверждением Enter
• Центрированное отображение меню в консоли
• Цветная подсветка выбранного пункта
• Автоматическая проверка и установка зависимостей Python

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

• Используйте стрелки ↑↓ для навигации по меню
• Нажмите 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
• Центрированное отображение меню в терминале
• Цветная подсветка выбранного пункта
• Автоматическая проверка и установка зависимостей Python

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

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

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

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

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

Остальные параметры (повторы, стабильность, геолокация, строгий режим проверки всех URL и т.д.) описаны в .env.example.

В контейнере исходящий доступ ограничен только подсетями из CIDR whitelist.

• Сборка и запуск: docker compose up --build (или docker compose run --rm vless-checker)
• Результат: файл с рабочими ключами создаётся в configs/ на хосте (volume .:/app)
• Свой URL списка: docker compose run --rm vless-checker "https://example.com/keys.txt"
• Режим merge: положите links.txt в каталог проекта (volume .:/app), задайте в .env MODE=merge и запустите docker compose run --rm vless-checker
• Требуется cap_add: NET_ADMIN для iptables внутри контейнера

В репозитории настроен workflow Daily VLESS check (.github/workflows/daily-check.yml):

• Расписание: три раза в день в 7:10 | 14:10 | 19:10 MSK (cron).
• Действия: запуск vless_checker.py в режиме merge (списки из links.txt), результат пишется в configs/available и configs/available(top100); копии в корень для GitHub Pages; при изменении — коммит и push.
• Ручной запуск: вкладка Actions → «Daily VLESS check» → Run workflow.

Чтобы не публиковать links.txt в репозитории: файл links.txt уже попадает под маску *.txt в .gitignore. В CI он создаётся из секрета. Добавьте в репозитории Settings → Secrets and variables → Actions секрет с именем LINKS_FILE_CONTENT и значением - содержимое вашего links.txt (по одной URL на строку). Workflow перед запуском проверки запишет этот секрет во временный links.txt. Если секрет не задан, шаг «Create links.txt from secret» завершится с ошибкой. Если links.txt уже был закоммичен ранее, удалите его из истории и добавьте секрет: git rm --cached links.txt и коммит.