How mustafaahmed007/sentinel-vpn- works
Sentinel-VPN Ω is a self-hosted Windows WireGuard VPN whose defining workflow is: a user configures a tunnel in the desktop UI, requests connection through the native boundary, and the privileged service coordinates protection and reports status. The documented security stages include firewall lockdown, tunnel startup, handshake, and verification before normal traffic is exposed. The service also owns DNS, profiles, network-change handling, and diagnostics; a separate Go VPS API manages peers and bounded P2P forwarding. Several internal links reflect README architecture documentation; unsampled implementations are not inferred beyond it.
Main entry points: lib.rs VPN service · main.rs Service runtime · main.go Peer and P2P API · main.tsx Desktop UI
Components 20
Windows client
- Desktop UI
apps/desktop/src/main.tsx - Tauri shell
apps/desktop/src-tauri/src/lib.rs
Privileged protection
- VPN service
crates/service/src/lib.rs - Service runtime
crates/service/src/main.rs - Authenticated IPC
crates/ipc/src/lib.rs - Connection state
crates/vpn-core/src/lib.rs - Windows firewall
crates/firewall-windows/src/lib.rs - WireGuard client
crates/wireguard-controller/src/lib.rs - DNS policy
crates/dns-controller/src/lib.rs - Network monitoring
crates/network-monitor/src/lib.rs - Profile management
crates/profile-manager/src/lib.rs - Verification diagnostics
crates/diagnostics/src/lib.rs
VPS control plane
- Peer and P2P API
server/cmd/sentinel-server/main.go - Peer and lease state
server/cmd/sentinel-server/main.go - Port forwarding
server/internal/firewall/nftables.go - VPS WireGuard
server/internal/wireguard/wireguard.go
External systems
- Windows network stack
- WireGuard peer
Other components
- VPN user
- VPS operator
Connections 19
- VPN user → Desktop UI: configures and connects
README.md - Desktop UI → Tauri shell: invokes commands
apps/desktop/src/main.tsx - Tauri shell → Service runtime: uses local IPC
README.md - Service runtime → Authenticated IPC: reads and writes frames
crates/service/src/main.rs - Service runtime → VPN service: dispatches requests
crates/service/src/main.rs - VPN service → Connection state: orchestrates states
README.md - VPN service → Windows firewall: enforces lockdown
README.md - VPN service → WireGuard client: manages tunnel
README.md - VPN service → DNS policy: applies DNS policy
README.md - VPN service → Network monitoring: handles transitions
README.md - VPN service → Profile management: manages profiles
README.md - VPN service → Verification diagnostics: runs verification
README.md - Windows firewall → Windows network stack: sets filtering rules
crates/firewall-windows/src/lib.rs - WireGuard client → Windows network stack: installs tunnel
crates/wireguard-controller/src/lib.rs - DNS policy → Windows network stack: sets DNS servers
crates/dns-controller/src/lib.rs - VPS operator → Peer and P2P API: manages VPS
- Peer and P2P API → Peer and lease state: reads and updates
server/cmd/sentinel-server/main.go - Peer and P2P API → Port forwarding: installs or removes rules
server/cmd/sentinel-server/main.go - WireGuard peer → VPS WireGuard: tunnels to