Happ VPN
Тарифы

Настройка Happ на Linux

Автор
Дмитрий Соколов, ведущий технический автор
Проверил:
Артём Волков
Проверено:
Опубликовано:
Версия гайда:
1.0

Коротко

Чтобы настроить Happ на Linux, импортируйте ключ или подписку кнопкой «+» из буфера обмена, выберите сервер и подключитесь в режиме TUN, если нужен весь трафик системы. Системный прокси учитывают только программы, читающие настройки рабочего стола.

На Linux Happ работает как на других десктопах: импорт через «+», выбор сервера, подключение, пинг. Отличие в том, как система распределяет трафик. Режим TUN создаёт сетевой интерфейс и охватывает все программы, включая терминал и контейнеры на хосте. Системный прокси записывается в настройки GNOME или KDE, и его видят не все приложения, а консольные утилиты смотрят на переменные окружения.

Перед настройкой

Настройка Happ на Linux начинается так же, как на Windows и macOS: импорт ключа или подписки, выбор сервера и подключение. Отличается то, как дистрибутив раздаёт трафик программам.

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

Инструкция рассчитана на сборку Qt 6 для Ubuntu 22.04+, Debian 11.6+ и Red Hat 8.10+. Названия системных меню зависят от окружения рабочего стола.

Пошаговая настройка

  1. Запустите Happ из меню приложений

    Найдите Happ в меню приложений или запустите его из терминала. При первом запуске приложение откроется с пустым списком серверов.

    Результат: Главное окно Happ без конфигураций.

  2. Скопируйте ключ или подписку

    Скопируйте строку ключа vless://, vmess://, trojan://, ss://, socks:// или hysteria2://, адрес подписки или зашифрованную ссылку happ://crypt в буфер обмена рабочего стола.

    Результат: Строка в буфере обмена целиком.

  3. Импортируйте кнопкой «+»

    Нажмите «+» вверху справа и выберите вставку из буфера обмена. Если диплинк из браузера не открывает Happ, скопируйте ссылку и вставьте её тем же способом. Для своего сервера подойдёт «Ручной ввод».

    Результат: Серверы появились в «Список серверов».

  4. Выберите режим и подключитесь

    Выберите сервер, режим TUN или системный прокси и нажмите кнопку подключения. Для TUN системе нужны повышенные права: если появится запрос пароля администратора, введите его.

    Результат: Статус подключено, в выводе ip link появляется новый интерфейс в режиме TUN.

  5. Проверьте пинг

    Нажмите иконку спидометра в шапке подписки. Если TCP-пинг кажется слишком низким, это может быть задержка до ближайшей точки CDN; способ Via Proxy HEAD покажет задержку через прокси точнее.

    Результат: Задержки в мс рядом с серверами, «Проверить текущее соединение» не показывает «Тайм-аут».

  6. Настройте маршрутизацию

    Импортируйте профиль ссылкой happ://routing/add/ или соберите его в routing.happ.su. Локальные сети 10.0.0.0/8, 172.16.0.0/12 и 192.168.0.0/16 уже идут напрямую по умолчанию.

    Результат: Профиль появился у подписки и применится при следующем подключении.

  7. Раздайте доступ по LAN при необходимости

    Включите «Разрешить LAN-подключения» в «Расширенные настройки», подключитесь к серверу и откройте порты SOCKS5 и HTTP в брандмауэре дистрибутива.

    Результат: Happ показывает текущий IP и порты, другие устройства сети подключаются к ним.

Режимы подключения

TUN
Happ создаёт виртуальный сетевой интерфейс и направляет в него трафик системы. Подходит для терминала, менеджеров пакетов и программ без настроек прокси. В пререлизе 4.4.6 режимом TUN по умолчанию стал Xray TUN.
Системный прокси
Happ записывает локальный прокси в сетевые настройки рабочего стола. Их читают браузеры и приложения GNOME и KDE, но не все консольные утилиты. В пререлизе 4.4.6 есть настройка исключений системного прокси.
Локальный SOCKS5 и HTTP для LAN
При включённой функции «Разрешить LAN-подключения» Linux-машина принимает подключения от других устройств сети на портах SOCKS5 и HTTP, которые показывает Happ.

Что поддерживает Happ на Linux

ВозможностьПоддержка
TUN-режим (весь трафик устройства)Да
Системный проксиДа
Прокси для отдельных приложенийНет данных
Раздача подключения по локальной сетиДа
МаршрутизацияПрофили маршрутизации

