Статья 105 из 141
Гайды
3x-ui не работает: панель не открывается, клиенты не подключаются
Установка панели: 3x-ui. Клиенты и лимиты: 3x-ui: клиенты и Reality. Здесь разбираем, что делать, когда что-то сломалось.
Сначала определите, какая из двух проблем у вас:
- не открывается веб-панель — дело в службе, порту панели или файрволе;
- панель открывается, но клиенты не подключаются — дело в inbound, порте подключения или настройках Reality.
Шаг 1. Служба запущена?
Заголовок раздела «Шаг 1. Служба запущена?»systemctl status x-uiДолжно быть active (running). Если служба упала, посмотрите причину:
journalctl -u x-ui -n 50 --no-pagerПерезапуск:
systemctl restart x-uiУ 3x-ui есть меню управления. Запустите x-ui без аргументов: там статус, перезапуск, логи, сброс настроек и обновление.
Шаг 2. Какой порт и путь у панели
Заголовок раздела «Шаг 2. Какой порт и путь у панели»После установки скрипт показывает порт, путь (web base path), логин и пароль. Если вы их не сохранили, посмотрите текущие настройки:
x-ui settingsПанель открывается по адресу http://IP:порт/путь/. Частая ошибка — открывать без пути или со старым портом 2053 из чужой инструкции.
Проверьте, что панель слушает порт:
ss -tulpn | grep x-uiШаг 3. Файрвол
Заголовок раздела «Шаг 3. Файрвол»Если служба работает, а панель в браузере не открывается, почти всегда порт закрыт файрволом.
ufw statusОткройте порт панели и порты всех inbound:
ufw allow 2053/tcp # замените на свой порт панелиufw allow 443/tcp # порт inboundПодробнее: настройка файрвола. Держать панель открытой для всего интернета не стоит: см. защиту VPN-панелей.
Шаг 4. Забыли логин или пароль
Заголовок раздела «Шаг 4. Забыли логин или пароль»Через меню x-ui можно сбросить логин и пароль администратора или все настройки панели. Сброс настроек панели не удаляет клиентов и inbound: они лежат в базе /etc/x-ui/x-ui.db. Перед любым сбросом сделайте копию базы:
cp /etc/x-ui/x-ui.db /root/x-ui.db.bakКлиенты не подключаются
Заголовок раздела «Клиенты не подключаются»Порт inbound закрыт
Заголовок раздела «Порт inbound закрыт»Каждый inbound слушает свой порт. Он должен быть открыт в UFW так же, как порт панели. Проверка:
ss -tulpn | grep xrayЕсли нужного порта в списке нет, inbound выключен или Xray не запустился. Смотрите логи Xray в меню x-ui.
Порт уже занят
Заголовок раздела «Порт уже занят»Если на 443 уже работает nginx или Caddy, Xray не сможет занять этот порт.
ss -tulpn | grep ':443'Решение: перенесите inbound на другой порт или настройте общий доступ к 443 через fallback.
Неверные параметры Reality
Заголовок раздела «Неверные параметры Reality»Самая частая причина «всё настроено, но не коннектится».
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, баланс в кабинете |
Если сервер вообще не отвечает, начните с диагностики сервера. Если сервер остановлен из-за баланса, пополните его.