5.5 KiB
5.5 KiB
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 | Сеть после reconnect хотспота: Joplin Manual IP + смена подсети Android, route flush, PAC; macos-hotspot-network-recover.sh |
| apps/joplin/STABLE_SETUP.md | Joplin: стабильный URL на телефоне (статический IP Mac на Android-хотспоте) |
| apps/joplin/RUNBOOK.md | Joplin Mac ↔ телефон: диагностика, ETIMEDOUT/401, логи |
| 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
- Joplin: синк Mac ↔ телефон — настройка apps/joplin/STABLE_SETUP.md, поломки apps/joplin/RUNBOOK.md,
./docs/apps/joplin/scripts/joplin-webdav-status.sh
Скрипты (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 | Reconnect хотспота: bash …/macos-hotspot-network-recover.sh recover — DHCP, route flush (sudo), Joplin alias *.100. См. 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) |