Happ — кроссплатформенный VPN-клиент с открытым исходным кодом. На Linux он работает стабильно, управляется из командной строки и легко встраивается в автозапуск через systemd. В этой статье — всё, что нужно для установки и первого подключения.
Что такое Happ и как он работает на Linux
Happ — open-source VPN-клиент, который использует протоколы на базе Xray-core: VLESS, VMess и другие. Клиент поддерживает маршрутизацию трафика, обход блокировок и гибкую конфигурацию через файлы настроек.
На Linux Happ работает на большинстве популярных дистрибутивов, включая Ubuntu, Debian, Fedora, openSUSE, Arch Linux и их производные. Актуальный список поддерживаемых платформ публикуется в репозитории github.com/Happ-proxy.
Важное разграничение: Happ — бесплатный клиент. Happ Plus — платная подписка, которая даёт доступ к приоритетным серверам с повышенной скоростью и стабильностью. Клиент работает без подписки, но к серверам Happ Plus без неё не подключиться.
Системные требования
Happ нетребователен к ресурсам и запускается даже на слабом железе:
| Параметр | Минимум |
|---|---|
| ОС | Linux с ядром 3.10+ |
| Оперативная память | 64 МБ |
| Дисковое пространство | ~50 МБ |
| Архитектура | x86_64, ARM64, ARMv7 |
Из зависимостей, как правило, нужны:
glibcактуальной версии (обычно уже есть в системе)curlилиwgetдля загрузкиsystemdдля автозапуска (опционально)
На Debian/Ubuntu может дополнительно потребоваться пакет ca-certificates для работы с TLS.
Установка Happ на Linux
Актуальные релизы публикуются в репозитории github.com/Happ-proxy. Там же находится документация.
Загрузка и установка вручную
-
Откройте раздел Releases в репозитории и скачайте архив для вашей архитектуры (например,
happ-linux-amd64.tar.gz). -
Распакуйте архив:
tar -xzf happ-linux-amd64.tar.gz -C /opt/happ
- Сделайте бинарник исполняемым:
chmod +x /opt/happ/happ
- Добавьте символическую ссылку для удобства:
sudo ln -s /opt/happ/happ /usr/local/bin/happ
Проверка установки
happ --version
Если выводится версия — клиент установлен корректно.
Первоначальная настройка и подключение
Добавление сервера
Happ использует конфигурационные файлы в формате JSON — аналогично Xray-core. Создайте файл конфигурации:
mkdir -p ~/.config/happ
nano ~/.config/happ/config.json
Вставьте конфигурацию сервера в стандартном формате (inbounds, outbounds, routing). Данные для подключения вы получаете вместе с подпиской или от своего провайдера серверов.
Запуск и проверка
Запустите клиент с указанием конфига:
happ run -c ~/.config/happ/config.json
Проверьте, что IP изменился:
curl ifconfig.me
Если адрес отличается от вашего реального — подключение работает.
Подключение к приоритетным серверам через Happ Plus
Happ Plus открывает доступ к выделенным серверам с приоритетной маршрутизацией — стабильная скорость в пиковые часы и меньшие задержки по сравнению с публичными узлами.
Как получить данные для подключения
- Оформите подписку Happ Plus.
- После оплаты в личном кабинете появятся данные подключения: ссылка-подписка или готовый конфиг.
- Скопируйте конфиг и сохраните его в
~/.config/happ/config.json.
Проверка приоритетных серверов
happ run -c ~/.config/happ/config.json
curl ifconfig.me
Если IP изменился на адрес из пула Happ Plus — всё работает правильно.
Конфиг добавлен и соединение проверено — чтобы получить приоритетные серверы с гарантированной скоростью, оформите Happ Plus.
Оформить Happ PlusАвтозапуск и управление через командную строку
На серверах и десктопах удобно запускать Happ автоматически через systemd.
Создание systemd-юнита
sudo nano /etc/systemd/system/happ.service
Содержимое:
[Unit]
Description=Happ VPN Client
After=network.target
[Service]
Type=simple
ExecStart=/usr/local/bin/happ run -c /home/YOUR_USER/.config/happ/config.json
Restart=on-failure
RestartSec=5
User=YOUR_USER
[Install]
WantedBy=multi-user.target
Замените YOUR_USER на имя вашего пользователя.
Управление сервисом
# Включить автозапуск
sudo systemctl enable happ
# Запустить сейчас
sudo systemctl start happ
# Проверить статус
sudo systemctl status happ
# Остановить
sudo systemctl stop happ
Логи
# Последние 50 строк
journalctl -u happ -n 50
# Следить в реальном времени
journalctl -u happ -f
Решение типичных проблем
Клиент не запускается
- Проверьте права на исполнение:
ls -la /usr/local/bin/happ - Убедитесь в совместимости glibc:
ldd --version - Запустите с подробным выводом:
happ run -c config.json -v
Нет подключения к серверу
- Проверьте адрес и порт сервера в конфиге.
- Убедитесь в доступности сервера:
curl -v telnet://SERVER_IP:PORT - Посмотрите логи — там обычно видна конкретная ошибка (timeout, TLS handshake failed и т.д.).
Конфликты с файрволом
Если используете ufw:
sudo ufw allow out to any port 443
sudo ufw status verbose
Для iptables:
sudo iptables -A OUTPUT -p tcp --dport 443 -j ACCEPT
Конкретный порт смотрите в конфиге сервера или в логах клиента.
Конфликт с другими VPN-клиентами
Если на машине уже запущен другой VPN, может возникнуть конфликт маршрутов. Остановите другие VPN-сервисы перед запуском Happ:
sudo systemctl stop openvpn
sudo systemctl stop wireguard