Логирование в 3x-ui: настройка и диагностика на личном VPS в 2026 году

Логирование в 3x-ui — это сбор и запись событий на сервере с панелью управления Xray/X-UI для мониторинга подключений, диагностики ошибок и контроля трафика. Оно нужно администраторам личных VPS и пользователям, которые хотят видеть, кто и как использует их канал. С сервисом SANSARA вы получаете готовый личный VPS в одной из 9+ стран, импортируете конфигурацию в клиентское ПО и настраиваете логирование прямо в панели 3x-ui.

Коротко:

• 3x-ui — веб-панель для управления Xray на Linux-сервере; логирование включается в её настройках.
• Логи показывают подключения, ошибки, объём трафика и помогают найти причину сбоев.
• С SANSARA вы арендуете личный VPS, получаете данные в кабинете и импортируете их в клиент без терминала.
• Поддерживаются iPhone, Android, Windows, macOS.
• Логи можно сохранять локально на сервере или отправлять в Telegram-бот SANSARA для уведомлений.
• Для диагностики используются логи сервера (Xray) и логи клиентского приложения.

Что это такое и зачем нужно

3x-ui — это веб-интерфейс для управления сервером с Xray. Он позволяет создавать пользователей, настраивать протоколы, ограничивать трафик и включать логирование.

Логирование — запись событий в файлы или внешние системы. В контексте 3x-ui оно включает:

• Подключения клиентов (время, IP, протокол).
• Ошибки (неверный ключ, неподдерживаемый протокол, проблемы с сертификатами).
• Статистику трафика (входящий/исходящий объём).
• Системные события (перезапуск службы, обновление конфигурации).

Логирование нужно, чтобы:

• Диагностировать проблемы: если клиент не подключается, логи покажут, на каком этапе возникает ошибка.
• Контролировать использование: видеть, кто и сколько трафика потребляет.
• Обеспечить безопасность: отслеживать подозрительные подключения или частые ошибки аутентификации.

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

Как настроить с SANSARA (пошагово)

SANSARA предоставляет личный VPS с уже настроенным доступом. Вам не нужно устанавливать панель вручную или работать в терминале.

1. 01Регистрация и выбор узла

• Зарегистрируйтесь в SANSARA, выберите страну и тариф.
• После оплаты в кабинете появится статус узла и данные для подключения.

1. 01Получение данных в кабинете

• В личном кабинете SANSARA вы видите:
• Адрес сервера (IP или домен).
• Порт и параметры протокола.
• Ссылку для импорта в клиентское приложение.
• Эти данные автоматически сгенерированы для вашего личного VPS.

1. 01Импорт в клиентское приложение

• На устройстве (телефон или компьютер) откройте клиентское приложение.
• Используйте функцию импорта из ссылки или QR-кода.
• Вставьте ссылку из кабинета SANSARA — клиент подтянет все настройки.

1. 01Проверка подключения

• Включите защищённый канал в клиенте.
• Убедитесь, что трафик проходит через ваш личный VPS (например, проверьте IP в браузере).
• Если есть проблемы, переходите к настройке логирования для диагностики.

1. 01Настройка логирования в 3x-ui

• Откройте веб-панель 3x-ui (адрес и данные для входа обычно указаны в кабинете SANSARA или приложении).
• Перейдите в раздел Настройки или Settings.
• Найдите параметры логирования:
• Уровень логирования (log level): info, warning, error, debug. Для диагностики временно используйте debug.
• Путь к логам (log path): например, /var/log/xray/access.log.
• Ротация логов (log rotation): включите, чтобы файлы не занимали всё место на диске.
• Сохраните изменения и перезапустите Xray через панель.

1. 01Отправка логов в Telegram-бот SANSARA

• В настройках 3x-ui может быть интеграция с Telegram-ботом SANSARA.
• Укажите токен бота и ID чата, куда отправлять уведомления о подключениях или ошибках.
• Это удобно для мониторинга без постоянного входа в панель.

1. 01Проверка логов

• В панели 3x-ui откройте раздел Логи или Logs.
• Попробуйте подключиться с клиента — в логах должны появиться записи о новом соединении.
• Если записи нет, проверьте настройки уровня логирования и путь к файлам.

Устройства: iPhone, Android, Windows, macOS

Логирование настраивается на стороне сервера (3x-ui), но для полной диагностики полезны и клиентские логи.

На всех платформах принцип одинаковый: серверные логи (3x-ui) показывают, что происходит на VPS, клиентские — что видит само устройство.

Практический чек-лист на 7–10 пунктов

1. 01Убедитесь, что личный VPS активен

Проверьте статус узла в кабинете SANSARA — он должен быть онлайн.

1. 01Импортируйте конфигурацию в клиент

Используйте ссылку из кабинета, чтобы избежать ошибок вручную.

1. 01Включите защищённый канал на устройстве

Убедитесь, что трафик идёт через ваш выделенный узел.

1. 01Проверьте базовое подключение

Откройте сайт, который показывает ваш IP, и убедитесь, что он соответствует адресу VPS.

1. 01Включите логирование в 3x-ui

Установите уровень debug, укажите путь к логам, сохраните и перезапустите службу.

1. 01Сымитируйте проблему

Отключите и снова подключите клиент, чтобы в логах появились свежие записи.

1. 01Проанализируйте серверные логи

Ищите ошибки аутентификации, таймауты, неподдерживаемые протоколы.

1. 01Проверьте клиентские логи

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

1. 01Настройте уведомления в Telegram-бот SANSARA

Получайте оповещения о новых подключениях и критических ошибках.

1. 01Верните уровень логирования на info после диагностики

Чтобы логи не росли слишком быстро и не занимали место на диске.

FAQ

• Убедитесь, что уровень логирования не none.
• Проверьте путь к логам — директория должна существовать, и у процесса Xray должны быть права на запись.
• Перезапустите Xray через панель 3x-ui и попробуйте подключиться заново.

Вопрос: Клиент на iPhone подключается, но трафик не идёт через VPS. Где искать причину?

• Сначала проверьте серверные логи 3x-ui: есть ли записи о новом подключении?
• Если есть, но трафик не проходит, возможно, проблема в маршрутизации на устройстве или в настройках клиента.
• Проверьте клиентские логи на iPhone — они покажут, какой профиль активен и куда направляется трафик.

Вопрос: Можно ли настроить логирование так, чтобы не хранить историю надолго? Да. Включите ротацию логов в 3x-ui:

• Укажите максимальный размер файла (например, 10 МБ).
• Настройте количество архивных файлов (например, 5).
• Так старые логи будут автоматически удаляться, а новые — записываться.

Вопрос: Зачем отправлять логи в Telegram-бот SANSARA, если они есть в панели? Telegram-бот SANSARA даёт мобильный мониторинг: вы получаете уведомления о критических событиях (ошибки, подозрительные подключения) без постоянного входа в веб-панель. Это удобно для быстрой реакции.

Итог

• Логирование в 3x-ui — ключевой инструмент для диагностики и контроля на личном VPS; настраивается в веб-панели без терминала.
• С SANSARA вы получаете готовый личный VPS в одной из 9+ стран, импортируете конфигурацию в клиент и включаете логирование за несколько кликов.
• Используйте серверные логи (3x-ui) и клиентские логи на iPhone, Android, Windows, macOS для полной картины проблем.
• Настройте уровень логирования, ротацию файлов и уведомления в Telegram-бот SANSARA, чтобы сохранять баланс между подробностью и размером логов.
• После диагностики возвращайте уровень логирования с debug на info, чтобы не перегружать диск сервера.