1
1
mirror of https://github.com/namibia/openvpn-install.git synced 2024-11-17 17:55:12 +00:00
openvpn-install/README.md

97 lines
4.2 KiB
Markdown
Raw Normal View History

2013-05-14 12:04:19 +00:00
##openvpn-install
2016-11-20 14:29:23 +00:00
Secure OpenVPN installer for Debian, Ubuntu and CentOS.
2013-05-14 12:04:19 +00:00
2016-11-15 12:36:24 +00:00
This script will let you setup your own secure VPN server in no more than a minute.
2013-05-14 12:04:19 +00:00
2016-10-23 10:49:20 +00:00
![](https://lut.im/xtTrl1R4if/j3j16qgomoL9JH9B)
2016-03-13 14:41:05 +00:00
##Fork
2016-11-15 12:36:24 +00:00
2016-11-20 14:29:23 +00:00
This script is based on the great work of [Nyr and its contributors](https://github.com/Nyr/openvpn-install).
2016-11-15 12:36:24 +00:00
2016-11-20 14:29:23 +00:00
I made it because I wanted to have a more secured OpenVPN out-of-the-box. It works like the original script, but is more focused on privacy and espicially better encryption. Nyr's original script uses mainly default parameters regarding encryption, which are not *bad*, but you can do a lot better with the latest versions of OpenVPN and have nearly state-of-the-art encryption.
2016-11-15 12:36:24 +00:00
2016-11-20 14:29:23 +00:00
Also, Nyr and myself clearly have not the same point of view regarding this script, that's why it's a fork.
2016-11-15 12:36:24 +00:00
2016-11-20 14:29:23 +00:00
The only drawback is that you need to use a recent version of OpenVPN, because some options are only availble since OpenVPN 2.3.3. Therefore I restrain the compatibility of this script to a few but widely used GNU/Linux distributions, to get a recent version of OpenVPN from trusted third-party repositories, if needed.
On the client-side, it's less problematic, but if you want to use an OpenVPN server installed with this script with an old client (\<2.3.3), it won't work. If you can't upgrade your client (which is a security problem), use Nyr's script.
2016-11-15 12:36:24 +00:00
### Features
2016-08-20 08:58:19 +00:00
This fork includes the following features :
2016-11-15 12:36:24 +00:00
- Every feature of the [original script](https://github.com/Nyr/openvpn-install)
2016-03-21 17:36:08 +00:00
- No comp-lzo [compression is a vector for oracle attacks, e.g. CRIME or BREACH](https://github.com/BetterCrypto/Applied-Crypto-Hardening/pull/91#issuecomment-75388575)
2016-03-19 16:38:34 +00:00
- Better encryption (see below)
2016-06-10 12:54:04 +00:00
- Avoid DNS leak
- UFW support
2016-03-08 22:16:52 +00:00
- TLS 1.2 only
2016-06-10 12:54:04 +00:00
- Strong ciphers, DH keys and certificates. (see variants)
2016-03-19 16:38:34 +00:00
- AES-256-CBC and SHA-512 for HMAC (instead of BF-128-CBC and SHA1)
- Run server in unprivileged mode, reducing risks to the system
- TLS-auth to help [thwart DoS attacks](https://openvpn.net/index.php/open-source/documentation/howto.html#security) and provide a 2nd line of defense to the TLS channel.
2016-03-08 22:51:02 +00:00
- [FDN's DNS Servers](http://www.fdn.fr/actions/dns/)
2016-06-10 22:33:57 +00:00
- [DNS.WATCH DNS Servers](https://dns.watch/index)
2016-05-10 20:56:34 +00:00
- Up-to-date OpenVPN (2.3.11) thanks to [EPEL](http://fedoraproject.org/wiki/EPEL) and [swupdate.openvpn.net](https://community.openvpn.net/openvpn/wiki/OpenvpnSoftwareRepos)
2016-05-10 22:29:43 +00:00
- Support for either SNAT or MASQUERADE for forwarding
2016-11-20 13:23:48 +00:00
2016-03-19 16:38:34 +00:00
## Variants
2016-03-13 14:41:05 +00:00
2016-03-19 16:38:34 +00:00
When you lauch the script you will be asked to choose a mode. Both will work the same way, but *slow* has higher encryption settings, so it may slow down your connection and take more time to install.
2016-03-15 20:36:05 +00:00
2016-03-19 16:38:34 +00:00
If you're just using your VPN at home, you may choose "fast". But if you're often using public Wi-Fi or traveling a lot, you choose use *slow*.
2016-03-15 20:36:05 +00:00
2016-03-19 16:38:34 +00:00
FYI, "fast" is still more secured than default OpenVPN settings.
2016-03-15 20:36:05 +00:00
2016-03-19 16:38:34 +00:00
### Slow (high encryption)
Features :
- 4096 bits RSA private key
- 4096 bits Diffie-Hellman key
- 256 bits AES-GCM
- SHA-384 RSA certificate
2016-03-13 14:41:05 +00:00
### Fast (lower encryption)
2016-03-19 16:38:34 +00:00
Features :
- 2048 bits RSA private key
- 2048 bits Diffie-Hellman key
- 128 bits AES-GCM
- SHA-256 RSA certificate
2016-03-13 14:41:05 +00:00
2016-03-19 16:38:34 +00:00
## Compatibility
2016-03-13 14:53:09 +00:00
2016-03-19 16:38:34 +00:00
The script is made to work on these OS :
- Debian 7
2016-03-13 14:41:05 +00:00
- Debian 8
2016-03-19 16:38:34 +00:00
- Ubuntu 12.04 LTS
- Ubuntu 14.04 LTS
2016-05-06 18:32:53 +00:00
- Ubuntu 16.04 LTS
- Ubuntu 16.10
2016-03-14 20:20:03 +00:00
- CentOS 6
- CentOS 7
2016-03-13 14:41:05 +00:00
2016-03-19 16:38:34 +00:00
##Installation
2016-03-13 14:53:09 +00:00
2016-08-20 09:50:02 +00:00
**You have to enable the TUN module otherwise OpenVPN won't work.** Ask your host if you don't know how to do it. If the TUN module is not enabled, the script will tell you.
2016-08-20 08:58:19 +00:00
2016-03-19 16:38:34 +00:00
Run the script and follow the assistant:
2016-03-13 14:41:05 +00:00
2016-03-19 16:38:34 +00:00
```
2016-06-10 14:12:02 +00:00
wget https://raw.githubusercontent.com/Angristan/OpenVPN-install/master/openvpn-install.sh
2016-03-19 16:38:34 +00:00
chmod +x openvpn-install.sh
./openvpn-install.sh
```
2016-03-15 20:37:58 +00:00
2016-03-19 16:38:34 +00:00
Once it ends, you can run it again to add more users, remove some of them or even completely uninstall OpenVPN.
2016-03-13 14:41:05 +00:00
2016-10-23 10:49:20 +00:00
![](https://lut.im/Z8xfJ8WqyO/3JoPmJK8VRp6zwOE)
2016-01-01 12:53:28 +00:00
2016-09-29 18:21:37 +00:00
You can get a cheap VPS for 3€/month at [PulseHeberg](https://goo.gl/oBhgaj).
2016-01-01 12:53:28 +00:00
2016-11-20 15:39:36 +00:00
## Credits & Licence
2016-01-01 12:53:28 +00:00
2016-11-20 15:03:59 +00:00
Thanks to the [contributors](https://github.com/Angristan/OpenVPN-install/graphs/contributors)
2016-01-01 12:53:46 +00:00
2016-11-20 15:39:36 +00:00
[Old repo](https://github.com/Angristan/OpenVPN-install-fork-old)
2016-11-20 15:03:59 +00:00
[MIT Licence](https://raw.githubusercontent.com/Angristan/openvpn-install/master/LICENSE)