Skip to content

Latest commit

 

History

History
594 lines (343 loc) · 51.4 KB

README.md

File metadata and controls

594 lines (343 loc) · 51.4 KB

🇷🇺 Русский · 🇬🇧 English · 🇪🇬 العربية · 🇮🇷 فارسی · 🇨🇳 简体中文 · 🇪🇸 Español · 🇹🇷 Türkçe

3X-UI AUTO NGINX

Автоматическое развёртывание 3X-UI / XRAY-CORE на собственном VPS

REALITY · XHTTP · HYSTERIA2 · NGINX · HTTPS · BACKUP / RESTORE

Два домена, чистый VPS и несколько минут на установку.

Releases Downloads Ubuntu Support

📦 Релизы · 🔗 Каскад · 🌐 Сайты-прикрытия · ✈️ Telegram Web Proxy Manager · ❤️ Поддержать · 💬 Обратная связь

3X-UI AUTO NGINX — бесплатный установщик 3x-ui и Xray на собственный VPS. Он настраивает Nginx, HTTPS-сертификаты, REALITY, XHTTP, Hysteria2, подписки (в том числе в формате Clash/Mihomo) и диагностику. Интерактивный менеджер позволяет устанавливать сервер, менять домены, управлять Backup/Restore v3 и настраивать Каскад из двух VPS. Дополнительные возможности — XTLS Vision, AmneziaWG 3.1, Cloudflare WARP для российских сайтов и AdGuard Home с DNS-over-HTTPS (DoH).

Больше, чем обычная установка 3x-ui: новые серверы получают собственные многостраничные сайты для панели и REALITY. В проекте не менее 2592 готовых вариантов оформления и текста, а при каждой установке дополнительно меняются цвета, иконки и даты. На сайтах работают навигация и дополнительные страницы. При обычном HTTPS-подключении по TCP и неавторизованном HTTP/3-запросе по UDP на домене REALITY показывается один и тот же сайт. Всё работает на существующих Nginx и Xray без Docker и дополнительных веб-серверов.

✨ Почему этот проект?

Готовые подключения
REALITY, XHTTP и Hysteria2 настраиваются автоматически. Дополнительные подключения (XTLS Vision, AmneziaWG, XHTTP для CDN) добавляются по выбору при установке и тоже настраиваются автоматически.
Полноценные сайты-прикрытия
Не менее 2592 готовых вариантов оформления и текста. Многостраничные сайты с работающей навигацией, своими текстами и изображениями. Поддержка HTTP/3-прикрытия Hysteria2.
Каскад из двух VPS
Цепочка из двух серверов, которая настраивается через меню. Российские сайты и российские IP-адреса открываются напрямую со входного сервера, остальной трафик идёт через выходной.
Собственный Nginx и HTTPS
Входящие TCP-подключения принимает Nginx на вашем VPS. Панель и подписки доступны по HTTPS на собственном домене, без прямого открытия служебных портов в интернет.
Backup / Restore v3
Резервные копии, восстановление и перенос на новый VPS с сохранением данных и персонализированных сайтов.
Менеджер и смена доменов
Смена домена панели, REALITY или обоих без переустановки 3X-UI и других сервисов.
Автоматические сертификаты и безопасность
Сертификаты Let's Encrypt с автоматическим продлением без остановки Nginx; по желанию - защита SSH и автоматические обновления безопасности VPS.
Дополнительные возможности
XTLS Vision, AmneziaWG 3.1, XHTTP для CDN, Cloudflare WARP, AdGuard Home с DoH и настройка Каскада.

🚀 Быстрый старт

Настройте DNS-записи двух доменов, указав IP-адрес вашего VPS: один для панели, другой для REALITY. Подключитесь по SSH под root и убедитесь, что входящие подключения на TCP-порты 80 и 443 и UDP-порт 443 доступны из интернета. Поддерживаемые ОС.

