From 43e8ad24d5f57736ef12a466748e38303a59ee2a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=A5=D0=BE=D0=BC=D1=8F=D1=87=D0=BE=D0=BA?=
 <hamyack@noreply.localhost>
Date: Fri, 16 Jan 2026 21:08:36 +0000
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D1=82?=
 =?UTF-8?q?=D1=8C=20=D0=A3=D1=81=D1=82=D0=B0=D0=BD=D0=BE=D0=B2=D0=BA=D0=B0?=
 =?UTF-8?q?=20=D0=BD=D0=B0=20Debian?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...E%D0%B2%D0%BA%D0%B0-%D0%BD%D0%B0-Debian.md | 61 +++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 %D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%BD%D0%B0-Debian.md

diff --git a/%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%BD%D0%B0-Debian.md b/%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%BD%D0%B0-Debian.md
new file mode 100644
index 0000000..84a6c1a
--- /dev/null
+++ b/%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/
+```
\ No newline at end of file