Решение проблем и частые вопросы по панели 3X-UI (FAQ) #

1. Панель не открывается в браузере #

Если после установки или перезагрузки страница http://<IP-сервера>:<порт>/ не загружается (ошибка «Превышено время ожидания» или «Не удается получить доступ к сайту»):

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

   x-ui status
   

   Если служба не активна, перезапустите ее:

   x-ui restart
   

2. Проверьте порты в сетевом фаерволе (UFW):
   Если на сервере включен фаервол, порт панели должен быть открыт:

   sudo ufw allow <порт-панели>/tcp
   sudo ufw reload
   

   📌IMPORTANT
   > Проверьте также **фаервол хостинга** в личном кабинете VPS (Security Groups / Сетевой экран у таких провайдеров, как Oracle Cloud, Hetzner, Timeweb, FirstVDS). Если в панели хостинга закрыты входящие порты, трафик не дойдет до сервера.
3. Убедитесь в правильности URL-адреса и Web Base Path:
   Если при установке был задан секретный путь (например, /mysecret/), при обращении просто по IP и порту откроется пустая страница или ошибка 404. Вводите точный адрес: http://<IP>:<порт>/<путь>/ со слэшем на конце.
4. Проверьте текущие настройки:
   Выполните команду x-ui settings — утилита напечатает текущий активный порт, логин, пароль и секретный путь.

2. Забыли логин, пароль или потеряли доступ к 2FA #

Если вы не можете войти в панель:

1. Подключитесь к серверу по SSH под пользователем root.
2. Введите команду:

   x-ui
   

3. Выберите пункт 7 (Reset Username & Password):
   • Задайте новый логин (или нажмите Enter для генерации случайного).
   • Задайте новый пароль.
   • На вопрос об отключении 2FA (Do you want to disable currently configured two-factor authentication?) ответьте y, если у вас включена двухфакторка и вы потеряли приложение-аутентификатор.
4. Если панель по-прежнему не работает из-за сбитых настроек, выберите в меню пункт 9 (Reset Settings) — все параметры панели сбросятся к стандартным: порт 2053, логин admin, пароль admin.

3. Где смотреть логи для диагностики ошибок? #

• Потоковый журнал панели:

  x-ui log
  

  (выполняет команду journalctl -u x-ui -e --no-pager -f)
• Журнал ядра Xray:

  cat /var/log/x-ui/error.log
  

  или в каталоге установки: tail -f /usr/local/x-ui/error.log.
• Журнал банов Fail2ban:

  x-ui banlog
  

  (показывает IP-адреса, заблокированные за превышение числа одновременных подключений)

4. Переполнение диска сервером (Disk Full / 100% Use) #

Если сервер внезапно зависает, а команда df -h показывает 100% заполнение корневого раздела:

• Причиной обычно является непрерывная запись клиентских подключений в access.log.
• Очистите файл журнала:

  echo "" > /usr/local/x-ui/access.log
  

• Если вы не используете Fail2ban для ограничения IP на пользователя, отключите access.log:
  • В веб-панели перейдите в Xray Configs → Log → установите Access log в значение none.

5. Ошибка «database is locked» в SQLite #

Ошибка «database is locked» возникает при высокой нагрузке или медленном диске VPS, когда Xray и веб-панель одновременно пытаются записать статистику в файл базы данных SQLite x-ui.db.

• Решение: отключите запись access.log в настройках Xray (см. пункт 4 выше).
• Для крупных серверов с десятками активных пользователей переключите базу данных на PostgreSQL:
  Укажите переменные окружения XUI_DB_TYPE="postgres" и строку подключения XUI_DB_DSN в /etc/default/x-ui или docker-compose.yml.

6. Ошибки скачивания GitHub при установке (таймауты raw.githubusercontent.com) #

Если установка скрипта зависает на этапе скачивания файлов с GitHub:

• Способ 1 (принудительный IPv4):

  bash <(curl -Ls https://raw.githubusercontent.com/mhsanaei/3x-ui/master/install.sh --ipv4)
  

• Способ 2 (статическая запись в hosts):
  Добавьте прямой IP-адрес CDN GitHub в файл /etc/hosts:

  echo "185.199.110.133 raw.githubusercontent.com" | sudo tee -a /etc/hosts
  

7. Трафик пользователей не учитывается (потребление 0 байт) #

Если клиенты успешно подключаются и выходят в интернет, но в таблице панели их счетчик трафика остается на нуле:

1. В разделе Routing Rules (Правила маршрутизации) убедитесь, что системное правило api находится на самом первом месте в списке правил. Если оно смещено, статистика не передается от ядра Xray в панель.
2. Проверьте Email пользователей: имя пользователя не должно содержать пробелов и нестандартных спецсимволов.
3. В разделе Xray Configs нажмите кнопку Reset to Default (Сброс к значениям по умолчанию) и сохраните конфигурацию.

8. Защита панели от сканеров и попыток подбора пароля (Brute-force) #

Если в логах видны попытки подбора пароля:

1. Немедленно измените порт панели на нестандартный (например, 48193) и задайте сложный путь Web Base Path.
2. Заблокируйте IP атакующего в фаерволе:

   sudo ufw deny from <IP-атакующего> to any
   

3. Для максимальной безопасности полностью закройте порт панели наружу и входите через SSH Port Forwarding (пункт 24 в меню x-ui):
   • Подключитесь с локального компьютера:

     ssh -L 2222:127.0.0.1:<порт-панели> root@<IP-сервера>
     

   • Открывайте панель в браузере по локальному адресу http://localhost:2222/<базовый-путь>/. Доступ из внешней сети будет физически невозможен.