Elora VPN Manager

A comprehensive VPN management solution with multi-zone support, automated account management, and real-time monitoring.

🚀 Features

🌍 Multi-Zone Management

Distributed server management across multiple zones
Automatic configuration synchronization
Load balancing and failover support
Centralized control panel

👥 Account Management

Automated account creation and deployment
Shopping system integration
Traffic monitoring and usage tracking
Flexible subscription management

🔄 Integration

X-UI panel synchronization
Telegram bot interface
Subscription URL system
Multiple client support

📋 System Overview

The system manages VPN services through three main components:

graph TB
    %% Main Components
    CP((Control<br>Panel))
    
    %% Zones with rounded rectangles
    subgraph "Zones"
        Z1[Zone A - Europe]
        Z2[Zone B - Asia]
    end

    %% Servers as circles
    S1((Server<br>Germany))
    S2((Server<br>France))
    S3((Server<br>Singapore))

    %% User Access as hexagons
    U1{VPN Client}
    U2{Telegram Bot}

    %% Simple Connections
    CP --> Z1 & Z2
    Z1 --> S1 & S2
    Z2 --> S3
    U1 & U2 --> CP

    %% Clean Modern Colors
    classDef panel fill:#6366F1,stroke:#4338CA,stroke-width:2px,color:#fff
    classDef zone fill:#34D399,stroke:#059669,stroke-width:2px,color:#fff
    classDef server fill:#F472B6,stroke:#DB2777,stroke-width:2px,color:#fff
    classDef user fill:#60A5FA,stroke:#2563EB,stroke-width:2px,color:#fff

    class CP panel
    class Z1,Z2 zone
    class S1,S2,S3 server
    class U1,U2 user

    %% Add Labels
    linkStyle default stroke:#6B7280,stroke-width:2px

Core Functions

Account creation and management
Traffic monitoring and control
Server synchronization
User access management

🛠️ Setup Requirements

Server Side

SSL certificate
Domain configuration
X-UI panel installation
Database system

Client Side

X-ray compatible client
Telegram account (for bot access)
Valid subscription URL

📱 Access Methods

1. Subscription URL

One-click configuration
Automatic updates
Multiple client support

2. Telegram Bot

Account management
Usage monitoring
Support access
Instant notifications

3. VPN Clients

Cross-platform support
Auto-configuration
Server selection

⚙️ How It Works

Account Creation
- Manual or automatic creation
- Zone assignment
- Server configuration
Server Sync
- Configuration deployment
- Traffic monitoring
- Status updates
User Access
- Subscription URL generation
- Client configuration
- Usage tracking

📊 Monitoring Features

Real-time traffic statistics
Server status monitoring
User activity tracking
System health checks

🔐 Security Features

SSL encryption
Domain validation
Access control
Traffic encryption
Secure protocols

📖 Usage Guidelines

Administrator Tasks

Enable SSL and configure domains
Set up zones and servers
Monitor system health
Manage user accounts

User Tasks

Purchase/activate account
Get subscription URL
Configure VPN client
Monitor usage via bot

⚡ Quick Start

System Setup

# Install required components
# Configure SSL
# Set up domains

Zone Configuration

# Configure zones
# Set up servers
# Enable synchronization

Account Management

# Create accounts
# Monitor usage
# Manage subscriptions

✨ Key Benefits

For Users

Easy account management
Multiple access methods
Real-time monitoring
Automatic configuration

For Administrators

Centralized management
Automated operations
Comprehensive monitoring
Revenue tracking

Installation Guide

System Requirements

Supported Operating Systems

Ubuntu 20.04 LTS (Focal Fossa)
Ubuntu 22.04 LTS (Jammy Jellyfish)
Debian 11 (Bullseye)
Debian 12 (Bookworm)

Minimum Hardware Requirements

CPU: 1 core
RAM: 1 GB
Storage: 10 GB

Prerequisites

