{"id":28493053,"url":"https://github.com/hhftechnology/wireguard-ent-manager","last_synced_at":"2025-06-25T06:33:25.692Z","repository":{"id":272270458,"uuid":"916035498","full_name":"hhftechnology/wireguard-ent-manager","owner":"hhftechnology","description":"WGEM is a comprehensive management system for WireGuard VPN","archived":false,"fork":false,"pushed_at":"2025-01-17T11:33:21.000Z","size":88,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-08T09:07:21.325Z","etag":null,"topics":["linux","nat","privacy","vpn","wireguard"],"latest_commit_sha":null,"homepage":"https://hhf.technology/wireguard-deployment","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hhftechnology.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-13T10:33:29.000Z","updated_at":"2025-04-30T22:05:25.000Z","dependencies_parsed_at":"2025-01-13T11:40:51.569Z","dependency_job_id":"400afaea-e8ba-43ae-88b5-f8993eef5b38","html_url":"https://github.com/hhftechnology/wireguard-ent-manager","commit_stats":null,"previous_names":["hhftechnology/wireguard-ent-manager"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hhftechnology/wireguard-ent-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hhftechnology%2Fwireguard-ent-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hhftechnology%2Fwireguard-ent-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hhftechnology%2Fwireguard-ent-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hhftechnology%2Fwireguard-ent-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hhftechnology","download_url":"https://codeload.github.com/hhftechnology/wireguard-ent-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hhftechnology%2Fwireguard-ent-manager/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261819357,"owners_count":23214487,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["linux","nat","privacy","vpn","wireguard"],"created_at":"2025-06-08T09:07:22.929Z","updated_at":"2025-06-25T06:33:25.683Z","avatar_url":"https://github.com/hhftechnology.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dont Use Enterprise feature still under development\n# WireGuard Ent Manager (WGEM)\n\nWGEM is a comprehensive management system for WireGuard VPN, designed to simplify the deployment, configuration, and maintenance of WireGuard servers in complex environments. This solution provides an interactive, feature-rich interface for managing multiple WireGuard tunnels, clients, and configurations through an easy-to-use command-line interface.\n\n## Features\n\nWGEM enhances the standard WireGuard experience with several advanced capabilities:\n\n- Interactive menu-driven interface for easy management\n- Support for multiple tunnel configurations\n- Batch client creation and management\n- Automatic peer cleanup and maintenance\n- Full NAT configuration options (including Full Cone NAT for gaming)\n- Comprehensive backup and restore functionality\n- Detailed logging and monitoring\n- Multiple VPN modes (proxy and point-to-point)\n- Flexible DNS configuration options\n- Advanced firewall integration\n\n## System Requirements\n\n### Compatible Operating Systems\n\nWGEM has been thoroughly tested and is officially supported on the following Linux distributions:\n\nPrimary Support:\n- Ubuntu 20.04 LTS and newer\n- Debian 11 (Bullseye) and newer\n- Fedora 35 and newer\n- CentOS Stream 8 and newer\n- Rocky Linux 8 and newer\n- AlmaLinux 8 and newer\n\nSecondary Support:\n- Arch Linux (rolling release)\n- Oracle Linux 8 and newer\n\n### Minimum System Requirements\n\n- CPU: 1 core (2 recommended)\n- RAM: 512MB (1GB recommended)\n- Storage: 1GB free space\n- Network: Static IP address or stable DDNS setup\n- Root access or sudo privileges\n\n## Installation\n\n### Quick Start\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/hhftechnology/wireguard-ent-manager.git\ncd wireguard-ent-manager\n```\n\n2. Make the scripts executable:\n```bash\nchmod +x *.sh\n```\n\n3. Run the installation script as root:\n```bash\nsudo ./wireguard-enhanced.sh\n```\n\n### Manual Installation\n\nIf you prefer to set up components individually:\n\n1. Install required dependencies:\n```bash\n# For Ubuntu/Debian\nsudo apt update\nsudo apt install wireguard iptables qrencode\n\n# For Fedora\nsudo dnf install wireguard-tools iptables qrencode\n\n# For CentOS/Rocky/Alma\nsudo dnf install epel-release\nsudo dnf install wireguard-tools iptables qrencode\n```\n\n2. Set up the configuration directory:\n```bash\nsudo mkdir -p /etc/wireguard\nsudo chmod 700 /etc/wireguard\n```\n\n3. Run the script:\n```bash\nsudo ./wireguard-enhanced.sh\n```\n\n## Configuration\n\n### Initial Setup\n\nWhen you first run WGEM, you'll be guided through several configuration steps:\n\n1. VPN Mode Selection\n   - Proxy Mode: Routes all client traffic through the VPN\n   - Point-to-Point Mode: Routes only specified networks\n\n2. DNS Configuration\n   - System DNS\n   - Custom DNS servers\n   - Split DNS options\n\n3. Network Configuration\n   - Interface selection\n   - IP range allocation\n   - Port selection\n\n### Managing Clients\n\nWGEM provides several ways to manage clients:\n\n1. Individual Client Creation:\n```bash\nSelect: \"Client Management\" \u003e \"Create New Client\"\n```\n\n2. Batch Client Creation:\n```bash\nSelect: \"Client Management\" \u003e \"Batch Create Clients\"\n```\n\nExample batch file format (clients.csv):\n```csv\nclient_name,ip_address,allowed_ips,keepalive,dns\nclient1,10.0.0.2,0.0.0.0/0,25,1.1.1.1\nclient2,10.0.0.3,192.168.1.0/24,,8.8.8.8\n```\n\n### Advanced Configuration\n\n#### NAT Configuration\n\nFor gaming or applications requiring specific NAT types:\n```bash\nSelect: \"System Configuration\" \u003e \"Configure NAT Settings\"\n```\n\n#### Multiple Tunnels\n\nTo create additional tunnels:\n```bash\nSelect: \"Tunnel Management\" \u003e \"Create New Tunnel\"\n```\n\n## Maintenance\n\n### Regular Maintenance Tasks\n\n1. Cleaning Inactive Peers:\n```bash\nSelect: \"Monitoring \u0026 Maintenance\" \u003e \"Clean Inactive Peers\"\n```\n\n2. Backing Up Configurations:\n```bash\nSelect: \"Backup \u0026 Restore\" \u003e \"Create Backup\"\n```\n\n### Monitoring\n\nMonitor your WireGuard installation:\n```bash\nSelect: \"Monitoring \u0026 Maintenance\" \u003e \"Show System Status\"\n```\n\n## Troubleshooting\n\n### Common Issues\n\n1. Permission Errors\n   - Ensure you're running the script as root\n   - Check directory permissions: /etc/wireguard should be 700\n\n2. Network Connectivity\n   - Verify firewall rules\n   - Check port forwarding\n   - Validate IP configurations\n\n3. Client Connection Issues\n   - Verify client configurations\n   - Check DNS settings\n   - Validate AllowedIPs settings\n\n### Logging\n\nView system logs:\n```bash\nSelect: \"Monitoring \u0026 Maintenance\" \u003e \"View Logs\"\n```\n\n## Contributing\n\nWe welcome contributions! Please read our contributing guidelines before submitting pull requests.\n\n1. Fork the repository\n2. Create a feature branch\n3. Commit your changes\n4. Push to the branch\n5. Create a Pull Request\n\n## Security Considerations\n\nWGEM implements several security best practices:\n\n- Secure key generation and storage\n- Proper permission management\n- Regular security updates\n- Automated peer cleanup\n- Detailed activity logging\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Acknowledgments\n\nWGEM is based on the WireGuard VPN project and includes improvements suggested by the community. Special thanks to all contributors who have helped make this project better.\n\n## Support\n\nFor support, please:\n\n1. Check the documentation\n2. Search existing issues on the [forum](https://forum.hhf.technology/).\n3. Create a new issue if needed on the [forum](https://forum.hhf.technology/).\n\n## Roadmap\n\nFuture planned features include:\n\n- Web interface for management\n- Multi-server synchronization\n- Advanced monitoring and metrics\n- Container integration\n- Cloud provider integration\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhhftechnology%2Fwireguard-ent-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhhftechnology%2Fwireguard-ent-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhhftechnology%2Fwireguard-ent-manager/lists"}