mvpg/README.md
2025-08-10 15:34:34 +02:00

60 lines
1.9 KiB
Markdown

# 🔒 Mullvad VPN Gateway for LXC - Multi-Provider Edition
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)](https://github.com/yourusername/vpn-gateway)
[![Security](https://img.shields.io/badge/security-hardened-green.svg)](https://github.com/yourusername/vpn-gateway)
Secure VPN Gateway with **permanent killswitch** for LXC containers. Supports Mullvad, custom WireGuard servers, and imported configurations.
## ⚡ Quick Start
```bash
curl -sSL https://raw.githubusercontent.com/yourusername/vpn-gateway/main/install.sh | bash
```
## 🎯 Features
-**Multi-Provider Support** - Mullvad, Custom Servers, Import Configs
-**Permanent Killswitch** - No internet without VPN, ever
- 🌍 **Dynamic Server Selection** - Switch between countries/cities via WebUI
- 🛡️ **Zero-Leak Protection** - DNS leak protection, IPv6 blocking
- 🎨 **Modern WebUI** - Beautiful, responsive control panel
- 🔄 **Auto-Reconnect** - Automatic recovery on connection drops
- 📊 **Live Monitoring** - Real-time status and statistics
## 📋 Requirements
- LXC Container (Proxmox/LXD)
- Ubuntu 20.04+ or Debian 11+
- Root access
- Mullvad account OR own WireGuard server
## 🚀 Installation
```bash
# Clone repository
git clone https://github.com/yourusername/vpn-gateway.git
cd vpn-gateway
# Run installer
sudo ./install.sh
```
## 📖 Documentation
- [Quick Start Guide](docs/QUICKSTART.md)
- [Provider Configuration](docs/PROVIDERS.md)
- [Security Documentation](docs/SECURITY.md)
- [FAQ](docs/FAQ.md)
## 🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## 📄 License
MIT License - see [LICENSE](LICENSE) file
## ⚠️ Disclaimer
The permanent killswitch will block ALL internet traffic when VPN is not connected. This is by design and cannot be disabled.