Happ VPN
Тарифы

Установка Happ на Ubuntu и Debian

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

Коротко

Скачайте Happ.linux.x64.deb (или вариант arm64) из релизов happ-desktop на GitHub и выполните в папке с файлом sudo apt install ./Happ.linux.x64.deb. Поддерживаются Ubuntu 22.04+ и Debian 11.6+ с glibc 2.31 и новее.

Для Ubuntu и Debian Happ распространяется пакетом .deb в двух вариантах: x64 для обычных ПК и arm64 для ARM-плат и ноутбуков. Установка через apt с путём к файлу сама подтягивает зависимости из репозиториев системы. Официально поддерживаются Ubuntu 22.04 и новее и Debian 11.6 и новее; приложению нужны glibc 2.31+ и библиотеки GCC 10+. Для Fedora и Red Hat есть пакет .rpm, для Arch — .pkg.tar.zst.

Коротко об установке

Happ для Linux — та же десктопная сборка на Qt 6, что и для Windows, упакованная в .deb, .rpm и .pkg.tar.zst. Для Ubuntu и Debian нужен .deb; все файлы лежат в релизах github.com/Happ-proxy/happ-desktop.

Документация называет минимальные версии: Ubuntu 22.04, Debian 11.6 и Red Hat 8.10. Ограничение идёт от системных библиотек — нужны glibc 2.31+ и GCC 10+, поэтому на старых дистрибутивах современная версия не запустится.

Производные дистрибутивы на базе Ubuntu 22.04 и новее, например Linux Mint 21 и новее, обычно принимают тот же .deb, но в официальных требованиях они не перечислены.

Чем отличается установка на этом устройстве

  • Установка из терминала одной командой apt вместо графического мастера.
  • Отдельные пакеты для x64 и arm64 — архитектуру выбирают самостоятельно.
  • Совместимость определяется версиями glibc и GCC, а не только номером дистрибутива.
  • Для других семейств Linux свои форматы: .rpm для Fedora и RHEL, .pkg.tar.zst для Arch.
  • Happ нет в репозиториях Ubuntu и Debian, поэтому apt upgrade его не обновляет — новую версию ставят тем же способом.

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

  • Проверьте версию системы командой lsb_release -a — нужна Ubuntu 22.04+ или Debian 11.6+.
  • Узнайте архитектуру: dpkg --print-architecture выводит amd64 или arm64.
  • Проверьте glibc: первая строка вывода ldd --version должна показывать 2.31 или выше.
  • Убедитесь, что у вашего пользователя есть права sudo.
  • Подготовьте ссылку подписки или конфигурацию для импорта.

Пошаговая установка

  1. Скачайте пакет

    Откройте страницу релизов happ-desktop на GitHub и скачайте Happ.linux.x64.deb для amd64 или Happ.linux.arm64.deb для arm64. Из терминала то же делает команда wget https://github.com/Happ-proxy/happ-desktop/releases/latest/download/Happ.linux.x64.deb.

    Результат: Файл .deb лежит в папке «Загрузки» или в текущей папке терминала.

    Скриншот (TODO): Раздел Assets релиза happ-desktop, выделены Happ.linux.x64.deb и Happ.linux.arm64.deb.

  2. Перейдите в папку с файлом

    Откройте терминал сочетанием Ctrl+Alt+T и выполните cd ~/Загрузки. В русской локали папка называется так, в английской — ~/Downloads.

    Результат: Команда ls показывает файл Happ.linux.x64.deb.

    Скриншот (TODO): Терминал Ubuntu: команды cd ~/Загрузки и ls, в выводе файл Happ.linux.x64.deb.

  3. Установите пакет через apt

    Выполните sudo apt update, затем sudo apt install ./Happ.linux.x64.deb. Префикс ./ говорит apt, что это локальный файл, а не имя пакета в репозитории; зависимости apt докачает сам.

    Результат: apt показывает список пакетов для установки и завершает работу без ошибок.

    Скриншот (TODO): Терминал с выводом apt install ./Happ.linux.x64.deb и строкой о настройке пакета.

  4. Не пугайтесь замечания о песочнице

    Если файл лежит в домашней папке, apt может вывести замечание, что скачивание выполняется без песочницы от имени root (unsandboxed). Это не ошибка: пакет всё равно устанавливается.

    Результат: После замечания apt сообщает о настройке пакета Happ.

    Скриншот (TODO): Терминал с замечанием apt про unsandboxed и последующей настройкой пакета.

  5. Проверьте установку

    Выполните dpkg -l | grep -i happ, чтобы увидеть имя и версию установленного пакета. Если apt сообщил о неразрешённых зависимостях, проверьте версию glibc командой ldd --version.

    Результат: В выводе есть строка со статусом ii и версией Happ.

    Скриншот (TODO): Терминал с выводом dpkg -l | grep -i happ.

  6. Запустите Happ

    Откройте Happ через «Показать приложения» в Ubuntu или меню приложений вашего окружения. При первом включении режима TUN система может запросить пароль: создание виртуального сетевого интерфейса в Linux требует повышенных прав.

    Результат: Открылось главное окно Happ без сообщений об ошибках библиотек.

    Скриншот (TODO): Меню приложений Ubuntu с найденным значком Happ.

  7. Добавьте подписку и подключитесь

    Скопируйте ссылку подписки, добавьте её в Happ из буфера обмена и подключитесь к серверу. При ошибке «Timeout при добавлении подписки» проверьте доступность сервера подписки: приложение ждёт его ответа 9 секунд.

    Результат: Серверы из подписки в списке, подключение активно.

    Скриншот (TODO): Главное окно Happ на Ubuntu с активным подключением.

