Релиз v1.2.8: подпись

.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

.gitea/workflows/fork-sync.yml

@@ -0,0 +1,32 @@
+name: Синхронизация с автором
+
+# Раз в сутки проверяем обновления у автора проекта и, если они есть, переносим наши правки
+# на свежий код и публикуем в ветку dev. Релиз и подпись здесь НЕ делаются: закрытый ключ
+# подписи лежит только на рабочей станции владельца.
+#
+# Ручной запуск: в Gitea → Actions → «Синхронизация с автором» → Run workflow.
+
+on:
+  schedule:
+    - cron: "30 3 * * *"    # каждую ночь в 03:30 по времени сервера Gitea
+  workflow_dispatch: {}
+  push:
+    paths:
+      - ".gitea/workflows/fork-sync.yml"
+
+concurrency:
+  group: fork-sync
+  cancel-in-progress: false
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Подтянуть обновления автора, проверить и опубликовать
+        env:
+          GITEA_URL: http://10.10.10.54:3000
+          TOKEN: ${{ secrets.GITEA_TOKEN }}
+        run: |
+          set -euo pipefail
+          curl -fsSL "$GITEA_URL/hacker07/3X-UI_autoVPS/raw/branch/main/tools/fork-sync-bot.sh" -o /tmp/fork-sync-bot.sh
+          bash /tmp/fork-sync-bot.sh

FORK-CHANGELOG.md

@@ -0,0 +1,135 @@
+# Что нового в сборке форка
+
+Здесь записи о наших версиях. Файл автора (`CHANGELOG.md`) мы не трогаем — так обновления
+автора не конфликтуют с нашими записями.
+
+## v1.2.6: вопросы при установке
+
+* **README.md переписан целиком:** убрано авторское описание с его командой установки, добавлены
+  актуальная команда, флаги, таблица протоколов, список сайтов-заглушек, команды `kit` и `kit local`,
+  канал обновлений и оговорки. Две картинки — наши (`manuals/assets/fork-banner.svg` и
+  `manuals/assets/script-3x-ui-local.svg`, терминал собран из настоящего вывода скрипта).
+* Шов в README больше не нужен (`tools/fork_apply.py`): файл наш целиком, как `kit-local.sh`.
+## v1.2.8: доступ к панели в конце установки и снос сервера из меню
+
+* В конце установки (перед подпиской) печатается **доступ к панели 3X-UI**: адрес, логин и пароль из
+  файла `/root/3x-ui.txt` — раньше это было видно только в общем потоке вывода установщика.
+* **`kit local uninstall`** — снос установки целиком: панель и служба `x-ui`, ядро Xray, службы и файлы
+  kit (`kit-sub`, автообновление, cron), конфиги nginx и сайт-заглушка, сертификаты (acme.sh),
+  наши правки системы (правило ICMP, обновления безопасности), наши бэкапы и файл с данными панели.
+  Правила ufw для 80/443 снимаются, ответ на ping возвращается. Спрашивает подтверждение словом
+  «удалить», есть `--dry-run`.
+  **SSH не трогается** — ни порт, ни конфиги, ни правила для него: иначе легко потерять доступ к серверу.
+  В главном меню `kit` появился пункт **10. Удалить всё установленное**.
+
+## v1.2.7: имя 3X-UI_autoVPS, справка kit help, подписка с QR, живые кнопки на заглушках
+
+* **Сборка называется `3X-UI_autoVPS`** (было `3X-UI KIT`): баннер сервера — `Hacker 07` в том же
+  стиле, новое имя в справке, версии, описаниях служб и в имени профиля в клиенте. В файлах автора
+  это сделано швами (`tools/fork_apply.py`), поэтому обновление автора правки не затирает.
+* **Совместимость шапки релиза.** В подписанном `SHA256SUMS` этого релиза шапка пишется **двумя
+  строками** (старая и новая), а проверка на сервере принимает обе. Иначе уже установленные серверы
+  отказались бы ставить обновление: они сверяют точный вид строки. Со следующего релиза останется
+  только новое имя.
+* Убрано дублирование подсказки «Дальше обязательно» при смене порта SSH: она печаталась и
+  установщиком, и командой `kit local ssh`.
+* **`kit help` — полный справочник по категориям**: пользователи, подключения и порты, маскировка и
+  сайт, проверка и починка, обслуживание и обновление, защита сервера (наш слой). Раньше `kit help`
+  показывал короткий список автора и не упоминал наши команды. Чтобы справка не отставала молча,
+  добавлена проверка `tools/check-help.sh`: она сверяет справку с диспетчером команд и встроена в
+  сборку релиза (`tools/release.sh`).
+* У сайтов-заглушек все ссылки и кнопки **живые**: нажатие открывает окно «раздел в разработке,
+  приносим извинения» (закрыть — кнопкой, кликом мимо окна или Esc). Никаких внешних запросов:
+  скрипт и стили внутри страницы.
+* В самом конце установки (после всех проверок) печатается то, что нужно сохранить: **подписка
+  с QR-кодом** и ссылки по протоколам — авторской командой `kit user link <имя> --all`, поэтому
+  вывод совпадает с тем, что показывает `kit` потом. Отключается флагом `--no-sub`.
+
+* Набор по умолчанию — **REALITY + AmneziaWG-3.1** (самый совместимый минимум); ответ «все»
+  ставит полный набор автора. Умолчание задаётся в одном месте (`DEFAULT_PROTOS`).
+* **Сайт-заглушка переделан на ИТ-тематику:** десять правдоподобных сайтов (дата-аналитика, DevOps,
+  мониторинг, разработка, аудит, ИТ-поддержка, колокейшн, заметки про Linux, бэкапы, документация)
+  вместо авторских «кофеен и пекарен». Ставится случайный, конкретный — `kit local site 7`,
+  список — `kit local site --list`. Команда обновляет и файл для nginx, и копию страницы внутри
+  подключения Hysteria2 (`kit net masq on`): если менять файл вручную, 443/tcp и UDP-порт начнут
+  отвечать разными страницами — это заметно снаружи.
+* Обёртка спрашивает, **какие протоколы ставить** (нумерованный список, `1,3,11` или «все»,
+  Enter — набор автора): невыбранные протоколы не создаются вообще — ни подключения в панели,
+  ни записей в nginx, ни ссылок в подписке. Список и умолчание взяты из самого установщика
+  (`ALL_PROTOS`/`DEFAULT_PROTOS`), передаётся его же флагом `--protocols`, так что поведение
+  не расходится с авторским. Свой `--protocols` можно задать флагом — тогда вопроса не будет.
+* Обёртка `scripts/3x-ui-local.sh` теперь спрашивает, а не решает за вас: закрывать ли ответ на ping,
+  включать ли автообновления безопасности, **менять ли порт SSH** (Enter — оставить текущий,
+  число — перевести на него; мусор и занятый порт переспрашивает), менять ли пароль root.
+  Маскировку и домен, как и раньше, спрашивает установщик автора.
+* Смена порта SSH никогда не закрывает прежний порт сама: сначала добавляется новый, затем скрипт
+  печатает две команды — проверить вход во втором окне и закрыть прежние (`kit local ssh --close-old`).
+* Запуск без флагов = «одна команда, дальше вопросы». Флаг `--yes` — наоборот, ничего не спрашивать
+  (для автоматизации): ping закрывается, автообновления включаются, порт SSH и пароль не трогаются.
+* Флаг `--harden` теперь действительно существует (раньше он уходил установщику автора неизвестным
+  параметром и ронял установку): закрыть ping и включить автообновления без вопросов.
+* `--dry-run` показывает, что именно будет спрошено или сделано по умолчанию.
+
+## v1.2.5: суммы релиза в формате, который понимает kit
+
+* Исправлена ошибка нашего релизного конвейера: на Windows `sha256sum` пишет суммы как
+  `hash *файл`, а `kit` на сервере сверяет имя строго (`$2 == "файл"`) — то есть `kit update`
+  отклонил бы релизы v1.2.1–v1.2.4 как «в подписанном списке нет такого файла». Теперь
+  `tools/release.sh` приводит список к POSIX-виду (`hash  файл`) **до** подписи.
+* `scripts/3x-ui-local.sh` принимает оба формата, чтобы не спотыкаться о суммы, собранные на
+  другой машине.
+* Проверка теперь повторяет логику самого `kit`: подпись `SHA256SUMS` + строгая сверка имени
+  каждого файла из подписанного списка (а не только `sha256sum -c`, который звёздочку прощает).
+
+## v1.2.4: проверка релиза отдельной командой
+
+* Флаг `--verify-only`: скачать релиз, проверить подпись `SHA256SUMS` и SHA256 установщика и выйти —
+  можно проверить канал на сервере, ничего не устанавливая.
+* Порядок шагов изменён: проверка подписи теперь идёт до предполётных проверок и до любых
+  изменений на сервере, чтобы чужой код не запускался раньше проверки.
+
+## v1.2.3: установка одной командой (`scripts/3x-ui-local.sh`)
+
+* Один скрипт на чистом VPS: проверка сервера → скачивание нашего релиза → проверка подписи
+  `SHA256SUMS` и SHA256 самого установщика → установщик автора (панель 3X-UI, протоколы,
+  сайт-заглушка, маскировка, сертификат, подписка, ufw) → наши дополнения → проверка.
+* По умолчанию досыпает: закрыть ответ на ping (правилом ufw), включить обновления безопасности,
+  `kit fix` (время и безопасные починки), в конце `kit check` и сводку `kit local hardening`.
+  Отключается флагами `--no-harden`, `--no-time`, `--no-check`.
+* Второй порт SSH — только по явному флагу `--ssh-port N`: прежний порт продолжает работать,
+  закрытие — отдельным шагом `kit local ssh --close-old N`. Автоматически доступ не запираем.
+* Все флаги установщика автора (`--domain`, `--sni`, `--panel-on`, `--host`, `--restore` …)
+  передаются как есть; есть `--dry-run` (план без изменений) и `--help`.
+* Публичный ключ форка вшит в обёртку — подпись проверяется до запуска чужого кода; при смене
+  ключа обновляется и здесь, и в `kit`.
+
+## v1.2.2: команды защиты сервера (поведение из StressOzz/vps-setup)
+
+* Новые команды `kit local`: `ssh <порт>` (добавить порт SSH), `ssh --close-old` (закрыть прежние
+  порты), `ping off|on` (не отвечать на ICMP echo), `passwd [--generate]` (сменить пароль),
+  `upgrades on|off|status` (автообновления безопасности), `hardening` (сводка по защите сервера).
+* Сделано безопаснее, чем в источнике: конфиг sshd проверяется через `sshd -t` **до** перезапуска,
+  новый порт сначала открывается в ufw, прежний порт продолжает работать до отдельного шага
+  `--close-old`, у правок есть `--dry-run`, а копии изменённых файлов остаются в
+  `/root/kit-local-backup-<дата>/` (не в `/tmp`).
+* `apt full-upgrade` из источника не выполняется: вместо него включаются обновления безопасности
+  (только security, без самовольной перезагрузки) — это не затрагивает закреплённые версии панели
+  и ядра, которые ставятся не из apt.
+* Учтён Ubuntu 24.04: если SSH слушает systemd (`ssh.socket`), порт добавляется socket-drop-in'ом,
+  а закрытие старых портов не делается автоматически — там ошибка запирает доступ к серверу.
+* Ping отключается правилом ufw (`before.rules`), а не общесистемным `icmp_echo_ignore_all`:
+  видно в `ufw status`, отменяется одной командой и не глушит ICMP для внутренних интерфейсов.
+
+## v1.2.1: сборка форка поверх 3X-UI_autoVPS 1.2
+
+* Источник файлов и обновлений — свой репозиторий Gitea: установка и `kit update` берут релиз
+  оттуда, а подпись релиза проверяется ключом форка. Авторский ночной апдейт приходит в наш
+  канал, поэтому наши доработки не стираются ночью.
+* Дополнения форка живут отдельным файлом `/usr/local/lib/kit/kit-local.sh` и подключаются одной
+  строкой: `kit local help | version | channel | seams | masking`.
+* Наш файл едет в том же подписанном релизе, что и код автора: он входит в `SHA256SUMS`,
+  проверяется по подписи и обновляется вместе с `kit`.
+* Швы в коде автора описаны в `tools/fork_apply.py` (источник правды), синхронизация с автором и
+  проверки — `tools/fork-sync.sh`.
+
+Основа — 3X-UI_autoVPS 1.2 (панель 3X-UI v3.9.0, ядро Xray v26.6.27). Что нового у автора — в `CHANGELOG.md`.

FORK.md

