Skip to content

VPN Admin v2.0.0

Choose a tag to compare

@ks-tool ks-tool released this 12 Nov 17:12
· 15 commits to main since this release

VPN Admin v2.0.0 is the first stable release of the redesigned provider-based architecture. The project evolves from an AmneziaWG-specific panel into a visual control plane for VPN infrastructure.

Highlights

Visual infrastructure management

  • Geographic server map with locations, health statuses, clusters, and tunnels.
  • Tunnel visualization with p95 latency over a sliding 15-minute window.
  • Interactive Network Graph for connecting interfaces and listeners with directed links.
  • Multi-server routes and visual rerouting of existing connections.

Multiple VPN providers

  • AmneziaWG / WireGuard, Xray, and Hysteria 2 support.
  • Mixed-protocol chains using local route connections between providers on the same host.
  • Unified user management across servers and protocols.
  • AWG client configurations and Xray/Hysteria 2 connection URIs.

Provider-driven configuration

  • Providers expose resource manifests and JSON Schemas.
  • Configuration forms are generated dynamically with React JSON Schema Form.
  • Cached schemas remain available when a server is temporarily unreachable.
  • New providers can be added without protocol-specific forms or deployment logic in the admin core.

Independent deployment

  • Pack-based agent and provider deployment.
  • Providers install and configure their own cores, dependencies, registrations, and firewall rules.
  • Public and private OCI registries, local binaries, and local directories are supported.
  • Agents and providers can be installed, updated, and removed independently.
  • The agent supervises provider processes and persists desired resource state.

Migration and reliability

  • Existing AWG configurations can be imported with preview.
  • Improved cleanup for users, peers, interfaces, links, servers, and remote provider resources.
  • Protocol-neutral health checks and detailed resource status reporting.
  • Desktop and standalone web server modes share the same model and functionality.

Breaking changes

V2 replaces AWG-specific resource and deployment workflows with provider-managed resources. Some APIs and configuration formats differ from v1.

The v2 database is stored separately at ~/.vpn-admin/db. Migration from v1 is manual and leaves the source database unchanged.

Before upgrading, back up your existing installation and stop both applications. Then run:

awg-migrate v2

By default, this migrates ~/.awg-admin to ~/.vpn-admin/db. After migration, review the imported resources and install the v2 agent and required providers through Manage panel → Agent.