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)
|
||||
|
||||

|
||||
|
||||
| | |
|
||||
|:------------------------------------------------------------------------------------------:|:------------------------------------------------------------------------------------------:|
|
||||
| <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