- kit update ставит только релизы, у которых SHA256SUMS подписан ключом автора
(ssh-keygen -Y verify), версия внутри подписи совпадает, файлы сошлись с хешами;
откат на старую версию запрещён; после обновления проверяется подписка, иначе возврат
- автообновление: systemd-таймер раз в сутки ночью со случайной задержкой,
kit update --manual / --auto, журнал /var/log/kit-update.log
- hy2 update тоже проверяет подпись
- tools/release.sh: проверка версий и хеша установщика 3X-UI, SHA256SUMS и подпись
- kit backup и 3x-ui.sh --restore: архив 600, строгая проверка архива, конфиги nginx
и kit-sub собираются заново, смена IP в подключениях
- сайт-заглушка: случайный из шести шаблонов внутри скрипта
- zashboard закреплён на v3.29.1, короткие тире и 192.168.x.x в текстах и картинках
- CI: ключ подписи одинаковый в kit и hy2, проверка подписи релиза
- CHANGELOG, README, инструкция, SECURITY.md
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q7GrBSRPVXhrz3RAprWDnt
kit update скачивает kit и kit-sub из тега релиза, переводит kit-sub на работу
без root, убирает cron меню x-ui и исправляет ссылку подписки в панели.
При сбое новой kit-sub возвращает прежнюю.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q7GrBSRPVXhrz3RAprWDnt
- hysteria2.sh: строгая проверка --email/--host/--sni, install.env через printf %q,
SHA256 бинарника в самом скрипте, hy2 update из тега релиза
- 3x-ui.sh: SHA256 установщика 3X-UI, проверка --sni/--host, kit и kit-sub из тега,
kit-sub без root (DynamicUser + LoadCredential), без cron для меню x-ui
- VERSION, CHANGELOG, SECURITY.md, CI (ShellCheck, Python, тесты генераторов),
установка с проверкой в README
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q7GrBSRPVXhrz3RAprWDnt
Адрес панели без слеша nginx перенаправлял на https://IP:10446/… (внутренний порт) —
панель не открывалась. absolute_redirect off и адрес панели сразу со слешем.
- nginx stream на 443: по SNI — REALITY, XHTTP REALITY (свой сайт маскировки), MTProto
(свой FakeTLS-домен); остальное — HTTPS-сервер nginx
- HTTPS-сервер: VLESS WS, VMess WS, Trojan gRPC, подписка (kit-sub) и панель по секретным
путям, сайт-заглушка на всё прочее
- Подключения слушают только localhost, ссылки ведут на 443 через External Proxy 3X-UI;
настоящие IP клиентов доходят через proxy protocol (лимит устройств работает)
- Снаружи открыты только 443/tcp, 80, SSH, Shadowsocks и UDP-порты
- Режим для новых установок с доверенным сертификатом; --multi-port — прежняя схема;
старые многопортовые установки не переделываются автоматически
Проверено: Mihomo по подписке 10/10 у двух пользователей, официальный AmneziaWG,
матрица Xray/Mihomo/sing-box, панель и заглушка, пробы REALITY и MTProto без ключа.
- scripts/kit.sh (команда kit на сервере): user add/list/link/limit/off/on/del;
общие трафик, лимит, срок и число устройств на все протоколы
- Установщик создаёт подключения без клиентов и первого пользователя сразу во все,
имя подписки случайное (чужую подписку не угадать по имени)
- AmneziaWG: у записи 3X-UI одна пара ключей WireGuard, поэтому ко второму AmneziaWG
подключается запись-«двойник» с подпиской «-awg»; kit работает с обеими как с одной
- kit-sub фильтрует по содержимому: Clash-приложениям без AmneziaWG он вырезается,
приложениям со ссылками не отдаются vpn:// и tg://
Проверено: три пользователя — Mihomo по подписке 10/10 у каждого, официальный клиент
AmneziaWG — оба варианта у каждого; выключение, лимиты и удаление действуют на все записи.
Karing запрашивает формат Clash, но работает на sing-box и AmneziaWG не умеет —
на телефоне AmneziaWG вернулся с ошибкой. Теперь Karing, Hiddify, NekoBox, Happ, Stash
и похожие получают Clash-конфиг без AmneziaWG. В журнал kit-sub пишется User-Agent
и выбранный вариант (без IP) — чтобы видеть, чем представляются приложения.
- scripts/kit-sub.py — посредник на публичном порту подписки (HTTPS), 3X-UI только на 127.0.0.1
- Clash/Mihomo (Clash Verge, FlClash…) получают конфиг 3X-UI плюс AmneziaWG
- Happ, v2rayN, Karing, Hiddify — ссылки без AmneziaWG, которого они не умеют
- expire=0 убирается из Subscription-Userinfo — больше нет «01.01.1970»
- Сертификат перечитывается после продления Let's Encrypt, TLS в потоках, тайм-ауты
- Установщик ставит kit-sub сам (systemd, ограничения безопасности); адрес подписки не меняется
Проверено: Mihomo по итоговому Clash-конфигу — все 10 прокси, включая оба AmneziaWG;
обновление поверх существующей установки на сервере в России.
Проверено на телефоне (Karing, мобильный МТС): приложения на sing-box и Xray видят
AmneziaWG как обычный WireGuard и не подключаются. Теперь общая подписка содержит
только протоколы, которые понимают все приложения; AmneziaWG — в подписке «-awg»
(Clash Verge, FlClash), ссылки vpn:// для AmneziaVPN и tg:// для Telegram — в /root/3x-ui.txt.
- Повторный запуск: панель по HTTPS определяется сама
- Клиент с занятым именем (остался от удалённого подключения) получает уникальное имя
Установка командой из инструкции на чистый Ubuntu 24.04 в России:
- Let's Encrypt на IP выпускается, панель/подписка/TLS-протоколы на нём
- через интернет работают REALITY, Hysteria2, XHTTP, VLESS/VMess WS, Trojan gRPC,
Shadowsocks, TUIC и оба AmneziaWG (Mihomo, Xray, sing-box, официальный AmneziaWG)
- обычный WireGuard режет DPI (ответ сервера не доходит) — убран из набора по умолчанию
- хостер блокирует Telegram — установщик проверяет доступ и пропускает MTProto
- Баннер, заголовки, шапки генераторов и картинки без прежнего названия
- Все ссылки на установку, генераторы и репозиторий — на новый адрес
- hysteria2.sh: файл настроек install.env, старый pinkman.env переносится сам
- tools/xray: 04_outbounds.json и 05_routing.json — серверы, выбор сервисов
по геобазам XKeen (ZKeen, V2Fly, Re:filter), реклама, QUIC, свои сайты,
балансировщик для нескольких серверов
- tools/mihomo: config.yaml с портами XKeen, подпиской, Hysteria2,
автовыбором сервера и панелью zashboard
- Обе страницы выдают команду, которая пишет файлы на роутер и перезапускает XKeen
- Всё считается в браузере, ссылки не сохраняются и никуда не отправляются
- Корень сайта перенаправляет на репозиторий
Проверено: модульные тесты, xray -test и mihomo -t на всех сценариях,
команды — в busybox ash, живое подключение через REALITY и Hysteria2.
Xray 26.7.11 и новее не пропускает REALITY-клиентов на Mihomo и sing-box
(Hiddify, FlClash, Clash Verge, Mihomo в XKeen). 3X-UI 3.8.5 ставит 26.9.9,
поэтому скрипт переключает ядро на 26.6.27 — последнюю версию, с которой
работают все клиенты и которую принимает панель.
Сайты маскировки: убраны Microsoft и Apple — их не советует сам Xray.
- scripts/3x-ui.sh: официальная 3X-UI v3.8.5 её установщиком, сертификат
Let's Encrypt на IP для панели, подключение VLESS REALITY через API,
подбор сайта для маскировки, ufw, ссылка и QR-код
- scripts/hysteria2.sh: официальный Hysteria 2.12.3 с проверкой sha256,
Let's Encrypt или самоподписанный сертификат с pinSHA256, сайт-заглушка,
ufw, команда hy2 для управления пользователями
- Инструкции переписаны под скрипты, старые (x-ui-pro, Blitz) удалены
Проверено: сквозные тесты в контейнерах с systemd и подключение через
интернет к тестовому серверу (VLESS REALITY и Hysteria2).
- 3x-ui 2.9.4 (ставит x-ui-pro): Dest → Target, «Создать подключение»,
«Исходящие подключения», поле «Ссылка» для импорта vless://
- XKeen: политика должна называться xkeen, иначе проксируются все устройства
- Blitz: кнопка «+», QR-код в колонке Configs
- README: баннер, бейджи, таблица инструкций, требования, полезные ссылки
- Все скриншоты заменены на SVG-схемы без IP, ключей и UUID
- Каскад: скрипт x-ui-pro-nodomain.sh удалён автором, заменён на -auto_domain y
- XKeen: команда установки 2.0, токен для KeeneticOS 5.2+, ссылки на Entware
- Blitz: Web Panel теперь пункт 8, а не 9
- Сайт: .nojekyll (меню не грузилось), поиск, копирование кода, листание
