Страницы ошибок

Unne Server показывает стилизованные страницы ошибок посетителям в браузере, когда что-то идет не так.

Типы страниц

Страница предупреждения (200)

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

Способы обхода:

• Cookie unne_confirmed_<subdomain>=1 (устанавливается автоматически после подтверждения, действует 24 часа)
• Заголовок X-Unne-Skip-Warning: 1
• Не-браузерный User-Agent (API-клиенты, curl и т.д.)
• Флаг клиента --skip-warning (если у пользователя есть разрешение skip_warning)

Не найдено (404)

Показывается, когда у поддомена нет активного туннеля. Включает:

• Код ошибки ERR_UNNE_404
• Команду CLI для исправления проблемы
• Кнопку обновления

Не в сети (502)

Показывается, когда туннель зарегистрирован, но upstream недоступен. Это означает:

• CLI-клиент подключен к серверу
• Но локальный сервис не запущен или не отвечает

Общая ошибка

Показывается для прочих ошибок с пользовательским кодом ошибки и сообщением.

Дизайн

Все страницы используют дизайн в стиле shadcn:

• Чистый белый фон
• Компонент оповещения с цветной левой границей (красная для ошибок, янтарная для предупреждений)
• Иконки Lucide
• Бейдж с ID запроса для отладки
• Адаптивная верстка

Кастомизация

Шаблоны страниц ошибок встроены в бинарный файл сервера в internal/server/pages/. Для кастомизации:

1. Форкните репозиторий
2. Отредактируйте HTML-шаблоны в internal/server/pages/
3. Измените стили в internal/server/pages/base.css
4. Пересоберите бинарный файл сервера

CSS и HTML встроены через Go embed.FS -- никаких внешних зависимостей во время выполнения.