The installation script will automatically install these dependencies, but for reference, the system needs:

Python 3.9
PostgreSQL
systemd
curl
Other dependencies will be installed automatically

Quick Installation

One-Line Installation

Auto-detects your public IP address

curl -fsSL https://raw.githubusercontent.com/eloravpn/EloraVPNManager/main/install.sh | sudo bash

Custom Domain and Port

curl -fsSL https://raw.githubusercontent.com/eloravpn/EloraVPNManager/main/install.sh | sudo bash -s -- \
  --domain your-domain.com \
  --port 8080

Full Custom Installation

curl -fsSL https://raw.githubusercontent.com/eloravpn/EloraVPNManager/main/install.sh | sudo bash -s -- \
  --domain your-domain.com \
  --port 8080 \
  --protocol https \
  --db-name custom_db \
  --db-user custom_user \
  --db-pass your_password \
  --jwt-secret your_jwt_secret

Installation Options

Option	Description	Default
`--domain`	Domain name for the application	localhost
`--port`	Port number for the application	8080
`--protocol`	Protocol (http/https)	http
`--db-name`	PostgreSQL database name	elora_db
`--db-user`	PostgreSQL user name	elora
`--db-pass`	PostgreSQL password	Random generated
`--jwt-secret`	JWT secret key	Random generated
`--version`	Specific version to install	Latest version

Domain/IP Configuration

If no domain is specified, the installer will automatically detect and use your server's public IP
If public IP detection fails, it will fall back to 'localhost'
You can always specify a custom domain using the --domain option
The detected or specified domain/IP will be used in the configuration for API endpoints

Post-Installation

SSL Certificate Setup

SSL certificates are essential for:

Secure subscription links for V2Ray clients
Encrypted API communications
Secure web interface access

1. Install Certbot

# Install Certbot and Nginx plugin
sudo apt update
sudo apt install -y certbot

# Stop any service using port 80
sudo systemctl stop elora-vpn

# Get certificate
sudo certbot certonly --standalone --agree-tos --register-unsafely-without-email -d your-domain.com

2. Certificate Locations

After successful certification, your certificates will be located at:

/etc/letsencrypt/live/your-domain.com/fullchain.pem  # Certificate
/etc/letsencrypt/live/your-domain.com/privkey.pem    # Private Key

3. Update Configuration

Update .env File

sudo nano /opt/elora-vpn/.env

# Update these lines:
UVICORN_SSL_CERTFILE=/etc/letsencrypt/live/your-domain.com/fullchain.pem
UVICORN_SSL_KEYFILE=/etc/letsencrypt/live/your-domain.com/privkey.pem
SUBSCRIPTION_BASE_URL=https://your-domain.com:your-port/api/sub

Update .config File

sudo nano /opt/elora-vpn/static/config.json

# Update these line:
"BASE_URL": "https://your-domain.com:your-port/api",

4. Enable Auto-Renewal

# Test auto-renewal
sudo certbot renew --dry-run

# Certbot automatically adds a renewal cron job at
# /etc/cron.d/certbot

5. Restart Service

sudo systemctl restart elora-vpn

Service Management

# Check service status
sudo systemctl status elora-vpn

# Start service
sudo systemctl start elora-vpn

# Stop service
sudo systemctl stop elora-vpn

# Restart service
sudo systemctl restart elora-vpn

# View logs
sudo journalctl -u elora-vpn -f

Configuration

The main configuration file is located at:

/opt/elora-vpn/.env

Default Paths

Installation Directory: /opt/elora-vpn
Virtual Environment: /opt/elora-vpn/venv
Service File: /etc/systemd/system/elora-vpn.service

Troubleshooting

Common Issues

Port Already in Use

# Check if port is already in use
sudo lsof -i :8080
sudo netstat -tulpn | grep 8080

# Test port accessibility
nc -zv localhost 8080

# Configure firewall for port
sudo ufw allow 8080/tcp
sudo ufw status

