OpenVPN-Monitor

OpenVPN-Monitor is a simple python program to generate html that displays the status of an OpenVPN server, including all current connections. It uses the OpenVPN management console. It typically runs on the same host as the OpenVPN server, however it does not necessarily need to.

The current source code is available on github:

https://github.com/furlongm/openvpn-monitor

mkdir /srv/openvpn-monitor
cd /srv/openvpn-monitor
virtualenv .
. bin/activate
pip install openvpn-monitor gunicorn
gunicorn openvpn-monitor -b 0.0.0.0:80

apt-get install python-geoip python-ipaddr python-humanize apache2 git

cd /var/www/html
git clone https://github.com/furlongm/openvpn-monitor.git

Add the following line to your OpenVPN server configuration to run the management console on 127.0.0.1 port 5555:

   management 127.0.0.1 5555

Refer to the OpenVPN documentation for further information on how to secure access to the management interface.

Choose one of the following two methods to serve under Apache:

apt-get install libapache2-mod-wsgi
a2enmod wsgi

Add the following to /etc/apache2/sites-enabled/000-default.conf

    WSGIScriptAlias /openvpn-monitor /var/www/html/openvpn-monitor/openvpn-monitor.py

a2enmod cgi

Add the following to /etc/apache2/sites-enabled/000-default.conf

    <Directory "/var/www/html/openvpn-monitor">
        Options +ExecCGI
        AddHandler cgi-script .py
        DirectoryIndex openvpn-monitor.py
    </Directory>

Restart apache:

/etc/init.d/apache2 restart

cd /usr/share/GeoIP/
wget http://geolite.maxmind.com/download/geoip/database/GeoLiteCity.dat.gz
gunzip GeoLiteCity.dat.gz
mv GeoLiteCity.dat GeoIPCity.dat

The example configuration file /var/www/html/openvpn-monitor/openvpn-monitor.conf should give some indication of how to set site name, add a logo, etc. You can also set a default location (latitude and longitude) for the embedded maps. If not set, the default location is Melbourne, Australia.

Edit /var/www/html/openvpn-monitor/openvpn-monitor.conf to match your site.

You should now be able to navigate to http://myipaddress/openvpn-monitor

OpenVPN-Monitor can be run from the command line in order to test if the html generates correctly:

cd /var/www/html/openvpn-monitor
python openvpn-monitor.py

OpenVPN-Monitor is licensed under the GPLv3, a copy of which can be found in the COPYING file.

Flags are created by Matthias Slovig (flags@slovig.de) and are licensed under Creative Commons License Deed Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0). See http://flags.blogpotato.de/ for more details.