curl -fSL https://github.com/xPROMSx/3x-ui-auto-nginx/releases/latest/download/x-ui-latest.sh -o x-ui-latest.sh && bash x-ui-latest.sh

После запуска выберите 1 — English или 2 — Русский. Затем откроется главное меню:

  • 1 — Установка: настройка сервера с нуля или полная переустановка.
  • 2 — Смена доменов: изменение домена панели, REALITY или обоих без переустановки.
  • 3 — Резервные копии: создание, просмотр и восстановление Backup.
  • 4 — Telegram Web Proxy Manager: запуск или установка отдельного менеджера Telegram-прокси.
  • 5 — Каскад: настройка цепочки из двух серверов, проверка состояния и отключение.
  • 0 — Выход.

Для работы с меню нужен интерактивный SSH-терминал.

Резервная загрузка — если GitHub Releases недоступен

Ветка main содержит альфа-версию проекта. Устанавливать её не рекомендуется. Используйте стабильный релиз по основной команде выше.

curl -fSL https://raw.githubusercontent.com/xPROMSx/3x-ui-auto-nginx/main/x-ui-latest.sh -o x-ui-latest.sh && bash x-ui-latest.sh

Caution

Установка — не обновление!

Повторный запуск скрипта без параметров открывает менеджер, а не переустанавливает сервер. Но пункт «Установка» предназначен для чистого VPS или полной переустановки.

Если обнаружена существующая установка, скрипт предупредит об удалении управляемых данных и запросит точное подтверждение YES. При переустановке заменяются база 3X-UI и конфигурация nginx. Заранее сохраните Backup вне VPS.

«Смена доменов» и «Резервные копии» — отдельные операции, не требующие переустановки панели.

Как обновляться?
  • 3X-UI и Xray: используйте штатные средства панели. Совместимость новых версий с конфигурацией проекта может быть ещё не проверена.
  • 3X-UI AUTO NGINX: обновление установленного стека поверх существующего не поддерживается. Для доступа к возможностям нового менеджера, например к пункту 5 — Каскад, можно скачать актуальный скрипт и выбрать нужную операцию. Скрипт проверит совместимость установленной конфигурации.
  • Backup / Restore: сохраняет и восстанавливает данные, но не обновляет стек.

Не выбирайте «Установка» ради обновления! nginx, ядро Linux и другие системные пакеты обновляются средствами ОС.

Ниже описаны настройки, которые предлагает установщик при выборе пункта «Установка».


1. 🌐 Домен панели 3X-UI

Введите домен панели 3X-UI:

Укажите домен, через который будут доступны панель управления, подписки и дополнительные веб-сервисы.


2. 🛰️ Домен VLESS REALITY

Введите домен VLESS REALITY:

Укажите второй домен для подключения REALITY. Оба домена должны указывать на IP-адрес вашего VPS.

ℹ️ Дополнительные параметры запуска

Оба домена можно передать установщику заранее, без интерактивного ввода:

bash x-ui-latest.sh -subdomain panel.example.com -reality_domain reality.example.com

Замените panel.example.com и reality.example.com своими доменами. Запуск с параметрами пропускает выбор языка и главное меню; остальные вопросы установки остаются интерактивными.


3. 🔐 Расширенная безопасность VPS

Усилить безопасность VPS? [Y/n]:

Рекомендуется неопытным пользователям · Включена по умолчанию (Y)

Установщик настроит Fail2ban для защиты SSH, зашифрованный системный DNS (DoT) и автоматические обновления безопасности. При подходящих условиях также создаётся swap-файл размером 1 ГиБ — независимо от выбора дополнительной защиты.

Перед включением ознакомьтесь с параметрами ниже, особенно с расписанием автоматических перезагрузок.

🔐 Подробное описание настроек безопасности

