How eljaja/bibavpn works
BibaVPN is a self-hosted Rust proxy tunnel with a shared desktop/Android app. A user configures a profile or imports an encrypted invitation, then connects through local SOCKS5 or HTTP CONNECT endpoints; the client carries traffic over TLS and WebSocket to a user-operated server and onward to the internet. The app also exposes platform VPN and split-tunnel settings. The README documents the end-to-end workflow and major capabilities; source excerpts show selected UI and TLS-profile details, but most runtime internals were not sampled, so undocumented links are omitted.
Main entry points: local_client.rs Local proxy client · App.jsx App interface · ws_bridge.rs WebSocket bridge · server.rs VPN server
Components 24
Client app
- App interface
apps/bibavpn-desktop/ui/src/App.jsx - Profiles and settings
apps/bibavpn-desktop/ui/src/screens/SettingsScreen.jsx - UI localization and types
apps/bibavpn-desktop/ui/src/i18n.js - Desktop backend
apps/bibavpn-desktop/src-tauri/src/lib.rs - Android VPN service
apps/bibavpn-desktop/src-tauri/android-bibavpn-extras/java/dev/bibavpn/BibaVpnService.kt - iOS tunnel extension
apps/bibavpn-desktop/src-tauri/ios-bibavpn-extras/BibaVpnTunnel/PacketTunnelProvider.swift - Native FFI
apps/bibavpn-ffi/src/lib.rs - Android JNI
apps/bibavpn-jni/src/lib.rs
Client runtime
- Local proxy client
bibavpn/src/local_client.rs - SOCKS5 and HTTP CONNECT
bibavpn/src/socks5.rs - Encrypted invitations
bibavpn/src/invite_uri.rs - TLS profile policy
bibavpn/src/client_policy.rs
Tunnel protocol
- TLS profiles
bibavpn/src/tls_util.rs - Traffic shaping
bibavpn/src/stealth_v12.rs - Encrypted frames
bibavpn/src/crypto_layer.rs - Frame and padding
bibavpn/src/frame.rs - TCP multiplexing
bibavpn/src/tcp_mux.rs - UDP relay
bibavpn/src/udp_mux.rs - WebSocket bridge
bibavpn/src/ws_bridge.rs - ClientHello profiles
biba/src/parrot.rs
Server runtime
- Camouflage site
bibavpn/src/camouflage.rs - VPN server
bibavpn/src/bin/server.rs
Other components
- User and apps
- Internet destinations
Connections 25
- User and apps → App interface: configures and connects
README.md - App interface → Profiles and settings: renders
apps/bibavpn-desktop/ui/src/App.jsx - App interface → UI localization and types: uses localization
apps/bibavpn-desktop/ui/src/App.jsx - App interface → Desktop backend: invokes commands
apps/bibavpn-desktop/ui/src/App.jsx - Profiles and settings → Desktop backend: invokes package picker
apps/bibavpn-desktop/ui/src/screens/SettingsScreen.jsx - Desktop backend → Local proxy client: starts client
- Android VPN service → Android JNI: calls native client
apps/bibavpn-desktop/src-tauri/android-bibavpn-extras/java/dev/bibavpn/BibaVpnService.kt - Android JNI → Local proxy client: wraps shared client
- Native FFI → Local proxy client: exposes client
- iOS tunnel extension → Local proxy client: forwards tunnel
- User and apps → SOCKS5 and HTTP CONNECT: sends proxy traffic
README.md - Local proxy client → SOCKS5 and HTTP CONNECT: accepts proxy requests
README.md - Local proxy client → Encrypted invitations: imports invitation
bibavpn/src/local_client.rs - Local proxy client → TLS profile policy: resolves TLS settings
bibavpn/src/client_policy.rs - TLS profile policy → TLS profiles: selects profile
bibavpn/src/client_policy.rs - TLS profiles → ClientHello profiles: uses ClientHello profiles
- Local proxy client → WebSocket bridge: opens tunnel sessions
README.md - WebSocket bridge → TCP multiplexing: carries multiplexed streams
README.md - WebSocket bridge → UDP relay: carries UDP session
README.md - Local proxy client → Encrypted frames: encrypts tunnel traffic
README.md - Encrypted frames → Frame and padding: frames and pads traffic
README.md - Local proxy client → Traffic shaping: applies traffic profiles
bibavpn/src/local_client.rs - WebSocket bridge → VPN server: connects over TLS
README.md - VPN server → Camouflage site: serves camouflage site
README.md - VPN server → Internet destinations: routes tunnel traffic
README.md