itsnotkubrick/3X-UI_KIT

Shell

435

160 commits

updated Oct 14, 2026

See the code

README

3X-UI KIT

Установка 3X-UI одной командой: 11 протоколов, один порт 443, одна подписка на всё

Версия Протоколов 3X-UI Звёзды Обновлено Поддержать


[!WARNING] Проект – набор скриптов с открытым кодом. Он не оказывает услуг связи и не предоставляет доступ к серверам. Вы ставите его на собственный сервер и сами отвечаете за соблюдение законодательства своей страны. Проект создан в образовательных целях.

[!TIP] Вышла версия 1.2.1: выбор протоколов при установке, полное удаление, меню вместо команд и исправления установки. Что нового

Сменился ключ подписи релизов, поэтому сервер на версии 1.2 и ниже сам не обновится. Один раз выполните на сервере эту команду, и дальше автообновление снова заработает:

curl -fsSL https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/v1.2.1/scripts/kit.sh -o /usr/local/bin/kit && chmod 755 /usr/local/bin/kit && kit update

Новая установка ничего не требует.

3X-UI KIT превращает чистый VPS в готовый VPN-сервер за несколько минут. Скрипт ставит официальную панель 3X-UI, настраивает все популярные протоколы, сертификат и файрвол и выдаёт одну ссылку-подписку. Её можно вставить в любое приложение – оно само получит подходящие ему протоколы. Домен не нужен.

Конец установки 3X-UI KIT

Возможности

  • 🧩 До 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) сервер поднимается из неё за несколько минут.
  • 🔄 Обновляется само, но только подписанными релизами.
  • 🩺 Проверка и починка сервера из меню kit.
  • 🧹 Полное удаление. Пункт «Удалить KIT с сервера» убирает панель, подписку, настройки и сертификаты, а ваш SSH и чужие сертификаты не трогает.

Что понадобится

  • VPS с Ubuntu 22.04/24.04 или Debian 12/13 и доступом root по SSH
  • Свободные порты 443 и 80 – на свежем сервере они свободны

Нужен VPS? Я сам использую IS Hosting и рекомендую его (реферальная ссылка).

Установка

Подключитесь к серверу по SSH и выполните одну команду на чистом VPS.

Панель 3X-UI, все протоколы на порту 443 и одна подписка на всё:

bash <(curl -fsSL https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/v1.2.1/scripts/3x-ui.sh)

Через пару минут скрипт покажет адрес панели, логин, пароль и подписку с QR-кодом. Подробно – подключение приложений, дополнительные пользователи и параметры – в инструкции.

Управление: меню kit

После установки на сервере появляется команда kit. Введите её без аргументов, и откроется меню, как у x-ui: выберите цифру, остальное спросит само. Запоминать команды не нужно, всё нужное внутри:

  • Пользователи, ссылки и подписки. Список, добавить пользователя, показать все ссылки на подключения одним экраном, изменить лимит, выключить или удалить.
  • Протоколы, порты и маскировка. Включить или выключить протокол, сменить сайт маскировки, порт, раздельную маршрутизацию, DNS.
  • Проверка сервера. Быстрая и глубокая: глубокая видит, виноват сервер или ваша сеть, и умеет исправить безопасное.
  • Обновить kit и подписку, резервная копия, версии.
  • Удалить KIT с сервера.

[!IMPORTANT] Обновляйте панель и ядро только через kit («Обновить kit и подписку»). Пункт обновления в меню x-ui ставит самую новую панель вместе с самым новым ядром Xray, на котором часть приложений (Karing, Hiddify и другие на sing-box) перестаёт подключаться. Если уже обновили через x-ui: kit → «Проверка сервера» → «Исправить безопасное» вернёт проверенное ядро.

Все команды (для скриптов и тех, кому так привычнее) и разбор «Если не подключается» – в инструкции.

VPN на роутере

Через прокси идут только нужные сервисы и выбранные устройства, остальное работает напрямую. Порядок: 1. установить программу на роутер → 2. собрать конфиг в генераторе → 3. вставить команду из генератора.

[!NOTE] На роутере работает XKeen автора jameszeroX, спасибо ему.