Дополнительная защита включается при выборе Y. Подготовка swap выполняется независимо от этого выбора:

  • Swap 1 ГиБ. Если swap отсутствует, файловая система поддерживается и свободно не менее 4 ГиБ, установщик создаст и активирует swap-файл. Существующие настройки swap не изменяются. Если условия не выполнены, этот этап будет пропущен без остановки установки.
  • Защита SSH — Fail2ban. Ограничение повторных неудачных попыток входа с учётом фактических SSH-портов. Существующие параметры SSH-аутентификации не изменяются.
  • Шифрованный DNS (DoT). Глобальные DNS-серверы Cloudflare и Google используют строгий DNS-over-TLS через systemd-resolved. DNS-маршруты и search domains интерфейсов/VPN сохраняются; их запросы могут оставаться незашифрованными. Если подготовка DoT не удалась, но исходный DNS успешно восстановлен, установка основного стека, Fail2ban и автоматических обновлений продолжается независимо от DoT; итоговый статус сообщает об отказе, код завершения ненулевой.
  • Автоматические обновления безопасности. Обновление списков пакетов — в 02:30, установка обновлений — в 02:50.
  • Автоматическая перезагрузка — 04:38. Если после обновлений системе потребуется перезагрузка, она выполняется в указанное время, в том числе при активных пользовательских сеансах. Это может прервать действующие подключения.

Время указано по локальному часовому поясу VPS.

Перед изменениями выполняются проверки совместимости существующих настроек. При ошибках конфигурации безопасности предусмотрен контролируемый откат.

Важно: установщик не отключает SSH-вход по паролю и не заменяет полноценное администрирование сервера. Рекомендуется настроить вход по SSH-ключам и затем самостоятельно отключить парольную аутентификацию.


4. 🔗 VLESS XTLS Vision

Настроить дополнительное подключение VLESS TCP/TLS (XTLS Vision)? Нужен отдельный домен. [y/N]:

Дополнительное подключение · По умолчанию отключено (N)

Альтернативное VLESS-подключение с TLS, которое может быть полезно, если REALITY работает нестабильно или блокируется в вашей сети. Устанавливается как отдельный профиль в панели 3X-UI.

Important

Для XTLS Vision требуется третий домен, отличный от доменов панели и REALITY. Его DNS-запись должна указывать на IP-адрес VPS. HTTPS-сертификат и маршрутизация nginx настраиваются автоматически.

После выбора Y установщик дополнительно запросит домен: Введите домен VLESS TLS Vision (отличный от доменов панели и REALITY):.


5. 🔑 Amnezia WG

Настроить дополнительное подключение AmneziaWG? [y/N]:

Дополнительное подключение · По умолчанию отключено (N)

Создаётся отдельное подключение AmneziaWG в панели 3X-UI. Дополнительный домен не нужен.

ℹ️ Подробнее об Amnezia WG

Устанавливается AmneziaWG 3.1 с использованием UDP/8443. Необходимое правило UFW добавляется автоматически.

После установки создайте клиента в панели 3X-UI и получите конфигурацию или ссылку vpn:// для совместимого приложения Amnezia.

Установщик создаёт серверное подключение, но не генерирует клиентов AmneziaWG автоматически.

Конфигурация включается в Backup / Restore v3 вместе с необходимыми настройками firewall.


6. 🌐 VLESS + XHTTP для CDN

Добавить дополнительное подключение XHTTP, совместимое с CDN? [y/N]:

Дополнительное подключение · По умолчанию не устанавливается (N)

Создаётся отдельное VLESS-подключение с транспортом XHTTP в режиме packet-up, предварительно настроенное для работы через CDN. Подключение создаётся выключенным в панели 3X-UI.

Используется существующий HTTPS-домен панели, поэтому дополнительный домен и сертификат не требуются. После включения подключение можно использовать напрямую, без CDN.

Для работы через CDN пользователь самостоятельно настраивает своего CDN-провайдера и изменяет параметры Host в 3X-UI. Установщик не настраивает CDN, а предоставляет готовый серверный профиль для дальнейшего использования.


