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.
144 lines
3.9 KiB
Markdown
144 lines
3.9 KiB
Markdown
# 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
|
|
|
|
1. Download the latest release:
|
|
```bash
|
|
git clone https://gittylab.com/ben/TorGuard_WireGuard.git
|
|
```
|
|
|
|
2. Run the installer script:
|
|
```bash
|
|
sudo python3 install.py
|
|
```
|
|
|
|
3. 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:
|
|
|
|
1. System Services:
|
|
- `wg-quick@wg0.service` for WireGuard with enhanced dependencies
|
|
- `wireguard-manager.service` with systemd hardening
|
|
|
|
2. Network Configuration:
|
|
- IP forwarding with sysctl persistence
|
|
- NAT rules with iptables-persistent
|
|
- DNS configuration (Cloudflare 1.1.1.1)
|
|
- Network service dependencies
|
|
|
|
3. 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
|
|
|
|
1. **Verification**
|
|
Check service status:
|
|
```bash
|
|
sudo systemctl status wireguard-manager
|
|
sudo systemctl status wg-quick@wg0
|
|
```
|
|
|
|
2. **Diagnostics**
|
|
View detailed logs:
|
|
```bash
|
|
sudo journalctl -u wireguard-manager -f
|
|
sudo journalctl -u wg-quick@wg0 -f
|
|
```
|
|
|
|
3. **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:
|
|
```bash
|
|
sudo python3 uninstall.py
|
|
```
|
|
|
|
## Copyright
|
|
|
|
Copyright © 2024 TorGuard. All rights reserved.
|
|
This software is officially developed and maintained by TorGuard.
|
|
|
|
---
|
|
|
|
Powered by TorGuard® - Secure Private VPN Service
|
|
https://torguard.net |