Баг-репорт

Как сообщить о проблеме

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

Собрать репорт

Сначала проверьте сами

Панель открывается по https://ваш-домен, а не по http:// и не по IP. Если только по HTTP или IP, значит SSL не поднялся, и часть функций не работает (генератор UUID, копирование). Сначала почините HTTPS.
Версия панели актуальная: на сервере выполните v2raytunsetup update, затем v2raytunsetup status.
Порты 80 и 443 открыты на сервере панели и не заняты другим nginx или caddy.
DNS: A-записи домена панели и домена подписок указывают на IP сервера.

Если подписка пустая или не подтягивается

Проверьте всю цепочку: пустая подписка почти всегда из-за неё.

1Config Profile с инбаундом (у инбаунда должен быть tag).
2Host (раздел Hosts), привязанный к этому инбаунду. Без хоста подписка пустая.
3Пользователь в скваде, которому назначен этот инбаунд.
4Нода онлайн, на которой реально запущен этот профиль.

Собрать репорт

Заполните поля, и текст по шаблону соберётся сам.

Версия панели

Строка version из v2raytunsetup status

Как открываете панель

Протокол

Что делали

Что ожидали

Что произошло

Клиент и устройство

Текст репорта

Версия панели:         …
Как открываете панель: https://домен
Протокол:              не знаю
Что делали (по шагам): …
Что ожидали:           …
Что произошло:         …
Клиент и устройство:   …

Открыть Telegram

Ничего не отправляется: текст копируется в ваш буфер обмена.

Что приложить к репорту

Скопируйте и заполните шаблон:

Шаблон

Версия панели:            (v2raytunsetup status — строка version)
Как открываете панель:    https://домен  /  http://домен  /  http://IP
Протокол:                 VLESS Reality / Hysteria2 / AmneziaWG
Что делали (по шагам):    1. ... 2. ... 3. ...
Что ожидали:              ...
Что произошло:            ... (точный текст ошибки)
Клиент (для подписки):    v2rayTun / Hiddify / NekoBox / Streisand + версия

Плюс приложите:

Скриншоты разделов Nodes, Hosts, Squads и сам Config Profile (раскрытый).
Скриншот текста ошибки (тоста или плашки) целиком.
Логи (см. ниже) текстом, а не картинкой, если возможно.

Где что взять

Выполните по SSH на сервере и приложите вывод текстом.

Статус и версия панели

v2raytunsetup status

Логи бэкенда (последние 50 строк)

v2raytunsetup logs backend --tail 50

Логи Caddy (если не открывается домен или нет SSL)

docker logs v2raytunpanel-caddy --tail 30

На сервере ноды (если нода офлайн)

docker ps && docker logs v2raytunpanel-node --tail 50

Проверка подписки (ссылка из вкладки «Подключение»)

curl -s "https://sub-домен/api/sub/XXXX" | head -c 300

Частые причины

Пустой UUID в «Инструментах», не копируется
Панель открыта по HTTP, нужен HTTPS.
«Подписка не найдена / отключена»
У пользователя лимит устройств (HWID), и браузер без HWID блокируется. Или статус пользователя не ACTIVE.
Подписка пустая
Нет Host под инбаунд, или у инбаунда нет tag, или пользователь не в скваде.
Нода онлайн, но в клиенте «н/а»
В профиле ноды нет рабочего инбаунда или инбаунд был без тега. Обновитесь до актуальной версии.
«Не пингуется», хотя нода онлайн
У хоста стоит Security: TLS, а инбаунд Reality. Поставьте Security: Default.
Hysteria2 не подключается
Не прописывайте пути к сертификатам вручную. Создайте ноду с протоколом HYSTERIA2: сертификат и конфиг появятся сами.
SSL не выпускается
DNS A-запись указывает не на сервер, или порт 80/443 занят другим сервисом.

Не нашли причину?

Соберите данные по шаблону и напишите нам. Ответим и поможем разобраться.

Написать нам