first commit
root
2 months ago
commit
8c7bef73af
@ -0,0 +1,144 @@
|
|||||||
|
# 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://git.local/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
|
||||||
Loading…
Reference in New Issue