cn/openvpn-status-web
1
0
Fork 0
mirror of https://github.com/cmur2/openvpn-status-web.git synced 2024-12-22 12:54:24 +01:00
Code Releases Activity
Small Rack (Ruby) application serving OpenVPN status file
82 Commits 1 Branch 13 Tags 738 KiB
Ruby 85.7%
HTML 14.3%
7c0722e875
Go to file
cn 7c0722e875 ci: use Github Actions in parallel to Travis CI 
- this adds a new workflow for Github Actions that mirrors what the existing Travis CI workflow tests
- Travis CI might become unfriendly to opensource soonish so migration might be necessary
2020-12-04 09:14:32 +01:00
.github/workflows ci: use Github Actions in parallel to Travis CI 2020-12-04 09:14:32 +01:00
docs release: 3.0.1 2020-10-03 11:04:48 +02:00
examples Convert into gem 2013-05-03 15:32:08 +02:00
exe gem: adopt frozen string literals 2020-03-07 01:30:57 +01:00
lib release: 3.0.1 2020-10-03 11:04:48 +02:00
spec gem: adopt frozen string literals 2020-03-07 01:30:57 +01:00
.editorconfig gem: add editorconfig 2020-08-14 14:07:47 +02:00
.gitignore gem: add solargraph support 2020-03-01 22:12:38 +01:00
.rubocop.yml gem: upgrade rubocop to version 0.88.0 2020-07-14 20:06:06 +02:00
.solargraph.yml gem: add solargraph support 2020-03-01 22:12:38 +01:00
.travis.yml ci: use Github Actions in parallel to Travis CI 2020-12-04 09:14:32 +01:00
Gemfile gems: use solargraph fork until gem metadata allows rubocop 1.0 compat 2020-10-30 23:59:05 +01:00
LICENSE Add license 2013-02-25 22:56:33 +01:00
openvpn-status-web.gemspec gems: update rubocop to version 1.5.1 2020-12-03 21:23:22 +01:00
Rakefile ci: use Github Actions in parallel to Travis CI 2020-12-04 09:14:32 +01:00
README.md ci: use Github Actions in parallel to Travis CI 2020-12-04 09:14:32 +01:00

README.md

openvpn-status-web

Build Status ci Depfu

Description

Small (another word for naive in this case, it's simple and serves my needs) Rack application providing the information an OpenVPN server collects in it's status file especially including a list of currently connected clients (common name, remote address, traffic, ...).

It lacks:

  • caching (parses file on each request, page does auto-refresh every minute as OpenVPN updates the status file these often by default)
  • management interface support
  • possibly more...

Usage

Install the gem:

gem install openvpn-status-web

Create a configuration file in YAML format somewhere:

# listen address and port
host: "0.0.0.0"
port: "8080"
# optional: drop priviliges in case you want to but you should give this user at least read access on the log files
user: "nobody"
group: "nogroup"
# logfile is optional, logs to STDOUT else
logfile: "openvpn-status-web.log"
# hash with each VPNs display name for humans as key and further config as value
vpns:
  My Small VPN:
    # the status file path and status file format version are required
    version: 1
    status_file: "/var/log/openvpn-status.log"
  My Other VPN:
    version: 3
    status_file: "/var/log/other-openvpn-status.log"

Your OpenVPN configuration should contain something like this:

# ...snip...
status /var/log/openvpn-status.log
status-version 1
# ...snip...

For more information about OpenVPN status file and version, see their man page. openvpn-status-web is able to parse all versions from 1 to 3.

Advanced topics

Authentication

If the information exposed is important to you serve it via the VPN or use a webserver as a proxy to handle SSL and/or HTTP authentication.

Startup

There is a Dockerfile that can be used to build a Docker image for running openvpn-status-web.

The Debian 6 init script assumes that openvpn-status-web is installed into the system ruby (no RVM support) and the config.yaml is at /opt/openvpn-status-web/config.yaml. Modify to your needs.

License

openvpn-status-web is licensed under the Apache License, Version 2.0. See LICENSE for more information.