Публичная страница статуса

Xray Checker включает встроенную публичную страницу статуса, которая позволяет делиться информацией о доступности прокси с пользователями без раскрытия конфиденциальных данных конфигурации.

Обзор

Публичная страница статуса предоставляет:

Статус прокси в реальном времени (онлайн/офлайн)
Информацию о задержке для каждого прокси
Чистый, адаптивный интерфейс
Автоматические обновления

При включении публичного режима конфиденциальная информация, такая как адреса серверов, порты и детали конфигурации, скрыты от просмотра.

Включение публичного режима

Установите переменную окружения:

WEB_PUBLIC=true

Или используйте флаг CLI:

xray-checker --web-public

Что скрыто в публичном режиме

Информация	Публичный режим	Обычный режим
Имя прокси	✓ Видно	✓ Видно
Статус	✓ Видно	✓ Видно
Задержка	✓ Видно	✓ Видно
Протокол	✗ Скрыто¹	✓ Видно
Адрес сервера	✗ Скрыто	✓ Видно
Порт	✗ Скрыто	✓ Видно
Локальный порт прокси	✗ Скрыто	✓ Видно
Детали конфигурации	✗ Скрыто	✓ Видно

¹ Бейдж протокола по умолчанию скрыт в публичном режиме. Как включить — см. Бейдж протокола ниже.

Бейдж протокола

На каждой карточке прокси отображается небольшой цветной бейдж с протоколом (VLESS, VMess, Trojan, Shadowsocks, Hysteria2, WireGuard, SOCKS, HTTP). В обычном режиме он показывается всегда.

В публичном режиме бейдж по умолчанию скрыт. Чтобы показать его, не раскрывая других деталей сервера, включите WEB_PUBLIC_SHOW_PROTOCOL=true. Опция влияет только на бейдж — адреса серверов, порты и ссылки на конфиги остаются скрытыми.

Сгруппированное представление

Прокси с общим group_name (например, узлы, развёрнутые из балансировщика) отображаются как сворачиваемые группы со счётчиком онлайн для каждой группы. Сначала идут несгруппированные прокси, затем каждая группа.

Пользовательское имя подписки

Вы можете установить пользовательское имя для страницы статуса, используя информацию о подписке от вашего провайдера, или установить его вручную:

# Будет отображаться как заголовок страницы
SUBSCRIPTION_URL=https://provider.com/sub#MyVPN

Настройка URL

Страница статуса поддерживает параметры URL для настройки отображения:

Параметр	Описание
`hideHeader=true`	Скрыть шапку с логотипом и элементами управления
`hideStats=true`	Скрыть карточки статистики
`hideServersHeader=true`	Скрыть заголовок “Серверы”
`hideControls=true`	Скрыть поиск и фильтры
`hideStatusInfo=true`	Скрыть техническую информацию в подвале
`hideFooter=true`	Скрыть подвал страницы
`hideBackground=true`	Прозрачный фон

Пример: Минимальное встраивание

https://your-server.com/?hideHeader=true&hideFooter=true&hideControls=true

Сценарии использования

Для пользователей

Предоставьте пользователям ссылку для проверки доступности прокси:

https://status.yourdomain.com/

Встраивание в документацию

Используйте iframe для встраивания страницы статуса:

<iframe
  src="https://status.yourdomain.com/?hideHeader=true&hideFooter=true"
  width="100%"
  height="400"
  frameborder="0"
>
</iframe>

Интеграция со службами статуса

Публичная страница хорошо работает за обратными прокси, такими как Nginx или Cloudflare, для дополнительной безопасности и кэширования.