Установка и настройка x‑ui на Ubuntu в 2026 году
Коротко
x‑ui — это веб-панель управления для настройки и мониторинга защищённых туннелей на вашем сервере. Она упрощает создание и раздачу конфигураций для клиентских приложений на смартфонах и компьютерах. Если у вас уже есть личный VPS с Ubuntu (например, в SANSARA), вы можете развернуть x‑ui в несколько команд и управлять подключениями через браузер, а затем импортировать готовые конфигурации в клиенты
Как установить и настроить x‑ui на Ubuntu в 2026 году: что это, пошаговая настройка с личным VPS SANSARA, совместимость с iPhone, Android, Windows, macOS, чек-лист и ответы на частые вопросы.
x‑ui — это веб-панель управления для настройки и мониторинга защищённых туннелей на вашем сервере. Она упрощает создание и раздачу конфигураций для клиентских приложений на смартфонах и компьютерах. Если у вас уже есть личный VPS с Ubuntu (например, в SANSARA), вы можете развернуть x‑ui в несколько команд и управлять подключениями через браузер, а затем импортировать готовые конфигурации в клиенты на iPhone, Android, Windows и macOS.
Коротко:
- x‑ui — веб-интерфейс для управления туннелями на сервере под Linux.
- Подходит для Ubuntu 20.04 LTS и новее, требует root-доступа и открытых портов.
- После установки вы получаете админку в браузере, где создаёте пользователей и конфиги.
- Готовые конфигурации импортируются в клиентские приложения на телефонах и ПК.
- SANSARA предоставляет личный VPS с Ubuntu и данными для подключения в кабинете.
- Совместимость: iPhone, Android, Windows, macOS — через стандартные клиенты.
Что это такое и зачем нужно
x‑ui — это панель управления для серверной части защищённого канала. Она работает поверх одного из популярных протоколов туннелирования и позволяет:
- централизованно управлять пользователями и их трафиком;
- генерировать готовые конфигурационные файлы и ссылки для клиентов;
- отслеживать статистику подключений и потребление трафика;
- быстро добавлять или удалять доступы через веб-интерфейс.
Панель устанавливается на сервер с Ubuntu (или другим дистрибутивом Linux) и служит «шлюзом» между вашим личным VPS и клиентскими устройствами. В отличие от массовых шаред-хостингов, где узлы часто перегружены, личный VPS даёт выделенный узел только под ваши сессии.
Как настроить с SANSARA (пошагово)
- 01Регистрация и выбор узла
После регистрации в SANSARA вы выбираете тариф с личным VPS и указываете:
- Операционную систему: Ubuntu 20.04 LTS или новее (рекомендуется LTS-версия).
- Локацию: одна из доступных стран (в SANSARA — 9+ узлов в Европе и других регионах).
- Конфигурацию VPS: в зависимости от планируемого числа одновременных подключений.
Система разворачивает VPS автоматически; вам не нужно вручную ставить панель управления или настраивать базовую сеть.
- 01Получение данных в кабинете
После активации VPS в личном кабинете SANSARA вы видите:
- IP-адрес сервера;
- логин и пароль для доступа по SSH;
- ссылку на статус-панель узлов (чтобы проверить доступность локации).
Этих данных достаточно, чтобы подключиться к серверу и установить x‑ui.
- 01Подключение к серверу и установка x‑ui
Откройте терминал на своём компьютере (Linux/macOS) или используйте клиент вроде PuTTY на Windows. Подключитесь по SSH:
`bash ssh root@IP_АДРЕС_ВАШЕГО_VPS `
Введите пароль из кабинета SANSARA.
Затем выполните команду установки x‑ui (версия и репозиторий могут меняться, ниже — общий шаблон):
`bash bash <(curl -Ls `
Скрипт:
- установит необходимые зависимости;
- настроит службу x‑ui;
- откроет порт по умолчанию для веб-панели (например, 54321) и для рабочего протокола.
После завершения скрипт покажет:
- адрес веб-панели (обычно `
- логин и пароль по умолчанию для входа (их нужно сразу сменить).
- 01Настройка панели x‑ui
Зайдите в веб-интерфейс по указанному адресу. Рекомендуемые шаги:
- Сменить пароль администратора в настройках учётной записи.
- Добавить входящее подключение (inbound):
- выбрать протокол (например, один из распространённых туннельных протоколов);
- указать порт (можно оставить предложенный системой или выбрать свой);
- при необходимости включить шифрование и дополнительные настройки безопасности.
- Создать пользователя:
- задать логин и пароль (или использовать автоматическую генерацию);
- установить лимиты трафика, если нужно.
После сохранения x‑ui сгенерирует:
- ссылку для импорта в клиентские приложения;
- QR-код для быстрого добавления на телефон;
- конфигурационный файл для загрузки вручную.
- 01Импорт в клиент и проверка
На клиентском устройстве:
- установите совместимое приложение (например, один из популярных клиентов для выбранного протокола);
- отсканируйте QR-код из x‑ui или импортируйте конфигурацию по ссылке/файлу;
- активируйте подключение.
Проверьте:
- статус соединения в клиенте (должен показывать «подключено»);
- в панели x‑ui — появление активного подключения и статистику трафика.
Если что-то не работает:
- убедитесь, что порт на VPS открыт и не блокируется фаерволом;
- проверьте, что вы используете актуальную версию клиента;
- при необходимости обратитесь в Telegram-бот SANSARA для проверки доступности узла.
Устройства: iPhone, Android, Windows, macOS
x‑ui совместима с большинством популярных клиентов на разных платформах.
| Устройство | Типичный клиент | Способ импорта из x‑ui |
|---|---|---|
| iPhone | App Store-клиент | QR-код или ссылка импорта |
| Android | клиент из Google Play или .apk | QR-код, ссылка или файл .json/.conf |
| Windows | десктопный клиент для Windows | импорт файла конфигурации |
| macOS | клиент для macOS (из официального сайта) | импорт файла или ссылки |
На всех платформах процесс выглядит одинаково: вы получаете от x‑ui готовую конфигурацию (в виде ссылки, QR-кода или файла) и добавляете её в клиент. После этого можно включать и выключать туннель по необходимости.
Практический чек-лист на 7–10 пунктов
- 01Выберите личный VPS с Ubuntu (например, в SANSARA) в подходящей локации.
- 02Убедитесь, что у вас есть root-доступ к серверу (логин и пароль из кабинета).
- 03Обновите систему перед установкой:
apt update && apt upgrade -y
- 01Установите x‑ui официальным скриптом и запишите выданные логин/пароль.
- 02Сразу смените пароль администратора в веб-панели.
- 03Настройте хотя бы одно входящее подключение (inbound) с выбранным протоколом и портом.
- 04Создайте пользователя и сгенерируйте конфигурацию (ссылка, QR-код, файл).
- 05Установите клиент на своё устройство (iPhone, Android, Windows или macOS).
- 06Импортируйте конфигурацию из x‑ui в клиент и активируйте подключение.
- 07Проверьте статус в клиенте и статистику в x‑ui; при проблемах — проверьте порты и версии.
FAQ
Нужны ли специальные знания Linux для установки x‑ui?+
Достаточно базового умения подключиться по SSH и выполнить команды из инструкции. Веб-панель x‑ui упрощает дальнейшую настройку через графический интерфейс.
Можно ли использовать x‑ui на shared-хостинге или только на VPS?+
x‑ui требует полноценного доступа к системе и возможности открывать порты, поэтому она предназначена для VPS или выделенных серверов. На типовом шаред-хостинге установка обычно невозможна.
Сколько пользователей выдержит x‑ui на одном VPS?+
Зависит от мощности сервера (CPU, RAM) и нагрузки каждого пользователя. На стартовых конфигурациях личного VPS можно комфортно работать с несколькими десятками активных сессий, если не злоупотреблять высоконагруженными задачами.
Что делать, если после настройки подключение не работает?+
- проверьте, что порт в x‑ui совпадает с портом, который слушает служба;
- убедитесь, что фаервол на сервере разрешает входящие соединения на этом порту;
- проверьте, что клиент на устройстве актуален и конфигурация импортирована корректно;
- при необходимости воспользуйтесь Telegram-ботом SANSARA для проверки статуса узла.
Итог
- Выберите личный VPS с Ubuntu в SANSARA — система сама подготовит сервер, вам останется только установить x‑ui.
- Установите x‑ui через официальный скрипт, смените пароль администратора и настройте входящее подключение.
- Создайте пользователя в x‑ui и получите готовую конфигурацию для импорта.
- Импортируйте конфигурацию в клиент на iPhone, Android, Windows или macOS и активируйте туннель.
- Следите за статистикой в x‑ui и при проблемах проверяйте порты, фаервол и версии ПО.
Ещё по теме
Читайте также
CTA · VPSSAFE
Свой VPS — сразу в кабинете
Регистрация на vpssafe.online, импорт профиля и устойчивый выход на телефон и компьютер. То, о чём пишем в блоге, — в готовом виде, без терминала.