📶 Keenetic: XKeen (jameszeroX) · 8 шагов, 20–30 минут

Нужны роутер Keenetic или Netcraze с USB-портом, USB-флешка в формате ext4 и свой сервер с VLESS (например, из этой инструкции).

1. Компоненты KeeneticOS

В веб-интерфейсе: Управление → Общие настройки → Изменить набор компонентов. Отметьте компоненты с галочками на картинке и установите. Роутер обновится и перезагрузится.

Нужные компоненты KeeneticOS

2. Entware на флешку
  1. Отформатируйте флешку в ext4 и вставьте её в роутер.
  2. Откройте её по сети (\\192.168.x.x\), создайте папку install и положите туда установщик под процессор роутера: mipsel, mips или aarch64. Не знаете, какой нужен? Модель роутера – в характеристиках на сайте Keenetic.

Установщик Entware на флешке

  1. Управление → OPKG: выберите флешку и сохраните. Установка займёт несколько минут.

Выбор накопителя для OPKG

3. Подключение по SSH
ssh root@192.168.x.x -p 222

Пароль по умолчанию keenetic. Сразу смените его командой passwd.

4. Шифрованный DNS

Пропишите шифрованные DNS-серверы (DoT или DoH) по инструкции Keenetic: без этого XKeen работает неправильно.

5. Токен для KeeneticOS 5.2 и новее

XKeen нужен токен доступа к роутеру. Создайте его в разделе Пользователи и доступ, вставьте в шаблон xkeen.json и положите файл на роутер по пути /opt/etc/xkeen/xkeen.json. Подробнее – в вики XKeen.

6. Установка XKeen

Подключитесь по SSH и выполните:

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

7. Какие устройства через прокси

В веб-интерфейсе откройте Приоритеты подключений → Политики доступа в Интернет, создайте политику с именем xkeen и перенесите в неё нужные устройства.

[!WARNING] Без политики xkeen через прокси пойдёт трафик всех устройств в сети.

8. Проверка
  • На роутере: xkeen -status – XKeen должен быть запущен.
  • На устройстве из политики xkeen откройте сайт, показывающий IP-адрес: он должен совпасть с адресом вашего сервера, а на остальных устройствах остаться прежним.
  • Удобнее управлять настройками из браузера через XKeen UI.

Подробная версия с теми же шагами: инструкция для Keenetic.

Генератор конфигов для роутера

Вставьте ссылку на сервер или подписку, выберите роутер и ядро, отметьте нужные сервисы – и получите готовый конфиг и одну команду, которая сама положит его на роутер. Всё считается в браузере, ссылки никуда не отправляются. Как поставить XKeen на роутер – в разделе VPN на роутере.

РоутерЯдроЧто получитсяГенератор
Keenetic (XKeen)Xray04_outbounds.json и 05_routing.json: серверы, выбор сервисов, реклама, свои сайтыОткрыть →
Keenetic (XKeen)Mihomoconfig.yaml с автовыбором сервера, подпиской, Hysteria2, AmneziaWG и веб-панельюОткрыть →
OpenWrt (Nikki), бетаMihomoпрофиль для Nikki и команда, которая его включитОткрыть →

Полезное

Поддержать проект

Скрипты и инструкции бесплатные. Донат добровольный – он помогает оплачивать тестовые серверы и держать скрипты в актуальном состоянии. Спасибо! 💜

Способ
Российской картой, СБП, Tinkoff PayTribute
Зарубежной картой, Apple Pay, Google PayBuy Me a Coffee
USDT (TRC-20)TS83ViXrdezUpp1eFadqj1rBhGLZaba1c1
TONUQBchO4XFPwF9MMa_tjXpwqTo8IL2FhUDyllhYuFo8WM-Qbf
Ethereum (ERC-20)0xC06F6B3A029d7Ea00705B7028490744e2BC16799

Лицензия: MIT, см. LICENSE. Сторонние компоненты – NOTICE.md.

Благодарности

3X-UI KIT построен на работе авторов этих проектов: 3X-UI · Xray-core · Mihomo · Hysteria · AmneziaWG · XKeen

itsnotkubrick/3X-UI_KIT

