Anonymous
Not logged in
Talk
Contributions
Create account
Log in
Search
Editing
OpenWRT WireGuard VPN Server Tutorial
(section)
From KB42
Namespaces
Page
Discussion
More
More
Page actions
Read
Edit
Edit source
History
Warning:
You are not logged in. Your IP address will be publicly visible if you make any edits. If you
log in
or
create an account
, your edits will be attributed to your username, along with other benefits.
Anti-spam check. Do
not
fill this in!
=Introduction= I recently figured out how to set up a WireGuard VPN on my Raspberry Pi 3 running OpenWRT and I decided to write an up-to-date guide on how to do it. It should work on any device running a recent-ish build of OpenWRT/LEDE, provided you have enough storage space for it. This will let you connect to your home network from anywhere, as well as route all your traffic through your home internet so you can avoid content filters at School/Work, as well as keeping your traffic encrypted. I don't use IPv6 on my network so you'll have to figure that stuff out for yourself. Before you begin, I'll warn you that the process of setting up WireGuard may disconnect you from the internet a few times so make sure nobody else is using the internet before you start. ==Step 1: Installing the packages== SSH into your OpenWRT device and run the following: <syntaxhighlight lang="bash"> opkg update opkg install luci-proto-wireguard luci-app-wireguard wireguard kmod-wireguard wireguard-tools reboot </syntaxhighlight> (protip: Windows 10 has built in SSH support if you don't have PuTTY installed. You can also use LuCI to install these packages by going to System>Software) ==Step 2: Creating a firewall rule== Go into LuCI and head to Network>Firewall>Port Forwards Create a new rule using the following input: <syntaxhighlight lang="bash"> Name: WireGuard Protocol: UDP External Zone: WAN External Port: 1234 Internal Zone: LAN Internal IP Address: <The IP address of your device, mine is 192.168.1.1> Internal Port: 1234 </syntaxhighlight> Click Add, then Save & Apply. This allows your VPN clients (Phone, Laptop etc) to connect to your OpenWRT device from the internet. ==Step 3: Generating the keys== SSH into your OpenWRT device and run the following: <syntaxhighlight lang="bash"> umask 077 && wg genkey > privkey cat privkey | wg pubkey > pubkey cat /root/pubkey cat /root/privkey </syntaxhighlight> This creates two files in the /root/ directory of your device, pubkey and privkey. You should email yourself the pubkey or transfer it securely to your phone somehow because you'll need it when setting up the VPN connection. Copy the private key to your clipboard because you'll need it for Step 4. == Step 4: Setting up the WireGuard interface == # Go into LuCI and head to Network>Interfaces>Add New Interface # Set the name of the new interface as wg0 # Set the protocol to WireGuard VPN # Click Submit # Paste the private key you got from Step 3 into the Private Key field # Set the listen port to 1234 # In the IP Addresses field, type 10.14.0.1/24 Go to the Firewall Settings tab and assign the interface to your LAN zone if it's not automatically been assigned. This will enable you to access your LAN devices when you're connected to your VPN. If you want to keep your devices seperate, you can create another Firewall zone specifically for the WireGuard Interface. Click Save & Apply ==Step 5: Setting up the VPN connection on an Android device== # Download the WireGuard app from the Play Store or F-Droid or whatever is your preferred source of apps # Open the WireGuard app # Tap the plus icon and go to "Create from scratch" # Make up a name for your VPN connection # Tap "Generate" to generate yourself a public and private key # In the Addresses field, type 10.14.0.3/32 # Leave the Listen Port and MTU fields empty unless you need to change them for whatever reason # In the DNS servers field, either type the address of your home DNS server or use a DNS server of your choice (e.g. 1.1.1.1) # Tap Add Peer # Paste the Public Key from the /root/ directory of your OpenWRT device # Leave the Pre-shared key field blank # In the Allowed IPs field, type 0.0.0.0/0,::0 (You should add ::0 even if you aren't using IPv6, as this stops your device from leaking data when connected to IPv6 enabled sites.) # In the Endpoint field, type the public (WAN) IP address or domain name of your OpenWRT device, followed by a colon and the port number. For example: 69.65.164.12:1234 # In the Persistent Keepalive field, type 25 # Save the connection ==Step 6: Adding your phone to the list of allowed peers== Now you have to register your phone as a peer to your OpenWRT device. To do this: # In the WireGuard app, copy your Public Key (The one you generated earlier) to the clipboard # Go into LuCI and head to Network>Interfaces # Click Edit on the WireGuard interface # Go to the Peers section and add click Add # Paste the Public Key from your phone into the Public Key field # In the Allowed IPs field, type 10.14.0.3/32 # Check the Route Allowed IPs checkbox # Leave the Endpoint Host and Endpoint Port fields blank # In the Persistent Keepalive field, type 25 # Click Save & Apply # Reboot the OpenWRT device, either through LuCI>System>Reboot or by typing reboot in SSH ==Step 7: Testing the VPN Connection== Theoretically, everything should be finished now. To test this, go into the WireGuard app and enable the VPN connection. Then open a browser and if you have internet connectivity then it worked. :) (protip: The WireGuard app has it's own quick settings tile, so you can add it to your quick settings panel for ease of access) {{article summary | image = | title = {{%PAGENAME%}} | summary = Set up a WireGuard VPN on a Raspberry Pi 3/4 running OpenWRT. It should work on any device running a recent-ish build of OpenWRT/LEDE, provided you have enough storage space for it. }} [[Category:Technology]] [[Category:Software]] [[Category:Computers]] [[Category:Privacy]] [[Category:VPN]]
Summary:
Please note that all contributions to KB42 may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see
KB42:Copyrights
for details).
Do not submit copyrighted work without permission!
Cancel
Editing help
(opens in new window)
Navigation
Navigation
Main page
Recent changes
Random page
Help about MediaWiki
DONATE
Wiki tools
Wiki tools
Special Pages
Categories
Import Pages
Cargo data
Page tools
Page tools
User page tools
More
What links here
Related changes
Page information
Page logs