# 04 — Проверяемая пользовательская установка Xray

**What to build:** Пользователь без root устанавливает официальный Xray одной
явной командой и получает проверенный бинарник нужной версии без скрытой замены
существующей установки или записи за пределами пользовательских каталогов.

**Blocked by:** 01 — Внешний прокси и переносимый Bash-интерфейс.

**Status:** ready-for-agent

- [ ] `install` поддерживает Linux x86_64 и aarch64, по умолчанию выбирает
  зафиксированную версию 26.3.27 и принимает другую только через явный параметр
  версии, не объявляя произвольный релиз поддержанным.
- [ ] Архив и файл контрольной суммы скачиваются из официального релиза, после
  чего SHA-256 проверяется до распаковки и установки; несовпадение прекращает
  операцию без изменения установленного бинарника.
- [ ] Работа ведётся во временном пользовательском каталоге, извлечённый бинарник
  сначала проходит проверку `version`, а затем атомарно устанавливается в
  пользовательский каталог исполняемых файлов.
- [ ] Существующий бинарник другой версии не перезаписывается без `--replace`;
  ошибка, отказ или прерывание не оставляют частично установленный файл.
- [ ] После установки `command -v xray` обязан указывать на установленный файл;
  иначе команда завершается с понятной подсказкой исправить `PATH`.
- [ ] Установщик не использует sudo, systemd или системные каталоги, а команды
  `start` и запуск без подкоманды никогда не начинают скачивание.
- [ ] Автоматические тесты проверяют обе архитектуры, корректную и повреждённую
  контрольную сумму, существующую версию, `--replace`, атомарность и отсутствие
  записи вне изолированного пользовательского каталога.