Shell

435

160 commits

updated Oct 14, 2026

See the code

README

3X-UI KIT

Установка 3X-UI одной командой: 11 протоколов, один порт 443, одна подписка на всё

Версия Протоколов 3X-UI Звёзды Обновлено Поддержать


[!WARNING] Проект – набор скриптов с открытым кодом. Он не оказывает услуг связи и не предоставляет доступ к серверам. Вы ставите его на собственный сервер и сами отвечаете за соблюдение законодательства своей страны. Проект создан в образовательных целях.

[!TIP] Вышла версия 1.2.1: выбор протоколов при установке, полное удаление, меню вместо команд и исправления установки. Что нового

Сменился ключ подписи релизов, поэтому сервер на версии 1.2 и ниже сам не обновится. Один раз выполните на сервере эту команду, и дальше автообновление снова заработает:

curl -fsSL https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/v1.2.1/scripts/kit.sh -o /usr/local/bin/kit && chmod 755 /usr/local/bin/kit && kit update

Новая установка ничего не требует.

3X-UI KIT превращает чистый VPS в готовый VPN-сервер за несколько минут. Скрипт ставит официальную панель 3X-UI, настраивает все популярные протоколы, сертификат и файрвол и выдаёт одну ссылку-подписку. Её можно вставить в любое приложение – оно само получит подходящие ему протоколы. Домен не нужен.

Конец установки 3X-UI KIT

Возможности

  • 🧩 До 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) сервер поднимается из неё за несколько минут.
  • 🔄 Обновляется само, но только подписанными релизами.
  • 🩺 Проверка и починка сервера из меню kit.
  • 🧹 Полное удаление. Пункт «Удалить KIT с сервера» убирает панель, подписку, настройки и сертификаты, а ваш SSH и чужие сертификаты не трогает.

Что понадобится

  • VPS с Ubuntu 22.04/24.04 или Debian 12/13 и доступом root по SSH
  • Свободные порты 443 и 80 – на свежем сервере они свободны

Нужен VPS? Я сам использую IS Hosting и рекомендую его (реферальная ссылка).

Установка

Подключитесь к серверу по SSH и выполните одну команду на чистом VPS.

Панель 3X-UI, все протоколы на порту 443 и одна подписка на всё:

