warp.md

Connecting to Cloudflare WARP with WireGuard

Cloudflare's WARP VPN uses a slightly modified version of the WireGuard protocol, but it remains backwards compatible with the normal WireGuard client software. This means you can connect to it on platforms which don't yet have an official WARP client, e.g. your computer or EdgeOS-based router.

Step 1

Generate a WireGuard keypair, as usual:

wg genkey | tee private.key | wg pubkey > public.key

Step 2

Register the public half with Cloudflare, changing the fields as appropriate:

curl -d '{"key":"PASTE_PUBLIC_KEY_HERE", "install_id":"", "warp_enabled":true, "tos":"2019-09-26T00:00:00.000+01:00", "type":"Android", "locale":"en_GB"}' https://api.cloudflareclient.com/v0a737/reg | tee warp.json

(tos should be the date you read and agreed to their terms of service)

Step 3

Find the tunnel endpoint:

jq '.config.peers[0]' warp.json

and the IP address for your end:

jq '.config.interface.addresses' warp.json

Step 4

Construct your WireGuard config file. It should look something like this:

[Interface]
Address = 172.16.0.2/12
ListenPort = 51820
PrivateKey = xxxxxxxxxxxxxxxxxx

[Peer]
PublicKey = yyyyyyyyyyyyyyyyyy
AllowedIPs = 0.0.0.0/0
Endpoint = engage.cloudflareclient.com:2408

Notes

• It seems ListenPort must not be accessible from the outside, as this appears to cause problems, so just choose any unused port and firewall it off for now
• PrivateKey is yours from Step 1
• PublicKey is Cloudflare's from Step 3
• You only get one IPv4 so you'll need to use SNAT if you're doing this on a router
• I don't know what netmask they want for IPv6 so have left that out

Thanks! I needed to add:

DNS = 1.1.1.1

To the [Interface] section.

I get error code: 1020% when registering my public key

I get error code: 1020% when registering my public key

@p00f try this project instead: https://github.com/ViRb3/wgcf