7. 🌐 Российские сайты через Cloudflare WARP

Скрыть IP вашего VPS от российских сайтов через Cloudflare WARP? [Y/n]:

Дополнительная маршрутизация · В русском меню включена по умолчанию (Y), в английском выключена (N)

Если планируете использовать этот VPS как входной сервер Каскада, выберите N. На входном сервере WARP несовместим с Каскадом, на выходном - разрешён.

При выборе Y установщик настроит Cloudflare WARP (MASQUE), чтобы российские сайты и некоторые сетевые сервисы видели IP-адрес Cloudflare вместо IP вашего VPS. Это необходимо для защиты IP вашего VPS.

Настройка действует только для трафика, проходящего через VPS. Если приложение обращается к сайту напрямую, WARP на сервере на него не влияет.

При включении функции установщик регистрирует устройство в Cloudflare и принимает условия использования сервиса.

Если настройка WARP не удалась, установка продолжится без него, а итоговый отчёт сообщит о частичном результате. При неподтверждённом откате необходимо проверить работу Xray в панели.

ℹ️ Какие сайты направляются через WARP и как проверить настройку

Установщик добавляет в конфигурацию Xray выходящее подключение warp-masque и три правила:

  • WARP - RU: российские домены из geosite:category-ru.
  • WARP - RU2: IP-адреса из geoip:ru.
  • WARP - RU3: ipify.org, ifconfig.me, checkip.amazonaws.com, ipapi.is, iplocate.io, ip.sb и 2gis.com.

Правила добавляются в конец списка маршрутизации. Более ранние правила сохраняют приоритет. Это не отдельный профиль для клиента и не системный VPN: маршрутизация работает внутри Xray.

После установки проверьте в панели 3X-UI раздел Xray → Outbounds (подключение warp-masque) и Xray → Routing (три правила с названиями выше). Настройки сохраняются в Backup v3 вместе с конфигурацией 3X-UI.


8. 🛡️ AdGuard Home + DNS-over-HTTPS

Установить и настроить AdGuard Home? [y/N]:

Дополнительный DNS-сервер · По умолчанию отключён (N)

Персональный DNS-сервер с блокировкой рекламы и отслеживания, управлением клиентами и защищёнными DNS-запросами.

ℹ️ Подробнее об AdGuard Home и настройке доступа

Дополнительный домен не требуется.

После установки будут доступны:

  • Панель AdGuard Home: https://panel.example.com/adg-.../ — индивидуальный случайный путь.
  • DNS-over-HTTPS: https://panel.example.com/dns-query.

Публичные TCP/UDP-порты 53 не открываются. Конфигурация и данные AdGuard Home сохраняются в Backup / Restore v3.

⚠️ Рекомендация по безопасности

Для личного VPS рекомендуется использовать отдельный ClientID для каждого устройства.

В интерфейсе AdGuard Home откройте Настройки → Настройки DNS → Настройки доступа → Разрешённые клиенты и укажите только созданные ClientID, без IP-адресов и подсетей.

Используйте DoH-адреса вида:

https://panel.example.com/dns-query/<ClientID>

После настройки запросы без разрешённого ClientID, в том числе на обычный /dns-query, будут отклоняться.

Используйте длинные случайные идентификаторы. Подробнее — в официальных рекомендациях AdGuard Home.

Начиная с v2.4.1, на новых установках проверка и установка обновлений AdGuard Home доступны прямо в его веб-интерфейсе. Если AdGuard Home установлен нашим скриптом до v2.4.1, включите эту возможность одной командой на VPS:

sudo bash -c 'set -euo pipefail; umask 077; d=$(mktemp -d); trap '\''rm -rf -- "$d"'\'' EXIT; cd "$d"; u=https://github.com/xPROMSx/3x-ui-auto-nginx/releases/download/v2.4.2; curl -fLsS --connect-timeout 15 --max-time 120 "$u/x-ui-latest.sh" -o x-ui-latest.sh; curl -fLsS --connect-timeout 15 --max-time 120 "$u/x-ui-latest.sh.sha256" -o x-ui-latest.sh.sha256; sha256sum --check --strict x-ui-latest.sh.sha256; bash ./x-ui-latest.sh --enable-agh-updates'