bash <(curl -fsSL https://raw.githubusercontent.com/itsnotkubrick/3X-UI_KIT/v1.2.1/scripts/3x-ui.sh)

Через пару минут скрипт покажет адрес панели, логин, пароль и подписку с QR-кодом. Подробно – подключение приложений, дополнительные пользователи и параметры – в инструкции.

Управление: меню kit

После установки на сервере появляется команда kit. Введите её без аргументов, и откроется меню, как у x-ui: выберите цифру, остальное спросит само. Запоминать команды не нужно, всё нужное внутри:

  • Пользователи, ссылки и подписки. Список, добавить пользователя, показать все ссылки на подключения одним экраном, изменить лимит, выключить или удалить.
  • Протоколы, порты и маскировка. Включить или выключить протокол, сменить сайт маскировки, порт, раздельную маршрутизацию, DNS.
  • Проверка сервера. Быстрая и глубокая: глубокая видит, виноват сервер или ваша сеть, и умеет исправить безопасное.
  • Обновить kit и подписку, резервная копия, версии.
  • Удалить KIT с сервера.

[!IMPORTANT] Обновляйте панель и ядро только через kit («Обновить kit и подписку»). Пункт обновления в меню x-ui ставит самую новую панель вместе с самым новым ядром Xray, на котором часть приложений (Karing, Hiddify и другие на sing-box) перестаёт подключаться. Если уже обновили через x-ui: kit → «Проверка сервера» → «Исправить безопасное» вернёт проверенное ядро.

Все команды (для скриптов и тех, кому так привычнее) и разбор «Если не подключается» – в инструкции.

VPN на роутере

Через прокси идут только нужные сервисы и выбранные устройства, остальное работает напрямую. Порядок: 1. установить программу на роутер → 2. собрать конфиг в генераторе → 3. вставить команду из генератора.

[!NOTE] На роутере работает XKeen автора jameszeroX, спасибо ему.

📶 Keenetic: XKeen (jameszeroX) · 8 шагов, 20–30 минут

Нужны роутер Keenetic или Netcraze с USB-портом, USB-флешка в формате ext4 и свой сервер с VLESS (например, из этой инструкции).

1. Компоненты KeeneticOS

В веб-интерфейсе: Управление → Общие настройки → Изменить набор компонентов. Отметьте компоненты с галочками на картинке и установите. Роутер обновится и перезагрузится.

Нужные компоненты KeeneticOS

2. Entware на флешку
  1. Отформатируйте флешку в ext4 и вставьте её в роутер.
  2. Откройте её по сети (\\192.168.x.x\), создайте папку install и положите туда установщик под процессор роутера: mipsel, mips или aarch64. Не знаете, какой нужен? Модель роутера – в характеристиках на сайте Keenetic.

Установщик Entware на флешке

  1. Управление → OPKG: выберите флешку и сохраните. Установка займёт несколько минут.

Выбор накопителя для OPKG

3. Подключение по SSH
ssh root@192.168.x.x -p 222

Пароль по умолчанию keenetic. Сразу смените его командой passwd.

4. Шифрованный DNS

Пропишите шифрованные DNS-серверы (DoT или DoH) по инструкции Keenetic: без этого XKeen работает неправильно.

5. Токен для KeeneticOS 5.2 и новее

XKeen нужен токен доступа к роутеру. Создайте его в разделе Пользователи и доступ, вставьте в шаблон xkeen.json и положите файл на роутер по пути /opt/etc/xkeen/xkeen.json. Подробнее – в вики XKeen.

6. Установка XKeen

Подключитесь по SSH и выполните:

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

7. Какие устройства через прокси

В веб-интерфейсе откройте Приоритеты подключений → Политики доступа в Интернет, создайте политику с именем xkeen и перенесите в неё нужные устройства.

[!WARNING] Без политики xkeen через прокси пойдёт трафик всех устройств в сети.

8. Проверка
  • На роутере: xkeen -status – XKeen должен быть запущен.
  • На устройстве из политики xkeen откройте сайт, показывающий IP-адрес: он должен совпасть с адресом вашего сервера, а на остальных устройствах остаться прежним.
  • Удобнее управлять настройками из браузера через XKeen UI.

Подробная версия с теми же шагами: инструкция для Keenetic.

Генератор конфигов для роутера

Вставьте ссылку на сервер или подписку, выберите роутер и ядро, отметьте нужные сервисы – и получите готовый конфиг и одну команду, которая сама положит его на роутер. Всё считается в браузере, ссылки никуда не отправляются. Как поставить XKeen на роутер – в разделе VPN на роутере.

РоутерЯдроЧто получитсяГенератор
Keenetic (XKeen)Xray04_outbounds.json и 05_routing.json: серверы, выбор сервисов, реклама, свои сайтыОткрыть →
Keenetic (XKeen)Mihomoconfig.yaml с автовыбором сервера, подпиской, Hysteria2, AmneziaWG и веб-панельюОткрыть →
OpenWrt (Nikki), бетаMihomoпрофиль для Nikki и команда, которая его включитОткрыть →

Полезное

Поддержать проект

Скрипты и инструкции бесплатные. Донат добровольный – он помогает оплачивать тестовые серверы и держать скрипты в актуальном состоянии. Спасибо! 💜

Способ
Российской картой, СБП, Tinkoff PayTribute
Зарубежной картой, Apple Pay, Google PayBuy Me a Coffee
USDT (TRC-20)TS83ViXrdezUpp1eFadqj1rBhGLZaba1c1
TONUQBchO4XFPwF9MMa_tjXpwqTo8IL2FhUDyllhYuFo8WM-Qbf
Ethereum (ERC-20)0xC06F6B3A029d7Ea00705B7028490744e2BC16799

Лицензия: MIT, см. LICENSE. Сторонние компоненты – NOTICE.md.

Благодарности

3X-UI KIT построен на работе авторов этих проектов: 3X-UI · Xray-core · Mihomo · Hysteria · AmneziaWG · XKeen