2020-11-19 12:08:55 -05:00
# openvpn-admin
2021-02-26 07:11:13 -05:00
Web UI for manage and admin openvpn users
## Install
### docker
We have [docker-compose.yaml ](https://github.com/flant/openvpn-admin/blob/master/docker-compose.yaml ) you can just change/add values you need and start it with [start.sh ](https://github.com/flant/openvpn-admin/blob/master/start.sh )
First you need to have installed
[docker ](https://docs.docker.com/get-docker/ )
[docker-compose ](https://docs.docker.com/compose/install/ )
```bash
git clone https://github.com/flant/openvpn-admin.git
cd openvpn-admin
start.sh
```
### building from source
First you need to have installed:
[golang ](https://golang.org/doc/install )
[packr2 ](https://github.com/gobuffalo/packr#installation )
[nodejs/npm ](https://nodejs.org/en/download/package-manager/ )
```bash
git clone https://github.com/flant/openvpn-admin.git
cd openvpn-admin
bootstrap.sh
build.sh
./openvpn-admin
```
be sure you don't forgot to configure all needed params
### prebuild binary (WIP)
You can use prebuild binary from [releases ](https://github.com/flant/openvpn-admin/releases ) page
just download tar.gz file .
## Usage
2020-11-19 12:08:55 -05:00
```
usage: openvpn-admin [< flags > ]
Flags:
2021-02-26 07:11:13 -05:00
--help Show context-sensitive help (also try --help-long and --help-man).
--listen.host="0.0.0.0" host for openvpn-admin
--listen.port="8080" port for openvpn-admin
--role="master" server role master or slave
2021-02-20 08:40:14 -05:00
--master.host="http://127.0.0.1"
2021-02-26 07:11:13 -05:00
url for master server
--master.basic-auth.user="" user for basic auth on master server url
2021-02-20 08:40:14 -05:00
--master.basic-auth.password=""
2021-02-26 07:11:13 -05:00
password for basic auth on master server url
--master.sync-frequency=600 master host data sync frequency in seconds.
--master.sync-token=TOKEN master host data sync security token
2021-02-20 08:40:14 -05:00
--ovpn.network="172.16.100.0/24"
2021-02-26 07:11:13 -05:00
network for openvpn server
--ovpn.server=HOST:PORT:PROTOCOL ...
comma separated addresses for openvpn servers
2021-02-20 08:40:14 -05:00
--mgmt=main=127.0.0.1:8989 ...
2021-02-26 07:11:13 -05:00
comma separated (alias=address) for openvpn servers mgmt interfaces
--metrics.path="/metrics" URL path for surfacing collected metrics
--easyrsa.path="./easyrsa/" path to easyrsa dir
--easyrsa.index-path="./easyrsa/pki/index.txt"
path to easyrsa index file.
--ccd Enable client-config-dir.
--ccd.path="./ccd" path to client-config-dir
--auth.password Enable additional password authorization.
--auth.db="./easyrsa/pki/users.db"
Database path fort password authorization.
--debug Enable debug mode.
--verbose Enable verbose mode.
--version Show application version.
2021-02-20 08:40:14 -05:00
2020-11-19 12:08:55 -05:00
```