70 lines
2.6 KiB
Markdown
70 lines
2.6 KiB
Markdown
# Сборка и запуск
|
|
|
|
## Development
|
|
|
|
```bash
|
|
uv sync
|
|
uv run pytest
|
|
uv run flet run app/main.py
|
|
```
|
|
|
|
`uv` уже был установлен в рабочем окружении. Flet current build creates a Flutter
|
|
shell and packages the Python app; the native Android bridge is registered as a local
|
|
Flet extension from `native/android/flet_vpn_bridge`.
|
|
|
|
## Backend
|
|
|
|
Generate a Fernet key and configure the operator token:
|
|
|
|
```bash
|
|
export VPNAPP_ADMIN_TOKEN="$(python -c 'import secrets; print(secrets.token_urlsafe(32))')"
|
|
export VPNAPP_SECRET_KEY="$(uv run --project backend python -c 'from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())')"
|
|
export VPNAPP_BASE_URL=http://127.0.0.1:8080
|
|
./scripts/run-backend.sh
|
|
```
|
|
|
|
Open `http://127.0.0.1:8080/admin`. The page is one self-contained HTML file with no
|
|
frontend build. It asks for the configured token, lists users/devices, creates/deletes
|
|
them and generates enrollment/subscription links. Deploy behind HTTPS and do not put
|
|
the admin token in a public URL.
|
|
|
|
## Android
|
|
|
|
The Flet shell can be built without native core artifacts; runtime connections then
|
|
return `UNSUPPORTED` honestly. A release build can enforce both artifacts:
|
|
|
|
```bash
|
|
./scripts/fetch-engine-artifacts.sh
|
|
REQUIRE_NATIVE_ARTIFACTS=1 ./scripts/build-android.sh
|
|
```
|
|
|
|
For a native-bridge/permissions smoke APK without cores, run
|
|
`./scripts/build-android.sh`. The script targets `arm64-v8a`.
|
|
|
|
Build prerequisites are current JDK/Android SDK/Flutter as required by Flet. Use a
|
|
device/emulator with API 26+ for LocalOnlyHotspot; API 33+ needs runtime
|
|
`NEARBY_WIFI_DEVICES`. Android VPN consent must be granted interactively by the user.
|
|
|
|
FreeTurn AAR:
|
|
|
|
```bash
|
|
git clone --depth 1 --branch <pinned-ref> https://github.com/samosvalishe/free-turn-proxy.git /tmp/free-turn-proxy
|
|
cd /tmp/free-turn-proxy
|
|
task build:android
|
|
cp dist/freeturn.aar /path/to/repo/native/android/libs/
|
|
```
|
|
|
|
For SignBox, use the exact artifact that exposes the API expected by
|
|
`native/android/flet_vpn_bridge/src/flutter/vpn_native_bridge/android/.../EngineAdapter.kt`. A generic sing-box
|
|
`libbox.aar` is not silently assumed to be the user's private SignBox fork. Record its
|
|
commit, build tags, ABIs, license and SHA-256 in `THIRD_PARTY_NOTICES.md`, then replace
|
|
the adapter with calls from that artifact and add a native integration test.
|
|
|
|
## Desktop
|
|
|
|
```bash
|
|
SIGNBOX_BIN=/absolute/path/to/sign-box ./scripts/build-desktop.sh linux
|
|
SIGNBOX_BIN=/absolute/path/to/sign-box.exe ./scripts/build-desktop.sh windows
|
|
```
|
|
|
|
Desktop SignBox proxy mode is process based. System proxy changes are not performed.
|