
CompassVPN: Scalable, Self-Hosted, Open-Source VPN Solution.
A powerful, scalable, and configurable VPN agent with built-in monitoring, automated management, and enhanced security features - all deployed on your own infrastructure.
Grafana Cloud Dashboard Images

Overall system performance and key metrics at a glance

Detailed server statistics and bandwidth usage

Detailed Xray performance metrics and usage statistics

Table displaying available VPN configuration links and their details
Data Flow Diagram
CompassVPN Data Flow Diagram
Features
Easy Deployment
Deploy your VPN server easily using a simple Web Panel for configuration.
- Start with a single command.
- Configure all settings via a user-friendly Web Panel
- Automatic SSL certificate generation using ZeroSSL or Let’s Encrypt
- Integrated Cloudflare DNS management to automatically manage DNS records.
- Direct & CDN Options: Select direct or Cloudflare CDN configurations via the panel.
Enhanced Security
Protect your server and network traffic with multiple layers of security features.
- Automatic blocking: Torrents, Iranian websites, Ads, Malware, Phishing (using curated blocklists)
- Configuration self-testing via Xray-Knife
- Fail2ban integration to prevent brute-force attacks and bad requests
- Automated UFW firewall configuration
- NGINX webserver enhances security and resource efficiency
Complete Monitoring
Gain insights into performance and usage through comprehensive metrics collection.
- Centralized monitoring via Grafana Cloud or self-hosted Prometheus/Pushgateway
- Real-time connection statistics
- Host system resource monitoring (CPU, memory, traffic, …)
- User metrics: Track approximate unique active users and blocked junk traffic requests
Scalability
Easily scale your VPN infrastructure horizontally.
- Effortlessly replicate agent instances using Docker for rapid capacity expansion.
- Stateless agent design simplifies horizontal scaling behind standard load balancers for high availability.
- Centralized monitoring via the Manager component handles metrics from numerous agents seamlessly.
Network Optimization
Optimize bandwidth usage and connection routing for better performance.
- NGINX web server improves connection handling efficiency
- Monitor blocked traffic requests to understand bandwidth savings
- Flexible Custom DNS options (Default, Cloudflare, ControlD, or custom DoU/DoT/DoH/DoQ)
- Choose between Direct or WARP outbound connections
Advanced Connectivity
Utilize modern protocols and flexible connection options.
- WARP and Direct outbound connection choices
- WireGuard integration for WARP outbound connections with automatic fallback
- Supports multiple VLESS inbound protocols (TCP / HTTPUpgrade(WS) / QUIC)
- Automatic configuration rotation based on a defined interval
Get Started Quickly
Deploy your own VPN server in minutes with our comprehensive setup guides.
- Supports Ubuntu (20+) and Debian (10+)
- Works on AMD64 or ARM64 architecture
- Requires minimal resources (2 vCPUs, 2GB RAM recommended)
Open Source Architecture
CompassVPN consists of two main components:
git clone https://github.com/compassvpn/agent.git && cd agent && ./start_panel.sh