Добавить Установка на Debian

%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%BD%D0%B0-Debian.md

@@ -0,0 +1,61 @@
+# Установка 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/
+```