How maeneko/forgetting works
Forgetting is a VPN management panel and API for AmneziaWG. A panel operator or API client requests peer/key operations through awg-ui; it authenticates requests, serves the web UI and public API, and brokers VPN operations to the privileged, loopback-only awg-ctrl. awg-ui also manages multi-server nodes and SenAWG master-key subscriptions. The CLI manages service processes and panel credentials. The README documents the component boundaries; some internal routing and storage details are unsampled, so uncertain links are omitted.
Main entry points: App.tsx Web panel · server.ts HTTP API and auth · sub.ts Subscription service · index.ts Privileged VPN API
Components 19
Panel interface
- Web panel
awg-ui/src/App.tsx - Peer management
awg-ui/src/tabs/users/index.tsx - API-key management
awg-ui/src/tabs/apikeys/index.tsx - Master-key management
awg-ui/src/tabs/masterkeys/index.tsx
Panel services
- HTTP API and auth
awg-ui/server.ts - Public API
awg-ui/server.ts - Node management
awg-ui/nodes.ts - Subscription service
awg-ui/sub.ts - Sen link protocol
awg-ui/sen.ts - Panel database
awg-ui/server.ts
VPN control
- Privileged VPN API
awg-ctrl/index.ts - VPN peers and config
awg-ctrl/index.ts - VPN agent
awg-agent/index.ts
Operations
- Service CLI
cli/src/index.ts - Admin console
admin/frontend/src/App.tsx - Admin service
admin/backend/server.ts
Other components
- Panel operator
- API client
- SenAWG device
Connections 16
- Panel operator → Web panel: uses
README.md - Web panel → HTTP API and auth: requests
awg-ui/src/App.tsx - Web panel → Peer management: renders
- Web panel → API-key management: renders
- Web panel → Master-key management: renders
- API client → Public API: calls
README.md - Public API → Privileged VPN API: proxies VPN requests
README.md - HTTP API and auth → Panel database: stores panel keys
awg-ui/server.ts - HTTP API and auth → Node management: starts
awg-ui/server.ts - HTTP API and auth → Subscription service: starts
awg-ui/server.ts - Subscription service → Panel database: reads and writes
awg-ui/sub.ts - Subscription service → Sen link protocol: encodes links
awg-ui/sub.ts - SenAWG device → Subscription service: registers device
README.md - Privileged VPN API → VPN peers and config: manages peers
README.md - Panel operator → Service CLI: manages services
README.md - Admin console → Admin service: uses