vpn-server/README.md
2015-11-28 01:36:03 +08:00

23 lines
1.3 KiB
Markdown

# IKEv2 VPN Server on Docker
Recipe to build [`gaomd/ikev2-vpn-server`](https://registry.hub.docker.com/u/gaomd/ikev2-vpn-server/) Docker image.
## 1. Start the IKEv2 VPN Server
docker run -d --name ikev2-vpn-server --privileged -p 500:500/udp -p 4500:4500/udp gaomd/ikev2-vpn-server:0.2.2
## 2. Generate a .mobileconfig file for iOS / OS X
*Replace `vpn1.example.com` with your own domain name and make sure it resolves to you server's IP address.*
docker run -i -t --rm --volumes-from ikev2-vpn-server -e "HOST=vpn1.example.com" gaomd/ikev2-vpn-server:0.2.2 generate-mobileconfig > ikev2-vpn.mobileconfig
This command generates an `ikev2-vpn.mobileconfig` file, transfer it to your local computer via SSH tunnel (`scp`) or any other secure methods.
## 3. Install .mobileconfig
- **iOS 9 or later**: AirDrop the `.mobileconfig` file to your iOS 9 device, finish the **Install Profile** screen;
- **iOS 8 or later**: Send an E-mail to your iOS device with the `.mobileconfig` file as attachment, then tap the attachment to bring up the **Install Profile** screen;
- **OS X 10.11 El Capitan or later**: Double click the `.mobileconfig` file to start the profile installation.
*IKEv2 protocol requires iOS 8 or later, Mac OS X 10.11 El Capitan is supported as well.*