You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

3.9 KiB

Raw Blame History

TorGuard WireGuard Manager

This is the Official TorGuard web interface for managing WireGuard VPN connections on Ubuntu/Debian systems. This tool provides a modern, user-friendly dashboard for managing your TorGuard WireGuard VPN configuration with enhanced security features.

Features

🌐 Modern, responsive web interface for WireGuard management
🔒 Enterprise-grade authentication system with password strength enforcement
📊 Real-time connection status and detailed transfer statistics
🔄 Easy configuration import with validation
🚀 One-click connect/disconnect with status feedback
🔧 Automatic system configuration and dependency management
🎯 Systemd integration for reliable boot-time autostart
📱 Mobile-optimized responsive design
🛡️ Advanced security features and input validation
📈 Live status updates and connection monitoring

Prerequisites

Ubuntu/Debian-based system (20.04 LTS or newer recommended)
Python 3.8 or higher
Root/sudo privileges
Internet connection for TorGuard services

Quick Start

Download the latest release:

git clone https://gittylab.com/ben/TorGuard_WireGuard.git

Run the installer script:

sudo python3 install.py

Access the web interface:

http://your-server-ip:1337

Enhanced Security Features

🔐 Secure credential storage using bcrypt and Fernet encryption
🛡️ CSRF protection on all forms
🔒 Strict file permissions and ownership
🚫 Comprehensive input validation and sanitization
🔑 Secure session management
📜 Encrypted configuration storage
🔍 Real-time password strength meter
🚦 Rate limiting for authentication attempts
🛑 Protection against brute force attacks

System Integration

The installer configures:

System Services:
- wg-quick@wg0.service for WireGuard with enhanced dependencies
- wireguard-manager.service with systemd hardening
Network Configuration:
- IP forwarding with sysctl persistence
- NAT rules with iptables-persistent
- DNS configuration (Cloudflare 1.1.1.1)
- Network service dependencies
Security Settings:
- Restricted file permissions
- Secure directory ownership
- Protected configuration storage
- System service hardening

Web Interface Features

Dashboard:
- Real-time connection status
- Live transfer statistics
- Total bandwidth usage
- Connection duration tracking
- System status monitoring
Configuration:
- Secure config import
- File upload with validation
- Format verification
- Syntax highlighting
- Auto-save functionality
Security:
- Password strength requirements
- Two-factor authentication (coming soon)
- Session management
- Activity logging
- Secure logout

Troubleshooting

Verification Check service status:

sudo systemctl status wireguard-manager
sudo systemctl status wg-quick@wg0

Diagnostics View detailed logs:

sudo journalctl -u wireguard-manager -f
sudo journalctl -u wg-quick@wg0 -f

Common Solutions
- Port access: sudo ufw allow 1337/tcp
- Service issues: sudo systemctl restart wireguard-manager
- Permission fixes: sudo chmod -R 700 /etc/wireguard-manager

Support

For official TorGuard support:

Visit: https://torguard.net/support
Email: support@torguard.net
Live Chat: Available 24/7 on TorGuard website

Uninstall

To uninstall and reverse all changes run:

sudo python3 uninstall.py

3.9 KiB Raw Blame History