Repository navigation
Releases
Releases · MKultra6969/MK_XRAYchecker
v1.10.1
Fixed
- Vmess-ссылка в base64-JSON с
"tls": true(булево, а не строка) больше не роняет весь прогон сAttributeError: 'bool' object has no attribute 'lower'. Раньше сырое значениеtlsуходило прямо вsecurity: Xray-сборщик молча глотал ошибку, а Mihomo-сборщик падал ещё до начала проверок. Теперьtlsнормализуется вparse_vmess:true/1/"true"/"tls"/"xtls"в любом регистре дают TLS, всё остальное — без TLS. Такая ссылка проверяется через Xray с TLS, а не открытым текстом. Репорт и первый вариант фикса: @PlushkaNet. #18 - Vmess-ссылки с
"tls": "true"или мусором вроде"aes-128-gcm"больше не теряются молча: раньше значение уходило в Xray как есть (Unknown security "true"), и починка батча выкидывала такие прокси. null/false/0вpath,host,sni,fp,echиpsvmess-JSON больше не ломают сборку конфигов и не превращаются в строки"None"/"False";alpnсписком склеивается через запятую.- Если сборщик Mihomo всё-таки падает на ссылке при выборе ядра, ссылка помечается как unsupported и пропускается, а не роняет весь прогон.
v1.10.0
Added
- TCP ping отсев — новый этап перед проверкой конфигов. До запуска ядра checker делает обычный TCP-коннект до
host:portкаждой ссылки и выкидывает те, что не принимают соединение. Ядро больше не поднимается ради заведомо мёртвых прокси. Идея: Telegram @loliconshik. - Отсев выключен по умолчанию (
tcp_ping.enabled = false): он судит прокси по TCP-коннекту с машины пользователя и на зажатом канале может выкинуть живые ссылки. Включается флагом--tcp-ping, пунктом меню или ключом в конфиге, так что поведение проверки без явного включения не меняется. - Блок
tcp_pingвconfig.json:enabled,timeout,concurrency,retries,max_latency_ms,skip_udp,resolve_timeout,max_ips_per_host,report_file. - Пункт меню
Настройки → TCP ping отсев: тумблер, таймаут, число одновременных коннектов, ретраи, порог TCP RTT, поведение с UDP-протоколами и файл отчёта. Состояние отсева выведено в статус-панель. - Пункт меню
Проверка → TCP ping отсев: прогнать файл или ссылку только через TCP-отсев и сохранить живые ссылки, без запуска ядра. - CLI:
--tcp-ping/--no-tcp-ping,--tcp-ping-only,--tcp-ping-timeout,--tcp-ping-concurrency,--tcp-ping-retries,--tcp-ping-max-ms. --tcp-ping-max-msдаёт второй, более дешёвый порог задержки: TCP RTT до сервера отсекается ещё до того, как ядро потратит время на реальный запрос через прокси.- Опциональный
report_fileсо списком живыхip:portи их RTT.
Changed
- Отсев асинхронный (
asyncio, без новых зависимостей): пул воркеров вместо задачи на каждую ссылку, поэтому память не зависит от размера списка. DNS резолвится один раз на хост и кешируется на весь прогон. - Ретраится только
timeout.refusedиunreachable— окончательный ответ хоста, повторять их бессмысленно. - UDP/QUIC-протоколы (
hysteria,hysteria2,tuic,wireguard,shadowquic,masque) по умолчанию проходят мимо отсева: TCP-коннект на их порт ничего не доказывает и выбросил бы живые прокси. Отключается черезskip_udp. - Ссылки без распознанного
host:portотсев не трогает — он удаляет только то, что реально проверил. - Дефолтный
timeout—3.0сек. Ниже2.5ставить не стоит: на WindowsConnectExотдаётrefusedтолько через ~2 сек (SYN-ретрай), и отказ начал бы читаться как timeout с лишним ретраем.
v1.9.0
Added
- Автообновление всех трёх ядер, от версий которых зависит checker: Telethon (MTProto), Xray-core и Mihomo. Проверка выполняется на старте, до основной работы, и по умолчанию раз в 24 часа (
core_update.state.jsonхранит время последней проверки). - Новый блок
core_autoupdateвconfig.jsonс мастер-выключателем и отдельными тумблерами на каждое ядро:enabled,auto_apply,check_interval_hours,telethon,xray,mihomo,telethon_max_version. - Пункт меню
Настройки → Ядра: автообновление: включение/отключение автообновления целиком и по каждому ядру, переключениеauto/ask, интервал проверки, потолок версии Telethon, ручная проверка «Проверить сейчас» и таблица «Версии ядер» (установлено / доступно / статус). - Строка
Автообновление ядерв статус-панели интерактивного меню. - CLI:
--update-cores(принудительно проверить и обновить ядра, затем выйти) и--no-core-update(пропустить только обновление ядер, оставив self-update скрипта). Переменная окруженияMKXRAY_SKIP_CORE_UPDATE=1делает то же самое. xray_installer.py: детект установленной версии Mihomo (get_current_mihomo_version), поиск установленного ядра (find_installed_core), проверка обновления (check_for_core_update) и обновление бинарника (update_core_binary) — общие для Xray и Mihomo.
Changed
- Обновление ядра выполняется только для уже установленного бинарника; первичная установка по-прежнему за
autoinstall_xray/autoinstall_mihomo, так что скрипт не тянет ядро, которым пользователь не пользуется. - Если бинарник ядра лежал не в
bin/, а рядом со скриптом, после обновления синхронизируются оба расположения — иначе checker продолжал бы подхватывать старую копию. xray_installer._safe_printбольше не падает на legacy-консоли Windows (cp1252): раньше перехватывался толькоImportError, иUnicodeEncodeErrorизrichпробивался наружу.
Fixed
- Обновление Telethon ограничено сверху веткой
1.x(telethon_max_version = "2.0.0"). Telethon 2.x — несовместимый rewrite API, иmtproto_checker/mtproto_faketlsна нём не работают:mtproto_faketlsимпортируетtelethon.network.connection.tcpmtproxy, которого в 2.x нет. Ограничение снимается пустым значением. - Каждое обновление откатывается при провале проверки: бинарники Xray/Mihomo бэкапятся перед заменой и восстанавливаются, если новый бинарник не отвечает на запрос версии; Telethon переустанавливается на прошлую версию, если после
pip installне проходит импортtelethon+mtproto_faketls+mtproto_checker. - После успешного обновления Telethon скрипт перезапускается автоматически: старый модуль уже импортирован в процесс, и без рестарта новая версия не применилась бы (защита от цикла —
MKXRAY_CORE_UPDATE_RESTARTED).
v1.8.0
[1.8.0] - 2026-07-24
Added
- Обновлены Xray-конфиги для совместимости с 26.3.27 и 26.7.11, добавлены возможности Mihomo 1.19.29 и Hysteria 2.10, поддержка AnyTLS и TUIC. #14
- Добавлен официальный импорт Mihomo-форматов SSR, Hysteria1, SOCKS, аутентифицированных HTTP(S) и mierus, включая нативный passthrough YAML-прокси. #14
Changed
- Capability routing теперь выбирает подходящее ядро Xray или Mihomo для каждого прокси. #14
- Улучшены валидация парсера и каноническая дедупликация; исправлены runtime/native mappings и удалён
allowInsecure. #14
[1.7.0] - 2026-07-04
Added
- Добавлено автоисправление Xray-батчей: при ошибке сборки outbound скрипт извлекает тег из лога ядра, отбрасывает только проблемный прокси и повторяет запуск batch-а. #14, refs #15
- Обновлена генерация Xray/Mihomo-конфигов для современных параметров ссылок:
spx/spiderX,pqv,pcs,packetEncoding,ed,ech, Hysteria2obfsPasswordиalpn. #14
Changed
- Дедупликация входных ссылок теперь использует канонический ключ по распарсенной proxy-структуре, поэтому порядок query-параметров, мусорные параметры и fragment/tag больше не создают дубликаты. #14
[1.6.4] - 2026-05-27
Fixed
- Исправлена проверка Shadowsocks через Mihomo:
ss://ссылки больше не пропускаются из-за рассинхронаshadowsocks/ssпри генерации Mihomo-конфига. #13 - Для Shadowsocks разделены allowlist шифров Xray и Mihomo: Xray по-прежнему отбрасывает legacy cipher'ы, чтобы избежать
Exit 23, а Mihomo принимает поддерживаемыеaes-*-cfb,rc4-md5,chacha20-ietfи другие совместимые методы. #13
[1.6.3] - 2026-05-25
Changed
- Автоматическое распределение прокси по ядрам: теперь скрипт автоматически использует ядро
mihomoдля сканирования прокси Hysteria2 (hy2://,hysteria2://), даже если основным выбрано ядроxray.
[1.6.2] - 2026-05-25
Added
- Добавлено предупреждение (алерт) о несовместимости протокола Hysteria2 с ядром Xray. Скрипт теперь рекомендует переключиться на ядро Mihomo, если в списке есть Hysteria2 ссылки, а текущее ядро - Xray.
[1.6.1] - 2026-05-24
Fixed
- Исправлено падение (TypeError:
>not supported between instances ofNoneTypeandint) при неудачном замере скорости скачивания. - Удален нерабочий сервис загрузки логов
paste.mk69.su, теперь всегда используетсяpaste.rs.
v1.6.0
[1.6.0] - 2026-05-20
Added
- MTProto checker теперь умеет читать
help.getPromoDataдля живых Telegram proxy и показывает результат в live-логе, колонкеPromo, summary и sidecar JSONsortedMtproto.promo.json. - Добавлен авторизованный promo-session flow: CLI
--mtproto-loginи TUI-пунктНастройки -> Login MTProtoсоздают Telethon sessionmtproto_promo.session, поддерживают код Telegram и 2FA-пароль. - Вход в Telegram подписывается как
MK_XrayCheckerв active sessions. - Для promo enrichment добавлены настройки
fetch_promo_data,promo_session_file,promo_output_file,promo_threads,promo_timeoutиpromo_probe_limit. - Promo enrichment распараллелен через in-memory
StringSession, чтобы не шарить SQLite session-файл между параллельными Telethon clients.
Changed
help.getPromoDataбольше не вызывается внутри unauthenticated liveness probe: сначала checker определяетLIVE, затем отдельным authenticated enrichment добавляет promo metadata.- Без авторизованной session promo теперь отображается как
auth required, а не как шумныйAuthKeyUnregisteredError. - Дефолты promo сделаны консервативнее:
promo_threads=3,promo_timeout=6,promo_probe_limit=50;promo_threadsограничен максимумом 8. - Promo targets при лимите сортируются по
ping_ms, чтобы сначала проверять самые быстрые live proxy. - Перед
--mtproto-loginдобавлено явное ToS-подтверждение: свой аккаунт, без spam/scam и AI/data scraping.
Fixed
- Убрано последовательное ожидание promo-запросов по всем live proxy: enrichment теперь использует bounded parallelism и отдельный timeout.
is_user_authorized()в promo path теперь ограничен timeout, чтобы зависшие proxy не блокировали весь этап.
v1.5.0
[1.5.0] - 2026-05-20
Added
- MTProto checker получил
probe_policy(strict/balanced/telegram_like), ограниченныеconnect_retries/rpc_retries, fallback RPChelp.GetNearestDcRequestпослеhelp.GetConfigRequestи JSON-диагностику attempts черезdebug_attempts. CONN/connect-only MTProto результаты теперь могут сохраняться отдельно в sidecarsortedMtproto.conn.txt, не смешиваясь с основнымLIVEoutput.
Fixed
- Исправлен FakeTLS
eestream handoff: server-handshakeapplication_dataбольше не отдаётся Telethon как MTProto payload, а первый client application-data теперь предваряется TLSChangeCipherSpec, как в TDLib/gotd. - Обновлён FakeTLS ClientHello под текущий TDLib-style layout с GREASE/permuted extensions, чтобы современные
eeproxy не падали в ложныйCONN/SOFT.
Changed
- Документация MTProto синхронизирована с
MTPROTO_CHECKER_IMPROVEMENT_PLAN.md: описаны статусыLIVE / CONN / DROP / UNREACH / SOFT / FAIL, политикиprobe_policy(strict,balanced,telegram_like),connect_retries/rpc_retries,save_connect_onlyи sidecar-файлsortedMtproto.conn.txt.
v1.4.1
[1.4.1] - 04-15-2026
Added
- Telegram checker теперь поддерживает
tg://socks/t.me/socks.
Fixed
- MTProto
safemode теперь отключает не толькоcryptg, но и nativelibsslbackend Telethon, чтобы битый FakeTLS/MTProto поток не валил процесс через OpenSSL assertion. #9 - Для входящих MTProto пакетов добавлена проверка длины ciphertext перед AES-IGE decrypt, чтобы некратный 16 буфер завершался обычным
FAIL, а не hard-crash процесса. #9 #7 - Если preferred MTProto DC не сработали, checker теперь автоматически добирает оставшиеся Telegram DC вместо раннего ложного
Timeout/FAILна живом proxy. #9 - Известный asyncio-шум
Future exception was never retrievedдля уже обработанного misaligned MTProto ciphertext подавляется, а причина показывается в человекочитаемом виде. - На Windows подавлен
asyncio Proactortraceback наConnectionResetError [WinError 10054]во время_call_connection_lost(), если это уже обработанное закрытие MTProto transport, а не реальный сбой проверки. - Telegram checker теперь явно показывает, сколько
proxy-ссылок было найдено всего, и отдельно считаетMTProtoиSOCKS, чтобы mixed-файлы не выглядели как “пропавшие” прокси. - Для
ee/FakeTLSchecker теперь перебирает несколько MTProxy transport (randomized,intermediate,abridged) вместо жёсткой привязки к одному codec, поэтому живые proxy с нестандартным transport больше не застревают в ложномCONN. #9
[1.4.0] - 04-13-2026
Changed
- MTProto checker получил управляемый выбор crypto backend:
auto,safeиunsafe. - Новый CLI-флаг
--mtproto-cryptoи новый ключmtproto.crypto_backendвconfig.jsonпозволяют принудительно выбирать backend или оставить авто-режим. - В интерактивное меню настроек добавлен отдельный пункт выбора MTProto crypto backend.
- Перед стартом MTProto проверки теперь явно показывается, какой crypto backend реально выбран.
Fixed
- MTProto checker больше не зависит жёстко от проблемного native crypto backend в чужом окружении: auto-режим консервативно уходит в safe path для рискованных сценариев. #7
- Восстановление panic-like ошибок в MTProto path стало надёжнее: создание
TelegramClientи cleanup-path больше не сваливаются в грубый crash без нормальногоFAIL/CONNрезультата.
[1.3.5] - 04-12-2026
Fixed
- Исправлена регрессия FakeTLS, из-за которой живые
eeproxy уходили вdcX/faketls: Timeoutвместо корректной проверки.
v1.3.4
[1.3.4] - 04-11-2026
Changed
- MTProto checker теперь выделяет сетевую недоступность proxy в отдельный статус
UNREACH, чтобы сразу отличать недоступный proxy-хост от transport/FakeTLS/DC ошибок.
Fixed
- Исправлено падение MTProto checker на части
ee/FakeTLSproxy: первый TLSapplication_dataпослеServerHelloбольше не теряется, поэтому Telethon не получает сдвинутый MTProto-поток. #7 - MTProto worker больше не валит весь checker на
BaseException-уровневых ошибках вродеPanicExceptionизcryptg: connect/probe/disconnect path восстанавливается в нормальный результат проверки. #7 - Сообщение
dcX/faketls: Timeoutбольше не маскирует кейс, когда сам proxy-хост недоступен по TCP с текущей машины.
[1.3.3] - 04-10-2026
Fixed
- Обновлён FakeTLS
ClientHelloпосле изменений Telegram MTProto. #6 - Убрана рассинхронизация TLS-потока, которая приводила к падению OpenSSL/AES-IGE и ложным ошибкам MTProto checker.
[1.3.2] - 03-21-2026
Added
- Поддержка
hex,base64иbase64urlдляMTProto secretвtg://proxy/t.me/proxy.
Changed
- MTProto parser теперь канонизирует
secretвhex, а live-результаты сохраняются в нормализованномtg://proxy?...&secret=<hex>виде. - Один и тот же MTProto proxy, пришедший в
hex,base64илиbase64url, теперь схлопывается в одинunique_key.
Fixed
- Восстановление
+после query-parsing для обычногоbase64secret, чтобы MTProto ссылки не ломались из-заparse_qs. ddMTProto secrets больше не гоняются через неподходящие transport-режимы: checker использует толькоrandomized.- FakeTLS backend теперь корректно принимает
eesecrets изhex, обычногоbase64иbase64url.
[1.3.1] - 03-15-2026
Added
- Новый регрессионный self-test для парсинга subscription URL: проверяет JSON-списки источников и строки с markdown/json-обрамлением. #5
- GitHub issue templates для багов, feature request и вопросов по использованию.
Changed
-f/--fileтеперь официально документирован как вход для.txtи.jsonсо списками подписок и прямых ссылок.
Fixed
- Исправлен разбор
sources.jsonи других JSON-файлов в режиме--file: subscription URL больше не уходят вrequestsс хвостами вроде"или",. #5 - Извлечение HTTP(S)-подписок стало устойчивым к JSON/Markdown-обрамлению и посторонним завершающим символам. #5
- В
fetch_url()добавлена финальная защитная нормализация URL, чтобы мусорный ввод не превращался в ложныеHTTP 404. #5
v1.3.0
[1.3.0] - 03-14-2026
Added
- Отдельный
MTProto checkerдля Telegram proxy (tg://proxy,t.me/proxy) в новом модулеmtproto_checker.py. - Новый CLI-флаг
--mtprotoдля запуска отдельного MTProto режима без участияxray/mihomo. - Новый блок
mtprotoвconfig.json:enabled,api_id,api_hash,threads,timeout,max_ping_ms,output_file. - Новый пункт
MTProtoв интерактивном меню и отдельная настройкаMTProto ping. - Self-test для MTProto parser через
--self-test. - Новая зависимость
telethonвrequirements.txt.
Changed
- Логика MTProto вынесена в отдельный backend и orchestration path внутри
v2rayChecker.py, не смешиваясь с текущим Xray/Mihomo pipeline. - Для существующих конфигов включено автоматическое дозаполнение новых nested-ключей в
config.json. --self-testи автообновление конфига переведены на ASCII-safe вывод, чтобы не падать в Windows-консолях сcp1252.- Переработка главного меню. Теперь меню - двухуровневое.
Fixed
- Мелкие фиксы
v1.1.4
[1.1.4] - 02-21-2026
Added
- Новый безопасный режим для роутеров/OpenWRT:
router_modeвconfig.jsonи CLI-флаг--router-mode. - Новая политика очистки старых процессов ядра:
core_cleanup_mode(owned/all/none) и CLI-флаг--cleanup-mode. - Новый фильтр агрегатора по странам:
--agg-countryи ключ конфигаagg_countries.
Changed
- Стартовая очистка процессов ядра переведена в безопасный режим по умолчанию (
owned): убиваются только процессы, запущенные самим чекером. - Для
router_modeдобавлена защита от агрессивной зачистки: режимallавтоматически понижается доowned. - Агрегатор сначала пытается фильтровать страны по уже существующим меткам/тегам, и только затем делает GeoIP-lookup для оставшихся IP.
Fixed
- Исправлен кейс, когда при выборе
mihomoчекер мог завершать системныйmihomo, запущенный роутером.