Database Connection Issues

# Check PostgreSQL status
sudo systemctl status postgresql

# Check database logs
sudo tail -f /var/log/postgresql/postgresql-*.log

Service Won't Start

# Check detailed error messages
sudo journalctl -u elora-vpn -n 50 --no-pager

# Verify Python path
sudo systemctl cat elora-vpn

# Check file permissions
sudo ls -la /opt/elora-vpn
sudo ls -la /opt/elora-vpn/venv/bin/python

# Manual start for debugging
cd /opt/elora-vpn
sudo ./venv/bin/python main.py

Recovery Procedures

1. Database Backup and Restore

# Backup database
sudo -u postgres pg_dump elora_db > backup.sql

# Restore database
sudo -u postgres psql elora_db < backup.sql

2. Configuration Backup

# Backup configuration
sudo cp /opt/elora-vpn/.env /opt/elora-vpn/.env.backup
sudo cp -r /opt/elora-vpn/static /opt/elora-vpn/static.backup

3. Complete Reset

# Stop service
sudo systemctl stop elora-vpn

# Reset database
sudo -u postgres psql -c "DROP DATABASE elora_db;"
sudo -u postgres psql -c "CREATE DATABASE elora_db OWNER elora;"

# Reinstall application
rm -rf /opt/elora-vpn/*
# Run installation script again...

Debug Mode

To enable debug mode for more detailed logging:

Edit .env file:

sudo nano /opt/elora-vpn/.env

# Change these settings:
DEBUG=true
LOG_LEVEL=10

Restart service:

sudo systemctl restart elora-vpn

Monitor debug logs:

sudo journalctl -u elora-vpn -f

System Information Collection

When reporting issues, include this information:

# System info
uname -a
lsb_release -a

# Installation info
python3.9 --version
pip list
systemctl status elora-vpn

# Logs
journalctl -u elora-vpn --no-pager -n 100

# Database status
sudo -u postgres psql -d elora_db -c "\dx"

Getting Help

If you encounter any issues:

Check the logs using the commands above
Verify your system meets the minimum requirements
Open an issue on GitHub

Security Notes

The installation script automatically generates secure random passwords for the database and JWT secret
All configuration files are created with proper permissions
The .env file contains sensitive information and is readable only by root
Default database user has limited permissions to only the necessary database

Updating

To update the application, use one of these commands:

# Update to latest version
curl -fsSL https://raw.githubusercontent.com/eloravpn/EloraVPNManager/main/install.sh | sudo bash -s -- --update

# Update to specific version
curl -fsSL https://raw.githubusercontent.com/eloravpn/EloraVPNManager/main/install.sh | sudo bash -s -- --update --version v1.2.3

Restart the service

Uninstallation

To completely remove the application:

sudo systemctl stop elora-vpn
sudo systemctl disable elora-vpn
sudo rm -rf /opt/elora-vpn
sudo rm /etc/systemd/system/elora-vpn.service
sudo systemctl daemon-reload

To also remove the database:

sudo -u postgres psql -c "DROP DATABASE elora_db;"
sudo -u postgres psql -c "DROP USER elora;"

Admin username and password

Default sudoer username and password is admin.

The environment varaibles is SUDO_USERNAME and SUDO_PASSWORD

The Web Panel Repository

Follow the Readme in Elora VPN Manager Panel

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Support

For support, please:

Join our Telegram channel
Check documentation
Submit issues via GitHub

Contact US in Telegram

Elora VPN

Made with ❤️ for better VPN management

Name		Name	Last commit message	Last commit date
Latest commit History 246 Commits
.github/workflows		.github/workflows
pyqrcode		pyqrcode
src		src
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
alembic.ini		alembic.ini
install.sh		install.sh
main.py		main.py
pyproject.toml		pyproject.toml
requirements.txt		requirements.txt

ca3tiel/EloraVPNManager

Folders and files

Latest commit

History

Repository files navigation