Советы

Если ноутбук на Linux теряет туннель после сна, проверьте версию: исправление вошло в релиз 4.3.0. На более старых версиях помогает переподключение.

Не держите одновременно другой клиент с режимом TUN. Два интерфейса и их маршруты по умолчанию мешают друг другу и DNS.

Если после загрузки геофайлов рядом с профилем маршрутизации появился красный восклицательный знак, проверьте доступ к GitHub. Загрузка останавливается, если не завершилась за 3 минуты.

Для контейнеров Docker на той же машине режим TUN охватывает трафик хоста, но сетевые настройки контейнеров могут требовать отдельной проверки.

Связанные инструкции

Главное

  • На Linux режим TUN охватывает трафик всех программ, включая консольные утилиты.
  • Системный прокси рабочего стола учитывают браузеры и GTK- или Qt-приложения, но не curl, git и apt.
  • Для консольных программ можно указать локальный порт Happ в переменных http_proxy и https_proxy.
  • Для LAN-раздачи на Linux нужно открыть порты SOCKS5 и HTTP во встроенном брандмауэре дистрибутива.
  • JSON-конфигурации Xray передаются в ядро без изменений, маршрутизация Happ к ним не применяется.

Частые вопросы

Почему в Linux браузер идёт через Happ, а apt и curl нет?

Режим системного прокси меняет настройки рабочего стола, которые читают Firefox, Chromium и приложения GNOME или KDE. Утилиты командной строки смотрят на переменные окружения http_proxy и https_proxy. Либо задайте их с локальным HTTP-портом Happ, либо переключитесь в режим TUN, тогда весь трафик системы пойдёт через туннель.

Работает ли системный прокси Happ в Wayland и на других окружениях?

Системный прокси в Linux — это не функция ядра, а настройка конкретного рабочего стола. В GNOME и KDE её видно в параметрах сети в разделе «Прокси», и она не зависит от X11 или Wayland. В минималистичных оконных менеджерах такой общей настройки часто нет, и там надёжнее режим TUN.

Как открыть порты для LAN-подключений на Linux?

Включите «Разрешить LAN-подключения» в «Расширенные настройки» и посмотрите порты SOCKS5 и HTTP, например 10808 и 10809. В Ubuntu с ufw выполните sudo ufw allow 10808/tcp и то же для 10809. В Fedora и Red Hat с firewalld добавьте порты командой firewall-cmd --add-port. После этого устройства из той же подсети смогут подключиться.

Можно ли использовать в Happ на Linux свой JSON-конфиг Xray?

Да, Happ принимает JSON-конфигурации и передаёт их в Xray-core без изменений. Маршрутизация Happ к ним не применяется, правила задаются внутри самого JSON. Из активного профиля берутся только выбор GEO-файлов и удалённый DNS. Для JSON-подписок допустим ноль или один профиль маршрутизации, изменить его нельзя.

Что делать, если после подключения не работают домены, а IP открываются?

Проблема в DNS. Профиль маршрутизации по умолчанию использует удалённый DNS-over-HTTPS cloudflare-dns.com, а для прямых запросов — dns.google. Проверьте, что systemd-resolved или NetworkManager не отправляют запросы мимо интерфейса TUN, и переподключитесь. Для диагностики сравните вывод resolvectl status до и после подключения.

Как запускать Happ вместе с системой в Linux?

Если в настройках приложения нет пункта автозапуска, используйте средства рабочего стола: в KDE это «Параметры системы» → «Автозапуск», в GNOME — список автоматически запускаемых приложений. Универсальный способ — скопировать ярлык Happ, обычно это .desktop-файл в /usr/share/applications, в папку ~/.config/autostart. В пререлизе 4.4.6 у каждой подписки появилась своя настройка подключения при запуске.

Упомянутые темы

Похожие материалы

Разделы по теме

Источники

  1. Системные требования Happ — обращение 27 сентября 2026
  2. Документация Happ: таблица загрузок — обращение 27 сентября 2026
  3. Релизы happ-desktop на GitHub — обращение 27 сентября 2026
  4. Happ Legacy 1.0.2 на GitHub — обращение 27 сентября 2026
  5. Добавление конфигурации и подписки — обращение 27 сентября 2026
  6. Подключения по локальной сети — обращение 27 сентября 2026
  7. Маршрутизация в Happ — обращение 27 сентября 2026
  8. Пинг в Happ — обращение 27 сентября 2026