@@ -0,0 +1,214 @@
+# Форк 3X-UI_autoVPS (hacker07) — своя сборка и свой канал обновлений
+
+Коротко: это [3X-UI_autoVPS](https://github.com/itsnotkubrick/3X-UI_KIT) со своими доработками. Наш код
+живёт рядом с кодом автора и не ломается, когда автор выпускает новую версию, а серверы ставятся и
+обновляются **из этого репозитория** — релизы подписываются нашим ключом.
+
+## С чего начать: новый VPS
+
+1. Если нужен свой домен для маскировки — заранее направьте его A-запись на IP сервера и освободите
+   порт 80 (иначе Let's Encrypt не выпустит сертификат). Без домена этот шаг пропускается.
+2. Одна команда на сервере (от root) — **дальше скрипт спросит сам**: какие протоколы ставить
+   (Enter — REALITY + AmneziaWG-3.1, «все» — набор автора), какую маскировку и домен,
+   закрывать ли ответ на ping, включать ли автообновления, менять ли порт SSH (Enter — оставить
+   текущий, число — перевести на него), менять ли пароль root:
+
+```bash
+bash <(curl -fsSL https://git.rukavishnikoff.ru/hacker07/3X-UI_autoVPS/raw/branch/main/scripts/3x-ui-local.sh)
+```
+
+   Те же ответы можно задать флагами — тогда вопросов не будет:
+
+```bash
+bash <(curl -fsSL …/scripts/3x-ui-local.sh) --protocols reality,hy2,awg,mtproto --domain vpn.example.com
+```
+
+3. Скрипт делает всё сам: проверяет сервер → скачивает наш релиз и **проверяет подпись `SHA256SUMS`
+   и SHA256 установщика** → запускает установщик автора (панель 3X-UI, **только выбранные протоколы**,
+   сайт-заглушка, маскировка, сертификат, подписка, ufw) → наши вопросы и правки (ping,
+   автообновления, второй порт SSH, пароль root) → `kit fix` → в конце показывает `kit check` и сводку
+   `kit local hardening`.
+4. Забрать ссылки и подписку: `kit user link admin` (или адрес подписки из вывода установки).
+
+Сомневаетесь в канале — сначала ничего не меняющие режимы:
+
+```bash
+bash <(curl -fsSL …/scripts/3x-ui-local.sh) --verify-only     # только проверка подписи релиза
+bash <(curl -fsSL …/scripts/3x-ui-local.sh) --dry-run --domain vpn.example.com   # план установки
+```
+
+### Флаги установки
+
+| Флаг | Что делает |
+|---|---|
+| `--protocols список` | какие протоколы ставить: `all`, `minimal` или через запятую — `reality,reality2,hy2,xhttp,ws,trojan,vmess,ss,tuic,wg,awg,awg3,mtproto`. Невыбранные не создаются вообще. Без флага — вопрос, по умолчанию предлагаются **REALITY + AmneziaWG-3.1** (ответ «все» — набор автора) |
+| `--site N\|random\|off` | сайт-заглушка: конкретный из нашего набора (10 ИТ-сайтов), случайный (по умолчанию) или не трогать авторскую страницу (то же — `--no-site`) |
+| `--yes` | не задавать вопросы (ping закрывается, автообновления включаются, порт SSH и пароль не трогаются) |
+| `--harden` | закрыть ответ на ping и включить автообновления без вопросов |
+| `--domain домен` | свой домен для маскировки: сайт и REALITY маскируются под него (A-запись на сервер, свободный 80) |
+| `--sni сайт.com` | маскировка под чужой сайт вместо домена |
+| `--panel-on domain\|ip` | где открывать панель и подписку |
+| `--ssh-port N` | перевести SSH на порт N (число 1024–65535). Прежний порт сам не закрывается: сначала проверьте вход во втором окне, потом `kit local ssh --close-old N` |
+| `--no-harden` | не закрывать ответ на ping и не включать автообновления безопасности |
+| `--no-time` / `--no-check` | не запускать `kit fix` / `kit check` |
+| `--verify-only` / `--dry-run` | проверить релиз / показать план и ничего не менять |
+| остальные | передаются установщику автора как есть: `--host`, `--user`, `--port`, `--protocols`, `--restore`, `--multi-port`, `--cert`/`--key`, `--panel-ssl` |
+
+Чего скрипт **не** делает (сознательно): `apt full-upgrade` (тянет систему вперёд и может сломать
+закреплённые панель 3X-UI 3.9.0 и ядро Xray 26.6.27 — вместо него обновления безопасности),
+автоматическую перезагрузку и смену пароля root (в однострочник пароль не подставляем, он попал бы
+в список процессов — для этого есть `kit local passwd`).
+
+### Как проверить, что установка удалась
+
+```bash
+kit check                    # без ❌: службы, порт 443 (nginx), подписка, маскировка, сертификат
+kit local hardening          # сводка: порты SSH, ответ на ping: deny, ufw активен, автообновления: включены
+kit local channel            # источник — этот репозиторий, ключей в KIT_SIGNERS: 1 (наш)
+kit local version            # версия сборки: 1.2.5 или новее
+ping <IP сервера>            # с домашней машины — таймаут: ответ на ping закрыт, это ожидаемо
+kit user link admin          # ссылка подписки; откройте её в браузере
+```
+
+Если ставили с доменом, в `kit check` должны быть строки «свой домен … указывает на этот сервер» и
+«сайт маскировки … отвечает по TLS 1.3 и HTTP/2»; предупреждения про известный сайт на чужом IP
+быть не должно (это касалось бы вспомогательного XHTTP, у REALITY должен быть ваш домен).
+
+## Команды форка (`kit local`)
+
+```bash
+kit local help                    # справка по всем командам форка
+kit local version                 # версия, источник обновлений, дата сборки нашего файла
+kit local channel                 # откуда берутся обновления и чем проверяется подпись
+kit local seams                   # какие швы форка сейчас в установленном /usr/local/bin/kit
+kit local masking                 # состояние маскировки (у REALITY должен быть свой домен)
+kit local hardening               # сводка по защите сервера
+```
+
+Защита сервера (поведение взято из проекта `StressOzz/vps-setup`, реализация своя и безопаснее):
+
+| Команда | Что делает |
+|---|---|
+| `kit local site` | поставить случайный сайт-заглушку из нашего набора (10 ИТ-сайтов) и синхронизировать ответ Hysteria2 |
+| `kit local site --list` / `kit local site 7` / `--show` | список сайтов с номерами / поставить конкретный / какой стоит сейчас |
+| `kit local ssh 2222` | добавить порт SSH (прежние продолжают работать; порт сначала открывается в ufw, конфиг проверяется через `sshd -t`) |
+| `kit local ssh --status` | какие порты SSH слушаются сейчас |
+| `kit local ssh --close-old 2222` | закрыть прежние порты после того, как новый проверен из второго окна |
+| `kit local ping off\|on\|status` | ответ на ICMP echo: закрыть/вернуть/показать (правилом ufw, видно в `ufw status`) |
+| `kit local passwd [юзер]` | сменить пароль (спросит дважды, в историю команд не попадёт) |
+| `kit local passwd --generate` | сгенерировать пароль и показать один раз |
+| `kit local upgrades on\|off\|status` | автообновления безопасности (только security, без перезагрузки) |
+
+К любой правке можно добавить `--dry-run` — покажет план и ничего не изменит. Копии изменённых
+файлов складываются в `/root/kit-local-backup-<дата>/` (не в `/tmp`).
+
+Что `ping off` затрагивает: только ICMP echo. Подписка (HTTPS), панель, REALITY/XHTTP (TCP 443),
+Hysteria2 (UDP 443) работают как работали; исходящий ping с самого сервера тоже остаётся. Если
+сервер есть в вашем мониторинге — пробу до него делайте по HTTPS/TCP, а не по ICMP.
+
+## Что где лежит
+
+| Что | Где | Правит |
+|---|---|---|
+| Наши доработки (команды, хуки) | `scripts/kit-local.sh` | только мы |
+| Установка одной командой (обёртка) | `scripts/3x-ui-local.sh` | только мы |
+| Описание «швов» в коде автора | `tools/fork_apply.py` | только мы |
+| Синхронизация с автором и проверки | `tools/fork-sync.sh` | только мы |
+| Записи о наших версиях | `FORK-CHANGELOG.md` | только мы |
+| `README.md` | целиком, включая картинки в `manuals/assets/` | только мы |
+| Файлы автора (`scripts/kit.sh`, `scripts/3x-ui.sh`, …) | как есть | только автор |
+
+Ключевая идея: в файлах автора мы правим только «швы» — несколько констант, одну строку подключения
+и нормализацию сумм в релизном скрипте. Всё, что мы дописываем по существу, лежит в наших файлах.
+Швы описаны в одном месте (`tools/fork_apply.py`) и накатываются только на чистое дерево автора;
+если автор изменил нужную строку — инструмент останавливается и говорит об этом, а не делает
+полу-патч.
+
+## Ветки и релизы
+
+- `upstream` — точная копия ветки автора (`main`), только вперёд.
+- `dev` — наша сборка: `upstream` + швы + наши файлы; из неё делаются релизы.
+- `main` — то же состояние плюс документация после релиза (по нему считается «последняя версия»).
+- релизы — теги `v<номера>`; номер = `<версия автора>.<наш уровень>` (автор 1.2 → наш 1.2.1; после
+  релиза автора 1.3 → 1.3.1). Номер обязан строго расти: `kit update` не принимает откат назад.
+
+## Обновление сервера и канал
+
+```bash
+kit update --force && kit check      # тянет наш релиз из этого репозитория, проверяет нашу подпись
+```
+
+Источник файлов — `KIT_RAW` / `kit_ref_raw()` в `scripts/kit.sh` (наш Gitea и наш тег), подпись
+проверяется ключом из `KIT_SIGNERS` (там только ключ форка). Ночной `kit-update.timer` (03:00) делает
+то же автоматически — поэтому сервер и должен смотреть в этот репозиторий: иначе наши доработки
+исчезнут в первую же ночь.
+
+Вернуться на канал автора: скачать `scripts/kit.sh` из релиза автора с GitHub в `/usr/local/bin/kit`,
+затем `kit update --force`.
+
+## Обновление от автора (с рабочей станции)
+
+### Автоматически: робот на раннере (CT 114)
+
+Раз в сутки (03:30) Gitea сама запускает `.gitea/workflows/fork-sync.yml` на раннере в CT 114:
+робот `tools/fork-sync-bot.sh` забирает ветку автора, переносит на неё наши правки, прогоняет те же
+проверки, что и `tools/fork-sync.sh`, дописывает раздел в `FORK-CHANGELOG.md` и публикует `dev`
+(`--force-with-lease`). Не сошлось (конфликт в местах наших правок) — **ничего не публикуется**,
+причина видна в Gitea → Actions и в `/opt/kit-fork-sync/last-run.log` на контейнере.
+
+Робот **не** выпускает и не подписывает релиз: закрытый ключ подписи остаётся на рабочей станции.
+После автоматической синхронизации — как обычно: `git fetch origin && git checkout dev && git reset --hard origin/dev`
+(робот переписывает `dev`), описать изменения в `FORK-CHANGELOG.md`, затем `tools/release.sh` и тег.
+
+```bash
+cd H:/My_Proj/Fork_3X-UI_KIT
+bash tools/fork-sync.sh            # подтянуть автора, перенести наши правки, прогнать проверки
+# при конфликте — разобрать вручную: инструмент сам ничего не публикует
+
+bash tools/release.sh ~/.ssh/3x-ui-kit-fork/release_key   # SHA256SUMS + подпись нашим ключом
+git add -A && git commit -m "Релиз v$(cat VERSION): …" && git tag v$(cat VERSION)
+git push origin dev v$(cat VERSION) upstream
+```
+
+## Подпись релизов
+
+- Открытая часть ключа — `tools/fork-signer.pub` и в `KIT_SIGNERS` (в `scripts/kit.sh`); она же
+  вшита в `scripts/3x-ui-local.sh`, чтобы проверять подпись до запуска установщика.
+- Закрытая часть — только на рабочей станции владельца (`~/.ssh/3x-ui-kit-fork/release_key`).
+  В репозиторий, CI и на серверы не попадает: кто получит ключ — получит root на всех серверах,
+  которые обновляются из этого репозитория. Пароль на ключ пока не установлен
+  (`ssh-keygen -p -f ~/.ssh/3x-ui-kit-fork/release_key`).
+- Смена ключа: новый релиз подписывается **старым** ключом, иначе серверы его не примут.
+
+## Грабли, о которых стоит помнить
+
+1. **Ночное автообновление** (`kit-update.timer`, 03:00) перезаписывает `/usr/local/bin/kit` тем, что
+   лежит в настроенном репозитории. Канал и наши правки — один шаг, а не два.
+2. **Переводы строк.** Релиз подписывается по суммам рабочей копии, а сервер сверяет их с файлами из
+   Gitea: при `core.autocrlf=true` суммы не сойдутся (CRLF против LF). В клоне должно быть
+   `git config core.autocrlf false` (и `.gitattributes`), проверка есть в `tools/fork-sync.sh`.
+3. **Наш файл обязан быть в двух списках** — `FILES=(…)` в `tools/release.sh` и список загрузки
+   `fetch_release()` в `scripts/kit.sh`, иначе после обновления `kit-local.sh` останется старым.
+4. **Панель 3X-UI ставится с GitHub** по закреплённой версии и SHA256 — это шаг автора; для установки
+   с нуля серверу нужен доступ к GitHub.
+5. **Формат контрольных сумм.** `kit` сверяет имя файла в `SHA256SUMS` строго (`$2 == "путь"`).
+   На Windows `sha256sum` пишет `hash *путь`, и такие релизы `kit update` отклоняет («в подписанном
+   списке нет такого файла»), хотя `sha256sum -c` их принимает. Поэтому `tools/release.sh` приводит
+   список к POSIX-виду **до** подписи, а релизы **v1.2.1–v1.2.4 ставить нельзя** — только v1.2.5+.
+   Проверять релиз надо логикой самого `kit`, а не одной `sha256sum -c`.
+6. **Сборка релиза обращается к GitHub** (сверка закреплённых версий панели и ядра). Из домашней сети
+   TLS до GitHub иногда рвётся (`schannel: failed to receive handshake`) — просто повторить запуск.
+7. **`README.md` — наш файл целиком.** Авторское описание убрано: иначе человек, открывший
+   репозиторий, читает команду установки **авторской** сборки, ставит по ней и оказывается на
+   авторском канале обновлений — ночное автообновление вернёт его сборку. При обновлении из
+   авторского проекта README конфликтует: берём нашу версию (`git checkout --ours README.md`),
+   авторские правки в нём нас не интересуют.
+
+## Что проверено на сегодня
+
+- Релиз `v1.2.5`: подпись сходится с ключом из опубликованного `kit.sh`, строгая сверка сумм
+  `$2 == путь` для `kit.sh`, `kit-sub.py`, `kit-local.sh` — как это делает `kit` на сервере.
+- Публичный однострочник в режиме `--verify-only` отвечает «подпись сошлась, SHA256 установщика
+  совпал» — проверено снаружи, из домашней сети.
+- Установка «в бою» на живом сервере пока не прогонялась: сначала её стоит выполнить на новом VPS,
+  посмотрев `--verify-only` и `--dry-run`.

README.md

@@ -1,311 +1,196 @@
 <div align="center">
 
-<img alt="3X-UI KIT" src="manuals/assets/banner.svg" width="820">
+<img alt="3X-UI autoVPS" src="manuals/assets/fork-banner.svg" width="860">
 
-**Установка 3X-UI одной командой: 11 протоколов, один порт 443, одна подписка на всё**
+**Сервер одной командой: панель 3X-UI, VPN-протоколы за одним портом 443, одна подписка на все устройства**
 
-[![Версия](https://img.shields.io/github/v/release/itsnotkubrick/3X-UI_KIT?label=3X-UI%20KIT&color=93E06F&labelColor=221B17)](https://github.com/itsnotkubrick/3X-UI_KIT/releases/latest)
-[![Протоколов](https://img.shields.io/badge/протоколов-11-93E06F?labelColor=221B17)](manuals/3x-ui.md#протоколы)
-[![3X-UI](https://img.shields.io/badge/3X--UI-v3.9.0-93E06F?labelColor=221B17)](https://github.com/MHSanaei/3x-ui)
-[![Звёзды](https://img.shields.io/github/stars/itsnotkubrick/3X-UI_KIT?label=звёзды&style=flat&color=93E06F&labelColor=221B17)](https://github.com/itsnotkubrick/3X-UI_KIT/stargazers)
-[![Обновлено](https://img.shields.io/github/last-commit/itsnotkubrick/3X-UI_KIT?label=обновлено&color=93E06F&labelColor=221B17)](https://github.com/itsnotkubrick/3X-UI_KIT/commits)
+Сборка со **своим каналом обновлений**: сервер ставится и обновляется из этого репозитория, релизы
+подписаны, ночное автообновление не вернёт чужую версию. В основе — открытый проект 3X-UI_autoVPS.
 
 </div>
 
----
+## Что ставится
 
-> [!WARNING]
-> **Проект – набор скриптов с открытым кодом.** Он не оказывает услуг связи и не предоставляет доступ
-> к серверам. Вы ставите его на собственный сервер и сами отвечаете за соблюдение законодательства
-> своей страны. Проект создан в образовательных целях.
-
-> [!TIP]
-> **Вышла версия 1.2:** панель 3X-UI v3.9.0, меню `kit`, раздельная маршрутизация и `--restore`.
-> [Что нового](https://github.com/itsnotkubrick/3X-UI_KIT/releases/tag/v1.2) ·
-> сервер на 1.1.x обновится сам этой ночью, а на 1.0 одной командой:
-> ```bash
-> curl -fsSL https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/v1.2/scripts/kit.sh -o /usr/local/bin/kit && chmod 755 /usr/local/bin/kit && kit update
-> ```
-
-**3X-UI KIT** превращает чистый VPS в готовый VPN-сервер за несколько минут. Скрипт ставит
-официальную панель [3X-UI](https://github.com/MHSanaei/3x-ui), настраивает все популярные
-протоколы, сертификат и файрвол и выдаёт одну ссылку-подписку. Её можно вставить в любое
-приложение – оно само получит подходящие ему протоколы. Домен не нужен.
-
-<div align="center">
-<img alt="Конец установки 3X-UI KIT" src="manuals/assets/script-3x-ui.svg" width="760">
-</div>
-
-## Возможности
-
-- 🧩 **11 протоколов на одном порту 443.** Панель, подписка и все TCP-протоколы спрятаны за одним портом,
-  а на случайный заход сервер показывает обычный сайт. Протоколы: VLESS REALITY, VLESS XHTTP + REALITY,
-  VLESS WebSocket + TLS, Trojan gRPC + TLS, VMess WebSocket + TLS, Shadowsocks 2022, Hysteria2, TUIC v5,
-  AmneziaWG, AmneziaWG 3.1, MTProto (прокси для Telegram).
-- 🔗 **Одна подписка на все приложения.** Hiddify, Happ, v2rayN, Karing, Clash Verge и FlClash
-  получают свой формат и только те протоколы, которые распознают.
-- 🧭 **Раздельная маршрутизация.** Через VPN идут только зарубежные сервисы, остальное – напрямую.
-  Правила приезжают вместе с подпиской, DNS не течёт.
-- 🥷 **Маскировка.** Со своим доменом на сервере стоит ваш сайт, без него сайт подбирается среди соседей
-  по подсети. REALITY работает с `xtls-rprx-vision`.
-- 👥 **Пользователи во все протоколы сразу.** Один пользователь – одна подписка, общий лимит трафика,
-  срок и число устройств. Меню `kit` работает как у x-ui: выбрали цифру – готово.
-- 💾 **Резервная копия и переезд на новый сервер одной командой.** Копия сохраняет подключения, ключи
-  и пользователей, а на чистом VPS (даже с другим IP) сервер поднимается из неё за несколько минут.
-- 🔄 **Обновляется само, но только подписанными релизами.**
-- 🩺 **Проверка и починка сервера** одной командой.
-
-## Что понадобится
-
-- VPS с **Ubuntu 22.04/24.04** или **Debian 12/13** и доступом root по SSH
-- Свободные порты **443** и **80** – на свежем сервере они свободны
-
-Нужен VPS? Я сам использую **[IS Hosting](https://ishosting.io/affiliate/NTg4MiM4)** и рекомендую его
-(реферальная ссылка).
+| Что | Зачем |
+|---|---|
+| Панель **3X-UI** + ядро **Xray** | управление подключениями и пользователями |
+| **nginx** на порту 443 | разводит подключения по именам и путям, отдаёт сайт-заглушку |
+| VPN-подключения | REALITY, Hysteria2, AmneziaWG, XHTTP, VLESS-WS, Trojan-gRPC, VMess-WS, Shadowsocks, TUIC, MTProto, WireGuard — какие выберете |
+| **Подписка** (`kit-sub`) | одна ссылка на все устройства: Happ, Hiddify, v2rayN, Clash/Mihomo |
+| **Сайт-заглушка** | на 443 и в ответе Hysteria2 — правдоподобный ИТ-сайт из нашего набора |
+| **ufw**, обновления безопасности, синхронизация времени | защита сервера и корректная работа REALITY |
 
 ## Установка
 
-Подключитесь к серверу по SSH и выполните одну команду на чистом VPS.
-
-Панель 3X-UI, все протоколы на порту 443 и одна подписка на всё:
+От root, на чистом сервере (Debian 11+ / Ubuntu 22.04+, 64-бит):
 
 ```bash
-bash <(curl -fsSL https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/main/scripts/3x-ui.sh)
+bash <(curl -fsSL https://git.rukavishnikoff.ru/hacker07/3X-UI_autoVPS/raw/branch/main/scripts/3x-ui-local.sh)
 ```
 
-Через пару минут скрипт покажет адрес панели, логин, пароль и подписку с QR-кодом.
-Подробно – подключение приложений, дополнительные пользователи и параметры – в **[инструкции](manuals/3x-ui.md)**.
+Без флагов скрипт **спрашивает** всё по ходу: какие протоколы ставить (Enter — REALITY + AmneziaWG-3.1),
+какую маскировку и домен, закрывать ли ответ на ping, включать ли автообновления безопасности,
+менять ли порт SSH (Enter — оставить 22), менять ли пароль root.
 
-## Команды KIT
+<img alt="Установка одной командой" src="manuals/assets/script-3x-ui-local.svg" width="860">
 
-После установки на сервере появляется команда `kit`. Запустите её **без аргументов** – откроется меню, как у `x-ui`: выберите цифру, остальное спросит само. Те же действия одной строкой – в группах ниже (нажмите, чтобы раскрыть). Подробности – в [инструкции](manuals/3x-ui.md).
-
-<details>
-<summary><b>Пользователи</b> – <code>kit user</code></summary>
+Если вопросы не нужны — те же ответы задаются флагами:
 
 ```bash
-kit user add имя [--gb 50] [--days 30] [--devices 3]   # добавить во все протоколы, показать подписку
-kit user list                                          # кто сколько израсходовал, до какого числа
-kit user link имя [--all | --amnezia | --telegram]     # подписка и ссылки «открыть в приложении»
-kit user limit имя [--gb N] [--days N] [--devices N]   # изменить лимиты (0 – без ограничений)
-kit user off имя  /  kit user on имя                   # выключить и включить
-kit user del имя                                       # удалить
-```
-</details>
+# минимум: свой домен и два протокола, без вопросов
+bash <(curl -fsSL …/scripts/3x-ui-local.sh) --protocols reality,awg3 --domain vpn.example.com
 
-<details>
-<summary><b>Сеть и маскировка</b> – <code>kit net</code></summary>
+# всё, кроме WireGuard, и второй порт SSH
+bash <(curl -fsSL …/scripts/3x-ui-local.sh) --protocols все --ssh-port 2222
+
+# ничего не спрашивать: ping закрыть, автообновления включить, порт и пароль не трогать
+bash <(curl -fsSL …/scripts/3x-ui-local.sh) --yes
+```
+
+Проверить канал, ничего не меняя:
 
 ```bash
-kit net                              # протоколы, порты, сайт маскировки, отпечаток – одним экраном
-kit net site [сайт.com]              # сменить сайт маскировки (без аргумента – среди соседей по подсети)
-kit net port имя порт                # сменить порт протокола
-kit net off имя  /  kit net on имя   # выключить и включить протокол (kit net on reality2 – второй REALITY)
-kit net fp firefox                   # сменить отпечаток клиента у всех подключений
-kit net masq on|off                  # Hysteria2 отвечает на чужой запрос страницей сайта
-kit net dns on|off                   # DNS в подписке по DoH через прокси
-kit net panel domain | ip            # панель и подписка по своему домену или по IP
-```
-</details>
-
-<details>
-<summary><b>Раздельная маршрутизация</b> – <code>kit net split</code></summary>
-
-Через VPN идёт только список зарубежных сервисов, остальное – напрямую. Подробнее – [в инструкции](manuals/3x-ui.md#раздельная-маршрутизация-kit-net-split).
-
-```bash
-kit net split on       # создать список и включить
-kit net split check    # проверить список
-kit net split apply    # после правки списка обновить профили Happ и Xray
-kit net split off      # выключить
-```
-</details>
-
-<details>
-<summary><b>Обслуживание сервера</b> – проверка, обновление, копия</summary>
-
-```bash
-kit check [--deep] [--fix]   # проверить сервер; --deep – подключиться клиентом, --fix – исправить безопасное
-kit update [--panel]         # обновить сейчас; --panel – панель 3X-UI до проверенной версии
-kit update --auto            # ночное автообновление включить (--manual – выключить)
-kit backup                   # копия сервера: подключения, ключи, пользователи
-kit version                  # версии KIT, панели и ядра
+bash <(curl -fsSL …/scripts/3x-ui-local.sh) --verify-only   # подпись релиза и сумма установщика
+bash <(curl -fsSL …/scripts/3x-ui-local.sh) --dry-run       # что именно будет сделано
 ```
 
-Копию из `kit backup` на новом чистом сервере поднимает `bash 3x-ui.sh --restore файл`. Если подписка выдавалась
-на домене, а не на IP, клиентам достаточно сменить адрес в DNS.
-</details>
+### Флаги установки
 
-<details>
-<summary><b>Если не подключается</b> – диагностика</summary>
-
-```bash
-kit check --deep             # проверить сервер и подключиться к нему клиентом: видно, виноват сервер или сеть
-kit net fp firefox           # другой отпечаток клиента (вернуть: kit net fp chrome)
-kit net site                 # другой сайт для маскировки
-kit net on reality2          # дополнительный REALITY на другом порту
-kit backup                   # не помогло – копия, затем перенос на другой адрес: на новом сервере bash 3x-ui.sh --restore файл
-```
-
-Один протокол не подключается – попробуйте соседний: у каждого свои сильные стороны (Hysteria2 работает по UDP,
-остальные по TCP). В подписке Clash «Авто» выбирает сама, в остальных приложениях – вручную.
-</details>
-
-## VPN на роутере
-
-Через прокси идут только нужные сервисы и выбранные устройства, остальное работает напрямую.
-Порядок: **1.** установить программу на роутер → **2.** собрать конфиг в [генераторе](#генератор-конфигов-для-роутера) →
-**3.** вставить команду из генератора.
-
-> [!NOTE]
-> На роутере работает [XKeen](https://github.com/jameszeroX/XKeen) автора jameszeroX, спасибо ему.
-
-<details>
-<summary><b>📶 Keenetic: XKeen (jameszeroX) · 8 шагов, 20–30 минут</b></summary>
-
-Нужны роутер **Keenetic** или **Netcraze** с USB-портом, USB-флешка в формате **ext4** и свой сервер с VLESS
-(например, из [этой инструкции](manuals/3x-ui.md)).
-
-<details>
-<summary><b>1. Компоненты KeeneticOS</b></summary>
-
-В веб-интерфейсе: **Управление → Общие настройки → Изменить набор компонентов**. Отметьте компоненты
-с галочками на картинке и установите. Роутер обновится и перезагрузится.
-
-![Нужные компоненты KeeneticOS](manuals/assets/keenetic-components.svg)
-
-</details>
-
-<details>
-<summary><b>2. Entware на флешку</b></summary>
-
-1. Отформатируйте флешку в **ext4** и вставьте её в роутер.
-2. Откройте её по сети (`\\192.168.x.x\`), создайте папку `install` и положите туда установщик под процессор роутера:
-   [mipsel](https://bin.entware.net/mipselsf-k3.4/installer/mipsel-installer.tar.gz),
-   [mips](https://bin.entware.net/mipssf-k3.4/installer/mips-installer.tar.gz) или
-   [aarch64](https://bin.entware.net/aarch64-k3.10/installer/aarch64-installer.tar.gz).
-   Не знаете, какой нужен? Модель роутера – в характеристиках на сайте Keenetic.
-
-![Установщик Entware на флешке](manuals/assets/entware-installer.svg)
-
-3. **Управление → OPKG**: выберите флешку и сохраните. Установка займёт несколько минут.
-
-![Выбор накопителя для OPKG](manuals/assets/keenetic-opkg.svg)
-
-</details>
-
-<details>
-<summary><b>3. Подключение по SSH</b></summary>
-
-```bash
-ssh root@192.168.x.x -p 222
-```
-
-Пароль по умолчанию `keenetic`. **Сразу смените его** командой `passwd`.
-
-</details>
-
-<details>
-<summary><b>4. Шифрованный DNS</b></summary>
-
-Пропишите шифрованные DNS-серверы (DoT или DoH) по
-[инструкции Keenetic](https://support.keenetic.ru/ultra/kn-1811/ru/31543-dot-and-doh-proxy-servers-for-dns-requests-encryption.html):
-без этого XKeen работает неправильно.
-
-</details>
-
-<details>
-<summary><b>5. Токен для KeeneticOS 5.2 и новее</b></summary>
-
-XKeen нужен токен доступа к роутеру. Создайте его в разделе **Пользователи и доступ**, вставьте в
-[шаблон xkeen.json](https://github.com/jameszeroX/XKeen/releases/download/2.0.1_Beta/xkeen.json) и положите файл на роутер
-по пути `/opt/etc/xkeen/xkeen.json`. Подробнее – в [вики XKeen](https://github.com/jameszeroX/XKeen/wiki/Порядок-установки).
-
-</details>
-
-<details>
-<summary><b>6. Установка XKeen</b></summary>
-
-Подключитесь по SSH и выполните:
-
-```bash
-opkg update && opkg upgrade && opkg install curl tar && cd /tmp
-sh -c "$(curl -sSL https://raw.githubusercontent.com/jameszeroX/XKeen/main/install.sh)"
-```
-
-Если GitHub недоступен, замените адрес на `https://cdn.jsdelivr.net/gh/jameszeroX/XKeen@main/install.sh`.
-Установщик спросит ядро (Xray или Mihomo), геобазы и автозагрузку.
-
-Затем соберите конфиг в [генераторе](#генератор-конфигов-для-роутера) (роутер Keenetic, нужное ядро), вставьте команду в SSH-консоль
-и нажмите Enter: файлы запишутся, XKeen перезапустится.
-
-![Конфигурационные файлы Xray](manuals/assets/xkeen-configs.svg)
-
-</details>
-
-<details>
-<summary><b>7. Какие устройства через прокси</b></summary>
-
-В веб-интерфейсе откройте **Приоритеты подключений → Политики доступа в Интернет**, создайте политику
-с именем **`xkeen`** и перенесите в неё нужные устройства.
-
-> [!WARNING]
-> Без политики `xkeen` через прокси пойдёт трафик **всех** устройств в сети.
-
-</details>
-
-<details>
-<summary><b>8. Проверка</b></summary>
-
-- На роутере: `xkeen -status` – XKeen должен быть запущен.
-- На устройстве из политики `xkeen` откройте сайт, показывающий IP-адрес: он должен совпасть с адресом вашего сервера,
-  а на остальных устройствах остаться прежним.
-- Удобнее управлять настройками из браузера через [XKeen UI](https://github.com/zxc-rv/XKeen-UI).
-
-</details>
-
-Подробная версия с теми же шагами: [инструкция для Keenetic](manuals/xkeen-keenetic.md).
-
-</details>
-
-## Генератор конфигов для роутера
-
-Вставьте ссылку на сервер или подписку, выберите роутер и ядро, отметьте нужные сервисы –
-и получите готовый конфиг и одну команду, которая сама положит его на роутер.
-Всё считается в браузере, ссылки никуда не отправляются.
-Как поставить XKeen на роутер – в разделе [VPN на роутере](#vpn-на-роутере).
-
-| Роутер | Ядро | Что получится | Генератор |
-|---|---|---|---|
-| Keenetic (XKeen) | Xray | `04_outbounds.json` и `05_routing.json`: серверы, выбор сервисов, реклама, свои сайты | [Открыть →](https://itsnotkubrick.github.io/3X-UI_KIT/tools/?core=xray) |
-| Keenetic (XKeen) | Mihomo | `config.yaml` с автовыбором сервера, подпиской, Hysteria2, AmneziaWG и веб-панелью | [Открыть →](https://itsnotkubrick.github.io/3X-UI_KIT/tools/?core=mihomo) |
-| OpenWrt (Nikki), бета | Mihomo | профиль для Nikki и команда, которая его включит | [Открыть →](https://itsnotkubrick.github.io/3X-UI_KIT/tools/?router=openwrt) |
-
-## Полезное
-
-- [XKeen](https://github.com/jameszeroX/XKeen) и его [вики](https://github.com/jameszeroX/XKeen/wiki) – документация по маршрутизации на Keenetic
-- [XKeen UI](https://github.com/zxc-rv/XKeen-UI) – веб-интерфейс для XKeen
-- [IP-адреса для AmneziaWG](https://github.com/RockBlack-VPN/ip-address) – актуальные списки от RockBlack
-
-## Поддержать проект
-
-Скрипты и инструкции бесплатные. Донат добровольный – он помогает оплачивать
-тестовые серверы и держать скрипты в актуальном состоянии. Спасибо! 💜
-
-| Способ | |
+| Флаг | Что делает |
 |---|---|
-| Российской картой, СБП, Tinkoff Pay | [Tribute](https://t.me/tribute/app?startapp=dRsY) |
-| Зарубежной картой, Apple Pay, Google Pay | [Buy Me a Coffee](https://buymeacoffee.com/relo.cate) |
-| USDT (TRC-20) | `TS83ViXrdezUpp1eFadqj1rBhGLZaba1c1` |
-| TON | `UQBchO4XFPwF9MMa_tjXpwqTo8IL2FhUDyllhYuFo8WM-Qbf` |
-| Ethereum (ERC-20) | `0xC06F6B3A029d7Ea00705B7028490744e2BC16799` |
+| `--protocols all\|minimal\|список` | какие протоколы ставить: `all`, `minimal` (только REALITY) или через запятую. Невыбранные не создаются вообще |
+| `--domain ваш.домен` | свой домен для маскировки (A-запись на сервер, свободный порт 80 — сертификат Let's Encrypt выпустит установщик) |
+| `--sni сайт.ком` | маскировка под чужой сайт вместо своего домена |
+| `--panel-on ip\|domain` | где открывать панель и подписку |
+| `--site N\|random\|off` | сайт-заглушка: конкретный из нашего набора, случайный (по умолчанию) или не трогать |
+| `--ssh-port N` | перевести SSH на порт N (прежний закроется только после вашей проверки) |
+| `--harden` / `--no-harden` | закрыть ping и включить автообновления безопасности / не трогать это |
+| `--yes` | не задавать вопросы (для автоматизации) |
+| `--host IP`, `--user имя`, `--port N`, `--restore файл` | адрес в ссылках, имя первого клиента, порт REALITY, восстановление из копии `kit backup` |
+| `--no-time`, `--no-check`, `--verify-only`, `--dry-run`, `-h` | служебные |
 
-## Благодарности
+## Что происходит по шагам
 
-3X-UI KIT построен на работе авторов этих проектов:
-[3X-UI](https://github.com/MHSanaei/3x-ui) ·
-[Xray-core](https://github.com/XTLS/Xray-core) ·
-[Mihomo](https://github.com/MetaCubeX/mihomo) ·
-[Hysteria](https://github.com/apernet/hysteria) ·
-[AmneziaWG](https://github.com/amnezia-vpn) ·
-[XKeen](https://github.com/jameszeroX/XKeen)
+1. **Проверка сервера**: root, Debian/Ubuntu, память, место на диске, занятые порты 80/443.
+2. **Проверка релиза**: файлы берутся из этого репозитория по тегу, проверяется **подпись `SHA256SUMS`**
+   нашим ключом и SHA256 самого установщика. Не сошлось — ничего не запускается.
+3. **Выбор протоколов** и запуск установщика: панель 3X-UI, выбранные подключения, nginx на 443,
+   сертификат, сайт-заглушка, служба подписки, правила ufw.
+4. **Сайт-заглушка**: ставится случайный правдоподобный ИТ-сайт из нашего набора (10 штук) и
+   синхронизируется в ответ Hysteria2.
+5. **Наши вопросы и правки**: закрыть ответ на ping, включить обновления безопасности, сменить порт
+   SSH, сменить пароль root.
+6. **`kit fix`** — синхронизация времени и безопасные починки.
+7. **Проверка**: `kit check` (порты, службы, подписка, сертификат, маскировка) и сводка
+   `kit local hardening`. В конце — как забрать ссылки и подписку.
+
+## Протоколы
+
+Один порт 443 на всё: nginx разводит подключения по именам и путям, поэтому снаружи видно только
+443/tcp (и Hysteria2 на 443/udp). Список и умолчание — как у проекта: невыбранные протоколы не
+создаются вообще, ни подключения в панели, ни записей в nginx, ни ссылок в подписке.
+
+| № | Протокол | Что это |
+|---|---|---|
+| 1 | **REALITY** | VLESS + Reality, основной вход. **По умолчанию** |
+| 2 | REALITY-2 | второй REALITY на случайном высоком порту |
+| 3 | Hysteria2 | быстрее на плохой сети (UDP 443) |
+| 4 | XHTTP | VLESS + Reality под другим именем маскировки |
+| 5 | VLESS-WS | VLESS через WebSocket |
+| 6 | Trojan-gRPC | Trojan через gRPC |
+| 7 | VMess-WS | VMess через WebSocket |
+| 8 | Shadowsocks | Shadowsocks 2022 |
+| 9 | TUIC | быстрый UDP-протокол |
+| 10 | WireGuard | обычный WireGuard: легко распознаётся, поэтому по умолчанию не ставится |
+| 11 | AmneziaWG | AmneziaWG: Mihomo, роутеры Keenetic |
+| 12 | **AmneziaWG-3.1** | AmneziaWG с защитой заголовков: приложения AmneziaVPN. **По умолчанию** |
+| 13 | MTProto | прокси для Telegram |
+
+Наш набор по умолчанию — **REALITY + AmneziaWG-3.1**: работает почти везде и не требует
+дополнительных объяснений на клиенте. Маскировку и сайт можно менять потом: `kit net site`,
+`kit local site`.
+
+## Сайт-заглушка
+
+На 443 при неизвестном имени отдаётся страница нашего набора: небольшие правдоподобные ИТ-сайты
+вместо стандартных «страница в разработке».
+
+| № | Сайт | Тема |
+|---|---|---|
+| 1 | Radian Analytics | дата-аналитика: хранилище, отчёты, дашборды |
+| 2 | Circuit Nine | DevOps-консалтинг: CI/CD, инфраструктура, наблюдаемость |
+| 3 | Cortex Monitor | мониторинг серверов: проверки, алерты, сертификаты |
+| 4 | Bluefin Software | разработка ПО на заказ |
+| 5 | Vantage Security | аудит и пентест |
+| 6 | Keystone IT | ИТ-поддержка офисов |
+| 7 | Meridian Networks | колокейшн и транзит |
+| 8 | Lumen Notes | заметки про Linux, nginx и сети |
+| 9 | Evercore Backup | бэкапы и восстановление |
+| 10 | Halyard Docs | документация проекта |
+
+```bash
+kit local site            # случайный сайт из набора
+kit local site --list     # список с номерами
+kit local site 7          # поставить конкретный
+kit local site --show     # какой стоит сейчас
+```
+
+Менять страницу нужно **этой командой**: `/var/www/kit/index.html` отдаёт nginx, а Hysteria2 держит
+свою копию страницы внутри подключения. Команда обновляет обе — иначе 443/tcp и UDP начнут отвечать
+разными страницами, и это заметно снаружи.
+
+## Команды
+
+На сервере после установки доступна команда `kit` (без аргументов — меню).
+
+| Команда | Что делает |
+|---|---|
+| `kit user …` | `add`, `list`, `link`, `limit`, `on`, `off`, `del` — пользователи, ссылки, лимиты трафика и сроков |
+| `kit net` | состояние подключений; `on`/`off` включить-выключить, `site` — сайт маскировки, `masq` — ответ Hysteria2 страницей, `dns` — DoH в подписках |
+| `kit port` / `kit port set <имя> <порт>` | какие порты слушают подключения / сменить порт подключения |
+| `kit reality add [порт]` | добавить второй REALITY |
+| `kit check [--deep\|--fix]`, `kit fix` | проверка сервера (в том числе с самого сервера, как клиент) и безопасные починки |
+| `kit update [--panel]`, `--auto`, `--manual` | обновление сборки и панели, режим автообновления |
+| `kit backup` | копия сервера (панель, сертификаты, настройки) |
+| `kit version` | версии сборки, панели и ядра |
+
+Наш слой — `kit local` (справка: `kit local help`):
+
+| Команда | Что делает |
+|---|---|
+| `kit local site` | сайт-заглушка: случайный, `--list`, номер, `--show` |
+| `kit local ssh 2222` / `--status` / `--close-old 2222` | добавить порт SSH / какие слушают / закрыть прежние после проверки |
+| `kit local ping off\|on\|status` | ответ на ICMP echo правилом ufw (видно в `ufw status`, отменяется одной командой) |
+| `kit local passwd [юзер]`, `--generate` | смена пароля (спрашивает дважды, в логи не попадает) |
+| `kit local upgrades on\|off\|status` | обновления безопасности |
+| `kit local hardening`, `masking`, `channel`, `seams`, `version` | сводка защиты, состояние маскировки, канал обновлений, какие места форк правит у автора |
+
+У любой правки есть `--dry-run` — показывает план и ничего не меняет. Копии изменённых файлов
+складываются в `/root/kit-local-backup-<дата>/`.
+
+## Обновление и канал
+
+- Сервер обновляется из **этого репозитория**: `kit update` и ночной таймер берут релиз с подписью
+  нашего ключа. Чужой релиз сервер не примет.
+- Посмотреть, откуда берутся обновления и чем проверяется подпись: `kit local channel`.
+- Управление автообновлением: `kit update --auto` (включить) и `kit update --manual` (выключить),
+  `kit update` — обновиться сейчас, `kit update --panel` — обновить саму панель 3X-UI.
+- Проверить канал, ничего не устанавливая: установщик с `--verify-only` или `kit local channel`.
+
+## Оговорки
+
+- **Пароль root** никогда не передаётся флагом: значение в командной строке видно другим процессам.
+  Спрашивается в ходе установки или меняется `kit local passwd`.
+- **Смена порта SSH** делается в два шага: новый порт добавляется, прежний продолжает работать, пока
+  вы не проверите вход во втором окне. Закрыть прежние: `kit local ssh --close-old 2222`.
+- **`apt full-upgrade` не выполняется** — только обновления безопасности: панель и ядро Xray
+  закреплены на проверенных версиях.
+- Версии панели и ядра в сборке сверяются с официальными хешами при выпуске релиза.
+
+## Документация форка
+
+| Файл | О чём |
+|---|---|
+| [FORK.md](FORK.md) | как устроен форк: где наши правки (швы), регламент обновления из авторского проекта, канал, подпись, грабли |
+| [FORK-CHANGELOG.md](FORK-CHANGELOG.md) | что менялось в наших версиях |
+| `kit local help` | команды форка прямо на сервере |

SHA256SUMS

@@ -1,6 +1,9 @@
-# 3X-UI KIT 1.2
-2d7a0f0dcc26ea4f8bab3d60e1900e7046a9673a88fef85c03630502120961f0  scripts/3x-ui.sh
-ec3d62ecee39d14ea98ccc367ebd34febbb2e57a28a4e2405f70bcc7b26e45ab  scripts/hysteria2.sh
-ce4889af8e9d1ce70508166f96986d33a5f4e3829b8223f8035e380f45ca7760  scripts/kit.sh
-eac3e47491ce86487f05160952ff5b4ad8a3821954f082eee3516e40575fb574  scripts/kit-sub.py
-44804414f85bef9588f60086587fd6e8871b39123c831ec129624f4d81a95fea  VERSION
+# 3X-UI KIT 1.2.8
+# 3X-UI_autoVPS 1.2.8
+b0497a26637fd2ef2aae6e512a9afc49f4f6f64b639994c9f029fa4c0977a3a8  scripts/3x-ui.sh
+03589cb294acf83be77aeb170eb8adcfc2f901437e437ebc6c1b56bb18579333  scripts/hysteria2.sh
+7d328be5414ab544d0b29e89db3ef172a7d650f3ac0b80bade25ac7136709a47  scripts/kit.sh
+4027ea2c6dbc9fd176356acac3f676445419c2f021146ed25dfe5a304c3ac5fb  scripts/kit-sub.py
+8216a98d82712dd320e6f158212b557c01c5aa94f8099c89ce33fe5fc39f9002  scripts/kit-local.sh
+bf961b4e33bfb9e4d18fd9edcea0a71320d6de9a8304c17b6cbeb95aef04affc  scripts/3x-ui-local.sh
+d2d31534641da01801512a3ec793bc8d57132d4cefa19a5fb503e8995f39eb8f  VERSION

SHA256SUMS.sig

@@ -1,6 +1,6 @@
 -----BEGIN SSH SIGNATURE-----
-U1NIU0lHAAAAAQAAADMAAAALc3NoLWVkMjU1MTkAAAAgatMYIOGGebxc7V6Sk8m5JZFUIm
-IWK6kSyl9DFxsQGbMAAAARM3gtdWkta2l0LXJlbGVhc2UAAAAAAAAABnNoYTUxMgAAAFMA
-AAALc3NoLWVkMjU1MTkAAABAdFL7PZOiEBqM7mNXcIUk96bj1YnqSR6BijHEd07ij1IG05
-Vjb8nVmTjlvGMbhxZw0lNAbdeQLSDpBgBS2JFGBQ==
+U1NIU0lHAAAAAQAAADMAAAALc3NoLWVkMjU1MTkAAAAgozRJ+f9RB6qO9S9j3BWCDtC0bV
+FHakRSSqtQPljLoQUAAAARM3gtdWkta2l0LXJlbGVhc2UAAAAAAAAABnNoYTUxMgAAAFMA
+AAALc3NoLWVkMjU1MTkAAABAc/dTe+Zehd28Zfczj1mJXWHNZGSAx8Lbr+jqpF7oYcVNq9
+ExRrCHUH3GS7IDR2KRJRV8zqVyEDwBDat6ZQhZBQ==
 -----END SSH SIGNATURE-----

VERSION

@@ -1 +1 @@
-1.2
+1.2.8

manuals/assets/fork-banner.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="860" height="190" viewBox="0 0 860 190" role="img" aria-label="3X-UI autoVPS — сборка форка">
+<style>.t{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif}
+.m{font-family:'JetBrains Mono',ui-monospace,Menlo,Consolas,monospace}</style>
+<rect x="0.5" y="0.5" width="859" height="189" rx="16" fill="#15110f" stroke="#43372e"/>
+<circle cx="748" cy="46" r="58" fill="#93e06f" opacity="0.07"/>
+<circle cx="808" cy="140" r="34" fill="#93e06f" opacity="0.05"/>
+<text x="44" y="86" class="t" font-size="46" font-weight="700" fill="#fbf6ec">3X-UI <tspan fill="#93e06f">autoVPS</tspan></text>
+<text x="44" y="118" class="t" font-size="16" fill="#cbbfa9">сервер одной командой: панель 3X-UI, VPN-протоколы, один порт 443, одна подписка</text>
+<text x="44" y="152" class="m" font-size="13" fill="#8a8073">свой канал обновлений · подписанные релизы · 13 протоколов · 10 сайтов-заглушек</text>
+</svg>

scripts/3x-ui-local.sh

@@ -0,0 +1,446 @@
+#!/usr/bin/env bash
+# 3X-UI_autoVPS (форк hacker07) — установка сервера одной командой из нашего канала.
+#
+# Что делает (по шагам):
+#   1) проверяет сервер и наличие curl, ssh-keygen, openssl;
+#   2) берёт из нашего Gitea релиз своей же версии, проверяет ПОДПИСЬ SHA256SUMS и SHA256 установщика;
+#   3) запускает установщик автора (scripts/3x-ui.sh) — панель 3X-UI, протоколы, сайт-заглушка,
+#      маскировка, сертификат, подписка, ufw. Флаги установщика можно передавать как есть,
+#      а можно ничего не передавать — тогда он задаст вопросы сам (в том числе про домен);
+#   4) спрашивает, какие протоколы ставить: невыбранные не создаются вообще — ни подключения в панели,
+#      ни записей в nginx, ни ссылок в подписке (за это отвечает флаг автора --protocols);
+#   5) ставит сайт-заглушку: случайный правдоподобный ИТ-сайт из нашего набора (10 штук;
+#      --site N — конкретный, --no-site — не трогать авторскую страницу);
+#   6) спрашивает и делает то, чего у автора нет: закрыть ответ на ping, включить обновления
+#      безопасности, перевести SSH на другой порт, сменить пароль root (поведение из StressOzz/vps-setup,
+#      но безопаснее);
+#   7) в конце: kit fix (время и безопасные починки), kit check, kit local hardening;
+#   8) последним — подписка, QR-код и ссылки по протоколам: то, что нужно сохранить.
+#
+# Запуск:
+#   # одна команда, дальше — вопросы:
+#   bash <(curl -fsSL https://git.rukavishnikoff.ru/hacker07/3X-UI_autoVPS/raw/branch/main/scripts/3x-ui-local.sh)
+#   # или сразу с ответами, без вопросов:
+#   ... 3x-ui-local.sh --domain vpn.example.com
+#   ... 3x-ui-local.sh --sni dl.google.com --no-harden --ssh-port 2222
+#   # без вопросов, всё по умолчанию (для автоматизации):
+#   ... 3x-ui-local.sh --yes
+#
+# Флаги этого скрипта (остальные уходят установщику автора):
+#   --domain ДОМЕН, --sni САЙТ, --panel-on ip|domain, --host IP, --user ИМЯ, --port N, --restore ФАЙЛ
+#   --harden        закрыть ping и включить автообновления, без вопросов
+#   --no-harden     не трогать ping и автообновления
+#   --ssh-port N    добавить порт SSH N (прежний порт продолжает работать)
+#   --yes           ни о чём не спрашивать (ping закрою, автообновления включу, порт и пароль — нет)
+#   --no-time       не запускать kit fix
+#   --no-check      не запускать в конце kit check
+#   --verify-only   только проверить релиз (подпись и SHA256) и выйти
+#   --dry-run       показать план и ничего не делать
+#   -h | --help     эта справка
+#
+# Наш файл: авторские релизы его не перезаписывают, а правки форка живут в scripts/kit-local.sh.
+
+set -Eeuo pipefail
+
+KIT_VERSION="1.2.8"                 # версия сборки форка; должна совпадать с VERSION релиза
+GITEA="${KIT_FORK_BASE:-https://git.rukavishnikoff.ru/hacker07/3X-UI_autoVPS}"
+NS="3x-ui-kit-release"
+SIG_ID="releases@3x-ui-kit"
+# Публичный ключ форка. Меняется только вместе с ключом подписи (тогда обновляется и здесь, и в kit).
+SIGNER_PUB='ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIKM0Sfn/UQeqjvUvY9wVgg7QtG1RR2pEUkqrUD5Yy6EF 3X-UI_autoVPS fork releases (hacker07)'
+
+G=$'\e[32m'; Y=$'\e[33m'; R=$'\e[31m'; B=$'\e[1m'; D=$'\e[2m'; N=$'\e[0m'
+[[ -t 1 ]] || { G=; Y=; R=; B=; D=; N=; }
+say()  { printf '%s\n' "${G}==>${N} $*"; }
+warn() { printf '%s\n' "${Y}!${N}  $*" >&2; }
+die()  { printf '%s\n' "${R}✗${N}  $*" >&2; exit 1; }
+
+usage() {
+  cat <<'EOF'
+3X-UI_autoVPS (форк hacker07) — установка сервера одной командой из нашего канала.
+
+  bash <(curl -fsSL <наш Gitea>/raw/branch/main/scripts/3x-ui-local.sh) [флаги…]
+
+Без флагов скрипт спрашивает: какие протоколы ставить (невыбранные не создаются вообще),
+маскировку и домен — это вопросы установщика автора; затем про ответ на ping, автообновления,
+второй порт SSH и пароль root — это наши вопросы.
+
+Флаги, которые скрипт передаёт установщику автора как есть:
+  --domain vpn.example.com   свой домен для маскировки (A-запись на этот сервер, свободный 80)
+  --sni сайт.com             маскировка под чужой сайт
+  --panel-on domain | ip     где открывать панель и подписку
+  --host IP, --user имя, --port N, --protocols …, --restore файл
+
+Флаги этого скрипта:
+  --harden             закрыть ping и включить автообновления, без вопросов
+  --no-harden          не трогать ping и автообновления
+  --ssh-port N         перевести SSH на порт N (прежний закроется после проверки входа)
+  --yes                ни о чём не спрашивать (для автоматизации)
+    --site N|random|off  сайт-заглушка: конкретный из нашего набора, случайный (по умолчанию) или
+                         не трогать авторскую страницу (то же: --no-site)
+    --no-sub             не показывать в конце подписку, QR-код и ссылки по протоколам
+    --no-time            не запускать kit fix (время и безопасные починки)
+  --no-check           не запускать в конце kit check
+  --verify-only        только проверить релиз (подпись и SHA256) и выйти
+  --dry-run            показать план и ничего не делать
+  -h | --help          эта справка
+EOF
+}
+
+# ------------------------------------------------------------------ разбор флагов
+
+INSTALLER_ARGS=(); harden=auto; ssh_port=""; fix_time=yes; do_check=yes; dry=no; verify_only=no; assume_yes=no
+site=random                     # заглушка: случайный сайт из нашего набора (off — не трогать)
+show_sub=yes                    # в самом конце показать подписку, QR-код и ссылки
+while (($#)); do
+  case $1 in
+    --harden) harden=yes ;;
+    --no-harden) harden=no ;;
+    --ssh-port) ssh_port=${2:-}; shift || die "--ssh-port: нужен номер порта" ;;
+    --ssh-port=*) ssh_port=${1#*=} ;;
+    --yes | -y) assume_yes=yes ;;
+    --site) site=${2:-random}; shift || die "--site: нужен номер сайта (1..10), random или off" ;;
+    --site=*) site=${1#*=} ;;
+    --no-site) site=off ;;
+    --no-sub) show_sub=no ;;
+    --no-time) fix_time=no ;;
+    --no-check) do_check=no ;;
+    --verify-only) verify_only=yes ;;
+    --dry-run) dry=yes ;;
+    -h | --help) usage; exit 0 ;;
+    *) INSTALLER_ARGS+=("$1") ;;
+  esac
+  shift
+done
+[[ -z $ssh_port ]] || { [[ $ssh_port =~ ^[0-9]{1,5}$ ]] && ((10#$ssh_port >= 1024 && 10#$ssh_port <= 65535)); } \
+  || die "--ssh-port: нужно число 1024–65535, например 2222"
+if [[ $site != off && $site != random ]]; then
+  # 10 — число сайтов в наборе (scripts/kit-local.sh, KL_SITE_TITLES); добавите сайт — поднимите границу
+  [[ $site =~ ^[0-9]{1,2}$ ]] && ((10#$site >= 1 && 10#$site <= 10)) \
+    || die "--site: random, off или номер 1..10 (список: kit local site --list)"
+fi
+
+# Если --protocols задан флагом — не спрашиваем и не дублируем его.
+proto_flag=""
+for ((_i = 0; _i < ${#INSTALLER_ARGS[@]}; _i++)); do
+  [[ ${INSTALLER_ARGS[_i]} == --protocols ]] && proto_flag=${INSTALLER_ARGS[_i + 1]:-all}
+done
+
+pre() { printf '  %s\n' "$*"; }
+ASK_SRC=${KIT_ASK_SRC:-/dev/tty}   # откуда читать ответы (в тестах подменяется файлом)
+interactive() { [[ $assume_yes == no && -r $ASK_SRC ]]; }
+
+if [[ $dry == yes ]]; then
+  say "план установки (--dry-run: ничего не делаю)"
+  pre "версия сборки: $KIT_VERSION"
+  pre "откуда:        $GITEA (тег v$KIT_VERSION), подпись проверяется ключом форка"
+  if ((${#INSTALLER_ARGS[@]})); then pre "установщик автора: bash scripts/3x-ui.sh ${INSTALLER_ARGS[*]}"; else pre "установщик автора: bash scripts/3x-ui.sh — спросит про маскировку и домен"; fi
+  if [[ $harden == auto ]]; then
+    if interactive; then pre "защита:        спрошу про ответ на ping и автообновления"
+    else pre "защита:        без терминала — закрыть ping и включить автообновления"; fi
+  elif [[ $harden == yes ]]; then pre "защита:        закрыть ping и включить автообновления (--harden)"
+  else pre "защита:        пропускаю (--no-harden)"; fi
+  if [[ -n $proto_flag ]]; then pre "протоколы:     ${proto_flag} (задано флагом)"
+  elif interactive; then pre "протоколы:     спрошу (Enter — REALITY + AmneziaWG-3.1, «все» — набор автора)"
+  else pre "протоколы:     REALITY + AmneziaWG-3.1 (без терминала вопроса нет)"; fi
+  if [[ -n $ssh_port ]]; then pre "порт SSH:      перевожу на $ssh_port (прежний — после проверки входа)"
+  elif interactive; then pre "порт SSH:      спрошу (Enter — оставить текущий)"; fi
+  if interactive; then pre "пароль root:   спрошу (по умолчанию — не менять)"; fi
+  case $site in
+    off) pre "заглушка:      оставляю авторскую страницу (--no-site)" ;;
+    random) pre "заглушка:      случайный ИТ-сайт из нашего набора (10 штук)" ;;
+    *) pre "заглушка:      сайт №$site из нашего набора (список: kit local site --list)" ;;
+  esac
+  [[ $fix_time == yes ]] && pre "после:         kit fix (время, безопасные починки)"
+  [[ $do_check == yes ]] && pre "проверка:      kit check + kit local hardening"
+  [[ $show_sub == yes ]] && pre "в самом конце: подписка, QR-код и ссылки по протоколам (--no-sub — не надо)"
+  echo
+  say "запуск без --dry-run выполнит всё это на сервере"
+  exit 0
+fi
+
+# ------------------------------------------------------------------ релиз: скачать и проверить подпись
+
+# Подпись проверяем ДО запуска чужого кода, поэтому здесь нужны только curl/ssh-keygen/openssl.
+for c in curl ssh-keygen openssl; do command -v "$c" >/dev/null || die "нет $c — поставьте: apt-get update && apt-get install -y $c"; done
+
+say "беру релиз v$KIT_VERSION и проверяю подпись"
+tmp=$(mktemp -d)
+trap 'rm -rf "$tmp"' EXIT
+raw="$GITEA/raw/tag/v$KIT_VERSION"
+for f in SHA256SUMS SHA256SUMS.sig scripts/3x-ui.sh; do
+  mkdir -p "$tmp/$(dirname "$f")"
+  curl -fsSL --retry 3 -m 60 -o "$tmp/$f" "$raw/$f" || die "не скачался $f из $raw (Gitea доступна с сервера?)"
+done
+printf '%s namespaces="%s" %s\n' "$SIG_ID" "$NS" "$SIGNER_PUB" >"$tmp/allowed_signers"
+ssh-keygen -Y verify -f "$tmp/allowed_signers" -I "$SIG_ID" -n "$NS" -s "$tmp/SHA256SUMS.sig" <"$tmp/SHA256SUMS" >/dev/null 2>&1 \
+  || die "подпись релиза v$KIT_VERSION не сошлась с ключом форка — это не наш релиз, ничего не запускаю"
+sum=$(awk '{f = $2; sub(/^\*/, "", f)} f == "scripts/3x-ui.sh" {print $1}' "$tmp/SHA256SUMS")
+[[ $(printf '%s' "$sum" | wc -c) -eq 64 ]] || die "в SHA256SUMS нет установщика — релиз собран неверно"
+got=$(sha256sum "$tmp/scripts/3x-ui.sh" | awk '{print $1}')
+[[ $got == "$sum" ]] || die "SHA256 установщика не совпал с подписанным — не запускаю"
+bash -n "$tmp/scripts/3x-ui.sh" || die "установщик не проходит проверку синтаксиса"
+printf '  ✓ подпись сошлась, SHA256 установщика совпал\n'
+
+if [[ $verify_only == yes ]]; then
+  say "релиз v$KIT_VERSION проверен: подпись и SHA256 сошлись, установщик не запускался"
+  exit 0
+fi
+
+# ------------------------------------------------------------------ предполётные проверки
+
+say "проверяю сервер"
+[[ ${EUID:-0} -eq 0 ]] || die "нужен root: запустите от root (на чистом VPS обычно так и есть)"
+[[ -r /etc/os-release ]] || die "не вижу /etc/os-release — это не Debian/Ubuntu?"
+# shellcheck disable=SC1091
+. /etc/os-release
+case ${ID:-} in debian | ubuntu | raspbian) ;; *) warn "система ${PRETTY_NAME:-?}: поддерживаются Debian и Ubuntu" ;; esac
+printf '  %s\n' "${PRETTY_NAME:-Linux}, ядро $(uname -r), памяти $(awk '/MemTotal/ {printf "%.1f ГБ", $2 / 1048576}' /proc/meminfo 2>/dev/null || echo '?')"
+df -P / | awk 'NR==2 {gsub("%","",$5); if ($5 >= 95) exit 1}' || warn "диск занят почти полностью — установка может не пройти"
+for p in 443 80; do ss -H -ltn 2>/dev/null | awk '{print $4}' | grep -qE "[:.]$p\$" && warn "порт $p уже кем-то занят"; done
+
+# ------------------------------------------------------------------ какие протоколы ставить
+
+# Список, порядок и набор по умолчанию — как у установщика автора (scripts/3x-ui.sh:
+# ALL_PROTOS / DEFAULT_PROTOS). Невыбранные протоколы не создаются вообще: под них не будет
+# ни подключения в панели, ни записей в nginx, ни ссылок в подписке.
+ALL_PROTOS=(reality reality2 hy2 xhttp ws trojan vmess ss tuic wg awg awg3 mtproto)
+PROTO_HINT=(
+  "REALITY          основной: VLESS + Reality, порт 443"
+  "REALITY-2        второй REALITY на случайном высоком порту"
+  "Hysteria2        быстрее на плохой сети (UDP 443)"
+  "XHTTP            VLESS + Reality под другим именем маскировки"
+  "VLESS-WS         VLESS через WebSocket"
+  "Trojan-gRPC      Trojan через gRPC"
+  "VMess-WS         VMess через WebSocket"
+  "Shadowsocks      Shadowsocks 2022"
+  "TUIC             быстрый UDP-протокол"
+  "WireGuard        обычный WireGuard: легко распознаётся, обычно не ставят"
+  "AmneziaWG        AmneziaWG: Mihomo, роутеры Keenetic"
+  "AmneziaWG-3.1    AmneziaWG с защитой заголовков: AmneziaVPN"
+  "MTProto          прокси для Telegram"
+)
+# Наш набор по умолчанию: VLESS REALITY и AmneziaWG-3.1 — самый совместимый минимум.
+# Набор автора (флаг --protocols all) доступен ответом «все».
+AUTHOR_PROTOS=(reality hy2 xhttp ws trojan vmess ss tuic awg awg3 mtproto)
+DEFAULT_PROTOS=(reality awg3)
+
+proto_menu() {
+  local i n mark
+  say "какие протоколы поставить?" >&2
+  for i in "${!ALL_PROTOS[@]}"; do
+    n=$((i + 1)) mark=" "
+    [[ " ${DEFAULT_PROTOS[*]} " == *" ${ALL_PROTOS[i]} "* ]] && mark="*"
+    printf '  %s %2d. %s\n' "$mark" "$n" "${PROTO_HINT[i]}" >&2
+  done
+  printf '  %s\n' "${D}[* — по умолчанию: REALITY + AmneziaWG-3.1. «все» — набор автора (всё, кроме WireGuard).${N}" >&2
+  printf '  %s\n' "${D}[Невыбранные протоколы не создаются вообще: ни подключения, ни записей в nginx, ни ссылок в подписке.]${N}" >&2
+}
+
+proto_parse() { # ответ → выбранные имена через запятую; код 1, если не разобрал
+  local ans=${1,,} tok i all=" ${ALL_PROTOS[*]} " picked=""
+  ans=${ans//[[:space:]]/,}            # «1 3 11» и «1,3,11» — одно и то же
+  [[ -n $ans ]] || { printf '%s' "$(IFS=,; echo "${DEFAULT_PROTOS[*]}")"; return 0; }
+  case $ans in
+    all | все | всё) printf '%s' "$(IFS=,; echo "${AUTHOR_PROTOS[*]}")"; return 0 ;;
+    minimal | минимум) printf '%s' "reality"; return 0 ;;
+  esac
+  local IFS=','
+  for tok in $ans; do
+    [[ -n $tok ]] || continue            # двойные запятые и пробелы — не ошибка
+    if [[ $tok =~ ^[0-9]{1,2}$ ]]; then
+      i=$((10#$tok - 1))
+      ((i >= 0 && i < ${#ALL_PROTOS[@]})) || return 1
+      tok=${ALL_PROTOS[i]}
+    fi
+    [[ $all == *" $tok "* ]] || return 1      # только имена из списка автора
+    [[ ,$picked, == *",$tok,"* ]] || picked+="${picked:+,}$tok"
+  done
+  [[ -n $picked ]] || return 1
+  printf '%s' "$picked"
+}
+
+ask_protocols() { # печатает итоговый список через запятую
+  local i ans picked
+  interactive || { printf '%s' "$(IFS=,; echo "${DEFAULT_PROTOS[*]}")"; return 0; }
+  proto_menu
+  for i in 1 2 3; do
+    printf '\n%sНомера через запятую (например 1,12) или «все»; Enter — REALITY + AmneziaWG-3.1: %s' "$B" "$N" >&2
+    ans=""
+    read -r -t 300 ans <"$ASK_SRC" 2>/dev/null || true
+    if picked=$(proto_parse "$ans"); then printf '%s' "$picked"; return 0; fi
+    warn "не понял «$ans» — нужны номера из списка через запятую или «все»"
+  done
+  warn "оставляю набор по умолчанию"
+  printf '%s' "$(IFS=,; echo "${DEFAULT_PROTOS[*]}")"
+}
+
+# ------------------------------------------------------------------ установка
+
+if [[ -z $proto_flag ]]; then
+  protos=$(ask_protocols)
+  INSTALLER_ARGS+=(--protocols "$protos")
+else
+  protos=$proto_flag
+fi
+say "протоколы: $protos — под остальные не создаётся ничего"
+
+say "запускаю установщик автора (панель 3X-UI, протоколы, сайт-заглушка, подписка)"
+if ((${#INSTALLER_ARGS[@]})); then printf '  флаги: %s\n' "${INSTALLER_ARGS[*]}"; else printf '  флагов нет: установщик задаст вопросы (маскировка, домен)\n'; fi
+# stdin: если есть терминал — отдаём его установщику (там есть вопросы), иначе /dev/null,
+# иначе установщик начнёт читать наш собственный скрипт вместо ответов.
+if [[ -r /dev/tty ]]; then
+  bash "$tmp/scripts/3x-ui.sh" ${INSTALLER_ARGS[@]+"${INSTALLER_ARGS[@]}"} </dev/tty || die "установщик остановился с ошибкой — смотрите его вывод выше"
+else
+  bash "$tmp/scripts/3x-ui.sh" ${INSTALLER_ARGS[@]+"${INSTALLER_ARGS[@]}"} </dev/null || die "установщик остановился с ошибкой (нет терминала — вопросы задать некому)"
+fi
+command -v kit >/dev/null || die "после установки нет команды kit — что-то пошло не так, смотрите вывод выше"
+
+# ------------------------------------------------------------------ наши дополнения
+
+ask_yes() { # "вопрос" y|n — по умолчанию
+  local q=$1 def=$2 ans=""
+  interactive || { [[ $def == y ]]; return; }
+  printf '\n%s [%s]: ' "$q" "$([[ $def == y ]] && echo 'Y/n' || echo 'y/N'])"
+  read -r -t 300 ans <"$ASK_SRC" 2>/dev/null || true
+  ans=${ans,,}; ans=${ans//[[:space:]]/}
+  [[ -z $ans && $def == y ]] && return 0
+  [[ $ans =~ ^(y|yes|д|да)$ ]]
+}
+
+# Сайт-заглушка: у автора это случайные «кофейни и пекарни», у нас — правдоподобный ИТ-сайт.
+# Меняем не файл вручную, а командой форка: она же обновляет копию страницы в ответе Hysteria2,
+# иначе 443/tcp и UDP-порт начнут отвечать разными страницами (это видно снаружи).
+case $site in
+  off) say "заглушку не трогаю (--no-site): остаётся страница автора" ;;
+  random)
+    say "ставлю сайт-заглушку: случайный ИТ-сайт из нашего набора"
+    kit local site || warn "не удалось поставить заглушку — позже: kit local site"
+    ;;
+  *)
+    say "ставлю сайт-заглушку №$site"
+    kit local site "$site" || warn "не удалось поставить заглушку — позже: kit local site $site"
+    ;;
+esac
+
+if [[ $fix_time == yes ]]; then
+  say "kit fix: синхронизация времени и безопасные починки (авторская команда, ничего необратимого)"
+  kit fix || warn "kit fix завершился с замечаниями — посмотрите вывод"
+fi
+
+# ping и автообновления: --harden/--no-harden решают без вопросов, иначе спрашиваем
+want_ping=$harden; want_update=$harden
+[[ $want_ping == auto ]] && want_ping=yes
+[[ $want_update == auto ]] && want_update=yes
+if [[ $harden == auto ]] && interactive; then
+  if ask_yes "Закрыть ответ сервера на ping? Снаружи пинг перестанет отвечать (подписка и VPN не затрагиваются)." y; then want_ping=yes; else want_ping=no; fi
+  if ask_yes "Включить автообновления безопасности? Только security-обновления, без перезагрузки." y; then want_update=yes; else want_update=no; fi
+fi
+if [[ $want_ping == yes ]]; then
+  say "закрываю ответ на ping (правилом ufw)"
+  kit local ping off || warn "не удалось — повторите: kit local ping off"
+fi
+if [[ $want_update == yes ]]; then
+  say "включаю автообновления безопасности"
+  kit local upgrades on || warn "не удалось — повторите: kit local upgrades on"
+fi
+
+# порт SSH: по флагу или по вопросу. Смена делается в два шага: сначала ДОБАВИТЬ новый порт
+# (прежний продолжает работать), потом закрыть прежние — иначе одна опечатка оставляет сервер без доступа.
+ssh_ports_now() {
+  local p
+  p=$(kit local ssh --status 2>/dev/null | sed -n 's/^порты SSH сейчас: //p')
+  [[ -n $p ]] || p=$(sshd -T 2>/dev/null | awk '$1 == "port" {print $2}' | paste -sd, -)
+  [[ -n $p ]] || p=$(grep -rhiE '^[[:space:]]*Port[[:space:]]+[0-9]+' /etc/ssh/sshd_config /etc/ssh/sshd_config.d 2>/dev/null | awk '{print $2}' | paste -sd, -)
+  printf '%s' "${p:-22}"
+}
+
+ask_ssh_port() { # пусто — оставить как есть; иначе номер нового порта
+  local cur ans try
+  cur=$(ssh_ports_now)
+  interactive || return 0
+  for try in 1 2 3; do
+    printf '\n%sСменить порт SSH? Сейчас %s. Введите новый номер, Enter — оставить как есть: %s' "$B" "$cur" "$N" >&2
+    ans=""
+    read -r -t 300 ans <"$ASK_SRC" 2>/dev/null || true
+    ans=${ans//[[:space:]]/}
+    [[ -n $ans ]] || { say "порт SSH оставляю как есть ($cur)" >&2; return 0; }
+    if ! [[ $ans =~ ^[0-9]{1,5}$ ]] || ((10#$ans < 1024 || 10#$ans > 65535)); then
+      warn "«$ans» не похоже на порт (нужно число 1024–65535)"
+      continue
+    fi
+    if [[ ,$cur, == *",$ans,"* ]]; then
+      say "порт $ans уже слушает SSH — менять нечего" >&2; return 0
+    fi
+    if ss -H -ltn 2>/dev/null | awk '{print $4}' | grep -qE "[:.]$ans\$"; then
+      warn "порт $ans/tcp занят другой программой"
+      continue
+    fi
+    printf '%s' "$ans"; return 0
+  done
+  warn "оставляю прежний порт ($cur)"
+}
+
+[[ -n $ssh_port ]] || ssh_port=$(ask_ssh_port)
+if [[ -n $ssh_port ]]; then
+  say "перевожу SSH на порт $ssh_port: новый добавляю, прежний пока остаётся рабочим"
+  kit local ssh "$ssh_port" || warn "порт не добавился — сделайте отдельно: kit local ssh $ssh_port"
+fi
+
+# пароль root: в флагах его нет намеренно — значение в командной строке видно в списке процессов
+if interactive; then
+  if ask_yes "Сменить пароль root прямо сейчас?" n; then
+    kit local passwd || warn "не получилось — повторите: kit local passwd"
+  fi
+fi
+
+# ------------------------------------------------------------------ проверка
+
+if [[ $do_check == yes ]]; then
+  say "проверяю, что получилось"
+  kit check || warn "kit check нашёл замечания — читайте выше; безопасные починки: kit fix"
+  kit local hardening
+fi
+
+cat <<EOF
+
+${G}${B}Готово.${N} Сервер поставлен из нашей сборки (3X-UI_autoVPS $KIT_VERSION, канал: наш Gitea).
+
+  подписка и ссылки:    kit user link admin        (или страница подписки из вывода установщика)
+  если что-то не так:   kit check --deep, затем kit fix
+  вернуться к авторскому каналу: положить авторский kit поверх и выполнить kit update --force
+EOF
+
+# ------------------------------------------------------------------ доступ к панели (перед подпиской)
+
+if [[ $show_sub == yes ]]; then
+  say "панель 3X-UI: адрес, логин и пароль"
+  if [[ -s /root/3x-ui.txt ]]; then
+    printf '  файл: /root/3x-ui.txt (виден только root). Сохраните данные себе:\n'
+    sed 's/^/  /' /root/3x-ui.txt
+  else
+    warn "файла /root/3x-ui.txt нет — адрес панели и логин были в выводе установщика выше"
+  fi
+fi
+
+# ------------------------------------------------------------------ подписка, QR-код и доступы
+
+# Показываем в самом конце, после всех проверок: это то, что человек уносит с собой.
+# Печатает авторская команда (подписка + QR-код через qrencode + ссылки по протоколам),
+# поэтому вывод не расходится с тем, что показывает `kit` потом.
+if [[ $show_sub == yes ]]; then
+  sub_user=admin
+  for ((_i = 0; _i < ${#INSTALLER_ARGS[@]}; _i++)); do
+    [[ ${INSTALLER_ARGS[_i]} == --user ]] && sub_user=${INSTALLER_ARGS[_i + 1]:-admin}
+  done
+  say "подписка и доступы — это то, что стоит сохранить"
+  printf '  подписка — одна ссылка на все устройства; QR-код ниже наводите камерой в приложении\n'
+  printf '  приложения: Happ, Hiddify, Karing, v2rayN, Clash/Mihomo\n'
+  printf '  отдельные ссылки по протоколам — ниже же (если приложение не умеет подписку)\n'
+  printf '  %sпозже то же самое: kit user link %s --all   (или меню: kit)%s\n' "$D" "$sub_user" "$N"
+  if ! kit user link "$sub_user" --all; then
+    warn "не смог показать ссылки для «$sub_user» — список пользователей: kit user list"
+  fi
+else
+  say "ссылки и QR-код не показываю (--no-sub). Посмотреть: kit user link admin --all"
+fi

scripts/3x-ui.sh

@@ -30,9 +30,9 @@ wait_apt_idle() {
 XUI_VERSION="v3.9.0"
 # SHA256 установщика 3X-UI этой версии: тег могут передвинуть, а хеш – нет (проверено 2026-09-30).
 XUI_INSTALL_SHA256="18616fe26c8f6c92db6daa2dcd7cd53c5143ee69ecfd26d8ea6dc9b2c78607a6"
-KIT_VERSION="1.2"
+KIT_VERSION="1.2.8"
 # kit и kit-sub берём из того же релиза, что и этот скрипт, а не из меняющейся ветки main.
-KIT_RAW="https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/v$KIT_VERSION"
+KIT_RAW="https://git.rukavishnikoff.ru/hacker07/3X-UI_autoVPS/raw/tag/v$KIT_VERSION"
 # Ядро Xray для панели. С 26.7.x клиенты на Mihomo и sing-box (Hiddify, FlClash,
 # Clash Verge, Mihomo в XKeen) не проходят REALITY – проверено 2026-09-25.
 # 26.6.27 – последняя версия, с которой работают все клиенты и которую принимает 3X-UI.
@@ -372,15 +372,15 @@ kit_banner() {
   echo
   printf '%s' "$G"
   cat <<'ART'
-  _ _                   _   _          _          _      _
- (_) |_ ___ _ __   ___ | |_| | ___   _| |__  _ __(_) ___| | __
- | | __/ __| '_ \ / _ \| __| |/ / | | | '_ \| '__| |/ __| |/ /
- | | |_\__ \ | | | (_) | |_|   <| |_| | |_) | |  | | (__|   <
- |_|\__|___/_| |_|\___/ \__|_|\_\\__,_|_.__/|_|  |_|\___|_|\_\
+   _   _            _                ___ _____
+  | | | | __ _  ___| | _____ _ __   / _ \___  |
+  | |_| |/ _` |/ __| |/ / _ \ '__| | | | | / /
+  |  _  | (_| | (__|   <  __/ |    | |_| |/ /
+  |_| |_|\__,_|\___|_|\_\___|_|     \___//_/
 ART
   printf '%s' "$N"
   echo
-  echo "${B}3X-UI KIT $KIT_VERSION${N}  ·  it's not Kubrick. it's just a VPN."
+  echo "${B}3X-UI_autoVPS $KIT_VERSION${N}  ·  сборка форка: панель 3X-UI и VPN-протоколы на одном порту"
   echo "${D}на основе панели 3X-UI (MHSanaei/3x-ui) и ядра Xray · github.com/itsnotkubrick/3X-UI_KIT${N}"
 }
 
@@ -761,7 +761,7 @@ main() {
   [[ $SINGLE == yes ]] && links=$(sed "s/^\(tg:\/\/proxy?\)\(.*\)port=${INNER[mtproto]}/\1\2port=443/" <<<"$links")
   umask 077
   {
-    echo "3X-UI KIT (3X-UI $XUI_VERSION) – данные для входа (файл виден только root)"
+    echo "3X-UI_autoVPS (3X-UI $XUI_VERSION) – данные для входа (файл виден только root)"
     echo
     echo "Панель:  $panel_url"
     echo "Логин:   $XUI_USERNAME"
@@ -1270,6 +1270,7 @@ awg_attach() { # имя subId [лимит-байт] [срок-мс] [устро
 }
 
 KIT_CLI_URL="$KIT_RAW/scripts/kit.sh"
+KIT_LOCAL_URL="$KIT_RAW/scripts/kit-local.sh"
 
 install_kit_cli() {
   install -d -m 700 /etc/kit
@@ -1293,10 +1294,18 @@ install_kit_file() {
   [[ -f $d/kit.sh && ${BASH_SOURCE[0]} != /dev/fd/* ]] && src=$d/kit.sh
   if [[ -n $src ]]; then install -m 755 "$src" /usr/local/bin/kit
   else curl -fsSL --retry 3 -o /usr/local/bin/kit "$KIT_CLI_URL" && chmod 755 /usr/local/bin/kit; fi
+  # Форк: ставим наши локальные дополнения (см. scripts/kit-local.sh).
+  install -d -m 755 /usr/local/lib/kit
+  if [[ -n $src && -f $d/kit-local.sh ]]; then
+    install -m 644 "$d/kit-local.sh" /usr/local/lib/kit/kit-local.sh
+  else
+    curl -fsSL --retry 3 -o /usr/local/lib/kit/kit-local.sh "$KIT_LOCAL_URL" \
+      || warn "Локальные дополнения kit не скачались: kit local не будет работать"
+  fi
   bash -n /usr/local/bin/kit || die "Команда kit скачалась повреждённой"
 }
 
-KIT_INSTALL_CMD="bash <(curl -fsSL https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/main/scripts/3x-ui.sh)"
+KIT_INSTALL_CMD="bash <(curl -fsSL https://git.rukavishnikoff.ru/hacker07/3X-UI_autoVPS/raw/branch/main/scripts/3x-ui.sh)"
 
 # После «x-ui → Uninstall» меню подсказывает команду официального установщика –
 # меняем её на нашу. Только в echo: вызов установщика в «Update» не трогаем.
@@ -1471,7 +1480,7 @@ setup_nginx() {
   local panel_path=/${XUI_WEB_BASE_PATH#/}
   panel_path=${panel_path%/}/
   {
-    echo "# Сгенерировано 3x-ui.sh (3X-UI KIT) – перезаписывается при повторном запуске."
+    echo "# Сгенерировано 3x-ui.sh (3X-UI_autoVPS) – перезаписывается при повторном запуске."
     echo "stream {"
     echo "    map \$ssl_preread_server_name \$kit_upstream {"
     [[ -n $reality_sni ]] && echo "        $reality_sni 127.0.0.1:${INNER[reality]};"
@@ -1491,7 +1500,7 @@ setup_nginx() {
     echo "}"
   } >/etc/nginx/kit-stream.conf
   cat >/etc/nginx/conf.d/kit.conf <<NGX
-# Сгенерировано 3x-ui.sh (3X-UI KIT) – перезаписывается при повторном запуске.
+# Сгенерировано 3x-ui.sh (3X-UI_autoVPS) – перезаписывается при повторном запуске.
 server {
     listen 127.0.0.1:${INNER[web]} ssl http2 proxy_protocol;
     server_name _;
@@ -1579,14 +1588,14 @@ setup_subscription() {
     # Без subURI панель показывает ссылку на внутренний порт 2097, до которого снаружи не достучаться.
     local uri="https://$HOST:$SUB_PORT$SUB_PATH"
     [[ $SINGLE == yes ]] && uri="https://$HOST$SUB_PATH"
-    upd=$(jq -c --arg path "$SUB_PATH" --argjson ip "$SUB_INTERNAL" --arg title "3X-UI KIT" --arg uri "$uri" '
+    upd=$(jq -c --arg path "$SUB_PATH" --argjson ip "$SUB_INTERNAL" --arg title "3X-UI_autoVPS" --arg uri "$uri" '
       .subEnable = true | .subPath = $path | .subTitle = $title | .subListen = "127.0.0.1" | .subPort = $ip
       | .subURI = $uri
       | .subCertFile = "" | .subKeyFile = ""
       | .subClashEnable = true | .subClashAutoDetect = true | .subJsonEnable = true | .subJsonAutoDetect = true' <<<"$all")
   else
     SUB_PORT=$(jq -r '.subPort // 2096' <<<"$all")
-    upd=$(jq -c --arg path "$SUB_PATH" --arg title "3X-UI KIT" '
+    upd=$(jq -c --arg path "$SUB_PATH" --arg title "3X-UI_autoVPS" '
       .subEnable = true | .subPath = $path | .subTitle = $title
       | .subClashEnable = true | .subClashAutoDetect = true | .subJsonEnable = true | .subJsonAutoDetect = true' <<<"$all")
   fi
@@ -1607,7 +1616,7 @@ setup_subscription() {
 kit_sub_unit() { # путь-к-сертификату путь-к-ключу (пусто – за nginx)
   cat <<UNIT
 [Unit]
-Description=kit-sub: подписка с учётом приложения (3X-UI KIT)
+Description=kit-sub: подписка с учётом приложения (3X-UI_autoVPS)
 After=network-online.target x-ui.service
 Wants=network-online.target
 
@@ -1709,11 +1718,11 @@ safe_env() { # файл имя...
   local f=$1 n re; shift
   [[ -r $f ]] || die "В копии нет файла ${f##*/}."
   [[ $(LC_ALL=C tr -d '\n -~' <"$f" | wc -c) -eq 0 ]] \
-    || die "Это не резервная копия 3X-UI KIT или она повреждена (файл ${f##*/}). Ничего не менял."
+    || die "Это не резервная копия 3X-UI_autoVPS или она повреждена (файл ${f##*/}). Ничего не менял."
   LC_ALL=C grep -aqvE "^([A-Z][A-Z0-9_]*=([A-Za-z0-9._:/@%+,=_-]*|''))?$" "$f" \
-    && die "Это не резервная копия 3X-UI KIT или она повреждена (файл ${f##*/}). Ничего не менял."
+    && die "Это не резервная копия 3X-UI_autoVPS или она повреждена (файл ${f##*/}). Ничего не менял."
   while IFS= read -r n; do
-    [[ " $* " == *" $n "* ]] || die "Это не резервная копия 3X-UI KIT или она повреждена (лишнее имя $n в ${f##*/}). Ничего не менял."
+    [[ " $* " == *" $n "* ]] || die "Это не резервная копия 3X-UI_autoVPS или она повреждена (лишнее имя $n в ${f##*/}). Ничего не менял."
     case $n in
       BACKUP_KIT_VERSION) re='^[0-9]{1,3}(\.[0-9]{1,3}){1,3}$' ;;
       BACKUP_HOST | HOST) re='^[A-Za-z0-9.:-]{1,253}$' ;;
@@ -1731,10 +1740,10 @@ safe_env() { # файл имя...
       SUB_PATH) re='^/[A-Za-z0-9_-]{1,64}/$' ;;
       SINGLE) re='^(yes|no)?$' ;;
       MTPROTO_INNER) re='^[0-9]{0,5}$' ;;
-      *) die "Это не резервная копия 3X-UI KIT или она повреждена (имя $n в ${f##*/}). Ничего не менял." ;;
+      *) die "Это не резервная копия 3X-UI_autoVPS или она повреждена (имя $n в ${f##*/}). Ничего не менял." ;;
     esac
     [[ $(env_get "$f" "$n") =~ $re ]] \
-      || die "Это не резервная копия 3X-UI KIT или она повреждена (значение $n в ${f##*/}). Ничего не менял."
+      || die "Это не резервная копия 3X-UI_autoVPS или она повреждена (значение $n в ${f##*/}). Ничего не менял."
   done < <(LC_ALL=C grep -aoE '^[A-Z][A-Z0-9_]*' "$f")
   return 0
 }
@@ -1865,7 +1874,7 @@ restore_main() { # файл
   tmp=$(mktemp -d)
   # shellcheck disable=SC2064 # путь подставляем сразу: при выходе локальной переменной уже нет
   trap "rm -rf -- '$tmp'" EXIT
-  python3 - "$file" "$tmp" <<'PY' || die "Это не резервная копия 3X-UI KIT или она повреждена. Ничего не менял."
+  python3 - "$file" "$tmp" <<'PY' || die "Это не резервная копия 3X-UI_autoVPS или она повреждена. Ничего не менял."
 import os, sys, tarfile
 allowed = ("etc/x-ui/x-ui.db", "etc/x-ui/install-result.env", "etc/kit/kit.env", "etc/kit-sub/config.json", "etc/kit-sub/rules.yaml",
            "etc/nginx/kit-stream.conf", "etc/nginx/conf.d/kit.conf", "var/www/kit", "root/cert/self",
@@ -1926,7 +1935,7 @@ PY
   safe_env "$tmp/kit-backup.env" BACKUP_KIT_VERSION BACKUP_HOST BACKUP_SSL BACKUP_DATE
   safe_env "$tmp/etc/x-ui/install-result.env" XUI_USERNAME XUI_PASSWORD XUI_PANEL_PORT XUI_WEB_BASE_PATH XUI_ACCESS_URL XUI_API_TOKEN XUI_DB_TYPE
   [[ $(env_get "$tmp/etc/x-ui/install-result.env" XUI_PANEL_PORT) =~ ^[0-9]{1,5}$ ]] \
-    || die "Это не резервная копия 3X-UI KIT или она повреждена (порт панели). Ничего не менял."
+    || die "Это не резервная копия 3X-UI_autoVPS или она повреждена (порт панели). Ничего не менял."
   if [[ -f $tmp/etc/kit/kit.env ]]; then
     safe_env "$tmp/etc/kit/kit.env" HOST LINK_HOST PANEL_ON SUB_BASE SUB_PATH SUB_INTERNAL SINGLE MTPROTO_INNER
   fi
@@ -1938,10 +1947,10 @@ PY
   BACKUP_SSL=$(env_get "$tmp/kit-backup.env" BACKUP_SSL)
   BACKUP_DATE=$(env_get "$tmp/kit-backup.env" BACKUP_DATE)
   BACKUP_KIT_VERSION=$(env_get "$tmp/kit-backup.env" BACKUP_KIT_VERSION)
-  [[ $BACKUP_HOST =~ ^[A-Za-z0-9.:-]+$ ]] || die "Это не резервная копия 3X-UI KIT или она повреждена (адрес сервера). Ничего не менял."
+  [[ $BACKUP_HOST =~ ^[A-Za-z0-9.:-]+$ ]] || die "Это не резервная копия 3X-UI_autoVPS или она повреждена (адрес сервера). Ничего не менял."
   [[ $BACKUP_SSL =~ ^(ip|custom|none)$ ]] || die "В копии нет данных о сертификате."
   [[ $BACKUP_SSL != custom || -f $tmp/root/cert/custom/fullchain.pem ]] \
-    || die "Это не резервная копия 3X-UI KIT или она повреждена (нет своего сертификата). Ничего не менял."
+    || die "Это не резервная копия 3X-UI_autoVPS или она повреждена (нет своего сертификата). Ничего не менял."
   PANEL_SSL=$BACKUP_SSL
   # Домен переезжает вместе с сервером (поменяйте A-запись), IP – нет.
   if [[ $BACKUP_HOST =~ ^[0-9.]+$ ]]; then

scripts/hysteria2.sh

@@ -2,18 +2,18 @@
 # Hysteria2 – https://github.com/itsnotkubrick/3X-UI_KIT
 #
 # Отдельный установщик Hysteria2 больше не поддерживается: Hysteria2 входит в основную
-# установку 3X-UI KIT (scripts/3x-ui.sh). Файл оставлен, чтобы старая команда `hy2 update`
+# установку 3X-UI_autoVPS (scripts/3x-ui.sh). Файл оставлен, чтобы старая команда `hy2 update`
 # получила из подписанного релиза понятное сообщение. Ничего не ставит, не удаляет и не
 # останавливает: сервер Hysteria2, установленный раньше, продолжает работать как был.
 # Код выхода 1 при любом запуске (и при `__update_binary`) – старый `hy2 update` на нём
 # останавливается и не заменяет команду hy2.
 
-KIT_VERSION="1.2"
+KIT_VERSION="1.2.8"
 
 cat >&2 <<'MSG'
 Отдельный установщик Hysteria2 больше не поддерживается.
 Сервер Hysteria2 продолжает работать как раньше, но не обновляется этим скриптом.
-Hysteria2 входит в основную установку 3X-UI KIT (один из 11 протоколов).
+Hysteria2 входит в основную установку 3X-UI_autoVPS (один из 11 протоколов).
 Если нужен только Hysteria2 без панели – официальный установщик:
   bash <(curl -fsSL https://get.hy2.sh/)
 MSG

scripts/kit-sub.py

@@ -494,11 +494,11 @@ def routing_payload(kind, loaded):
         else:
             ips.append(v)
     if kind == "happ":
-        data = {"Name": "3X-UI KIT", "GlobalProxy": "false", "DomainStrategy": "IPIfNonMatch", "ProxySites": sites,
+        data = {"Name": "3X-UI_autoVPS", "GlobalProxy": "false", "DomainStrategy": "IPIfNonMatch", "ProxySites": sites,
                 "ProxyIp": ips, "DirectIp": ["geoip:private"]}
     else:
         # localhost – системный DNS клиента для прямых сайтов (как в подписке Mihomo); список direct_dns его заменяет.
-        data = {"Name": "3X-UI KIT", "DomainStrategy": "IPIfNonMatch", "RouteOrder": "block-proxy-direct",
+        data = {"Name": "3X-UI_autoVPS", "DomainStrategy": "IPIfNonMatch", "RouteOrder": "block-proxy-direct",
                 "ProxySites": sites, "ProxyIp": ["1.1.1.1", "8.8.8.8"] + ips, "DirectSites": ["regexp:.*"],
                 "DirectIp": ["geoip:private", "0.0.0.0/0", "::/0"], "DomesticDNSDomain": direct_dns[0] if direct_dns else "localhost"}
     text = json.dumps(data, ensure_ascii=False, separators=(",", ":"))
@@ -577,3 +577,4 @@ def main():
 
 if __name__ == "__main__":
     main()
+

scripts/kit.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# kit – управление сервером 3X-UI KIT: пользователи, обновление, резервная копия.
+# kit – управление сервером 3X-UI_autoVPS: пользователи, обновление, резервная копия.
 # https://github.com/itsnotkubrick/3X-UI_KIT
 #
 #   kit user add имя [--gb 50] [--days 30] [--devices 3]
@@ -12,10 +12,17 @@
 set -Eeuo pipefail
 export LC_ALL=C.UTF-8  # ширина колонок по символам, а не байтам
 
-KIT_VERSION="1.2"
-KIT_RAW="https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/main"
+KIT_VERSION="1.2.8"
+KIT_RAW="https://git.rukavishnikoff.ru/hacker07/3X-UI_autoVPS/raw/branch/main"
 # Файлы новой версии берём из её тега, а не из меняющейся ветки main.
-kit_ref_raw() { echo "https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/v$1"; }
+kit_ref_raw() { echo "https://git.rukavishnikoff.ru/hacker07/3X-UI_autoVPS/raw/tag/v$1"; }
+
+# --- 3X-UI_KIT (форк hacker07): локальные команды и хуки ---
+# Подключаем scripts/kit-local.sh, если он установлен. Наш файл: правки автора его не касаются.
+# Все команды форка — под «kit local …» (см. kit local help).
+KIT_LOCAL_LIB="${KIT_LOCAL_LIB:-/usr/local/lib/kit/kit-local.sh}"
+if [[ -r $KIT_LOCAL_LIB ]]; then . "$KIT_LOCAL_LIB"; kit_local_dispatch "$@"; fi
+
 
 XUI_ENV=/etc/x-ui/install-result.env
 KIT_ENV=/etc/kit/kit.env
@@ -380,7 +387,7 @@ cmd_enforce() {
 limit_timer_on() {
   cat >/etc/systemd/system/kit-limit.service <<'UNIT'
 [Unit]
-Description=3X-UI KIT: общий лимит трафика пользователей (сумма по всем записям)
+Description=3X-UI_autoVPS: общий лимит трафика пользователей (сумма по всем записям)
 After=x-ui.service
 
 [Service]
@@ -390,7 +397,7 @@ TimeoutStartSec=120
 UNIT
   cat >/etc/systemd/system/kit-limit.timer <<'UNIT'
 [Unit]
-Description=3X-UI KIT: проверка общего лимита трафика раз в 5 минут
+Description=3X-UI_autoVPS: проверка общего лимита трафика раз в 5 минут
 
 [Timer]
 OnBootSec=2min
@@ -454,8 +461,8 @@ cmd_del() {
 # есть только у автора, поэтому подменить обновление, взломав один GitHub, не выйдет.
 # Новый ключ приходит только в релизе, подписанном старым.
 KIT_SIGNERS=(
-  # SHA256:VDuGgJ8dOeCNXB4nBZf3+kRlWthw3+vh8rfMxzMSRIM (itsnotkubrick, 2026-09-30)
-  "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGrTGCDhhnm8XO1ekpPJuSWRVCJiFiupEspfQxcbEBmz 3X-UI KIT releases"
+  # Ключ подписи форка (владелец: hacker07). Закрытая часть — только на рабочей станции.
+  "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIKM0Sfn/UQeqjvUvY9wVgg7QtG1RR2pEUkqrUD5Yy6EF 3X-UI_autoVPS fork releases (hacker07)"
 )
 KIT_SIG_NS="3x-ui-kit-release"
 KIT_SIG_ID="releases@3x-ui-kit"
@@ -489,7 +496,7 @@ update_hint() {
 }
 
 cmd_version() {
-  echo "3X-UI KIT $KIT_VERSION"
+  echo "3X-UI_autoVPS $KIT_VERSION"
   echo "${D}панель 3X-UI $(/usr/local/x-ui/x-ui -v 2>/dev/null | head -1 || echo '?'), ядро Xray $(xray_version)${N}"
   if auto_enabled; then echo "${D}автообновление: включено (только подписанные релизы), журнал $KIT_UPDATE_LOG${N}"
   else echo "${D}автообновление: выключено, включить: kit update --auto${N}"; fi
@@ -498,7 +505,7 @@ cmd_version() {
 
 # Что нового в версии $1 – из CHANGELOG.md, без разметки.
 changelog_of() {
-  curl -fsS -m 5 "$KIT_RAW/CHANGELOG.md" 2>/dev/null | awk -v v="## v$1" '
+  { curl -fsS -m 5 "$KIT_RAW/CHANGELOG.md" 2>/dev/null; curl -fsS -m 5 "$KIT_RAW/FORK-CHANGELOG.md" 2>/dev/null; } | awk -v v="## v$1" '
     index($0, v) == 1 { on = 1; t = substr($0, length(v) + 1); sub(/^[: ]+/, "", t); if (t != "") print t; next } on && /^## / { exit } on' | sed -E 's/ ?Спасибо .*$//; s/\[([^]]*)\]\([^)]*\)/\1/g; s/\*\*//g; s/`//g' | grep -v '^[[:space:]]*$' | head -40 || true
 }
 
@@ -518,8 +525,8 @@ fetch_release() { # версия каталог
     return 1
   fi
   # Версия записана внутри подписанного файла: старый подписанный релиз под видом нового не пройдёт.
-  grep -qx "# 3X-UI KIT $v" "$d/SHA256SUMS" || { warn "Подписанный релиз не той версии – ничего не ставлю."; return 1; }
-  for f in scripts/kit.sh scripts/kit-sub.py; do
+  grep -qxE "# (3X-UI KIT|3X-UI_autoVPS) $v" "$d/SHA256SUMS" || { warn "Подписанный релиз не той версии – ничего не ставлю."; return 1; }
+  for f in scripts/kit.sh scripts/kit-sub.py scripts/kit-local.sh; do
     sum=$(awk -v f="$f" '$2 == f {print $1}' "$d/SHA256SUMS")
     [[ $sum =~ ^[0-9a-f]{64}$ ]] || { warn "В подписанном списке нет $f."; return 1; }
     curl -fsSL --retry 3 -o "$d/${f##*/}" "$raw/$f" || { warn "Не удалось скачать $f."; return 1; }
@@ -533,7 +540,7 @@ fetch_release() { # версия каталог
 kit_sub_unit() { # путь-к-сертификату путь-к-ключу (пусто – за nginx)
   cat <<UNIT
 [Unit]
-Description=kit-sub: подписка с учётом приложения (3X-UI KIT)
+Description=kit-sub: подписка с учётом приложения (3X-UI_autoVPS)
 After=network-online.target x-ui.service
 Wants=network-online.target
 
@@ -597,7 +604,7 @@ needs_migration() {
 auto_on() {
   cat >/etc/systemd/system/kit-update.service <<UNIT
 [Unit]
-Description=3X-UI KIT: автообновление kit и kit-sub (только подписанные релизы)
+Description=3X-UI_autoVPS: автообновление kit и kit-sub (только подписанные релизы)
 After=network-online.target
 Wants=network-online.target
 
@@ -609,7 +616,7 @@ StandardError=append:$KIT_UPDATE_LOG
 UNIT
   cat >/etc/systemd/system/kit-update.timer <<'UNIT'
 [Unit]
-Description=3X-UI KIT: проверка обновлений раз в сутки
+Description=3X-UI_autoVPS: проверка обновлений раз в сутки
 
 [Timer]
 OnCalendar=*-*-* 03:00:00
@@ -659,7 +666,7 @@ cmd_update() {
     [[ $unattended == yes ]] || echo "${D}Переустановить файлы kit той же версии: kit update --force${N}"
     return
   fi
-  if [[ $latest == "$KIT_VERSION" ]]; then say "Применяю исправления версии $latest"; else say "3X-UI KIT $KIT_VERSION → $latest"; fi
+  if [[ $latest == "$KIT_VERSION" ]]; then say "Применяю исправления версии $latest"; else say "3X-UI_autoVPS $KIT_VERSION → $latest"; fi
   tmp=$(mktemp -d)
   # shellcheck disable=SC2064 # путь подставляем сразу: при выходе локальной переменной уже нет
   trap "rm -rf -- '$tmp'" EXIT
@@ -715,10 +722,13 @@ cmd_update() {
 
   # Через rename: bash дочитывает текущий kit по ходу работы, его файл трогать нельзя.
   install -m 755 "$tmp/kit.sh" /usr/local/bin/kit.new && mv -f /usr/local/bin/kit.new /usr/local/bin/kit
+  # Форк: ставим наши локальные дополнения из того же подписанного релиза.
+  install -d -m 755 /usr/local/lib/kit
+  install -m 644 "$tmp/kit-local.sh" /usr/local/lib/kit/kit-local.sh
   # Новые пути подписки (Clash и JSON) подключает уже новая версия kit.
   /usr/local/bin/kit __subextra >/dev/null 2>&1 || warn "Дополнительные пути подписки не подключились: kit update --force"
   echo
-  echo "${G}✓ Готово: 3X-UI KIT $latest.${N} Пользователи, ссылки и подписки не менялись."
+  echo "${G}✓ Готово: 3X-UI_autoVPS $latest.${N} Пользователи, ссылки и подписки не менялись."
   [[ $unattended == yes ]] && return
   local news
   news=$(changelog_of "$latest")
@@ -1904,10 +1914,10 @@ YAML
 
 # Приложениям на Xray правила раздаёт сама панель (3X-UI 3.9+): заголовок Routing для Happ и правила JSON-подписки.
 # Собираем их из того же rules.yaml. Чужой профиль, уже стоящий в панели, не трогаем.
-split_panel_ours() { # наш профиль: JSON или ссылка happ://routing/onadd/<base64> с Name "3X-UI KIT"
+split_panel_ours() { # наш профиль: JSON или ссылка happ://routing/onadd/<base64> с Name "3X-UI_autoVPS"
   local v=$1
   [[ $v == happ://routing/onadd/* ]] && v=$(printf '%s' "${v#happ://routing/onadd/}" | base64 -d 2>/dev/null || true)
-  grep -q '"Name":"3X-UI KIT"' <<<"$v"
+  grep -q '"Name":"3X-UI_autoVPS"' <<<"$v"
 }
 
 split_panel_sync() { # on|off
@@ -2541,14 +2551,15 @@ menu_main() {
   local c
   while :; do
     echo
-    box "3X-UI KIT $KIT_VERSION – управление сервером" "1. Пользователи" "2. Протоколы, порты и маскировка" "3. Проверка сервера" "" \
+    box "3X-UI_autoVPS $KIT_VERSION – управление сервером" "1. Пользователи" "2. Протоколы, порты и маскировка" "3. Проверка сервера" "" \
       "4. Обновить kit и подписку" "5. Обновить панель 3X-UI" "6. Автообновление: включить или выключить" "" \
       "7. Резервная копия" "8. Версии" "" "9. Панель 3X-UI (меню x-ui)" "0. Выход"
+      "10. Удалить всё установленное (наш пункт)"
     echo
     menu_status
     update_hint
     echo
-    ask_num "Выбор [0-9]: "; c=$REPLY
+    ask_num "Выбор [0-9, 10]: "; c=$REPLY
     case $c in
       1) menu_users ;;
       2) menu_net ;;
@@ -2559,6 +2570,7 @@ menu_main() {
       7) run_action cmd_backup; pause ;;
       8) run_action cmd_version; pause ;;
       9) command -v x-ui >/dev/null && x-ui || echo "Меню x-ui не найдено." ;;
+      10) kit_local_uninstall ;;
       0 | "") return 0 ;;
       *) echo "Нет такого пункта." ;;
     esac
@@ -2567,7 +2579,7 @@ menu_main() {
 
 usage() {
   cat <<EOF
-${B}3X-UI KIT $KIT_VERSION${N} – команды (то же самое есть в меню: просто ${B}kit${N})
+${B}3X-UI_autoVPS $KIT_VERSION${N} – команды (то же самое есть в меню: просто ${B}kit${N})
 
   kit                        меню
   kit user …                 add, list, link, limit, on, off, del

tools/check-help.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+# Справка `kit help` обязана перечислять все команды: авторские (их берём прямо из диспетчера
+# scripts/kit.sh) и наши. Если автор добавит команду, а мы забудем про справку — проверка упадёт,
+# и сборка релиза остановится: так справка не отстанет молча.
+set -Eeuo pipefail
+cd "$(dirname "${BASH_SOURCE[0]}")/.."
+
+help=$(awk '/^kit_help_all\(\) \{/,/^\}/' scripts/kit-local.sh)
+[[ -n $help ]] || { echo "✗ не нашёл kit_help_all в scripts/kit-local.sh" >&2; exit 1; }
+
+bad=0
+# 1) авторские команды: первое слово каждой ветки диспетчера kit.sh
+while read -r word; do
+  [[ -n $word ]] || continue
+  case $word in __* | local | help | -h | --help | -v | --version) continue ;; esac
+  # «user off» в справке может стоять как «user on|off» — поэтому пробел допускаем и как разделитель вариантов
+  pat=${word// /[ |]}
+  grep -qE " kit ${pat}" <<<"$help" || { echo "  ✗ в справке нет авторской команды: kit $word" >&2; bad=1; }
+done < <(grep -oE '^ +"[a-z][a-z0-9 -]*"\)|^ +"[a-z][a-z0-9 -]*" \*\)' scripts/kit.sh | sed 's/)$//' | tr -d '"' | sed 's/^ *//' | sort -u)
+
+# 2) наши команды из ветки kit_local_cmd
+while read -r word; do
+  [[ -n $word ]] || continue
+  grep -qF " kit local $word" <<<"$help" || { echo "  ✗ в справке нет нашей команды: kit local $word" >&2; bad=1; }
+done < <(awk '/^kit_local_cmd\(\) \{/,/^\}/' scripts/kit-local.sh | grep -oE '^    [a-z-]+' | tr -d ' ' | sort -u)
+
+if (( bad )); then
+  echo "✗ справка kit help отстала от набора команд — поправьте kit_help_all в scripts/kit-local.sh" >&2
+  exit 1
+fi
+echo "  ✓ справка kit help содержит все команды (авторские и наши)"

tools/fork-signer.pub

@@ -0,0 +1 @@
+ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIKM0Sfn/UQeqjvUvY9wVgg7QtG1RR2pEUkqrUD5Yy6EF 3X-UI_autoVPS fork releases (hacker07)

tools/fork-sync-bot.sh

@@ -0,0 +1,157 @@
+#!/usr/bin/env bash
+# Робот ежесуточной синхронизации: проверяет обновления у автора проекта и, если они есть,
+# переносит их в нашу ветку dev — но только когда всё сошлось.
+#
+# Где живёт: запускается из .gitea/workflows/fork-sync.yml на раннере (CT 114 «runner»).
+# Что НЕ делает: не выпускает релиз и не подписывает его — закрытый ключ подписи остаётся
+# только на рабочей станции владельца, поэтому версия автора публикуется вручную.
+#
+# Переменные окружения (все имеют значения по умолчанию, кроме TOKEN):
+#   TOKEN      токен Gitea с правом записи в репозиторий (берётся из секретов workflow)
+#   GITEA_URL  внутренний адрес Gitea (снаружи контейнер её не видит: имя резолвится в публичный IP)
+#   REPO       владелец/репозиторий
+#   UPSTREAM   адрес авторского репозитория
+#   WORK       рабочая копия на раннере
+#   BRANCH     наша ветка для синхронизации
+#   LOG        файл отчёта последнего запуска (его читают из контейнера руками)
+
+set -Eeuo pipefail
+
+GITEA_URL=${GITEA_URL:-http://10.10.10.54:3000}
+REPO=${REPO:-hacker07/3X-UI_autoVPS}
+UPSTREAM=${UPSTREAM:-https://github.com/itsnotkubrick/3X-UI_KIT}
+WORK=${WORK:-/opt/kit-fork-sync/repo}
+BRANCH=${BRANCH:-dev}
+LOG=${LOG:-/opt/kit-fork-sync/last-run.log}
+TOKEN=${TOKEN:-}
+
+say() { printf '\n==> %s\n' "$*"; }
+ok() { printf '  ✓ %s\n' "$*"; }
+die() { printf '✗  %s\n' "$*" >&2; exit 1; }
+
+mkdir -p "$(dirname "$LOG")"
+exec > >(tee -a "$LOG") 2>&1
+printf '\n===== запуск %s =====\n' "$(date '+%F %T %Z')"
+
+[[ -n $TOKEN ]] || die "нет TOKEN: workflow не передал секрет GITEA_TOKEN"
+command -v git >/dev/null || die "нет git"
+PY=${PY:-$(command -v python3 || command -v python || true)}
+[[ -n $PY ]] || die "нет python3 — без него не применить швы"
+
+auth_url="${GITEA_URL}/${REPO}.git"
+auth_url="${auth_url/http:\/\//http://x-access-token:${TOKEN}@}"
+
+# ---------------------------------------------------------------- рабочая копия
+
+if [[ ! -d $WORK/.git ]]; then
+  say "Первая синхронизация: клонирую репозиторий"
+  git clone -q "$auth_url" "$WORK" || die "не смог склонировать $REPO"
+  git -C "$WORK" remote set-url origin "$auth_url"
+  git -C "$WORK" remote add upstream "$UPSTREAM" 2>/dev/null || git -C "$WORK" remote set-url upstream "$UPSTREAM"
+else
+  git -C "$WORK" remote set-url origin "$auth_url"
+  git -C "$WORK" remote set-url upstream "$UPSTREAM" 2>/dev/null || git -C "$WORK" remote add upstream "$UPSTREAM"
+fi
+cd "$WORK"
+
+say "Забираю ветки: наша $BRANCH и авторскую main"
+git fetch -q origin --prune
+git fetch -q upstream 'refs/heads/main:refs/heads/upstream' --prune
+git checkout -q "$BRANCH"
+git reset -q --hard "origin/$BRANCH"
+
+author_version=$(git show upstream:VERSION 2>/dev/null | tr -d '[:space:]' || true)
+[[ -n $author_version ]] || die "у автора не читается VERSION — проверьте ветку upstream"
+ours=$(tr -d '[:space:]' <VERSION)
+echo "  у автора: $author_version · у нас: $ours"
+
+new_commits=$(git rev-list --count "$BRANCH..upstream")
+if [[ $new_commits == 0 ]]; then
+  say "У автора нет новых коммитов — публиковать нечего"
+  ok "проверка выполнена, ветка $BRANCH не изменялась"
+  exit 0
+fi
+say "У автора $new_commits новых коммитов — переношу наши правки на свежий код"
+git --no-pager log --oneline "$BRANCH..upstream" | sed 's/^/    /'
+
+# ---------------------------------------------------------------- перенос и проверки
+
+# Скрипт форка делает перенос (rebase на ветку автора) и все проверки: швы, синтаксис, LF, тесты.
+# Без --apply: швы в нашей ветке уже накатаны, повторный накат на такое дерево падает (якоря автора
+# заменены нашими строками). Номер версии поднимаем сами — по той же логике, что и в fork-sync.sh.
+if ! bash tools/fork-sync.sh; then
+  die "перенос не прошёл (конфликт в местах наших правок). Ветка $BRANCH не изменена. Разберите вручную на рабочей станции"
+fi
+
+# Номер версии: у автора 1.3 → наш 1.3.1; если база та же, а мы дорабатываем — 1.3.2. Обязан расти.
+base=${author_version%%.*}
+cur=$(tr -d '[:space:]' <VERSION)
+if [[ ${cur%%.*} == "$base" ]]; then
+  new_version="$base.$(( ${cur##*.} + 1 ))"
+else
+  new_version="${author_version}.1"
+fi
+printf '%s\n' "$new_version" >VERSION
+for f in scripts/kit.sh scripts/3x-ui.sh scripts/hysteria2.sh scripts/3x-ui-local.sh; do
+  sed -i "s/^KIT_VERSION=\"[0-9.]*\"/KIT_VERSION=\"$new_version\"/" "$f"
+done
+"$PY" tools/fork_apply.py >/dev/null 2>&1 || true     # на дереве со швами это ожидаемо: якорей уже нет
+echo "  версия сборки: $cur → $new_version"
+
+# Заглушка записи в нашем журнале версий: без раздела «## v<версия>» сборщик релиза откажется
+# подписывать. Текст — на владельца, он правит его перед выпуском.
+if ! grep -q "^## v$new_version" FORK-CHANGELOG.md; then
+  say "Добавляю запись в FORK-CHANGELOG для версии $new_version"
+  "$PY" - "$new_version" "$author_version" <<'PY'
+import sys, pathlib
+new, author = sys.argv[1], sys.argv[2]
+p = pathlib.Path("FORK-CHANGELOG.md")
+text = p.read_text(encoding="utf-8")
+block = (f"## v{new}: обновление от автора {author}\n\n"
+         f"* Автоматическая синхронизация подтянула код автора {author} в нашу сборку: наши правки (швы)\n"
+         f"  перенесены на свежий код, проверки прошли. Описать, что изменилось у автора, до выпуска релиза.\n\n")
+marker = "## v"
+i = text.find(marker)
+p.write_text(text[:i] + block + text[i:], encoding="utf-8", newline="\n")
+print(f"  ✓ раздел «## v{new}» добавлен")
+PY
+fi
+
+# Финальный контроль: швы на месте, синтаксис и LF — как того требует сборщик релиза.
+"$PY" tools/fork_apply.py --check >/dev/null || die "после переноса швы не проверяются — ничего не публикую"
+for f in scripts/*.sh tools/*.sh; do bash -n "$f" || die "$f: синтаксис"; done
+if grep -qU $'\r' scripts/*.sh tools/*.sh VERSION 2>/dev/null; then
+  die "в файлах CRLF — сервер сверяет SHA256, сумма не сойдётся. Ничего не публикую"
+fi
+ok "швы на месте, синтаксис и переводы строк в порядке"
+
+# ---------------------------------------------------------------- публикация
+
+if git diff --quiet origin/"$BRANCH" -- VERSION scripts tools .gitea 2>/dev/null && [[ $new_version == "$ours" ]]; then
+  say "Содержимое не изменилось — публиковать нечего"
+  exit 0
+fi
+
+say "Публикую в $BRANCH"
+git add -A
+git -c user.name="fork-sync-bot" -c user.email="fork-sync@rukavishnikoff.ru" \
+  commit -q -m "Синхронизация с автором ${author_version}: швы и версия ${new_version}" \
+  -m "Автоматика CT 114. Проверки: швы на месте, bash -n, LF. Релиз и подпись — вручную с рабочей станции." \
+  || die "не смог закоммитить"
+curl -fsS -o /dev/null -H "Authorization: token ${TOKEN}" \
+  "${GITEA_URL}/api/v1/repos/${REPO}/branches/${BRANCH}" || die "Gitea недоступна перед отправкой"
+# Перенос идёт rebase'ом: наша ветка переписывается на свежий код автора, поэтому отправляем
+# с --force-with-lease — если за это время в ветку что-то попало с рабочей станции, отправка
+# откажется, а не затрёт чужой коммит.
+git push -q --force-with-lease=refs/heads/"$BRANCH" origin "$BRANCH" \
+  || die "не смог отправить ветку $BRANCH (возможно, в ней есть ваши свежие коммиты — тогда синхронизируйте вручную)"
+ok "ветка $BRANCH обновлена: $(git --no-pager log --oneline -1)"
+
+cat <<EOF
+
+Готово. Дальше вручную, с рабочей станции:
+  1) git fetch origin && git checkout $BRANCH && git reset --hard origin/$BRANCH
+  2) описать изменения в FORK-CHANGELOG.md (раздел уже добавлен)
+  3) bash tools/release.sh ~/.ssh/3x-ui-kit-fork/release_key   — подпись и релиз
+  4) git tag v$new_version && git push origin $BRANCH v$new_version
+EOF

tools/fork-sync.sh

@@ -0,0 +1,93 @@
+#!/usr/bin/env bash
+# 3X-UI_KIT (форк hacker07): подтянуть обновление автора в ветку dev и прогнать проверки.
+#
+# Ничего не публикует и ничего не обновляет на серверах: после проверок печатает, что делать
+# дальше (версия, подпись, тег, push). Запускать с рабочей станции, по шагам.
+#
+#   bash tools/fork-sync.sh              # подтянуть автора и проверить
+#   bash tools/fork-sync.sh --apply      # ещё и вписать VERSION/KIT_VERSION (номер версии)
+#
+# Логика версии: у автора 1.3 → наш номер 1.3.1; если база та же, а мы что-то доработали —
+# 1.3.2. Номер обязан строго расти: kit у серверов не принимает откат назад.
+set -Eeuo pipefail
+
+cd "$(dirname "${BASH_SOURCE[0]}")/.."
+
+PY=${PY:-$(command -v python3 || command -v python || true)}
+[[ -n $PY ]] || { echo "!  нужен python3" >&2; exit 1; }
+
+apply=no
+case ${1:-} in --apply) apply=yes ;; "") ;; *) echo "Использование: bash tools/fork-sync.sh [--apply]" >&2; exit 1 ;; esac
+
+say() { printf '\n\033[1m==> %s\033[0m\n' "$*"; }
+die() { printf '!  %s\n' "$*" >&2; exit 1; }
+
+[[ -z $(git status --porcelain) ]] || die "в рабочей копии есть незакоммиченные правки — сначала закоммить или убери их"
+
+say "Забираю ветку автора"
+git fetch --prune upstream 'refs/heads/main:refs/heads/upstream'
+author_version=$(git show upstream:VERSION | tr -d '[:space:]')
+echo "у автора: $author_version"
+
+say "Переношу наши правки на свежую ветку автора"
+git checkout -q dev
+if ! git rebase upstream; then
+  echo
+  echo "Конфликт при переносе. Это ожидаемо, если автор переписал те же строки."
+  echo "  1) разбери конфликт: git status, правь файлы, git add, git rebase --continue"
+  echo "  2) если проще собрать швы заново: git rebase --abort, затем"
+  echo "     git checkout -B dev upstream && $PY tools/fork_apply.py && git commit -am 'fork: швы'"
+  die "остановился, ничего не публикую"
+fi
+
+say "Проверяю, что наши швы ещё на месте"
+"$PY" tools/fork_apply.py --check
+
+say "Проверки кода (как на стороне сервера и в CI автора)"
+for f in scripts/*.sh tools/*.sh; do bash -n "$f" || die "$f: синтаксис"; done
+echo "  ✓ bash -n"
+"$PY" -m py_compile scripts/kit-sub.py && echo "  ✓ python-скрипты собираются"
+if grep -qU $'\r' scripts/*.sh tools/*.sh VERSION 2>/dev/null; then
+  die "в файлах есть CRLF — сервер сверяет SHA256, и его сумма не сойдётся. Проверь core.autocrlf (нужен false)"
+fi
+echo "  ✓ переводы строк LF"
+if command -v shellcheck >/dev/null; then
+  shellcheck -S warning -e SC1090,SC2034,SC2211 scripts/*.sh tools/release.sh tools/fork-sync.sh && echo "  ✓ shellcheck"
+else
+  echo "  – shellcheck не установлен, пропускаю"
+fi
+if command -v node >/dev/null; then
+  node --test tools/test/*.test.js >/dev/null && echo "  ✓ node --test"
+else
+  echo "  – node нет, пропускаю тесты генераторов"
+fi
+"$PY" tools/test/restore_env_test.py >/dev/null && "$PY" tools/test/restore_archive_test.py >/dev/null \
+  && echo "  ✓ тесты копии (--restore)"
+
+say "Готово: наши правки лежат на свежем коде автора"
+git --no-pager log --oneline upstream..dev
+echo
+echo "Версия автора: $author_version · наша сейчас: $(tr -d '[:space:]' <VERSION)"
+
+if [[ $apply == yes ]]; then
+  base=${author_version%%.*}
+  cur=$(tr -d '[:space:]' <VERSION)
+  if [[ ${cur%%.*} == "$base" ]]; then
+    new="$base.$(( ${cur##*.} + 1 ))"
+  else
+    new="$author_version.1"
+  fi
+  printf '%s\n' "$new" >VERSION
+  "$PY" tools/fork_apply.py >/dev/null
+  echo "Версия сборки → $new (VERSION и KIT_VERSION в трёх скриптах)"
+fi
+
+cat <<'NEXT'
+
+Дальше вручную, по шагам:
+  1) подпись и релиз:   bash tools/release.sh ~/.ssh/3x-ui-kit-fork/release_key
+  2) коммит и тег:      git add -A && git commit -m "Релиз v$(cat VERSION): швы форка + подпись"
+                        git tag v$(cat VERSION)
+  3) публикация:        git push origin dev v$(cat VERSION) upstream
+  4) на сервере:        kit update --force && kit check
+NEXT

tools/fork_apply.py

@@ -0,0 +1,345 @@
+#!/usr/bin/env python3
+"""3X-UI_KIT (форк hacker07): накатывает наши «швы» на чистый код автора.
+
+Это источник правды для форка: единственное место, где описано, ЧТО именно мы правим в
+файлах автора. Всё, что мы дописываем по существу, живёт в scripts/kit-local.sh — файле,
+который автор не трогает, поэтому обновления автора его не ломают.
+
+Правила:
+  * каждый якорь обязан найтись РОВНО один раз, иначе — стоп (автор изменил код, правку
+    надо пересмотреть руками);
+  * при любой ошибке ничего не пишется наполовину: сначала прогоняй --check;
+  * открытый ключ подписи берётся из tools/fork-signer.pub (закрытая часть — только на
+    рабочей станции владельца, в репозиторий не попадает).
+
+Использование:
+    python3 tools/fork_apply.py --check [корень-репозитория]
+    python3 tools/fork_apply.py         [корень-репозитория]
+"""
+
+import os
+import pathlib
+import re
+import sys
+
+GITEA = os.environ.get("FORK_GITEA_BASE", "https://git.rukavishnikoff.ru/hacker07/3X-UI_autoVPS")
+SIGNER_FILE = os.environ.get("FORK_SIGNER_PUB", "tools/fork-signer.pub")
+
+# README.md форка — НАШ файл целиком: авторское описание из него убрано, чтобы никто не
+# ставил сервер авторской командой и не оказался на авторском канале обновлений. Шва здесь нет:
+# при обновлении из авторского проекта README конфликтует и решается в нашу пользу (см. FORK.md).
+HOOK = """
+# --- 3X-UI_KIT (форк hacker07): локальные команды и хуки ---
+# Подключаем scripts/kit-local.sh, если он установлен. Наш файл: правки автора его не касаются.
+# Все команды форка — под «kit local …» (см. kit local help).
+KIT_LOCAL_LIB="${KIT_LOCAL_LIB:-/usr/local/lib/kit/kit-local.sh}"
+if [[ -r $KIT_LOCAL_LIB ]]; then . "$KIT_LOCAL_LIB"; kit_local_dispatch "$@"; fi
+"""
+
+
+def die(msg):
+    print("!  " + msg, file=sys.stderr)
+    sys.exit(1)
+
+
+def ok(msg):
+    print("==> " + msg)
+
+
+def count(text, anchor, regex):
+    if regex:
+        return len(re.findall(anchor, text, re.MULTILINE))
+    return text.count(anchor)
+
+
+def main():
+    args = [a for a in sys.argv[1:]]
+    check = False
+    if "--check" in args:
+        check = True
+        args.remove("--check")
+    root = pathlib.Path(args[0] if args else ".").resolve()
+    if not (root / "VERSION").exists():
+        die("%s не похож на репозиторий 3X-UI_autoVPS (нет VERSION)" % root)
+    os.chdir(root)
+
+    version = (root / "VERSION").read_text(encoding="utf-8").strip()
+    if not re.fullmatch(r"[0-9]+(\.[0-9]+)+", version):
+        die("VERSION=%r: нужен числовой номер вида 1.2.1" % version)
+
+    signer_path = pathlib.Path(SIGNER_FILE)
+    if not signer_path.exists():
+        die(
+            "нет %s — сначала создай ключ подписи:\n"
+            "     ssh-keygen -t ed25519 -C \"3X-UI KIT fork releases\" -f ~/.ssh/3x-ui-kit-fork/release_key\n"
+            "     mkdir -p tools && ssh-keygen -y -f ~/.ssh/3x-ui-kit-fork/release_key > tools/fork-signer.pub"
+            % SIGNER_FILE
+        )
+    pub = ""
+    for line in signer_path.read_text(encoding="utf-8").splitlines():
+        line = line.strip()
+        if line.startswith(("ssh-ed25519 ", "ssh-rsa ")):
+            pub = line
+            break
+    if not pub:
+        die("%s: не нашёл строку открытого ключа (ssh-ed25519 …)" % signer_path)
+
+    version_re = r'^KIT_VERSION="[0-9.]+"$'
+    edits = [
+        # --- scripts/kit.sh -------------------------------------------------
+        ("scripts/kit.sh", version_re, True, 'KIT_VERSION="%s"' % version, "версия сборки форка"),
+        (
+            "scripts/kit.sh",
+            'KIT_RAW="https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/main"',
+            False,
+            'KIT_RAW="%s/raw/branch/main"' % GITEA,
+            "источник VERSION и подсказки об обновлении",
+        ),
+        (
+            "scripts/kit.sh",
+            'kit_ref_raw() { echo "https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/v$1"; }',
+            False,
+            'kit_ref_raw() { echo "%s/raw/tag/v$1"; }' % GITEA + "\n" + HOOK,
+            "файлы релиза из нашего тега + подключение kit-local.sh",
+        ),
+        (
+            "scripts/kit.sh",
+            r'  # SHA256:[^\n]*\n  "ssh-ed25519 [^\n]*"\n',
+            True,
+            '  # Ключ подписи форка (владелец: hacker07). Закрытая часть — только на рабочей станции.\n'
+            '  "%s"\n' % pub,
+            "ключ проверки подписи релизов",
+        ),
+        (
+            "scripts/kit.sh",
+            "for f in scripts/kit.sh scripts/kit-sub.py; do",
+            False,
+            "for f in scripts/kit.sh scripts/kit-sub.py scripts/kit-local.sh; do",
+            "наш файл в списке проверяемых и скачиваемых",
+        ),
+        (
+            "scripts/kit.sh",
+            '  install -m 755 "$tmp/kit.sh" /usr/local/bin/kit.new && mv -f /usr/local/bin/kit.new /usr/local/bin/kit',
+            False,
+            '  install -m 755 "$tmp/kit.sh" /usr/local/bin/kit.new && mv -f /usr/local/bin/kit.new /usr/local/bin/kit\n'
+            "  # Форк: ставим наши локальные дополнения из того же подписанного релиза.\n"
+            "  install -d -m 755 /usr/local/lib/kit\n"
+            '  install -m 644 "$tmp/kit-local.sh" /usr/local/lib/kit/kit-local.sh',
+            "установка kit-local.sh при обновлении",
+        ),
+        # --- scripts/3x-ui.sh -----------------------------------------------
+        ("scripts/3x-ui.sh", version_re, True, 'KIT_VERSION="%s"' % version, "версия сборки форка"),
+        (
+            "scripts/3x-ui.sh",
+            'KIT_RAW="https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/v$KIT_VERSION"',
+            False,
+            'KIT_RAW="%s/raw/tag/v$KIT_VERSION"' % GITEA,
+            "запасная загрузка kit из нашего релиза",
+        ),
+        (
+            "scripts/3x-ui.sh",
+            'KIT_CLI_URL="$KIT_RAW/scripts/kit.sh"',
+            False,
+            'KIT_CLI_URL="$KIT_RAW/scripts/kit.sh"\nKIT_LOCAL_URL="$KIT_RAW/scripts/kit-local.sh"',
+            "адрес нашего файла для установщика",
+        ),
+        (
+            "scripts/3x-ui.sh",
+            'KIT_INSTALL_CMD="bash <(curl -fsSL https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/main/scripts/3x-ui.sh)"',
+            False,
+            'KIT_INSTALL_CMD="bash <(curl -fsSL %s/raw/branch/main/scripts/3x-ui.sh)"' % GITEA,
+            "команда установки, которую показывает панель",
+        ),
+        (
+            "scripts/3x-ui.sh",
+            '  bash -n /usr/local/bin/kit || die "Команда kit скачалась повреждённой"',
+            False,
+            "  # Форк: ставим наши локальные дополнения (см. scripts/kit-local.sh).\n"
+            "  install -d -m 755 /usr/local/lib/kit\n"
+            '  if [[ -n $src && -f $d/kit-local.sh ]]; then\n'
+            '    install -m 644 "$d/kit-local.sh" /usr/local/lib/kit/kit-local.sh\n'
+            "  else\n"
+            '    curl -fsSL --retry 3 -o /usr/local/lib/kit/kit-local.sh "$KIT_LOCAL_URL" \\\n'
+            '      || warn "Локальные дополнения kit не скачались: kit local не будет работать"\n'
+            "  fi\n"
+            '  bash -n /usr/local/bin/kit || die "Команда kit скачалась повреждённой"',
+            "установка kit-local.sh установщиком",
+        ),
+        # --- scripts/hysteria2.sh -------------------------------------------
+        ("scripts/hysteria2.sh", version_re, True, 'KIT_VERSION="%s"' % version, "версия сборки форка"),
+        # --- tools/release.sh -----------------------------------------------
+        (
+            "tools/release.sh",
+            "FILES=(scripts/3x-ui.sh scripts/hysteria2.sh scripts/kit.sh scripts/kit-sub.py VERSION)",
+            False,
+            "FILES=(scripts/3x-ui.sh scripts/hysteria2.sh scripts/kit.sh scripts/kit-sub.py scripts/kit-local.sh scripts/3x-ui-local.sh VERSION)",
+            "наш файл в подписанном списке релиза",
+        ),
+        (
+            "tools/release.sh",
+            '{ echo "# 3X-UI KIT $v"; echo "# 3X-UI_autoVPS $v"; sha "${FILES[@]}"; } >SHA256SUMS',
+            False,
+            "{ echo \"# 3X-UI KIT $v\"; echo \"# 3X-UI_autoVPS $v\"; sha \"${FILES[@]}\" | awk '{ sub(/^\\*/, \"\", $2); print $1\"  \"$2 }'; } >SHA256SUMS",
+            "суммы в POSIX-виде без звёздочки (на Windows sha256sum её ставит, и kit её не понимает)",
+        ),
+        # --- свои записи о версии (наш файл, авторский CHANGELOG не трогаем) ----
+        (
+            "tools/release.sh",
+            'grep -q "^## v$v" CHANGELOG.md || die "В CHANGELOG.md нет раздела ## v$v"',
+            False,
+            '(grep -q "^## v$v" CHANGELOG.md || grep -q "^## v$v" FORK-CHANGELOG.md)'
+            ' || die "Нет раздела ## v$v ни в CHANGELOG.md, ни в FORK-CHANGELOG.md (форк ведёт свои записи в FORK-CHANGELOG.md)"',
+            "раздел версии форка — в нашем файле",
+        ),
+        (
+            "tools/release.sh",
+            '[[ -z $(git status --porcelain -- "${FILES[@]}" CHANGELOG.md) ]]',
+            False,
+            '[[ -z $(git status --porcelain -- "${FILES[@]}" CHANGELOG.md FORK-CHANGELOG.md) ]]',
+            "наш файл записей тоже должен быть закоммичен",
+        ),
+        (
+            "scripts/kit.sh",
+            '  curl -fsS -m 5 "$KIT_RAW/CHANGELOG.md" 2>/dev/null | awk -v v="## v$1" \'',
+            False,
+            '  { curl -fsS -m 5 "$KIT_RAW/CHANGELOG.md" 2>/dev/null; curl -fsS -m 5 "$KIT_RAW/FORK-CHANGELOG.md" 2>/dev/null; } | awk -v v="## v$1" \'',
+            "«что нового» ищет и в наших записях",
+        ),
+        (
+            "scripts/3x-ui.sh",
+            "  _ _                   _   _          _          _      _\n (_) |_ ___ _ __   ___ | |_| | ___   _| |__  _ __(_) ___| | __\n | | __/ __| '_ \\ / _ \\| __| |/ / | | | '_ \\| '__| |/ __| |/ /\n | | |_\\__ \\ | | | (_) | |_|   <| |_| | |_) | |  | | (__|   <\n |_|\\__|___/_| |_|\\___/ \\__|_|\\_\\\\__,_|_.__/|_|  |_|\\___|_|\\_\\",
+            False,
+            "   _   _            _                ___ _____\n  | | | | __ _  ___| | _____ _ __   / _ \\___  |\n  | |_| |/ _` |/ __| |/ / _ \\ '__| | | | | / /\n  |  _  | (_| | (__|   <  __/ |    | |_| |/ /\n  |_| |_|\\__,_|\\___|_|\\_\\___|_|     \\___//_/",
+            "баннер сервера: наша надпись вместо авторской",
+        ),
+        (
+            "scripts/3x-ui.sh",
+            '  echo "${B}3X-UI KIT $KIT_VERSION${N}  ·  it\'s not Kubrick. it\'s just a VPN."',
+            False,
+            '  echo "${B}3X-UI_autoVPS $KIT_VERSION${N}  ·  сборка форка: панель 3X-UI и VPN-протоколы на одном порту"',
+            "подпись под баннером: наше имя сборки",
+        ),
+        (
+            "scripts/kit.sh",
+            '  grep -qx "# 3X-UI KIT $v" "$d/SHA256SUMS"',
+            False,
+            '  grep -qxE "# (3X-UI KIT|3X-UI_autoVPS) $v" "$d/SHA256SUMS"',
+            "проверка шапки подписанного релиза принимает и старое, и новое имя",
+        ),
+        (
+            'scripts/kit.sh',
+            '      "7. Резервная копия" "8. Версии" "" "9. Панель 3X-UI (меню x-ui)" "0. Выход"',
+            False,
+            '      "7. Резервная копия" "8. Версии" "" "9. Панель 3X-UI (меню x-ui)" "0. Выход"\n      "10. Удалить всё установленное (наш пункт)"',
+            'пункт меню: снос установки',
+        ),
+        (
+            'scripts/kit.sh',
+            '      9) command -v x-ui >/dev/null && x-ui || echo "Меню x-ui не найдено." ;;',
+            False,
+            '      9) command -v x-ui >/dev/null && x-ui || echo "Меню x-ui не найдено." ;;\n      10) kit_local_uninstall ;;',
+            'пункт меню: снос установки (обработчик)',
+        ),
+        (
+            "scripts/kit.sh",
+            'ask_num "Выбор [0-9]: "',
+            False,
+            'ask_num "Выбор [0-9, 10]: "',
+            "подсказка выбора в меню учитывает новый пункт",
+        ),
+    ]
+
+    bad = 0
+    for path, anchor, is_re, new, why in edits:
+        p = pathlib.Path(path)
+        if not p.exists():
+            print("✗ %s: файла нет" % path)
+            bad += 1
+            continue
+        text = p.read_text(encoding="utf-8", newline="")
+        if check:
+            # --check смотрит на готовое дерево dev: наш шов обязан быть на месте и ровно один раз
+            n = text.count(new)
+            what, shown = "наш шов", new
+        else:
+            # применение — только на чистое дерево автора: якорь обязан найтись ровно один раз
+            n = count(text, anchor, is_re)
+            what, shown = "якорь автора", anchor
+        short = shown if len(shown) <= 54 else shown[:51] + "…"
+        short = short.replace("\n", "⏎")
+        if n != 1:
+            print("✗ %-20s %-56s %s найден %d раз (%s)" % (path, short, what, n, why))
+            bad += 1
+            continue
+        if check:
+            print("✓ %-20s %-56s (%s)" % (path, short, why))
+            continue
+        if is_re:
+            text = re.sub(anchor, new, text, count=1, flags=re.MULTILINE)
+        else:
+            text = text.replace(anchor, new, 1)
+        p.write_text(text, encoding="utf-8", newline="")
+        print("✓ %-20s %-56s (%s)" % (path, short, why))
+
+
+    # Массовая замена бренда в файлах автора: строки, которые видит человек (справка, версия,
+    # описания служб, баннер). Строку проверки шапки SHA256SUMS не трогаем — её правит отдельный шов,
+    # а сама шапка ещё один релиз пишется в старом виде (иначе уже установленные серверы откажутся
+    # принимать обновление: они сверяют точный вид строки).
+    globals_ = [
+        ("scripts/kit.sh", "3X-UI KIT", "3X-UI_autoVPS"),
+        ("scripts/3x-ui.sh", "3X-UI KIT", "3X-UI_autoVPS"),
+        ("scripts/hysteria2.sh", "3X-UI KIT", "3X-UI_autoVPS"),
+        ("scripts/kit-sub.py", "3X-UI KIT", "3X-UI_autoVPS"),
+    ]
+    for path, old, new in globals_:
+        p = pathlib.Path(path)
+        if not p.exists():
+            print("✗ %s: файла нет" % path)
+            bad += 1
+            continue
+        text = p.read_text(encoding="utf-8", newline="")
+        # строки, где старое имя — часть служебной сверки, не переименовываем
+        keep = lambda line: "grep -qx" in line
+        if check:
+            if new not in text:
+                print("✗ %-20s нет нашего имени «%s»" % (path, new))
+                bad += 1
+                continue
+            left = [l for l in text.splitlines() if old in l and not keep(l)]
+            if left:
+                print("✗ %-20s осталось старое имя в %d строк(ах)" % (path, len(left)))
+                bad += 1
+                continue
+            print("✓ %-20s бренд: %s" % (path, new))
+            continue
+        out = []
+        changed = 0
+        for line in text.splitlines(keepends=True):
+            if old in line and not keep(line):
+                out.append(line.replace(old, new))
+                changed += line.count(old)
+            else:
+                out.append(line)
+        if not changed:
+            if new in text:
+                print("– %-20s уже переименовано" % path)
+                continue
+            print("✗ %-20s не нашёл «%s»" % (path, old))
+            bad += 1
+            continue
+        p.write_text("".join(out), encoding="utf-8", newline="")
+        print("✓ %-20s переименовано вхождений: %d" % (path, changed))
+
+    if bad:
+        if check:
+            die("якорей не найдено: %d — автор изменил код, пересмотри правки в tools/fork_apply.py" % bad)
+        die("якорей не найдено: %d — правки не применены" % bad)
+    if check:
+        ok("все якоря на месте (версия сборки %s)" % version)
+    else:
+        ok("швы накатаны, версия сборки %s" % version)
+
+
+if __name__ == "__main__":
+    main()

tools/release.sh

@@ -1,11 +1,11 @@
 #!/usr/bin/env bash
-# Подпись релиза 3X-UI KIT. Запускает только автор, на своём компьютере, перед тегом:
+# Подпись релиза 3X-UI_autoVPS. Запускает только автор, на своём компьютере, перед тегом:
 #
 #   tools/release.sh [~/.ssh/3xui_kit_release]
 #
 # Проверяет, что версии сходятся и установщик 3X-UI не подменили, пишет SHA256SUMS,
 # подписывает его закрытым ключом (ssh-keygen спросит пароль ключа) и сразу проверяет
-# подпись открытым ключом, записанным в kit. Сервер 3X-UI KIT ставит обновление, только
+# подпись открытым ключом, записанным в kit. Сервер 3X-UI_autoVPS ставит обновление, только
 # если эта проверка у него тоже сошлась. Закрытый ключ никуда не отправляется.
 
 set -euo pipefail
@@ -16,20 +16,30 @@ ok()  { printf '✓  %s\n' "$*"; }
 sha() { if command -v sha256sum >/dev/null; then sha256sum "$@"; else shasum -a 256 "$@"; fi; }
 
 key=${1:-$HOME/.ssh/3xui_kit_release}
-[[ -f $key ]] || die "Нет закрытого ключа $key. Создать: ssh-keygen -t ed25519 -C \"3X-UI KIT releases\" -f $key"
+[[ -f $key ]] || die "Нет закрытого ключа $key. Создать: ssh-keygen -t ed25519 -C \"3X-UI_autoVPS releases\" -f $key"
 NS="3x-ui-kit-release"
 ID="releases@3x-ui-kit"
-FILES=(scripts/3x-ui.sh scripts/hysteria2.sh scripts/kit.sh scripts/kit-sub.py VERSION)
+FILES=(scripts/3x-ui.sh scripts/hysteria2.sh scripts/kit.sh scripts/kit-sub.py scripts/kit-local.sh scripts/3x-ui-local.sh VERSION)
 
 v=$(tr -d '[:space:]' <VERSION)
 [[ $v =~ ^[0-9]+(\.[0-9]+)+$ ]] || die "VERSION: $v"
 for f in scripts/3x-ui.sh scripts/hysteria2.sh scripts/kit.sh; do
   grep -qx "KIT_VERSION=\"$v\"" "$f" || die "$f: KIT_VERSION не $v"
 done
-grep -q "^## v$v" CHANGELOG.md || die "В CHANGELOG.md нет раздела ## v$v"
+(grep -q "^## v$v" CHANGELOG.md || grep -q "^## v$v" FORK-CHANGELOG.md) || die "Нет раздела ## v$v ни в CHANGELOG.md, ни в FORK-CHANGELOG.md (форк ведёт свои записи в FORK-CHANGELOG.md)"
 ok "Версия $v во всех скриптах и в CHANGELOG"
 
-[[ -z $(git status --porcelain -- "${FILES[@]}" CHANGELOG.md) ]] || die "Есть незакоммиченные изменения в файлах релиза – сначала коммит."
+# Переводы строк. Сервер получает файл из git (там LF), а суммы считаются по рабочей копии:
+# если в рабочей копии окажутся CR, суммы не сойдутся и kit update откажется ставить релиз.
+for f in "${FILES[@]}"; do
+  [[ -z $(tr -cd "\r" <"$f") ]] || die "$f: переводы строк Windows (CR). Уберите: tr -d '\r' < \"$f\" > \"$f.lf\" && mv \"$f.lf\" \"$f\""
+done
+ok "Переводы строк во всех файлах релиза — LF"
+
+export PY
+bash tools/check-help.sh || die "справка kit help отстала от набора команд"
+
+[[ -z $(git status --porcelain -- "${FILES[@]}" CHANGELOG.md FORK-CHANGELOG.md) ]] || die "Есть незакоммиченные изменения в файлах релиза – сначала коммит."
 
 # Установщик 3X-UI: хеш в скрипте должен совпадать с тем, что сейчас лежит на GitHub.
 xv=$(sed -n 's/^XUI_VERSION="\(.*\)"/\1/p' scripts/3x-ui.sh)
@@ -70,7 +80,7 @@ pub=$(ssh-keygen -y -f "$key" | awk '{print $1, $2}')
 signers scripts/kit.sh | awk '{print $1, $2}' | grep -qxF "$pub" || die "Ключа $key нет в KIT_SIGNERS – серверы не примут такую подпись."
 ok "Ключ подписи записан в kit"
 
-{ echo "# 3X-UI KIT $v"; sha "${FILES[@]}"; } >SHA256SUMS
+{ echo "# 3X-UI KIT $v"; echo "# 3X-UI_autoVPS $v"; sha "${FILES[@]}" | awk '{ sub(/^\*/, "", $2); print $1"  "$2 }'; } >SHA256SUMS
 rm -f SHA256SUMS.sig
 ssh-keygen -Y sign -f "$key" -n "$NS" SHA256SUMS >/dev/null
 tmp=$(mktemp)

tools/test/restore_archive_test.py

@@ -113,7 +113,7 @@ class RestoreEnv(unittest.TestCase):
     def bad(self, over):
         r = restore_env(over)
         self.assertNotIn("ENV-OK", r.stdout)
-        self.assertIn("Это не резервная копия 3X-UI KIT", r.stdout + r.stderr)
+        self.assertIn("Это не резервная копия 3X-UI_autoVPS", r.stdout + r.stderr)
 
     def test_mtproto_inner_sed(self):
         for v in (b"MTPROTO_INNER='[0-9]*.*/touch \\/tmp\\/pwn-test/e;#'", b"MTPROTO_INNER='1/x/;1e touch /tmp/pwn-test #'", b"MTPROTO_INNER=1/x/e"):
@@ -148,7 +148,7 @@ class RestoreEnv(unittest.TestCase):
             self.assertIn("байты " + name, check(p).stderr)
 
     def test_3xui_txt(self):
-        good = "3X-UI KIT – данные для входа\n\nПанель:  https://1.2.3.4/x/\n\tvless://a@1.2.3.4:443?x=1#Мой 🙂\n".encode()
+        good = "3X-UI_autoVPS – данные для входа\n\nПанель:  https://1.2.3.4/x/\n\tvless://a@1.2.3.4:443?x=1#Мой 🙂\n".encode()
         r = check(archive([(k, v) for k, v in ENVS.items()] + [("root/3x-ui.txt", good)]))
         self.assertEqual(r.returncode, 0, r.stderr)
         for bad in (b"\0", b"\x1b]0;x\x07", b"\x1b[2J", b"\r", b"\xff", b"\xc2\x9b", b"\x7f"):

tools/test/restore_env_test.py

@@ -102,7 +102,7 @@ class SafeEnv(unittest.TestCase):
     def rejected(self, name, text):
         code, out = run(name, text, 'echo "RESULT=$RESULT"\n')
         self.assertNotEqual(code, 0, out)
-        self.assertIn("Это не резервная копия 3X-UI KIT", out)
+        self.assertIn("Это не резервная копия 3X-UI_autoVPS", out)
         self.assertNotIn("\nOK\n", "\n" + out)
 
     def test_result_in_backup_env(self):
@@ -148,7 +148,7 @@ class SafeEnv(unittest.TestCase):
         r = subprocess.run(["bash", "-c", script, "t", p], capture_output=True)
         out = (r.stdout + r.stderr).decode("utf-8", "replace")
         self.assertNotEqual(r.returncode, 0, "%s %r: %s" % (name, data, out))
-        self.assertIn("Это не резервная копия 3X-UI KIT", out, "%s %r" % (name, data))
+        self.assertIn("Это не резервная копия 3X-UI_autoVPS", out, "%s %r" % (name, data))
         self.assertNotIn("\nOK\n", "\n" + out)
 
     def test_substitutions(self):

tools/test/rules_test.py

@@ -128,7 +128,7 @@ class Rules(unittest.TestCase):
         link = ks.routing_payload("happ", loaded)
         self.assertTrue(link.startswith("happ://routing/onadd/"))
         h = json.loads(base64.b64decode(link.split("/onadd/")[1]))
-        self.assertEqual(h["Name"], "3X-UI KIT")
+        self.assertEqual(h["Name"], "3X-UI_autoVPS")
         self.assertEqual(h["GlobalProxy"], "false")
         self.assertEqual(h["ProxySites"], ["geosite:youtube", "domain:example.org", "full:api.example.com"])
         self.assertEqual(h["ProxyIp"], ["geoip:telegram", "203.0.113.0/24"])