Sem descrição

Mustafa Arici 9ab0a1fd12 chore(package): update afterupdate and systemd unit há 8 anos atrás
api 9c34a5fcb1 feat(permset): apply permission checking using permsets há 8 anos atrás
bindata 9ab0a1fd12 chore(package): update afterupdate and systemd unit há 8 anos atrás
cmd a8338623a3 style(webui): add version to ovpmd start prompt há 8 anos atrás
contrib 9ab0a1fd12 chore(package): update afterupdate and systemd unit há 8 anos atrás
permset 5b9fdc5548 doc(permset): add package docstring há 8 anos atrás
pki 3c59a7469c doc: fix the word usage whether há 8 anos atrás
supervisor 3c59a7469c doc: fix the word usage whether há 8 anos atrás
template e7be5159cb feat(webui): handle enter key on login há 8 anos atrás
webui e7be5159cb feat(webui): handle enter key on login há 8 anos atrás
.gitignore 33a3d57151 init: add gitignore há 8 anos atrás
.travis.yml 5c4c565601 chore(ci): fix on fix há 8 anos atrás
CHANGELOG.md ff285d7995 release: v0.2.0 há 8 anos atrás
Dockerfile 5622b954fb chore(build): update build env to include npm há 8 anos atrás
LICENSE cd22d83ab6 Create LICENSE há 8 anos atrás
Makefile 5622b954fb chore(build): update build env to include npm há 8 anos atrás
README.md 62d1bbaef7 doc(readme): add network management link há 8 anos atrás
build.sh d42c20dc41 chore: fix user generation after package install há 8 anos atrás
const.go 144c2759db release: v0.2.3 há 8 anos atrás
db.go 55acfb6b25 refactor: major refactor of all service há 8 anos atrás
db_test.go 55acfb6b25 refactor: major refactor of all service há 8 anos atrás
doc.go 6006fb9610 feat(api): implement authentication service há 8 anos atrás
generate.go cbaf634afb doc(generate): seperate docstring from package definition há 8 anos atrás
net.go 55acfb6b25 refactor: major refactor of all service há 8 anos atrás
net_test.go 8bbbb27401 feat(vpn): implement configurable dns option há 8 anos atrás
perms.go d37557bd4d refactor(perms): add DeleteNetworkPerm to admin há 8 anos atrás
user.go e705ea422a fix(user): allow update if updated ip is same with user's existing static ip há 8 anos atrás
user_test.go e705ea422a fix(user): allow update if updated ip is same with user's existing static ip há 8 anos atrás
vpn.go d9ed207d44 refactor(vpn): push associated servernets to client há 8 anos atrás
vpn_test.go 0f211905e5 test(vpn): remove client ovpn config nopull check há 8 anos atrás

README.md

OVPM - OpenVPN Management Server

Build Status GitHub version codecov GoDoc

OVPM allows you to administrate an OpenVPN server on linux easily via command line and web interface.

With OVPM you can create and run an OpenVPN server, add/remove VPN users, generate client .ovpn files for your users etc.

This software is not stable yet. We recommend against using it for anything serious until, version 1.0 is released.

Roadmap

  • OpenVPN management functionality
  • User management functionality
  • Network management functionality
  • Command Line Interface (CLI)
  • API (REST and gRPC)
  • Web User Interface (WebUI)
  • Import/Export/Backup OVPM config
  • Effortless client profile (.ovpn file) delivery over Web
  • Monitoring and Quota functionality

Demo Here is a little demo of what it looks on terminal to init the server, create a vpn user and generate .ovpn file for the created user.

asciicast

Installation

from RPM (CentOS/Fedora):

# Add YUM Repo
$ sudo yum-config-manager --add-repo https://cad.github.io/ovpm/rpm/ovpm.repo

# Install OVPM
$ sudo yum install ovpm

from DEB (Ubuntu/Debian):

This is tested only on Ubuntu >=16.04.3 LTS

# Add APT Repo
$ sudo sh -c 'echo "deb [trusted=yes] https://cad.github.io/ovpm/deb/ ovpm main" >> /etc/apt/sources.list'
$ sudo apt update

# Install OVPM
$ sudo apt install ovpm

# Enable and start ovpmd service
$ systemctl start ovpmd
$ systemctl enable ovpmd  

from Source (go get):

Only dependency for ovpm is OpenVPN>=2.3.

$ go get -u github.com/cad/ovpm/...

# Make sure user nobody and group nogroup is available
# on the system
$ sudo useradd nobody
$ sudo groupadd nogroup

# Start ovpmd on a seperate terminal
$ sudo ovpmd

Now ovpmd should be running.

Quickstart

Create a vpn user and export vpn profile for the created user.

# We should init after fresh install
$ ovpm vpn init --hostname <vpn.example.com>
INFO[0004] ovpm server initialized

# Now, lets create a vpn user
$ ovpm user create -u joe -p verySecretPassword
INFO[0000] user created: joe

# Finally export the vpn profile for user joe
$ ovpm user genconfig -u joe
INFO[0000] exported to joe.ovpn

OpenVPN profile for user joe is exported to joe.ovpn file. You can simply use this file with OpenVPN to connect to the vpn server from another computer.

Next Steps