9. 👤 Автоматическое создание клиента и подписки

Создать клиента в 3X-UI и показать ссылку подписки после установки? [Y/n]:

Рекомендуется · Включено по умолчанию (Y)

Установщик создаст клиента в панели 3X-UI и сформирует персональную HTTPS-ссылку подписки для настроенных поддерживаемых подключений.

Ссылка будет отображена в итоговом отчёте. Если отказаться от этой функции, клиентов можно создать самостоятельно через панель управления.


По завершении установки будут показаны адрес панели, логин и пароль, диагностика и ссылка подписки (если выбрано создание клиента). Для AdGuard Home дополнительно выводятся адрес панели управления, пароль и DoH. Для WARP показывается результат настройки.

Если после обновления ОС требуется перезагрузка, установщик сообщит об этом. Первоначальная перезагрузка выполняется вручную командой sudo reboot.

🌐 Сайты-прикрытия и HTTP/3

Полноценные сайты вместо стандартных заглушек. При новой установке автоматически создаются разные многостраничные сайты для панели и REALITY. В проекте не менее 2592 готовых вариантов оформления и текста, с работающей навигацией, иллюстрациями и адаптацией под мобильные устройства. Для опционального XTLS Vision выбирается отдельный сайт.

Каждая установка выглядит по-своему. Названия, цветовые схемы, изображения, иконки и тексты автоматически персонализируются. Дополнительные страницы содержат разные материалы и даты публикаций. Выбранный вариант сохраняется при Backup/Restore и смене доменов.

Hysteria2 с HTTP/3-прикрытием. Обычные HTTPS-запросы по TCP и неавторизованные HTTP/3-запросы по UDP на домене REALITY получают один и тот же полноценный сайт. При этом панель и подписки остаются изолированы от публичного HTTP/3-прикрытия.

🚀 Профили подключения

Подключение Статус
VLESS + REALITY ✅ Включён по умолчанию
VLESS + XHTTP ✅ Включён по умолчанию
VLESS + XHTTP для CDN 🔧 Опционально, выключен
Hysteria2 ✅ Включён по умолчанию
VLESS + WebSocket (TLS) ◻️ Выключен по умолчанию
Trojan + gRPC ◻️ Выключен по умолчанию
VLESS + XTLS Vision 🔧 Опционально
Amnezia WG 🔧 Опционально

REALITY, XHTTP и Hysteria2 включены после установки. WebSocket TLS и Trojan gRPC создаются, но остаются выключенными до активации в панели 3X-UI.

XTLS Vision, Amnezia WG и XHTTP для CDN добавляются по выбору при установке. XHTTP для CDN создаётся выключенным и не отображается в подписках до включения и привязки клиента.

Для использования подключений необходимо создать клиентов - автоматически при установке либо вручную в панели. Для Amnezia WG клиент создаётся отдельно.

Совместимость зависит от используемого приложения и его версии. Для XHTTP через CDN дополнительно важны настройки и ограничения CDN-провайдера.

Подписки

Обычная подписка, JSON и Mihomo / Clash — через nginx и HTTPS. provider=1 возвращает исходную подписку для proxy providers вместо полной конфигурации Clash.

🌐 Смена доменов

В главном меню выберите 2 — Смена доменов. Можно заменить домен панели, REALITY или оба сразу без переустановки. Новые DNS-записи должны указывать на VPS; для получения сертификатов необходим доступ к TCP/80. Домены должны различаться между собой и с доменом Vision.

Перед изменениями автоматически создаётся полный Backup v3. Клиенты, ключи, настройки и статистика сохраняются. Домен Vision не меняется. После успешной смены может потребоваться обновить адреса подписок и настройки клиентов.

