Как добавить сервер в Happ вручную
- Автор
- Екатерина Лебедева, редактор раздела knowledge base
- Проверил:
- Артём Волков
- Проверено:
- Опубликовано:
- , обновлено
- Версия гайда:
- 1.0
Коротко
Чтобы добавить сервер в Happ вручную, нажмите «+» на главном экране, выберите «Ручной ввод», укажите протокол (VLESS, VMess, Trojan, Shadowsocks, SOCKS5 или Hysteria2) и заполните его поля значениями от администратора сервера, затем нажмите «Готово».
«Ручной ввод» — отдельный от вставки ссылки способ добавить сервер: вместо готовой строки vless:// или vmess:// вы заполняете параметры протокола по одному в отдельных полях формы. Он нужен, когда у вас есть только сырые параметры сервера — адрес, порт, UUID или пароль, — а не готовая ссылка или QR-код. Happ поддерживает так шесть протоколов: VLESS, VMess, Trojan, Shadowsocks, SOCKS5 и Hysteria2. После заполнения обязательных полей и нажатия «Готово» сервер появляется в общем «Списке серверов» на главном экране, рядом с серверами из подписок, и живёт независимо от них.
Когда нужен именно ручной ввод
Happ поддерживает добавление серверов тремя способами: вставкой ссылки, подпиской и «Ручным вводом». Первые два рассчитаны на готовую строку вроде vless://… или адрес подписки. Ручной ввод — для случая, когда готовой ссылки нет, а есть только отдельные параметры: адрес сервера, порт, протокол и ключ доступа.
Так бывает, если администратор сервера присылает параметры текстом или таблицей, а не в виде уже собранной ссылки. Ручной ввод превращает эти значения в рабочую конфигурацию внутри приложения без промежуточного шага «собрать ссылку самостоятельно».
Поддерживаются те же шесть протоколов, что и во всех остальных способах добавления: VLESS, VMess, Trojan, Shadowsocks, SOCKS5 и Hysteria2.
Как добавить сервер вручную
Соберите параметры сервера
Проверьте у администратора сервера полный список того, что нужно для выбранного протокола: например, для VLESS с Reality это UUID, публичный ключ и short id, а для Trojan — просто пароль.
Результат: У вас есть адрес, порт, протокол и ключ доступа, а для TLS или Reality — SNI и дополнительные значения.
Откройте Happ и нажмите «+»
Кнопка находится в верхнем правом углу главного экрана.
Результат: Открывается меню способа добавления.
Выберите «Ручной ввод»
Результат: Открывается список поддерживаемых протоколов.
Выберите протокол сервера
Список одинаков для всех платформ: VLESS, VMess, Trojan, Shadowsocks, SOCKS5, Hysteria2. Ошибка в выборе протокола на этом шаге означает, что дальше придётся заполнять форму заново.
Результат: Открывается форма с полями именно для этого протокола.
Заполните обязательные поля
Внесите адрес, порт и ключ доступа, а также параметры транспорта и шифрования, если сервер их использует. Разбор конкретных параметров по протоколам — на страницах протоколов Happ.
Результат: Все обязательные поля формы заняты значениями без опечаток.
Нажмите «Готово»
Кнопка расположена в верхнем правом углу окна формы.
Результат: Форма закрывается, сервер появляется в «Список серверов».
Проверьте новый сервер
Выберите его в списке, подключитесь и выполните «Проверить текущее соединение», чтобы убедиться, что параметры введены верно.
Результат: Сервер подключается и показывает пинг в мс.
Что заполнять по протоколам
Набор полей зависит от протокола: часть параметров общая, часть — специфична только для одного из них.
| Протокол | Обязательные поля | Особенность |
|---|---|---|
| VLESS | Адрес, порт, UUID | При Reality или TLS дополнительно SNI, публичный ключ, short id, flow |
| VMess | Адрес, порт, UUID | Транспорт (network) и параметры TLS, если сервер их требует |
| Trojan | Адрес, порт, пароль | Обычно работает вместе с TLS и SNI |
| Shadowsocks | Адрес, порт, метод шифрования, пароль | Метод шифрования должен точно совпадать с настройкой сервера |
| SOCKS5 | Адрес, порт | Логин и пароль — не всегда обязательны, зависят от настроек сервера |
| Hysteria2 | Адрес, порт, пароль (auth) | Отдельно указываются obfs с паролем и мультипорт, если сервер их использует |
Полный разбор параметров конкретного протокола и их значений — на страницах раздела протоколы: там же примеры готовых ссылок, если в какой-то момент проще получить строку целиком, чем вводить поля по одному.
Отличия по платформам
Форма «Ручной ввод» одинаково устроена на телефоне, компьютере и телевизоре — набор протоколов и полей от платформы не зависит. Разница — в том, насколько удобно набирать текст.
| Платформа | Особенность ручного ввода |
|---|---|
| Windows, macOS, Linux | Полноразмерная клавиатура ускоряет ввод длинных значений вроде UUID или публичного ключа |
| Android, iOS | Экранная клавиатура удобна для коротких полей; длинные ключи проще скопировать по частям из заметок |
| Android TV, Apple TV | Ввод текста пультом самый медленный вариант; при наличии готовой ссылки удобнее передать её QR-кодом с телефона, как описано на страницах настройка Android TV и настройка Apple TV |
Если параметров много, а устройство — телевизор, часто быстрее сначала собрать ссылку на телефоне через ручной ввод там, поделиться получившимся сервером QR-кодом, а на самом телевизоре только отсканировать код.
Проверка результата
- Сервер появился в «Список серверов» под тем протоколом, который вы выбрали.
- Все обязательные поля заполнены без опечаток, особенно адрес, порт и ключ доступа.
- Сервер подключается без ошибки конфигурации.
- «Проверить текущее соединение» показывает задержку в мс, а не «Тайм-аут».
- Пинг сервера отображается в списке после проверки спидометром.
Типичные ошибки
| Что видно в Happ | Возможная причина | Где разбор |
|---|---|---|
Конфигурация {config type} не валидная | Значение поля не соответствует формату протокола, например неверная длина UUID | Конфигурация не валидная |
| Сервер сохраняется, но не подключается | Верно введён формат, но не совпадает с реальными настройками сервера — опечатка в адресе, порте или ключе | UUID |
| «Тайм-аут» при проверке соединения | Сервер недоступен по указанному адресу и порту либо неверно указан протокол транспорта | Пинг: Тайм-аут |
| Ошибка TLS-рукопожатия при подключении | Не совпадают параметры TLS, SNI или сертификата между введёнными данными и сервером | Ошибка TLS-рукопожатия |
Если сервер сохраняется без ошибок, но не подключается, сначала заново сверьте каждое поле формы с параметрами от администратора — это самая частая причина при ручном вводе, а не сбой самого приложения.
Главное
- «Ручной ввод» открывается кнопкой «+» на главном экране и подходит, когда есть только отдельные параметры сервера, а не готовая ссылка.
- Happ поддерживает ручное добавление для шести протоколов: VLESS, VMess, Trojan, Shadowsocks, SOCKS5 и Hysteria2.
- После сохранения через «Готово» сервер попадает в «Список серверов» и хранится независимо от любых подписок.
- Обновление подписки не трогает серверы, добавленные вручную, — это отдельный, локальный список.
- Для Hysteria2 в ручном вводе нужно отдельно указывать обфускацию Salamander и мультипорт, если сервер их использует, — это не входит в базовые поля адреса и порта.
Частые вопросы
Чем «Ручной ввод» отличается от вставки ссылки из буфера обмена?
Вставка ссылки — это когда у вас уже есть готовая строка вида vless:// или vmess://, и Happ сам разбирает её на параметры. «Ручной ввод» — обратный случай: у вас есть отдельные значения, например адрес, порт и UUID, а строку с ними никто не собрал, поэтому вы заполняете форму полями по одному вручную через тот же экран «+».
Где взять параметры для ручного ввода, если провайдер не дал ссылку?
Обычно их предоставляет администратор сервера или провайдер текстом: адрес, порт, протокол, UUID или пароль и, при использовании TLS или Reality, дополнительные параметры вроде SNI и публичного ключа. Если вместо перечисления параметров вам дали лишь готовую строку с protocol://, проще использовать вставку из буфера обмена, а не переносить значения в ручной ввод вручную.
Что делать, если в форме ручного ввода нет нужного поля, например flow или obfs?
Заполните поля, которые есть в форме для выбранного протокола, и уточните у администратора сервера, обязателен ли отсутствующий параметр для подключения. Если конкретное поле критично и отсутствует, надёжнее получить готовую ссылку с этим параметром и добавить сервер через вставку ссылки или QR-код вместо ручного ввода.
Появится ли вручную добавленный сервер после обновления подписки?
Нет, и это не зависит от того, добавили вы его до или после подписки. Ручной ввод создаёт запись в локальном списке серверов, а обновление подписки работает только с серверами, которые прислал провайдер по адресу подписки. Эти два набора серверов существуют параллельно и не влияют друг на друга.
Нужно ли вручную добавлять параметры маршрутизации при ручном вводе сервера?
Нет, профиль маршрутизации — это отдельная сущность, привязанная к подписке, а не к одному серверу. У серверов из локального списка обычно нет своего профиля маршрутизации; при необходимости раздельного туннелирования для них ориентируйтесь на общие настройки маршрутизации приложения, а не на форму ручного ввода.
Как проверить правильность введённых вручную данных перед сохранением?
Сверьте каждое поле с тем, что прислал администратор сервера, особенно адрес, порт и ключ доступа — опечатка в любом из них приведёт к ошибке подключения, а не к ошибке валидации при сохранении. Форма ручного ввода проверяет формат данных, но не то, существует ли сервер по указанному адресу, поэтому итоговую проверку делает только реальное подключение.
Упомянутые темы
Похожие материалы
- Как включить TLS-фрагментацию
- Как поделиться подпиской или конфигурацией
- Схемы ссылок Happ: vless://, vmess://, ss:// и другие
- «Конфигурация не валидная» в Happ: проверка vless и vmess
- Как перенести конфигурации Happ на другое устройство
- Конфигурация в Happ: что это и из чего состоит
- Ключ доступа в Happ: UUID, пароль и где они нужны
- Shadowsocks
Разделы по теме
Источники
- Документация Happ: добавление конфигурации и подписки — обращение 28 сентября 2026
- Документация Happ: примеры ссылок и параметры — обращение 28 сентября 2026
- Документация Happ: Hysteria 2 — обращение 28 сентября 2026