Table of Contents

Установка Hamy VPN Client на Debian

📥Шаг 1: Клонирование репозитория
🛠️ Шаг 2: Сборка проекта
▶️ Шаг 3: Запуск
При первом запуске:
🔄 Обновление
❓ Возможные проблемы

Готово! Теперь вы можете использовать HamyVPN Client на своём Debian-устройстве. 🎉

Чтобы запускать из любого места, скопируйте бинарник в /usr/local/bin:

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Установка Hamy VPN Client на Debian

Убедитесь что у вас установлены следующие пакеты:

sudo apt update
sudo apt install -y golang git gcc build-essential \
    libgtk-3-dev libcairo2-dev libgl1-mesa-dev

📥Шаг 1: Клонирование репозитория

git clone https://git.hamystudio.ru/hamystudio/vpn-client.git
cd vpn-client

🛠️ Шаг 2: Сборка проекта

go mod tidy
CGO_ENABLED=1 GOOS=linux GOARCH=amd64 go build -o hamy-vpn-client .

⚠️ Обязательно используйте CGO_ENABLED=1 — Fyne требует CGO для работы с GTK/OpenGL.

▶️ Шаг 3: Запуск

./hamy-vpn-client

При первом запуске:

Приложение создаст файл configs.json (если его нет). Если sing-box отсутствует в папке bin/, клиент автоматически скачает актуальную версию для Linux

🌐 Убедитесь, что у вас есть интернет-доступ при первом запуске!

🔄 Обновление

Чтобы обновить клиент:

cd vpn-client
git pull
go mod tidy
go build -o hamy-vpn-client .

❓ Возможные проблемы

Проблема	Решение
Ошибка: `cannot find package "fyne.io/fyne/v2"`	Выполните `go mod tidy`
Ошибка: `GLX not found` или пустое окно	Установите `libgl1-mesa-dev` и перезапустите сессию
Нет GUI	Убедитесь, что вы работаете в X11/Wayland (не в чистом терминале)

Готово! Теперь вы можете использовать HamyVPN Client на своём Debian-устройстве. 🎉

Чтобы запускать из любого места, скопируйте бинарник в /usr/local/bin:

sudo cp hamy-vpn-client /usr/local/bin/