amnezia-vpn-panel
Web management panel for AmneziaVPN / AmneziaWG with in-panel login form, client list, live traffic monitoring, QR code generation, and .conf download. wg-easy style UI running on nginx + Node.js.
Ficha actualizada 23 sept 2026, 7:30 · upstream 23 sept 2026, 7:27 · release v2.1
Qué es amnezia-vpn-panel
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Amnezia VPN Panel is a web-based management interface designed to simplify the administration of AmneziaVPN / AmneziaWG services. It provides an in-panel login form that eliminates browser popup prompts for authentication, offering a seamless user experience. The panel features a comprehensive client list displaying IP addresses, connection status (Online/Offline/Disabled), download/upload speeds, and total traffic metrics. Key capabilities include one-click client creation with automatic generation of the corresponding Amnezia configuration file (.conf), QR code generation for app access, toggle switching between clients on/off, deletion of unwanted connections, and a dark/light theme toggle integrated into the header.
The panel is built using Node.js and Fastify as its framework, running behind an nginx reverse proxy. It communicates with the AmneziaVPN API via HTTP requests, handling authentication through session cookies rather than requiring repeated password entry at each request. This design reduces user friction while maintaining secure access control. The interface also includes server cards that display client count, geographic location (via GeoIP), and supported protocols.
The installation process is streamlined for both containerized and traditional deployment scenarios. For users with AmneziaVPN already running on a host system, the script copies configuration files from an existing container without modifying or reinstalling the VPN software itself. This approach ensures minimal disruption to the underlying infrastructure while providing centralized management through a single web interface.
- Centralized client management for multiple AmneziaVPN instances with a unified dashboard
- Remote administration of VPN clients from any location without requiring physical access to the server
- Monitoring and troubleshooting by viewing live traffic statistics and connection status in real-time
- Generating QR codes for app-based access, enabling users to connect via mobile devices or smart home devices
- Automated client provisioning with one-click creation of new connections from a web interface
- Dark/light theme customization for improved visual comfort during extended use sessions
- Session-based authentication using PBKDF2 hashing eliminates the need to re-enter passwords on each page load, significantly improving user experience and reducing credential fatigue.
- One-click client creation with automatic .conf file generation ensures consistent configuration without manual editing or potential errors from copy-paste operations.
- Live traffic monitoring displays real-time download/upload speeds and total data transfer for each client, enabling immediate visibility into network performance.
- The panel does not install AmneziaVPN itself; it only manages the existing amnezia-awg* container, requiring that the VPN software be pre-installed on the server.
- API access requires a valid session cookie obtained through login, meaning direct API calls without authentication will return 401 errors.
- The panel does not support dynamic client provisioning or bulk updates of existing clients; each new connection must be created individually via the web interface.
- No built-in firewall rules are provided for port exposure — users must configure their own iptables/nftables rules to allow traffic through nginx and the AmneziaVPN container ports.
- The panel does not include a built-in client management UI; all operations (toggle, delete) require navigating through API endpoints or using command-line tools.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
To deploy on Ubuntu/Debian: ensure port 80/tcp is open and the AmneziaVPN container's UDP port (default 31509) is accessible. Run `wget -O install.sh <url>` as root, then execute `bash install.sh`. For production environments, consider using a Docker Compose file for easier service orchestration. The panel runs on nginx with its own vhost; ensure the AmneziaVPN container's IP address is correctly configured in nginx upstream settings. Always backup /etc/amnezia-panel/auth.json before modifying configuration files. Use systemd services to keep amnezia-api and nginx running persistently across reboots.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.