How stuffam/drawbridge works
Drawbridge manages a WireGuard VPN through a self-hosted web UI, CLI, and authenticated API. The main workflow is a user request entering an API or local control socket, passing through shared management logic, being persisted, and—when configuration changes—reconciled with the host tunnel and firewall. The product also covers authentication, client configuration, traffic and DNS visibility, backups, diagnostics, certificates, and event history. Several links reflect the README or SOURCE INDEX; unsampled API and daemon wiring is not inferred beyond those references.
Main entry points: service.go Management service · reconcile.go Host reconciliation · handlers.go Web API · client_cmd.go CLI commands
Components 21
User interfaces
- CLI commands
cmd/drawbridge/client_cmd.go - Web UI
web/src/routes/(app)/+page.svelte - Web API
internal/api/handlers.go - Local control API
internal/control/server.go - Control client
internal/control/client.go
Management services
- Management service
internal/service/service.go - Authentication
internal/service/auth.go - Shared API views
internal/views/views.go - Client configs
internal/clientconf/clientconf.go - Host diagnostics
internal/diag/checks.go - AdGuard integration
internal/adguard/adguard.go
VPN runtime
- Host reconciliation
internal/reconcile/reconcile.go - WireGuard tunnel
internal/wg/wg.go - Firewall rules
internal/firewall/firewall.go
State and integrations
- Domain model
internal/model/model.go - Persistent state
internal/store/store.go - Traffic history
internal/store/traffic.go - Backup and restore
internal/backup/backup.go - TLS certificates
internal/tlscert/tlscert.go - Address allocation
internal/ipam/ipam.go
Other components
- Administrator
Connections 25
- Administrator → CLI commands: runs commands
README.md - Administrator → Web UI: manages VPN
README.md - CLI commands → Control client: invokes
cmd/drawbridge/client_cmd.go - Control client → Local control API: calls over socket
internal/control/client.go - Web UI → Web API: uses API
README.md - Local control API → Management service: calls
internal/control/server.go - Web API → Management service: calls
internal/api/handlers.go - Web API → Shared API views: formats responses
internal/api/handlers.go - Local control API → Shared API views: formats responses
internal/control/server.go - Management service → Persistent state: reads and writes
internal/service/service.go - Management service → Host reconciliation: applies changes
internal/service/service.go - Management service → Authentication: uses
internal/service/auth.go - Management service → Host diagnostics: runs checks
internal/service/service.go - Management service → Client configs: renders configs
internal/service/service.go - Management service → Domain model: uses domain types
internal/service/service.go - Management service → AdGuard integration: integrates DNS
- Host reconciliation → WireGuard tunnel: configures tunnel
internal/reconcile/reconcile.go - Host reconciliation → Firewall rules: configures rules
internal/reconcile/reconcile.go - Host reconciliation → Domain model: reads settings
internal/reconcile/reconcile.go - Domain model → Address allocation: allocates addresses
internal/model/model.go - Management service → Traffic history: records traffic
- Management service → Backup and restore: creates backups
- Management service → TLS certificates: manages certificates
- CLI commands → Client configs: displays client config
cmd/drawbridge/client_cmd.go - Web UI → Web API: renames clients through