Особенности и ограничения

Fedora и Red Hat: скачайте Happ.linux.x64.rpm и выполните sudo dnf install ./Happ.linux.x64.rpm. Минимальная поддерживаемая версия Red Hat по документации — 8.10.

Arch Linux и производные: скачайте Happ.linux.x64.pkg.tar.zst и установите командой sudo pacman -U ./Happ.linux.x64.pkg.tar.zst. Отдельной минимальной версии для Arch документация не называет — действуют те же glibc 2.31+ и GCC 10+.

Ubuntu 20.04 и Debian 10 в список поддерживаемых не входят. Если приложение не стартует с ошибкой о не найденной версии GLIBC или GLIBCXX, система слишком старая: обновите дистрибутив или используйте Legacy-версию 1.0.2.

Для удаления выполните sudo apt remove с именем пакета из вывода dpkg -l. Если после сна ноутбука пропадал туннель, обновитесь до 4.3.0 или новее — в этом релизе проблема исправлена для Linux.

Что дальше

Главное

  • Пакет выбирают по архитектуре: команда dpkg --print-architecture выводит amd64 для x64 или arm64.
  • Команда sudo apt install ./Happ.linux.x64.deb ставит пакет вместе с недостающими зависимостями; префикс ./ обязателен.
  • Минимальные требования Happ для Linux — glibc 2.31 и GCC 10; версию glibc показывает ldd --version.
  • Для Fedora и Red Hat 8.10+ предназначен Happ.linux.x64.rpm, для Arch Linux — Happ.linux.x64.pkg.tar.zst.
  • В релизе 4.3.0 исправлена потеря туннеля после сна на Linux.

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

Чем apt install ./файл.deb лучше, чем dpkg -i?

dpkg -i ставит только сам пакет и останавливается, если в системе нет нужной библиотеки. apt install с путём к файлу разбирает зависимости и докачивает их из репозиториев. Если вы уже запускали dpkg -i и получили ошибку зависимостей, выполните sudo apt -f install — apt доустановит недостающие пакеты и завершит настройку Happ.

Как понять, какой пакет Happ нужен: x64 или arm64?

Выполните dpkg --print-architecture. Ответ amd64 означает, что нужен Happ.linux.x64.deb, ответ arm64 — Happ.linux.arm64.deb. Архитектура arm64 встречается на одноплатных компьютерах, ARM-ноутбуках и виртуальных машинах на Mac с Apple Silicon. Пакет чужой архитектуры dpkg откажется ставить с сообщением о несовпадении архитектуры пакета и системы.

Запустится ли Happ на Ubuntu 20.04?

Официально нет: документация называет минимальной Ubuntu 22.04. В Ubuntu 20.04 glibc формально версии 2.31, но этот выпуск в список поддерживаемых не входит, и корректная работа не гарантирована. Надёжнее обновиться до 22.04 или 24.04. Для совсем старых систем разработчики оставили Legacy-версию 1.0.2 без функций ветки 4.x.

Как обновить Happ в Ubuntu?

Happ нет в репозиториях Ubuntu, поэтому sudo apt upgrade его не обновит. Скачайте новый .deb со страницы релизов и выполните ту же команду sudo apt install ./Happ.linux.x64.deb — apt заменит старую версию. Стабильный релиз на 2026-09-27 — 4.3.0; пререлизы вроде 4.4.6 публикуются отдельно и по ссылке latest не скачиваются.

Нужно ли запускать Happ через sudo?

Нет, открывайте Happ как обычную программу из меню приложений. Графические программы, запущенные от root, создают файлы настроек с правами суперпользователя в домашней папке, и потом обычный запуск ломается. Повышенные права система запрашивает сама, когда они действительно нужны, например при создании виртуального сетевого интерфейса в режиме TUN.

Можно ли поставить Happ на Debian 11?

Да, если система обновлена до Debian 11.6 или новее. В Debian 11 используется glibc 2.31 — ровно минимальная версия для Happ. Номер выпуска показывает команда cat /etc/debian_version; если он ниже 11.6, выполните sudo apt update и sudo apt full-upgrade. Debian 12 и более новые выпуски тоже подходят.

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

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

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

Источники

  1. Документация Happ — обращение 27 сентября 2026
  2. Системные требования Happ — обращение 27 сентября 2026
  3. Релизы happ-desktop на GitHub — обращение 27 сентября 2026
  4. Happ Legacy 1.0.2 на GitHub — обращение 27 сентября 2026
  5. Ошибки Happ — обращение 27 сентября 2026