mirror of
https://github.com/wireadmin/wireadmin
synced 2025-02-26 05:48:44 +00:00
updates docs
This commit is contained in:
parent
b0663a7e15
commit
19d79ada40
21
LICENSE
Normal file
21
LICENSE
Normal file
@ -0,0 +1,21 @@
|
|||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) 2023 Shahrad Elahi
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all
|
||||||
|
copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||||
|
SOFTWARE.
|
74
README.md
74
README.md
@ -1 +1,75 @@
|
|||||||
# WireGuard GUI (Easy Admin UI)
|
# WireGuard GUI (Easy Admin UI)
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
| | |
|
||||||
|
|:------------------------------------------------------------------------------------------:|:------------------------------------------------------------------------------------------:|
|
||||||
|
| <img src="assets/screenshot-2.png" alt="screenshot" style="width:100%;max-height:300px;"/> | <img src="assets/screenshot-3.png" alt="screenshot" style="width:100%;max-height:300px;"/> |
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- Easy-to-use web-based admin UI
|
||||||
|
- Support for multiple users and servers
|
||||||
|
- Support for **Tor to anonymize connections**
|
||||||
|
- List, create, delete, or modify any server or user
|
||||||
|
- Scan QR codes or easily download the client configurations.
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
* A host with a kernel that supports WireGuard.
|
||||||
|
* A host with Docker installed.
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
### 1. Install Docker
|
||||||
|
|
||||||
|
To install Docker, go to the official documentation and install a version that meets your environment's requirements.
|
||||||
|
|
||||||
|
- [Install Docker Engine](https://docs.docker.com/engine/install/)
|
||||||
|
|
||||||
|
### 2. Run WireAdmin
|
||||||
|
|
||||||
|
Install WireAdmin using the command line:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker run -d \
|
||||||
|
--name wireadmin \
|
||||||
|
-e WG_HOST="🚨YOUR_SERVER_IP" \
|
||||||
|
-e UI_PASSWORD="🔐OPTIONAL_ADMIN_PASSWORD" \
|
||||||
|
-p "3000:3000/tcp" \
|
||||||
|
-p "51820:51820/udp" \
|
||||||
|
-v "~/wireadmin-data:/data" \
|
||||||
|
--cap-add=NET_ADMIN \
|
||||||
|
--cap-add=SYS_MODULE \
|
||||||
|
--sysctl="net.ipv4.conf.all.src_valid_mark=1" \
|
||||||
|
--sysctl="net.ipv4.ip_forward=1" \
|
||||||
|
--restart unless-stopped \
|
||||||
|
ghcr.io/shahradelahi/wireadmin
|
||||||
|
```
|
||||||
|
|
||||||
|
Please note that the port `3000` is for the UI and it is up to you to remove it after configuring the Servers/Peers.
|
||||||
|
|
||||||
|
> IMPORTANT: When creating each server, ensure that you add the port exposure through Docker. (The port `51820` is added
|
||||||
|
> as an example.)
|
||||||
|
|
||||||
|
### 3. Enjoy
|
||||||
|
|
||||||
|
Please feel free to open an issue if you have any questions or suggestions.
|
||||||
|
|
||||||
|
## Environment Options
|
||||||
|
|
||||||
|
These options can be configured by setting environment variables using `-e KEY="VALUE"` in the `docker run` command.
|
||||||
|
|
||||||
|
| Option | Description | Default |
|
||||||
|
|---------------|------------------------------------------------|---------|
|
||||||
|
| `WG_HOST` | The public IP address of the WireGuard server. | `""` |
|
||||||
|
| `UI_PASSWORD` | The password for the admin UI. (optional) | `""` |
|
||||||
|
|
||||||
|
## Support the Project
|
||||||
|
|
||||||
|
Seriously, this project is free and open-source, and all I ask for as support is for you to give a star to the
|
||||||
|
repository.
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
This project is licensed under the MIT License—see the [LICENSE](LICENSE) file for details.
|
||||||
|
Binary file not shown.
Before Width: | Height: | Size: 118 KiB After Width: | Height: | Size: 128 KiB |
Binary file not shown.
Before Width: | Height: | Size: 164 KiB After Width: | Height: | Size: 193 KiB |
BIN
assets/screenshot-3.png
Normal file
BIN
assets/screenshot-3.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 158 KiB |
Loading…
Reference in New Issue
Block a user