connectivity

Документация и скрипты для работы через прокси ru.hunab.app (149.154.64.19): доступ к продакшену, обход ограничений из РФ, туннели и автозапуск.

Содержимое папки

Файл / папка	Назначение
PROXY_GUIDE.md	Основное руководство: SSH, Nginx, безопасность, scp через туннель, Cursor, скорость
TELEGRAM_GUIDE.md	Гайд по Telegram: быстрые команды и порядок настройки с нуля на новой машине
PROXY_CHANGELOG.md	История изменений (безопасность, скрипты, документация)
BUILD_AAB_FROM_RUSSIA_GUIDE.md	Сборка AAB/APK из России: Maven proxy на проде + SSH-туннель
scripts/	Скрипты для туннелей и локальной работы
launchd/	LaunchAgent для macOS: автозапуск SOCKS-туннеля при входе

Доступ по SSH к прокси — PROXY_GUIDE.md → Доступ и файлы
Telegram через SOCKS — TELEGRAM_GUIDE.md (быстрые команды + гайд для новой машины), launchd/README.md
Cursor (PING timeout из РФ) — PROXY_GUIDE.md → Cursor IDE, в репо: docs/cursor/README.md, скрипт docs/cursor/scripts/cursor-socks-tunnel.sh
Загрузка файлов на прод через прокси — PROXY_GUIDE.md → Загрузка файлов на прод (scp)
Безопасность прокси (nginx, fail2ban) — PROXY_GUIDE.md → Безопасность, SECURITY.md (если есть в папке)
Сборка AAB из РФ — BUILD_AAB_FROM_RUSSIA_GUIDE.md

Скрипт	Описание
telegram-socks-tunnel.sh	Поднять/остановить/проверить SOCKS5 на 127.0.0.1:1081 для Telegram (и др.). Хост: ahau@149.154.64.19. Переменные: `TELEGRAM_SOCKS_PORT`, `TELEGRAM_TUNNEL_HOST`.

Автозапуск SOCKS-туннеля для Telegram при входе в macOS:

com.hunab.telegram-socks.plist — LaunchAgent (RunAtLoad, KeepAlive, порт 1081).
install.sh — один раз скопировать plist и загрузить; дальше туннель поднимается при каждом входе.
uninstall.sh — снять автозапуск.
launchd/README.md — установка, удаление, требования (ключ в keychain), возможные конфликты портов.

Порт	Назначение
1081	Telegram (и др. приложения) — SOCKS через `scripts/telegram-socks-tunnel.sh` или LaunchAgent
10809	Cursor IDE — SOCKS через `docs/cursor/scripts/cursor-socks-tunnel.sh`