Установка и настройка Happ в Linux-дистрибутивах

Установка Happ на Linux: AppImage и .deb

Десктопная сборка Happ распространяется в разделе Releases репозитория Happ-proxy на GitHub. Для большинства дистрибутивов удобнее универсальный формат AppImage — он не требует установки и запускается из любой папки. Для семейства Debian и Ubuntu есть отдельный пакет .deb.

Скачайте свежий файл под свою архитектуру (обычно x86_64) и сделайте AppImage исполняемым, затем запустите: `chmod +x Happ-x86_64.AppImage` и `./Happ-x86_64.AppImage`. Для .deb используйте `sudo apt install ./happ_amd64.deb` — менеджер пакетов сам подтянет зависимости.

Если AppImage не стартует, чаще всего не хватает библиотеки FUSE. Установите её командой `sudo apt install libfuse2` (Debian/Ubuntu) или аналогом для вашего дистрибутива. В качестве обходного пути AppImage можно распаковать и запустить напрямую: `./Happ-x86_64.AppImage --appimage-extract` и затем `./squashfs-root/AppRun`.

Импорт подписки и конфигурации

Доступ к серверам выдаёт Telegram-бот сервиса: там вы активируете пробный, оплаченный или официальный ключ и получаете ссылку-подписку вида https://…/sub/…. Эта ссылка содержит актуальный список серверов и параметры Xray — вводить конфиги вручную не нужно.

В приложении откройте добавление конфигурации, вставьте ссылку-подписку и сохраните. Happ загрузит все доступные серверы одним списком и в дальнейшем будет обновлять их по этой же ссылке. Если серверы меняются или добавляются новые локации, достаточно нажать обновление подписки — переустановка не требуется.

При необходимости можно добавить и одиночную конфигурацию: скопируйте строку vless:// или ss:// из бота и вставьте её через импорт из буфера обмена. Один и тот же ключ работает на всех устройствах, поэтому подписка для Linux, Windows и мобильных клиентов совпадает.

Запуск прокси-режима на ядре Xray

После импорта выберите сервер из списка и включите подключение. Happ поднимает локальный прокси (SOCKS и HTTP) на ядре Xray и маршрутизирует через него трафик. В системном режиме клиент прописывает прокси в настройки рабочего окружения, поэтому браузеры и большинство приложений начинают работать через туннель без дополнительной настройки.

Локальный порт прокси можно указать вручную в настройках приложения — это удобно, когда нужно направить в Happ только конкретную программу. Пропишите адрес 127.0.0.1 и заданный порт в настройках прокси браузера или в переменных окружения (например, `export https_proxy=http://127.0.0.1:PORT`), а остальной трафик оставить напрямую.

Для точечного разделения трафика в Happ есть маршрутизация по спискам и split tunneling — какие домены и приложения идут через прокси, а какие в обход. Подробный разбор правил и utility вынесен в отдельные разделы сайта, чтобы не смешивать базовую установку с тонкой настройкой маршрутов.

Автозапуск Happ при старте системы

Чтобы прокси поднимался автоматически, добавьте клиент в автозагрузку рабочего окружения. Создайте файл `~/.config/autostart/happ.desktop` со строками `[Desktop Entry]`, `Type=Application`, `Exec=/полный/путь/Happ-x86_64.AppImage` и `X-GNOME-Autostart-enabled=true`. GNOME, KDE и большинство сред подхватят его при следующем входе.

Для .deb-установки ярлык автозапуска можно включить прямо в настройках приложения либо через меню автозагрузки вашего окружения — путь к исполняемому файлу подставится автоматически. После входа Happ свернётся в системный трей и будет доступен из значка рядом с часами.

Если вы запускаете Linux без графической оболочки, оформите запуск как пользовательский сервис systemd: положите unit в `~/.config/systemd/user/`, укажите путь к AppImage в `ExecStart` и активируйте автозапуск командой `systemctl --user enable --now happ.service`.

Проверка соединения и диагностика

После подключения проверьте, что трафик идёт через сервер: откройте любой сервис определения IP — адрес и страна должны соответствовать выбранной локации. Если IP остался прежним, убедитесь, что системный прокси включён, а приложение читает нужный локальный порт.

При обрывах или медленной скорости смените сервер в списке подписки — соседние локации часто дают более стабильный маршрут. Затем обновите подписку, чтобы получить актуальные параметры Xray, и перезапустите подключение. Иногда мешает локальный фаервол: разрешите Happ исходящие соединения в ufw или firewalld.

Если после обновления клиента список серверов не загружается, проверьте срок действия ключа в Telegram-боте и корректность ссылки-подписки. Логи подключения доступны в самом приложении и помогают отличить проблему с ключом от сетевой блокировки.