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

Возможности · Установка · Команды · Роутер · Генератор · Полезное · Поддержать

---

Tip

Вышла версия 1.1.2: исправление установки на чистом сервере и мелкие починки. Что нового · сервер на 1.1 и 1.1.1 обновится сам этой ночью, а на 1.0 одной командой:

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

Note

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

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

Возможности

• 🧩 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 сохраняет копию сервера с пользователями и ключами.
• 🔒 Сертификат Let's Encrypt на IP выпускается и продлевается сам, панель скрыта на случайном пути со случайными логином и паролем.
• ✅ Проверено настоящими клиентами – каждый протокол на ядрах Xray, Mihomo и sing-box, в том числе через интернет к удалённому серверу: tests/matrix.

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

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

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

Установка

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

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

Через пару минут скрипт покажет адрес панели, логин, пароль и подписку с QR-кодом.

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

Warning

Проект создан в образовательных целях. Убедитесь, что ваши действия соответствуют законодательству вашей страны.

Команды kit

После установки на сервере появляется команда kit. Подробности – в инструкции.

Команда	Что делает
kit user add имя [--gb 50] [--days 30] [--devices 3]	добавить пользователя во все протоколы и показать его подписку с QR-кодом
kit user list	кто сколько израсходовал, до какого числа и когда был в сети
kit user link имя [--all]	показать подписку ещё раз; --all добавляет ссылки vpn:// и tg://
kit user limit имя [--gb N] [--days N] [--devices N]	изменить лимиты (0 – без ограничений)
kit user off имя / kit user on имя	временно выключить и включить пользователя
kit user del имя	удалить пользователя
kit check	проверить сервер: службы, сертификат, подписку, сайт маскировки, права на файлы (ничего не меняет)
kit fix [--dry-run]	исправить безопасное: перезапустить службы, вернуть права, включить автообновление
kit update [--manual | --auto]	обновить сейчас; --manual выключает автообновление, --auto включает
kit backup	сохранить копию сервера (подключения, ключи, пользователи)
kit version	версии kit, панели и ядра, состояние автообновления

Для отдельного сервера Hysteria2 есть команда hy2 (hy2 add, hy2 del, hy2 list, hy2 link, hy2 status, hy2 restart, hy2 update, hy2 uninstall), подробнее – в инструкции по Hysteria2. Панелью 3X-UI управляет команда x-ui.

VPN на роутере

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

Note

🙏 Спасибо автору XKeen. На роутере работает не моя программа: я только собрал инструкцию и генератор конфигов, а всю сложную работу сделал jameszeroX.

XKeen – прокси на Keenetic (Xray и Mihomo, политики для устройств). Репозиторий · Вики · ⭐ Поставить звезду

Вопросы по самой программе задавайте в её репозитории: так автор узнаёт об ошибках. Если что-то не так с моей инструкцией или генератором, пишите мне.

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

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

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

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

2. Entware на флешку

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

3. Управление → 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 перезапустится.

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

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

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

8. Проверка

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

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

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

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

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

Полезное

• XKeen и его вики – документация по маршрутизации на Keenetic
• XKeen UI – веб-интерфейс для XKeen
• IP-адреса для AmneziaWG – актуальные списки от RockBlack

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

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

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

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

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