Files
dotfiles/.scratch/headless-xray-proxy/issues/05-package-delivery-and-acceptance.md
T
ddadmin e69a4bb7df feat(xray-proxy): добавлен управляемый прокси для CLI
Зачем:
- отделить переносимый прокси-интерфейс от общих Bash-функций
- запускать агентские CLI через явный внешний или управляемый прокси

Что:
- добавлен stow-пакет xray-proxy с CLI, Bash-модулем и примерами
- реализованы строгий разбор VLESS и управляемый запуск Xray
- добавлены проверки процесса, порта, сигналов и отсутствия утечек
- сохранены спецификация и очередь следующих тикетов

Проверка:
- python3 tests/test_xray_proxy.py — 22/22
- python3 tests/test_xray_proxy_managed.py — 16/16
- bash tests/test_proxy_launchers.sh — 9/9
- bash tests/test_install.sh
- bash -n, Python 3.8 grammar, git diff --check
2026-07-20 00:00:59 +03:00

38 lines
3.6 KiB
Markdown

# 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 25.12.8 и отсутствие systemd, автозапуска и
автоматического перехода между типами прокси.
- [ ] Корневой обзор кратко описывает подсистему, показывает подключение пакета
и направляет к полной инструкции, не дублируя её.
- [ ] Полный автоматический прогон подтверждает Python 3.8-совместимый синтаксис,
внешний Hiddify-сценарий, обе семьи VLESS, обе версии Xray, установку,
жизненный цикл, Bash-интеграцию и отсутствие утечки секретов.
- [ ] На доступной Ubuntu с Python 3.10 проверены установка, `xray run -test` и
работа HTTP и SOCKS через один локальный вход для заявленных совместимых
сочетаний Xray 26.3.27 и 25.12.8.
- [ ] На целевой удалённой системе выполнен тот же пользовательский сценарий;
версия Python в РЕД ОС проверена до заявления поддержки, а недоступная среда
явно записана как неподтверждённая вместо неподкреплённого обещания.
- [ ] После приёмки статус исходной спецификации и документация соответствуют
фактически подтверждённому объёму, включая все оставшиеся ограничения.