Claude
0a19858efa
- 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
149 lines
9.1 KiB
Markdown
149 lines
9.1 KiB
Markdown
<div align="center">
|
||
|
||
<img alt="3X-UI KIT" src="manuals/assets/banner.svg" width="820">
|
||
|
||
**Свой VPN-сервер одной командой: 11 протоколов, один порт 443, одна подписка на всё**
|
||
|
||
[](manuals/3x-ui.md#протоколы)
|
||
[](https://github.com/MHSanaei/3x-ui)
|
||
[](https://github.com/itsnotkubrick/3X-UI_KIT/commits)
|
||
|
||
[Возможности](#возможности) · [Установка](#установка) · [Генераторы](#генераторы-конфигов-для-xkeen) · [Полезное](#полезное) · [Поддержать](#поддержать-проект)
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
> [!TIP]
|
||
> **Вышла версия 1.1:** исправления по аудиту безопасности, автообновление только подписанных
|
||
> релизов, резервная копия и переезд. [Что нового](CHANGELOG.md) · сервер на 1.0 обновляется
|
||
> одной командой:
|
||
> ```bash
|
||
> curl -fsSL https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/v1.1/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 протоколов сразу** – VLESS REALITY, XHTTP, WebSocket, Trojan gRPC, VMess,
|
||
Shadowsocks 2022, Hysteria2, TUIC, AmneziaWG (классика и 3.1) и MTProto для Telegram.
|
||
- 🚪 **Всё TCP – через порт 443.** Панель, подписка и протоколы спрятаны за одним портом,
|
||
а на случайный заход сервер показывает обычный сайт.
|
||
- 🔗 **Одна подписка на все приложения.** Hiddify, Happ, v2rayN, Karing, Clash Verge и FlClash
|
||
получают свой формат и только те протоколы, которые умеют.
|
||
- 👥 **Дополнительные пользователи одной командой** – `kit user add` добавляет пользователя
|
||
сразу во все протоколы с общим лимитом трафика, сроком и числом устройств.
|
||
- 🔄 **Обновляется сам, но только подписанными релизами**, а `kit backup` переносит сервер
|
||
на новый VPS вместе с пользователями и ключами.
|
||
- 🔒 **Сертификат Let's Encrypt на IP** выпускается и продлевается сам, панель скрыта на
|
||
случайном пути со случайными логином и паролем.
|
||
- ✅ **Проверено настоящими клиентами** – каждый протокол на ядрах Xray, Mihomo и sing-box,
|
||
в том числе с сервером в России: [tests/matrix](tests/matrix/).
|
||
|
||
## Что понадобится
|
||
|
||
- VPS с **Ubuntu 22.04/24.04** или **Debian 12/13** и доступом root по SSH
|
||
- Свободные порты **443** и **80** – на свежем сервере они свободны
|
||
|
||
## Установка
|
||
|
||
Подключитесь к серверу по SSH и выполните:
|
||
|
||
```bash
|
||
bash <(curl -fsSL https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/main/scripts/3x-ui.sh)
|
||
```
|
||
|
||
Через пару минут скрипт покажет адрес панели, логин, пароль и подписку с QR-кодом.
|
||
|
||
<details>
|
||
<summary>🔍 Хотите сначала посмотреть скрипт? Установка с проверкой</summary>
|
||
|
||
Скачайте скрипт конкретной версии, прочитайте его и сверьте SHA256 с файлом `SHA256SUMS`
|
||
из того же релиза. Этот файл подписан ключом автора, подпись тоже можно проверить:
|
||
|
||
```bash
|
||
v=1.1; raw=https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/v$v
|
||
curl -fsSLO $raw/scripts/3x-ui.sh -O $raw/SHA256SUMS -O $raw/SHA256SUMS.sig
|
||
less 3x-ui.sh
|
||
grep 3x-ui.sh SHA256SUMS && sha256sum 3x-ui.sh
|
||
bash 3x-ui.sh
|
||
```
|
||
|
||
<details>
|
||
<summary>Проверка подписи</summary>
|
||
|
||
Открытый ключ автора записан в [`scripts/kit.sh`](scripts/kit.sh) (`KIT_SIGNERS`). Сохраните его
|
||
строку в файл `allowed_signers` в виде `releases@3x-ui-kit namespaces="3x-ui-kit-release" ssh-ed25519 AAAA…`
|
||
и выполните:
|
||
|
||
```bash
|
||
ssh-keygen -Y verify -f allowed_signers -I releases@3x-ui-kit -n 3x-ui-kit-release -s SHA256SUMS.sig < SHA256SUMS
|
||
```
|
||
|
||
«Good signature» – файл подписан автором. Так же каждую ночь проверяет обновления ваш сервер.
|
||
|
||
</details>
|
||
|
||
Скрипт версии 1.1 скачивает свои части (`kit`, `kit-sub`) из того же релиза, а установщик
|
||
3X-UI сверяет по SHA256 и не запускает, если он изменился. Первый раз удобнее ставить на
|
||
свежий VPS без ваших данных.
|
||
|
||
</details>
|
||
|
||
Подробно – подключение приложений, дополнительные пользователи и параметры –
|
||
в **[инструкции](manuals/3x-ui.md)**. Нужен только Hysteria2 – есть
|
||
[отдельный скрипт](manuals/hysteria2.md).
|
||
|
||
> [!WARNING]
|
||
> Проект создан в образовательных целях. Убедитесь, что ваши действия
|
||
> соответствуют законодательству вашей страны.
|
||
|
||
## Генераторы конфигов для XKeen
|
||
|
||
Вставьте ссылку на сервер или подписку, отметьте нужные сервисы – и получите
|
||
готовый конфиг и одну команду, которая сама положит его на роутер.
|
||
Всё считается в браузере, ссылки никуда не отправляются.
|
||
Как поставить XKeen на роутер – в [инструкции для Keenetic](manuals/xkeen-keenetic.md).
|
||
|
||
| | Генератор | Что получится |
|
||
|---|---|---|
|
||
| ⚙️ | [Xray](https://itsnotkubrick.github.io/3X-UI_KIT/tools/xray/) | `04_outbounds.json` и `05_routing.json`: серверы, выбор сервисов, реклама, свои сайты |
|
||
| 🧩 | [Mihomo](https://itsnotkubrick.github.io/3X-UI_KIT/tools/mihomo/) | `config.yaml` с автовыбором сервера, подпиской, Hysteria2, AmneziaWG и веб-панелью |
|
||
|
||
## Полезное
|
||
|
||
- [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 | [CloudTips](https://pay.cloudtips.ru/p/d4f9e3d1) |
|
||
| Зарубежной картой, 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` |
|
||
|
||
## Благодарности
|
||
|
||
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)
|