openflux-mobile/README.md

OpenFlux Mobile (зеркало + инструкция)

Зеркало официального Android-клиента OpenFlux. Нужно, чтобы APK можно было скачать на телефон из сети, где GitHub недоступен.

Скачать: releases/tag/0.0.2 → OpenFluxAndroid-arm64.apk (22 145 615 байт, версия 0.0.2 от 11.09.2026, лицензия GPL-3.0)

sha256 = 582453b1282df790a0d43aec7dd5906d2c3c7751f1ef305008a5105899d88ab1 — совпадает с файлом из релиза апстрима, проверено анонимной скачкой 13.09.2026.

Зачем это

Мобильный интернет по белым спискам: обычный VPN ломается не шифрованием, а тем, что его endpoint не в белом списке. OpenFlux несёт TCP-туннель внутри легального сервиса — клиент и exit-node встречаются на канале транспорта, поэтому exit-node работает за NAT, без белого IP и проброса портов.

Схема: телефон → транспорт (Яндекс.Документы / MAX) → exit-node на малине → интернет. Exit-node в нашей сети достаёт и наши сервисы (kodlo.art, Gitea, HQ, n8n).

Настройка в приложении

1. Транспорт → Яндекс.Документы (yandex) либо vyandex.
2. В поле URL вставить ссылку на публичный Яндекс-Документ (доступ по ссылке).
3. Сохранить и включить туннель (системный VPN, маршрут по умолчанию — на всё).

Креды для Яндекса не нужны: транспорт сам открывает документ по ссылке и берёт из страницы анонимные cookie и editor-токен. Аккаунт нужен только чтобы документ существовал.

MAX-транспорт требует токен и user id аккаунта — это фактически доступ к сессии аккаунта; апстрим прямо предупреждает не использовать основной аккаунт.

Обвязка на нашей стороне

/home/pi/openflux на малине: собранный exit-node arm64 + run_exit_node.sh, скилл openflux-whitelist-bypass. Локально исправлен баг апстрима: с --encryption-key-file туннель молча не работал (разные соли KDF у клиента и exit-node) — в main.go context теперь всегда равен типу транспорта.