Skip to content

Latest commit

 

History

History
95 lines (73 loc) · 6.17 KB

cli.md

File metadata and controls

95 lines (73 loc) · 6.17 KB

⚙️ Аргументы CLI

Полный список аргументов v2rayChecker.py. Краткая версия с типовыми сценариями — в README.

Режимы запуска

Аргумент Описание
-m, --menu Принудительный запуск интерактивного меню
--agg Запустить встроенный агрегатор (граббер) прокси
--mtproto Запустить отдельный checker MTProto proxy (tg://proxy, t.me/proxy)
--mtproto-login Авторизовать Telethon session для чтения MTProto promo data (v1.6.0)
--tcp-ping-only Только TCP ping отсев: сохранить живые ссылки и выйти, ядро не запускается (v1.10.0)
--self-test Запустить самопроверку URL парсинга (v1.0.3)
--debug Debug режим (1 proxy/batch, 1 thread) (v1.0.3)

Ввод и вывод

Аргумент Описание
-f, --file Путь к .txt/.json с прокси или со списком URL-подписок
-u, --url URL ссылка на подписку или список (v1.1.3)
-o, --output Файл для сохранения результатов. Для MTProto по дефолту: sortedMtproto.txt
-n, --number Ограничить количество проверяемых прокси (взять первые N)
--reuse Перепроверить файл результатов (sortedProxy.txt)
-s, --shuffle Перемешать список перед проверкой

Ядро и производительность

Аргумент Описание
-c, --core Путь к исполняемому файлу ядра (xray/v2ray/mihomo)
--engine Режим выбора ядра: auto / xray / mihomo
-T, --threads Лимит одновременно запущенных ядер или MTProto-воркеров
-t, --timeout Таймаут ожидания ответа в секундах
-l, --lport Стартовый локальный порт для ядер (по дефолту: 1080)
--t2exec Время ожидания запуска ядра в секундах
--t2kill Задержка после убийства процесса ядра
--router-mode Безопасный режим роутера (не убивать чужие процессы ядер) (v1.1.4)
--cleanup-mode Очистка старых процессов: owned / all / none (v1.1.4)

Проверка и фильтрация

Аргумент Описание
-d, --domain Тестовый домен для проверки подключения (по дефолту: Google/CF generate_204)
--max-ping Отсев по ping (мс), 0 = отключить (для MTProto использует его отдельный блок)
--speed Включить тест скорости скачивания (вместо только пинга)
--sort Метод сортировки результатов: ping или speed
--speed-url Ссылка на файл для теста скорости

TCP ping отсев

Быстрый TCP-коннект до host:port перед запуском ядра. По умолчанию отсев выключен. Все флаги перекрывают блок tcp_ping из config.json на один запуск.

Аргумент Описание
--tcp-ping Включить отсев на этот запуск (v1.10.0)
--no-tcp-ping Отключить отсев, даже если в конфиге он включён (v1.10.0)
--tcp-ping-timeout Таймаут одной TCP-попытки в секундах (v1.10.0)
--tcp-ping-concurrency Сколько TCP-коннектов держать одновременно (v1.10.0)
--tcp-ping-retries Доп. попытки перед вердиктом «мёртв». Ретраится только timeout (v1.10.0)
--tcp-ping-max-ms Порог TCP RTT в мс, 0 = только живой/мёртвый (v1.10.0)

--tcp-ping-max-ms — это RTT до сервера, а не ping через прокси. Полноценный порог задержки — --max-ping. В режиме --tcp-ping-only без явного -o результат пишется в tcp_alive.txt, чтобы не затереть sortedProxy.txt.

Подробнее — в README.

Агрегатор

Аргумент Описание
--agg-cats Категории источников для агрегатора (например: 1 2)
--agg-filter Фильтр агрегатора по ключевым словам (например: vless reality)
--agg-country Фильтр агрегатора по странам ISO2 (например: RU DE GB) (v1.1.4)

MTProto

Аргумент Описание
--mtproto-crypto Принудительный выбор MTProto crypto backend: auto / safe / unsafe

Подробнее про режим — в docs/mtproto.md.

Обновления

Аргумент Описание
--no-update Пропустить проверку самообновления на старте (v1.1.0)
--update-cores Принудительно проверить и обновить ядра (Telethon/Xray/Mihomo), затем выйти (v1.9.0)
--no-core-update Пропустить только автообновление ядер (v1.9.0)

--no-update отключает и self-update скрипта, и автообновление ядер. То же самое делает переменная окружения MKXRAY_SKIP_CORE_UPDATE=1.