База знаний Happ

База знаний — справочная часть сайта о Happ, отдельная от инструкций по скачиванию и первому запуску. В ней пять разделов.

Глоссарий объясняет отдельные термины: протоколы, режимы, параметры подписки. Wiki разбирает более широкие темы целиком — архитектуру приложения, форматы ссылок, устройство подписки. How-to — пошаговые инструкции к конкретным задачам поперёк платформ. Troubleshooting ведёт от симптома к причине и решению. Compare сравнивает протоколы, режимы и приложения по таблице.

Happ в этих материалах — клиентское приложение на ядре Xray-core: оно устанавливает соединение по выбранному протоколу и маршрутизирует трафик, но своих серверов не имеет и подписку на доступ не продаёт. Разница с типичным VPN-сервисом подробно разобрана в статье «Happ — клиент, а не VPN-сервис»: рамка важна, потому что многие формулировки в базе знаний написаны именно с этой позиции.

Разделы рассчитаны на чтение друг за другом, но у каждого свой уровень детализации.

Глоссарий — самый короткий формат: определение, пример в Happ, отличие от похожих терминов. Wiki — самый подробный: одна статья wiki опирается сразу на несколько терминов глоссария и добавляет то, чего в коротком определении нет — таблицу, схему связей, историю вопроса. Например, статья «Как работает Happ» использует термины «TUN», «системный прокси» и «профиль маршрутизации» вместе, а не по отдельности.

How-to переводит понятое в действие: у каждого шага есть ожидаемый результат, а платформенные отличия собраны в отдельную таблицу или подраздел. Troubleshooting устроен по-другому: сначала таблица «причина — как проверить — что сделать» для симптома, затем шаги диагностики, затем чек-лист и указание, когда писать провайдеру. Compare решает третью задачу — выбор между вариантами: таблица minimum на 10 измерений и дата, на которую данные сверены.

Новичку, который впервые открыл Happ, логичнее начать с wiki: статья «Что такое Happ» объясняет архитектуру и способы добавить сервер без предварительных знаний. Незнакомые слова по ходу текста ищите в глоссарии — там короче и конкретнее. Первую практическую задачу, например обновление подписки, удобно решать по инструкции how-to уже после этого.

Опытному пользователю, который знает термины и ищет конкретный ответ, обычно нужнее не вводная статья, а точная страница: определение параметра в глоссарии, таблица сравнения в compare или разбор симптома в troubleshooting. Для такого чтения порядок разделов не важен — важна ссылка из поисковика или из другой страницы сайта прямо на нужный материал.

База знаний не пересказывает страницы других разделов сайта, а ссылается на них за деталями.

Точный текст ошибки Happ и пошаговое решение для конкретной платформы — в разделе errors; troubleshooting ссылается туда, когда симптом сводится к известной ошибке. Параметры протокола — адрес, порт, флаги ссылки — подробно разобраны в разделе protocols; глоссарий даёт только суть термина и отсылает туда за примером конфигурации. Первая установка и включение приложения на конкретной платформе — задача разделов setup и download, а не базы знаний. Работу Happ в мобильной сети, роуминге, на работе или в публичном Wi-Fi разбирают сценарии раздела restricted-network — база знаний ссылается на них, когда речь заходит о конкретной сети, а не о приложении в целом.