Initial commit: local_machine docs and scripts

docs/connectivity/vpn/README.md

@@ -0,0 +1,115 @@
+# 🔐 VPN Решения для Hunab.app
+
+## 📋 Обзор
+
+Документация по VPN решениям для сервера 209.38.32.21. Все решения развернуты через Docker и готовы к использованию.
+
+**Сервер:** 209.38.32.21 (Ubuntu 24.10)  
+**Архитектура:** Docker-based deployment
+
+---
+
+## 🚀 Быстрый старт
+
+### Shadowsocks (Рекомендуется для обхода блокировок)
+
+**Лучший выбор для обхода строгих блокировок и цензуры.**
+
+- 📖 [Полное руководство](./SHADOWSOCKS.md)
+- ⚡ Быстрый старт: `bash scripts/deployment/deploy-vpn-shadowsocks.sh`
+- 📱 [Android инструкция](./SHADOWSOCKS.md#android)
+- 🍎 [macOS инструкция](./SHADOWSOCKS.md#macos)
+
+**Параметры подключения:**
+```
+Server: 209.38.32.21
+Port: 8388
+Password: bNkSbuMQXgMXmuBLPQCA5cSUE
+Method: chacha20-ietf-poly1305
+```
+
+### WireGuard (Рекомендуется для обычного использования)
+
+**Проще в настройке, полное туннелирование из коробки.**
+
+- 📖 [Полное руководство](./WIREGUARD.md)
+- ⚡ Быстрый старт: `bash scripts/deployment/deploy-vpn-wireguard.sh`
+
+---
+
+## 📚 Документация
+
+### Основные руководства
+
+- **[SHADOWSOCKS.md](./SHADOWSOCKS.md)** - Полное руководство по Shadowsocks
+  - Развертывание сервера
+  - Настройка клиентов (Android, macOS, CLI)
+  - Решение проблем
+  - Управление и мониторинг
+
+- **[MAC_CLIENTS.md](./MAC_CLIENTS.md)** - Клиенты для macOS
+  - ShadowsocksX-NG, ClashX, V2rayU, Outline
+  - Настройка системного прокси
+  - Решение проблем с браузерами
+  - Альтернативные клиенты
+
+- **[WIREGUARD.md](./WIREGUARD.md)** - Руководство по WireGuard
+  - Развертывание
+  - Настройка клиентов
+  - Управление
+
+- **[WHONIX.md](./WHONIX.md)** - Whonix для приватности
+  - Установка на Mac
+  - Настройка для Apple Silicon
+  - Использование
+
+---
+
+## 🔧 Скрипты
+
+Все скрипты находятся в папке `scripts/`:
+
+- `scripts/toggle-shadowsocks-proxy.sh` - Переключение системного прокси
+- `scripts/check-proxy-status.sh` - Проверка статуса прокси
+- `scripts/fix-shadowsocks.sh` - Автоматическое исправление
+- `scripts/enable-shadowsocks-full.sh` - Включение для всего трафика
+
+**Использование:**
+```bash
+cd docs/servers/vpn
+./scripts/toggle-shadowsocks-proxy.sh
+./scripts/check-proxy-status.sh
+./scripts/fix-shadowsocks.sh
+./scripts/enable-shadowsocks-full.sh
+```
+
+---
+
+## 📊 Сравнение решений
+
+| Критерий | Shadowsocks | WireGuard |
+|----------|-------------|-----------|
+| **Скорость** | 90-95% | 85-95% |
+| **Обход блокировок** | 🏆 Лучший | Хороший |
+| **Обнаружимость DPI** | 🏆 Сложнее | Легче |
+| **Настройка** | Простая | Очень простая |
+| **Полное туннелирование** | Требует настройку | Из коробки |
+
+**Рекомендация:**
+- **Для обхода блокировок:** Shadowsocks
+- **Для обычного использования:** WireGuard
+
+---
+
+## 🔗 Полезные ссылки
+
+- [Shadowsocks Official](https://shadowsocks.org/)
+- [WireGuard Official](https://www.wireguard.com/)
+- [Whonix Official](https://www.whonix.org/)
+
+---
+
+**Версия:** 2.0  
+**Дата:** 2025-01-XX  
+**Статус:** ✅ Актуально
+