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
This commit is contained in:
ddadmin committed 2026-07-20 00:00:59 +03:00
1 parent fdf744e578
commit e69a4bb7df
20 files changed
+3224 -170

No files matched your search

@@ -0,0 +1,37 @@
# 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 в РЕД ОС проверена до заявления поддержки, а недоступная среда
явно записана как неподтверждённая вместо неподкреплённого обещания.
- [ ] После приёмки статус исходной спецификации и документация соответствуют
фактически подтверждённому объёму, включая все оставшиеся ограничения.