ddadminandClaude Fable 5
98bfd6338a
- Зачем:
- CLI и спека были переусложнены относительно принятой модели угроз
(один пользователь, доверенная машина): лишняя ось версий Xray и
защита от входов, которые не возникают при ручном редактировании.
- Что:
- убрана поддержка Xray 25.12.8 — поддерживается только 26.3.27;
allowInsecure валидируется, но никогда не эмитится в JSON.
- удалена проверка владения сокетом через /proc/net/tcp; идентичность
процесса и сверка адрес/порт со state сохранены.
- валидация INI/профиля/адреса/query сведена к отказам на реальные
опечатки; scoped IPv6 отклоняется одинаково на Python 3.8 и 3.9+.
- удалены fsync/O_EXCL-церемония, SIGALRM-таймер, zombie-инспекция,
мёртвый отпечаток профиля и двойной разбор extra/alpn.
- shell.bash принимает вывод env без ре-валидации, сохранив атомарность;
спека и issue 01–05 приведены к новому объёму (тикет 06, леджер).
- Проверка:
- python3 -m unittest discover -s tests — 34 теста OK.
- bash tests/test_proxy_launchers.sh — 8 проверок PASS.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
7.8 KiB
7.8 KiB
02 — Управляемый Xray: полный штатный путь
What to build: Пользователь с уже установленным поддерживаемым Xray кладёт одну VLESS-ссылку в закрытый файл и получает полный штатный сценарий локального прокси: проверку профиля, запуск на переднем плане, диагностику, запуск команд через прокси и штатную остановку.
Blocked by: 01 — Внешний прокси и переносимый Bash-интерфейс.
Status: done
Часть требований пересмотрена в 06 — см. 06-simplification-pass.md.
startразрешён только при явном типеxray, требует loopback-адрес и согласованный локальный порт, никогда не скачивает бинарник и выбирает первыйxrayизPATH. Один разрешённый путь используется дляversion,run -testи основного процесса и показывается перед запуском.- Успешный
xray versionразбирается только по первой строке в формеXray VERSIONс концом строки либо ASCII-пробелом после полного токена версии. Принимаются только25.12.8и26.3.27; ведущий мусор, похожий префикс вроде26.3.270, пустой, неверный или завершившийся ошибкой вывод запрещает преобразование и запуск. Запрошенная или указанная в профиле версия не подменяет фактическую версию выбранного бинарника. - Профиль берётся из предусмотренного файла по умолчанию либо из явно
переданного
-f, содержит ровно одну VLESS-ссылку, а конечный файл после разрешения симлинка недоступен группе и остальным пользователям. - Строгий преобразователь поддерживает TCP/RAW с REALITY и XHTTP с TLS, сохраняет все предусмотренные спецификацией поля, отклоняет повторы, любой неизвестный query-параметр, отсутствующие обязательные поля и неподдерживаемые сочетания до запуска Xray.
- Для Xray 26.3.27 корректно обрабатываются
pcs/vcn, а устаревшиеallowInsecure/insecureне переносятся и дают предупреждение; для явно выбранного Xray 25.12.8 сохраняется совместимое insecure-поведение, а новые поля отклоняются без автоматического отката версии. allowInsecureиinsecureпринимают только точные значенияtrueилиfalse; при одновременном присутствии значения должны совпадать. Для 25.12.8 только согласованное истинное значение включаетallowInsecureс предупреждением, а для 26.3.27 поле никогда не попадает в JSON и истинное значение предупреждает об обычной проверке сертификата.- Созданный клиентский JSON слушает только loopback, предоставляет HTTP и
SOCKS на одном порту, отключает журнал доступа и проходит
xray run -testдо запуска основного процесса. startостаётся на переднем плане как супервизор одного дочернего Xray; после запуска процесс жив и порт принимает соединения, а сбой отдельной проверки внешнего IP остаётся предупреждением.- Штатный
startсоздаёт закрытое состояние с PID супервизора и дочернего Xray, разрешённым путём к бинарнику, портом и безопасным отпечатком профиля.status,env,runиstopтребуют это состояние, живой супервизор, ожидаемый дочерний процесс и настроенный порт; один чужой listener или PID никогда не считается управляемым Xray и не затрагивается. status,env,runиstopобеспечивают штатный путь управляемого Xray;runникогда не запускает его скрыто, аstopможет завершить управляемый процесс после переключения машинного типа наexternal. Успешныйstopпосылает сигнал супервизору, ограниченно ждёт завершения супервизора и Xray, очищает штатное состояние и возвращает исходный foreground-вызовstartв терминал.- Диагностика внешнего IP действительно делает запрос через настроенный локальный HTTP-прокси. Её сбой явно показан как предупреждение и не отменяет уже успешные проверки процесса и порта.
- Безопасная сводка показывает только полезные несекретные свойства
профиля; XHTTP
pathпоказывается только как скрытое значение с длиной, а UUID, ключи, short ID и другие секреты — без фрагментов исходного значения. Полная VLESS-ссылка и уникальные секреты отсутствуют в stdout, stderr и argv дочерних процессов при успехе, любом отказе разбора и сбоеrun -test. - Модульные и интеграционные тесты покрывают обе семьи ссылок, варианты ALPN, типичную ссылку Hiddify XHTTP/TLS, обе поддержанные версии Xray и понятные отказы на неподдерживаемом вводе.
- Чёрный ящик для каждой поддержанной версии доказывает полный порядок:
профиль по умолчанию и
-f,version, успешныйrun -testдо основного запуска, живое управляемое состояние и порт,status,env, дочернюю команду черезrun, проксированную IP-диагностику,stopи ограниченное завершение исходногоstart. Через один настроенный локальный порт реально завершаются отдельный HTTP-proxy-запрос и отдельный SOCKS-proxy-запрос. Подмена порта или состояния чужим процессом даёт безопасный отказ.