Устранение неполадок

Чек-лист по самым распространённым проблемам. Если сомневаетесь, повысьте уровень логирования (XUI_LOG_LEVEL=debug) и проверьте логи панели и Xray.

Панель не запускается

• Проверьте статус службы и логи (меню x-ui → статус/логи).
• Убедитесь, что порт панели не занят другой службой.
• Проверьте, что путь к базе данных доступен для записи (по умолчанию /etc/x-ui/x-ui.db).

502 / панель недоступна за прокси

• Убедитесь, что панель действительно слушает на восходящем порту (например, 2053).
• Убедитесь, что ваш обратный прокси передаёт заголовки обновления WebSocket и указывает на правильный порт и базовый веб-путь.
• Проверьте, что брандмауэр не блокирует соединение прокси → панель.

Проблемы с сертификатами

• DNS домена должен указывать на сервер до выпуска сертификата.
• Порты 80/443 должны быть доступны для проверки HTTP/TLS (либо используйте проверку через DNS).
• Помните, что для REALITY сертификат не нужен — обычно проблема в неверном dest/SNI (см. подводные камни REALITY).

Клиент не может подключиться

• Декодируйте ссылку клиента с помощью инспектора ссылок и проверьте каждый параметр.
• Убедитесь, что транспорт и безопасность совпадают на обоих концах.
• Убедитесь, что клиент не достиг своего лимита трафика, срока действия или лимита IP.
• Проверьте, что входящий порт открыт в брандмауэре.