mirror of
https://github.com/eduardogsilva/wireguard_webadmin.git
synced 2025-04-19 08:55:12 +00:00
Readme and install instructions
This commit is contained in:
parent
91502f6cc5
commit
5e598deba3
49
README.md
49
README.md
@ -1 +1,50 @@
|
|||||||
|
|
||||||
# wireguard_webadmin
|
# wireguard_webadmin
|
||||||
|
|
||||||
|
wireguard_webadmin is a full-featured yet easy-to-configure web interface for managing WireGuard VPN instances. Designed to simplify the administration of WireGuard networks, it provides a user-friendly interface that supports multiple users with varying access levels, multiple WireGuard instances with individual peer management, and support for crypto key routing for site-to-site interconnections.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- **Multi-User Support**: Manage access with different permission levels for each user.
|
||||||
|
- **Multiple WireGuard Instances**: Enables separate management for peers across multiple instances.
|
||||||
|
- **Crypto Key Routing**: Simplifies the configuration for site-to-site interconnections.
|
||||||
|
|
||||||
|
This project aims to offer an intuitive and user-friendly solution for WireGuard VPN management without compromising the power and flexibility WireGuard provides.
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
||||||
|
|
||||||
|
## Deployment
|
||||||
|
|
||||||
|
Follow these steps to deploy wireguard_webadmin:
|
||||||
|
|
||||||
|
1. Clone the repository:
|
||||||
|
```
|
||||||
|
git clone https://github.com/eduardogsilva/wireguard_webadmin
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Create the `wireguard_webadmin/production_settings.py` file and configure the minimum required variables:
|
||||||
|
```python
|
||||||
|
DEBUG = False
|
||||||
|
ALLOWED_HOSTS = ['your_domain']
|
||||||
|
CSRF_TRUSTED_ORIGINS = ['https://your_domain']
|
||||||
|
SECRET_KEY = 'your_secret_key'
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Place your SSL certificates for nginx in the `certificates` volume.
|
||||||
|
|
||||||
|
4. Run Docker Compose:
|
||||||
|
```
|
||||||
|
docker-compose up
|
||||||
|
```
|
||||||
|
|
||||||
|
After completing these steps, your wireguard_webadmin should be up and running. Access your server using `http://your_domain` and start configuring it.
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
|
||||||
|
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
|
||||||
|
|
||||||
|
## Support
|
||||||
|
|
||||||
|
If you encounter any issues or require assistance, please open an issue on the project's GitHub page.
|
||||||
|
@ -179,7 +179,7 @@
|
|||||||
<footer class="main-footer">
|
<footer class="main-footer">
|
||||||
wireguard-webadmin
|
wireguard-webadmin
|
||||||
<div class="float-right d-none d-sm-inline-block">
|
<div class="float-right d-none d-sm-inline-block">
|
||||||
<b>Version</b> 0.0001
|
<b>Version</b> 0.8 beta
|
||||||
</div>
|
</div>
|
||||||
</footer>
|
</footer>
|
||||||
|
|
||||||
|
@ -1,5 +1,21 @@
|
|||||||
{% extends "base.html" %}
|
{% extends "base.html" %}
|
||||||
|
|
||||||
{% block content %}
|
{% block content %}
|
||||||
this page is just a placeholder for the moment
|
<h1>Welcome to wireguard_webadmin</h1>
|
||||||
|
<p>I've been working hard on it over the past week and plan to continue making corrections and finishing it in the coming days.</p>
|
||||||
|
<p>Currently, it's quite functional, but there's still a need to polish various aspects of the interface to enhance usability.</p>
|
||||||
|
<p>If you encounter any issues or have suggestions, please open an issue on GitHub so I can review it.</p>
|
||||||
|
<h2>Important Points to Note:</h2>
|
||||||
|
<ul>
|
||||||
|
<li>The peers page does not yet display data from WireGuard such as the last handshake and data transfer.</li>
|
||||||
|
<li>The verification of allowed IPs against the output of wg show has not yet been implemented. This will help detect configuration errors for crypto routing.</li>
|
||||||
|
<li>After editing a peer or server settings, go to the status page and click to update the WireGuard configurations, then restart the service. I still need to make this process more intuitive.</li>
|
||||||
|
<li>The DNS server provided to the peer is still hardcoded.</li>
|
||||||
|
</ul>
|
||||||
|
<p>Your involvement and feedback are crucial to the development of wireguard_webadmin. Together, we can refine and enhance its functionality. Thank you for being part of this journey!</p>
|
||||||
|
|
||||||
|
<h2>Don't Forget</h2>
|
||||||
|
<p>Remember to save your configuration changes and restart the service for them to take effect.</p>
|
||||||
|
<p>Keep checking the GitHub page, I will be updating this project very soon.</p>
|
||||||
|
|
||||||
{% endblock %}
|
{% endblock %}
|
||||||
|
Loading…
x
Reference in New Issue
Block a user