Поддерживаются только распознанные конфигурации проекта, включая совместимые установки v2.1.7. При ошибке не удаляйте Backup и данные восстановления. Если появилось ROLLBACK_UNVERIFIED, остановитесь и сохраните диагностику. Подробности, ограничения и восстановление.

💾 Backup / Restore

В главном меню откройте 3 — Резервные копии, чтобы создать Backup, просмотреть список архивов или выполнить Restore. Резервную копию можно использовать после переустановки ОС или для переноса на другой VPS. Для восстановления должны совпадать операционная система, её версия и архитектура процессора. На свежем VPS Restore из меню сам дождётся конца автоматического обновления системы (до 60 минут); в это время не перезагружайте сервер.

Для работы через командную строку доступны команды (от root):

# Создать новую резервную копию
x-ui-backup backup

# Показать доступные копии
x-ui-backup list

# Восстановить выбранную копию
x-ui-backup restore /var/backups/x-ui/<archive>.tar.gz

Архивы сохраняются в /var/backups/x-ui/.

Backup содержит чувствительные данные: базу клиентов, пароли и приватные ключи сертификатов. Храните копию вне VPS и восстанавливайте только доверенные архивы.

Если Restore невозможен, файлы можно аварийно извлечь без установки пакетов и запуска служб. Нужны только Bash, Python 3 и доступ к архиву и месту извлечения; root не требуется:

x-ui-backup extract /path/to/archive.tar.gz ./recovered-backup

Каталог должен быть новым; исходные пути сохраняются под files/, ссылки пропускаются. Данные содержат секреты — не копируйте их поверх работающего сервера без проверки.

Восстановление на новом VPS.

🔗 Каскад из двух серверов

Каскад соединяет два VPS проекта 3X-UI AUTO NGINX в одну цепочку: устройства подключаются к входному серверу, а в интернет выходят через выходной. Каскад может быть полезен, если у вас возникают проблемы с подключением к VPS или нужен выход в интернет через сервер в другой стране.

Клиент → Входной VPS → Выходной VPS → Интернет

Российские сайты и российские IP-адреса открываются прямо со входного сервера (это можно отключить после настройки в правилах маршрутизации входного VPS). Остальной трафик, который не поймали другие правила маршрутизации, идёт через выходной сервер.

Настройка выполняется в главном меню, пункт 5 — Каскад. Править конфигурации вручную не нужно.

Как настроить Каскад, проверить его работу и отключить

Что потребуется

  • Два VPS с работающим 3X-UI AUTO NGINX.
  • Логин и пароль панели 3X-UI каждого сервера.
  • Актуальный установщик с пунктом 5 — Каскад.
  • На входном сервере не должен быть настроен WARP (его можно удалить вручную).

1. Создать ключ на выходном сервере

На VPS, через который планируете выходить в интернет, запустите актуальный установщик.

Выберите 5 — Каскад → 1 — Создать ключ (выходной сервер).

Введите логин и пароль от панели 3X-UI. Они вводятся скрыто и нигде не сохраняются. Менеджер создаст специального клиента cascade в существующем REALITY-подключении и покажет ключ-ссылку, начинающуюся с vless://.

Скопируйте эту ссылку. Она понадобится для подключения второго сервера.

Не публикуйте ключ-ссылку: по ней можно подключиться к созданному клиенту.

Существующие клиенты не изменяются.

2. Подключить входной сервер

Теперь откройте актуальный установщик на VPS, к которому подключаются ваши устройства.

Выберите 5 — Каскад → 2 — Подключить выходной сервер (входной сервер).

Введите логин и пароль панели 3X-UI (они тоже нигде не сохраняются), затем вставьте ключ-ссылку, полученную на первом шаге. При вставке ключ виден на экране и нигде не сохраняется.

