Перейти к содержимому

Статья 105 из 141

Гайды

3x-ui не работает: панель не открывается, клиенты не подключаются

Установка панели: 3x-ui. Клиенты и лимиты: 3x-ui: клиенты и Reality. Здесь разбираем, что делать, когда что-то сломалось.

Сначала определите, какая из двух проблем у вас:

  • не открывается веб-панель — дело в службе, порту панели или файрволе;
  • панель открывается, но клиенты не подключаются — дело в inbound, порте подключения или настройках Reality.
Окно терминала
systemctl status x-ui

Должно быть active (running). Если служба упала, посмотрите причину:

Окно терминала
journalctl -u x-ui -n 50 --no-pager

Перезапуск:

Окно терминала
systemctl restart x-ui

У 3x-ui есть меню управления. Запустите x-ui без аргументов: там статус, перезапуск, логи, сброс настроек и обновление.

После установки скрипт показывает порт, путь (web base path), логин и пароль. Если вы их не сохранили, посмотрите текущие настройки:

Окно терминала
x-ui settings

Панель открывается по адресу http://IP:порт/путь/. Частая ошибка — открывать без пути или со старым портом 2053 из чужой инструкции.

Проверьте, что панель слушает порт:

Окно терминала
ss -tulpn | grep x-ui

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

Окно терминала
ufw status

Откройте порт панели и порты всех inbound:

Окно терминала
ufw allow 2053/tcp # замените на свой порт панели
ufw allow 443/tcp # порт inbound

Подробнее: настройка файрвола. Держать панель открытой для всего интернета не стоит: см. защиту VPN-панелей.

Через меню x-ui можно сбросить логин и пароль администратора или все настройки панели. Сброс настроек панели не удаляет клиентов и inbound: они лежат в базе /etc/x-ui/x-ui.db. Перед любым сбросом сделайте копию базы:

Окно терминала
cp /etc/x-ui/x-ui.db /root/x-ui.db.bak

Каждый inbound слушает свой порт. Он должен быть открыт в UFW так же, как порт панели. Проверка:

Окно терминала
ss -tulpn | grep xray

Если нужного порта в списке нет, inbound выключен или Xray не запустился. Смотрите логи Xray в меню x-ui.

Если на 443 уже работает nginx или Caddy, Xray не сможет занять этот порт.

Окно терминала
ss -tulpn | grep ':443'

Решение: перенесите inbound на другой порт или настройте общий доступ к 443 через fallback.

Самая частая причина «всё настроено, но не коннектится».

  • dest и serverNames должны указывать на реальный сайт, который открывается с вашего сервера по TLS 1.3. Проверка с VPS:
Окно терминала
curl -sI https://www.example.com | head -1
  • После смены ключей, shortIds или serverNames клиент должен заново импортировать конфиг или ссылку. Старый QR-код работать перестанет.

Расхождение часов ломает TLS-рукопожатие. На сервере:

Окно терминала
timedatectl

Строка System clock synchronized: yes должна быть yes. Если нет:

Окно терминала
timedatectl set-ntp true

На телефоне включите автоматическое время.

Если у клиента закончился трафик или срок, он просто перестаёт подключаться. Откройте карточку клиента в панели и проверьте лимиты.

Симптом Что проверить
Панель не открывается systemctl status x-ui, порт и путь в x-ui settings, ufw status
Панель открывается, клиенты не подключаются порт inbound в UFW, ss -tulpn, параметры Reality
Работало, перестало после правок клиент не обновил конфиг после смены ключей
Отваливается у одного клиента лимиты трафика и срока, время на устройстве
Отваливается у всех сразу сервер перегружен или выключен: htop, df -h, баланс в кабинете

Если сервер вообще не отвечает, начните с диагностики сервера. Если сервер остановлен из-за баланса, пополните его.