Files

ahauimix 1938b7c743 Expand local_machine docs and automation for connectivity, games, and ops.

Add proxy/VPN/telegram launchd and emergency runbooks; reorganize apps docs;
document JA3 CrossOver runbook and Wine troubleshooting; add GOG/HoMM game
scripts, disk cleanup guides, and gitea push-via-proxy helper. Ignore temp/.

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-06-01 08:12:19 +03:00

5.0 KiB

Raw Blame History

connectivity

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

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

Файл / папка	Назначение
PROXY_GUIDE.md	Основное руководство: SSH, Nginx, безопасность, scp через туннель, Cursor, скорость
TELEGRAM_GUIDE.md	Telegram SOCKS: быстрые команды → регламент → развёртывание с нуля по сценариям
PROXY_CHANGELOG.md	История изменений (безопасность, скрипты, документация)
BUILD_AAB_FROM_RUSSIA_GUIDE.md	Сборка AAB/APK из России: Maven proxy на проде + SSH-туннель
WINDOWS_CURSOR_TUNNEL.md	Cursor из РФ на Windows: туннель через прокси, скрипт .ps1, автозапуск
WINDOWS_SSH_KEY_INSTALL.md	Установка SSH-ключа на Windows (один файл `setup-ssh-key-for-proxy.ps1`, только для туннеля)
HOTSPOT_NETWORK_EMERGENCY.md	Сеть после смены хотспота: причина (PAC localhost), ручной сброс без ребута, `macos-hotspot-network-recover.sh`
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 (macOS/Linux), Windows: WINDOWS_CURSOR_TUNNEL.md и docs/cursor/scripts/cursor-socks-tunnel.ps1
Загрузка файлов на прод через прокси — PROXY_GUIDE.md → Загрузка файлов на прод (scp)
Безопасность прокси (nginx, fail2ban) — PROXY_GUIDE.md → Безопасность, SECURITY.md (если есть в папке)
Сборка AAB из РФ — BUILD_AAB_FROM_RUSSIA_GUIDE.md

Скрипты (scripts/)

Скрипт	Описание
telegram-socks-tunnel.sh	SOCKS5 на 1081 для Telegram. `TELEGRAM_SOCKS_VIA_DO=1` — только Mac→RU→DO (`telegram-socks-via-do`); без RU — ошибка. См. PROXY_GUIDE.
macos-hotspot-network-recover.sh	После смены хотспота: `status` / `recover` (PAC off, SOCKS off на Wi‑Fi, DNS, DHCP, перезапуск радио). См. HOTSPOT_NETWORK_EMERGENCY.md.
ssh-hunab-prod.sh	Опционально: сначала `hunab-prod-direct`, иначе `hunab-prod` (в конфиге по умолчанию уже через RU). См. PROXY_GUIDE.

launchd/

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

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

Порты (без пересечений)

Порт	Назначение
1081	Telegram (и др. приложения) — SOCKS через `scripts/telegram-socks-tunnel.sh` или LaunchAgent
10809	Cursor IDE — SOCKS через `docs/cursor/scripts/cursor-socks-tunnel.sh` / `cursor-socks-tunnel.ps1`; по умолчанию только Mac→RU→DO (`CURSOR_SOCKS_VIA_DO=1`, `telegram-socks-via-do`)

5.0 KiB Raw Blame History Unescape Escape