Менеджер проверит соединение с выходным сервером. Если проверка пройдёт, он создаст подключение cascade-exit и три правила маршрутизации CASCADE.

Российские сайты и российские IP-адреса будут направляться напрямую со входного сервера, остальной подходящий трафик - через выходной.

При применении настроек соединения пользователей могут прерваться на несколько секунд. Если настройка не пройдёт проверку, менеджер попытается вернуть прежнюю конфигурацию и сообщит результат.

Существующие клиентские подключения и подписки продолжают использоваться, создавать новые специально для Каскада не нужно.

3. Проверить состояние

На каждом сервере откройте 5 — Каскад → 3 — Состояние.

Менеджер запросит логин и пароль панели, как и в других действиях.

Менеджер покажет, настроена ли на этом сервере входная или выходная роль и работает ли Xray. Эта проверка ничего не изменяет.

4. Отключить Каскад

Откройте 5 — Каскад → 4 — Отключить на нужном VPS.

На входном сервере менеджер предложит удалить подключение cascade-exit и три правила CASCADE. Остальные подключения и правила панели сохранятся.

На выходном сервере будет удалён только клиент cascade. После этого все входные серверы, использующие его ключ, потеряют связь с этим выходом.

Каждое отключение требует отдельного подтверждения. Применение изменений на входном сервере может ненадолго прервать соединения пользователей.

Что нужно знать

  • WARP: на входном сервере несовместим с Каскадом. Если WARP установлен, удалите его подключение и правила через панель 3X-UI перед настройкой Каскада. На выходном сервере WARP разрешён.
  • AmneziaWG: подключения этого типа не передаются через выходной сервер.
  • Правила маршрутизации: существующие правила с более высоким приоритетом могут направлять часть трафика в обход выходного сервера. Менеджер предупредит об этом.
  • Недоступность выхода: если выходной сервер перестанет работать, трафик, направленный через него, тоже перестанет проходить. Автоматического резервного выхода нет.
  • QUIC через Vision: UDP/443 не проходит через такой Каскад.
  • Смена доменов: после смены доменов на выходном VPS потребуется заново подключить его на входном сервере.

Резервные копии

Backup v3 сохраняет настройки Каскада. После восстановления на входном сервере эти настройки сохраняются вместе с остальными данными 3X-UI.

Работа Каскада проверена на двух реальных VPS с REALITY, XHTTP и Hysteria2. Совместимость со всеми клиентскими приложениями и конфигурациями пока не подтверждена.

Если обнаружите ошибку, сообщите о ней на GitHub.

🔐 Безопасность

Служебные интерфейсы не открываются напрямую в интернет: панель, подписки и дополнительные сервисы доступны через nginx и HTTPS, а внутренние порты остаются локальными.

Не уверены, как самостоятельно защитить VPS? При установке можно включить расширенную настройку безопасности. Установщик автоматически настроит защиту SSH от перебора паролей, шифрованный DNS и обновления безопасности. Перед включением ознакомьтесь с подробным описанием и расписанием ночных перезагрузок в разделе «Быстрый старт».

Важно: не забывайте защищать сам доступ к серверу. Используйте SSH-ключи, а после проверки входа по ключу отключите аутентификацию по паролю. Установщик не отключает её автоматически.

✈️ Telegram Web Proxy Manager

Telegram Web Proxy Manager — самостоятельный проект для собственного Telegram WEB Proxy с HTTPS, сайтом-прикрытием и обновлениями с аварийным откатом.

TWPM не входит в базовую установку 3X-UI. Пункт 4 главного меню позволяет запустить его либо перейти к отдельной установке после подтверждения. Оба проекта управляются независимо.

