Home

Awesome

IKEv2-setup

Table of contents

What?

A Bash script that takes Ubuntu Server LTS versions 18.04 - 24.04 from clean install to fully-configured IKEv2 VPN using strongSwan. Comments and pull requests welcome.

VPN server

VPN clients

The VPN is tested working with:

Configuration files, scripts and instructions are sent by email. They are also dropped in the newly-created non-root user's home directory on the server (this point may be important, because VPS providers sometimes block traffic on port 25 by default and, even if successfully sent, conscientious email hosts will sometimes mark the email as spam).

Caveats

How?

  1. Pick a domain name for the VPN server and ensure that it already resolves to the correct IP by creating the appropriate A record in the DNS and making sure it has propagated. Let's Encrypt needs this in order to create your server certificate.

Don't want to use your own domain name here? You could try using the reverse DNS name provided by your server host, or an automatic IP/DNS alias service such as sslip.io, xip.io, nip.io, s.test.cab, or xip.lhjmmc.cn (earlier versions of this script used an sslip.io address by default). However, these options may fall foul of Let's Encrypt's per-domain rate limit of 50 certificates per week. Note that ephemeral AWS domain names like ec2-34-267-212-76.compute-1.amazonaws.com are not accepted by Let's Encrypt.

  1. Start with a clean Ubuntu Server installation. The cheapest VPSs offered by Linode, OVH, vps.ag, Google, AWS Lightsail, Hetzner, Vultr, Scaleway's ARM64-2GB, and Oracle's VM.Standard.E2.1.Micro (AMD) have all been tested working.

    • On Scaleway, unblock SMTP ports in the admin panel and hard reboot the server first, or your configuration email will not be delivered.
    • On Vultr, port 25 may also be blocked, but you won't know, and the only way to fix it is to open a support ticket.
    • On Oracle you'll need to enable network ingress for TCP on port 80 (for Let's Encrypt) and on any custom SSH port you choose, and for UDP on ports 500 and 4500 (for the VPN) in the interface for the relevant VNIC. Egress on port 25 is always blocked unlesss you file a ticket to open it.
  2. Optionally, set up key-based SSH authentication (alternatively, this may have been handled automatically by your server provider, or you may choose to stick with password-based authentication). This may require you to run some or all of the following commands, with appropriate substitutions, on the machine you're going to be logging in from:

    ssh-keygen -t ed25519 -C "me@my-domain.tld"      # if you need a new key, ed25519 is the latest and possibly most secure option
    ssh-keygen -t rsa -b 4096 -C "me@my-domain.tld"  # alternatively, use RSA and go (4,096 bits) large
    
    ssh root@myvpn.example.net  # if your host forces a password change before anything else (e.g. Hetzner), do it now, then exit
    ssh-copy-id -i ~/.ssh/id_ed25519.pub root@myvpn.example.net  # copy your public key over to the VPN server
    ssh root@myvpn.example.net  # log back in to the server for the next step ...
    
  3. On your new server installation, become root, download the script, give it execute permissions, and run it:

    wget https://raw.githubusercontent.com/jawj/IKEv2-setup/master/setup.sh
    chmod u+x setup.sh
    ./setup.sh
    
  4. You'll be prompted to enter all the necessary details after the software updates and installations complete. If you are not using key-based SSH authentication, you must pick a really strong password for the login user when prompted, or your server will be compromised.

    The part of your session where the script asks you questions should look something like this:

     --- Configuration: VPN settings ---
    
     Network interface: eth0
     External IP: 100.100.100.100
    
     ** Note: hostname must resolve to this machine already, to enable Let's Encrypt certificate setup **
     Hostname for VPN: 
     VPN username: george
     VPN password (no quotes, please): 
     Confirm VPN password: 
    
     Public DNS servers include:
    
     176.103.130.130,176.103.130.131  AdGuard               https://adguard.com/en/adguard-dns/overview.html
     176.103.130.132,176.103.130.134  AdGuard Family        https://adguard.com/en/adguard-dns/overview.html
     1.1.1.1,1.0.0.1                  Cloudflare/APNIC      https://1.1.1.1
     84.200.69.80,84.200.70.40        DNS.WATCH             https://dns.watch
     8.8.8.8,8.8.4.4                  Google                https://developers.google.com/speed/public-dns/
     208.67.222.222,208.67.220.220    OpenDNS               https://www.opendns.com
     208.67.222.123,208.67.220.123    OpenDNS FamilyShield  https://www.opendns.com
     9.9.9.9,149.112.112.112          Quad9                 https://quad9.net
     77.88.8.8,77.88.8.1              Yandex                https://dns.yandex.com
     77.88.8.88,77.88.8.2             Yandex Safe           https://dns.yandex.com
     77.88.8.7,77.88.8.3              Yandex Family         https://dns.yandex.com
     
     DNS servers for VPN users (default: 1.1.1.1,1.0.0.1): 176.103.130.130,176.103.130.131
    
     --- Configuration: general server settings ---
    
     Timezone (default: Europe/London): 
     Email address for sysadmin (e.g. j.bloggs@example.com): me@my-domain.tld
     Desired SSH log-in port (default: 22): 2222
     New SSH log-in user name: george
     Copy /root/.ssh/authorized_keys to new user and disable SSH password log-in [Y/n]? y
     New SSH user's password (e.g. for sudo): 
     Confirm new SSH user's password: 
    
  5. Once you're up and running, use these commands for some insight into what's going on:

     sudo ipsec statusall           # status, who's connected, etc.
     sudo iptables -L -v            # how much traffic has been forwarded, dropped, etc.?
     sudo tail -f /var/log/syslog   # real-time logs of (dis)connections etc.
    

Troubleshooting

If you ran this script before 13 September 2021, and used the generated PowerShell commands to set up Windows 10 clients, those clients may be unable to connect owing to a bug in Windows 10. If this is the case, see issue #126.

Otherwise, if things don't work out right away ...

Users

To add or change VPN users, it's:

  sudo nano /etc/ipsec.secrets

Edit usernames and passwords as you see fit (but don't touch the first line, which specifies the server certificate). The line format for each user is:

  someusername : EAP "somepassword"

To exit nano it's Ctrl + O then Ctrl + X, and to have strongSwan pick up the changes it's:

  sudo ipsec secrets

Upgrades

If you're on an older version of Ubuntu, it's probably easiest to make a record of any changes to ipsec.secrets, blow the whole thing away and reinstall, then reinstate ipsec.secrets.

Note that you may also need to delete and recreate all your client connection settings using the updated PowerShell commands or .mobileconfig file, since there have been a few cipher changes over time.

Bonus paranoia

Your traffic is not logged on the server, but if you're feeling especially paranoid there are various things you could do to reduce logging further. A simple and somewhat drastic option (once you've got everything working) is:

  sudo rm /var/log/syslog && sudo ln -s /dev/null /var/log/syslog
  sudo rm /var/log/auth.log && sudo ln -s /dev/null /var/log/auth.log

Why?

We use a similar setup as a corporate VPN at PSYT. And I use this to bounce my personal web browsing via Europe, in the hope of giving Theresa May's Investigatory Powers Bill the finger.

Why IKEv2?

More on IKEv2 at https://www.cl.cam.ac.uk/~mas90/resources/strongswan/ and https://www.bestvpn.com/blog/4147/pptp-vs-l2tp-vs-openvpn-vs-sstp-vs-ikev2/

Why not Algo?

Feel free to use Algo instead. It has similar aims, and now configures WireGuard too. However, it has many more moving parts, and requires several local installation steps before you even start setting up your VPN. This script is intended to be much simpler.