Files
dotfiles/.scratch/headless-xray-proxy/issues/05-package-delivery-and-acceptance.md
T
ddadminandClaude Fable 5 98bfd6338a refactor(xray-proxy): срезана accidental-сложность CLI, тестов и спеки
- Зачем:
  - 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>
2026-07-20 04:13:54 -04:00

3.5 KiB

05 — Доставка пакета и итоговая приёмка

What to build: Завершённая прокси-подсистема устанавливается отдельно или вместе с dotfiles, снабжена безопасными шаблонами и понятной инструкцией, а её заявленные сценарии подтверждены автоматическими и доступными системными проверками.

Blocked by: 03 — Безопасный жизненный цикл управляемого процесса; 04 — Проверяемая пользовательская установка Xray.

Status: ready-for-agent

  • Самостоятельный stow-совместимый пакет доставляет CLI, Bash-модуль и вымышленные шаблоны машинного INI и VLESS-профиля; реальные пользовательские настройки, UUID, ссылки и ключи не входят в репозиторий.
  • Пакет можно подключить отдельно через stow, эквивалентные ручные симлинки или копирование; общий установщик использует тот же пакет без отдельной реализации и сохраняет повторяемость установки.
  • Основная инструкция объясняет внешний Hiddify и управляемый Xray, подготовку двух файлов настройки, все команды управления, proxy_on/off, pclaude/pcodex, NO_PROXY, ограничения CIDR и диагностику.
  • Инструкция фиксирует две поддержанные семьи VLESS, Xray 26.3.27, современную проверку сертификата и отсутствие systemd, автозапуска и автоматического перехода между типами прокси.
  • Корневой обзор кратко описывает подсистему, показывает подключение пакета и направляет к полной инструкции, не дублируя её.
  • Полный автоматический прогон подтверждает Python 3.8-совместимый синтаксис, внешний Hiddify-сценарий, обе семьи VLESS, Xray 26.3.27, установку, жизненный цикл, Bash-интеграцию и отсутствие утечки секретов.
  • На доступной Ubuntu с Python 3.10 проверены установка, xray run -test и работа HTTP и SOCKS через один локальный вход для Xray 26.3.27.
  • На целевой удалённой системе выполнен тот же пользовательский сценарий; версия Python в РЕД ОС проверена до заявления поддержки, а недоступная среда явно записана как неподтверждённая вместо неподкреплённого обещания.
  • После приёмки статус исходной спецификации и документация соответствуют фактически подтверждённому объёму, включая все оставшиеся ограничения.