---
title: Устранение неполадок
description: Решение типичных проблем 3x-ui — панель не запускается, ошибки 502, проблемы с сертификатами и клиенты, которые не могут подключиться.
icon: Wrench
---

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

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

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

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

- Убедитесь, что панель действительно слушает на восходящем порту (например, `2053`).
- Убедитесь, что ваш [обратный прокси](/docs/operations/reverse-proxy) передаёт заголовки
  обновления WebSocket и указывает на правильный порт и **базовый веб-путь**.
- Проверьте, что брандмауэр не блокирует соединение прокси → панель.

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

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

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

- Декодируйте ссылку клиента с помощью
  [инспектора ссылок](/docs/config/share-links) и проверьте каждый параметр.
- Убедитесь, что **транспорт и безопасность совпадают** на обоих концах.
- Убедитесь, что клиент не достиг своего **лимита трафика, срока действия или лимита IP**.
- Проверьте, что входящий порт открыт в брандмауэре.

<Callout type="info">
  Всё ещё не получается? Поищите в
  [GitHub issues](https://github.com/MHSanaei/3x-ui/issues) — скорее всего, с вашим
  симптомом уже сталкивались.
</Callout>