⚙️ Технические подробности и совместимость

  • ОС: Ubuntu 24.04, Ubuntu 26.04 и Debian 13.
  • UFW: разрешаются 80/tcp, 443/tcp и 443/udp (8443/udp — при выборе AmneziaWG). При установке UFW включается только после проверки SSH-доступа; если сделать это безопасно нельзя, остаётся выключенным с предупреждением. После Restore через меню его можно включить только по отдельному выбору и после проверок безопасности; обычная команда x-ui-backup restore UFW не включает.
  • Сертификаты: Let's Encrypt webroot и certbot.timer продлевают сертификаты автоматически, без остановки nginx.
  • Версия 3x-ui: по умолчанию устанавливается последняя версия, тщательно протестированная на совместимость с 3X-UI AUTO NGINX. После установки вы можете самостоятельно обновить 3x-ui штатными средствами панели, но совместимость новой версии с нашей конфигурацией может быть ещё не подтверждена. Другой стабильный релиз можно явно выбрать через -version <tag> (минимальная поддерживаемая версия — v3.8.0); установщик предупредит о неподтверждённой совместимости.

Восстановление на новом VPS

Нужны те же ОС, версия и архитектура, что у копии. При смене IP VPS обновите DNS-записи доменов. Не запускайте x-ui-latest.sh — установите только утилиту и восстановите доверенный архив:

curl -fSL https://raw.githubusercontent.com/xPROMSx/3x-ui-auto-nginx/main/assets/backup/x-ui-backup.sh -o /tmp/x-ui-backup
install -o root -g root -m 0755 /tmp/x-ui-backup /usr/local/bin/x-ui-backup
rm -f /tmp/x-ui-backup
x-ui-backup restore /root/<archive>.tar.gz

SSH, настройки ОС и базовый firewall остаются ответственностью администратора. Для архивов v2 нужна утилита из соответствующего старого релиза.

🤝 Происхождение и авторы

Проект основан на 3x-ui-pro (автор mozaroc). Тот возник из форка x-ui-pro и восходит к исходному x-ui-pro от GFW4Fun. Сейчас проект развивается независимо. После создания форка существенно переработаны маршрутизация nginx/SNI и конфигурация XHTTP, механизм выпуска и автоматического продления TLS-сертификатов, а также Backup / Restore v3 с восстановлением и откатом. Добавлен Hysteria2 на UDP/443 и устранены выявленные проблемы безопасности.

Панель предоставляет MHSanaei/3x-ui. Права авторов сторонних компонентов и существующие лицензии сохраняются.

Собственные разработки и изменения xPROMSx распространяются под GNU GPL-3.0-only. Copyright (C) 2026 xPROMSx contributors. Лицензия охватывает только наши права на эти материалы; она не перелицензирует унаследованный код и не подтверждает GPL-статус всего репозитория. Область действия нашей лицензии и сведения о сторонних компонентах приведены в THIRD_PARTY_NOTICES.md.

Если вы хотите взять наш код. Чтобы просто установить и пользоваться проектом, ничего делать не нужно: он бесплатный, как и раньше. Если вы публикуете свою версию или переносите наш код в другой проект, оставьте ссылку © xPROMSx · github.com/xPROMSx/3x-ui-auto-nginx в README и на стартовом экране или в главном меню установщика и честно напишите, что версия изменена. Не выдавайте нашу работу за свою. Точные условия: docs/NOTICE.md.

🖥️ Флаги стран в Windows 11

Если при открытии панели 3x-ui в Chrome, Edge или Brave на Windows 11 вместо флагов стран отображаются буквенные коды (FI, DE, US), воспользуйтесь нашим небольшим проектом Flag Emojis Windows Installer. Он помогает вернуть отображение флагов, сохраняет оригинальный шрифт Windows и имеет возможность отката.

❤️ Поддержать разработку

Если проект оказался полезен, вы можете добровольно поддержать его разработку и дальнейшее развитие. Проект и все его возможности остаются бесплатными и открытыми независимо от пожертвований.

Два домена. Несколько минут. Собственный 3x-ui / Xray сервер.

⭐ Если установщик оказался полезен, поставьте Star. Это поможет другим найти проект.

Установка · Релизы · Ошибки