mirror of
https://github.com/pirate/wireguard-docs
synced 2024-11-12 19:10:34 +00:00
move examples to folders
This commit is contained in:
Nick Sweeting
parent
889d8a29cf
commit
9ec86c0e0f
341
README.md
341
README.md
@ -57,13 +57,16 @@ See https://github.com/pirate/wireguard-docs for example code and documentation
|
||||
|
||||
<ul>
|
||||
<li><a href="#Table-of-Contents">Table of Contents</a></li>
|
||||
<li><a href="#Intro">Intro</a><ul>
|
||||
<li><a href="#Intro">Intro</a>
|
||||
<ul>
|
||||
<li><a href="#My-Personal-Requirements-for-a-VPN-Solution">My Personal Requirements for a VPN Solution</a></li>
|
||||
<li><a href="#List-of-Possible-VPN-Solutions">List of Possible VPN Solutions</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#Wireguard-Documentation">Wireguard Documentation</a><ul>
|
||||
<li><a href="#Glossary">Glossary</a><ul>
|
||||
<li><a href="#Wireguard-Documentation">Wireguard Documentation</a>
|
||||
<ul>
|
||||
<li><a href="#Glossary">Glossary</a>
|
||||
<ul>
|
||||
<li><a href="#PeerNodeDevice">Peer/Node/Device</a></li>
|
||||
<li><a href="#Bounce-Server">Bounce Server</a></li>
|
||||
<li><a href="#Subnet">Subnet</a></li>
|
||||
@ -76,7 +79,8 @@ See https://github.com/pirate/wireguard-docs for example code and documentation
|
||||
<li><a href="#Example-Strings">Example Strings</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#How-WireGuard-Works">How WireGuard Works</a><ul>
|
||||
<li><a href="#How-WireGuard-Works">How WireGuard Works</a>
|
||||
<ul>
|
||||
<li><a href="#How-Public-Relay-Servers-Work">How Public Relay Servers Work</a></li>
|
||||
<li><a href="#How-WireGuard-Routes-Packets">How WireGuard Routes Packets</a></li>
|
||||
<li><a href="#What-WireGuard-Traffic-Looks-Like">What WireGuard Traffic Looks Like</a></li>
|
||||
@ -85,7 +89,8 @@ See https://github.com/pirate/wireguard-docs for example code and documentation
|
||||
<li><a href="#How-WireGuard-Manages-Keys">How WireGuard Manages Keys</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#Usage">Usage</a><ul>
|
||||
<li><a href="#Usage">Usage</a>
|
||||
<ul>
|
||||
<li><a href="#Quickstart">Quickstart</a></li>
|
||||
<li><a href="#Setup">Setup</a></li>
|
||||
<li><a href="#Config-Creation">Config Creation</a></li>
|
||||
@ -95,12 +100,14 @@ See https://github.com/pirate/wireguard-docs for example code and documentation
|
||||
<li><a href="#Testing">Testing</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#Config-Reference">Config Reference</a><ul>
|
||||
<li><a href="#Config-Reference">Config Reference</a>
|
||||
<ul>
|
||||
<li><a href="#Interface">[Interface]</a></li>
|
||||
<li><a href="#Peer">[Peer]</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#Advanced-Topics">Advanced Topics</a><ul>
|
||||
<li><a href="#Advanced-Topics">Advanced Topics</a>
|
||||
<ul>
|
||||
<li><a href="#IPv6">IPv6</a></li>
|
||||
<li><a href="#Forwarding-All-Traffic">Forwarding All Traffic</a></li>
|
||||
<li><a href="#NAT-to-NAT-Connections">NAT-to-NAT Connections</a></li>
|
||||
@ -113,25 +120,8 @@ See https://github.com/pirate/wireguard-docs for example code and documentation
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#Example-Server-To-Server-Config-with-Roaming-Devices">Example Server-To-Server Config with Roaming Devices</a><ul>
|
||||
<li><a href="#Overview">Overview</a><ul>
|
||||
<li><a href="#Network-Topology">Network Topology</a></li>
|
||||
<li><a href="#Explanation">Explanation</a></li>
|
||||
<li><a href="#The-Public-Relay">The Public Relay</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#Full-Example-Code">Full Example Code</a></li>
|
||||
<li><a href="#Node-Config">Node Config</a><ul>
|
||||
<li><a href="#public-server1example-vpntld">public-server1.example-vpn.tld</a></li>
|
||||
<li><a href="#public-server2example-vpndev">public-server2.example-vpn.dev</a></li>
|
||||
<li><a href="#home-serverexample-vpndev">home-server.example-vpn.dev</a></li>
|
||||
<li><a href="#laptopexample-vpndev">laptop.example-vpn.dev</a></li>
|
||||
<li><a href="#phoneexample-vpndev">phone.example-vpn.dev</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#Further-Reading">Further Reading</a><ul>
|
||||
<li><a href="#Further-Reading">Further Reading</a>
|
||||
<ul>
|
||||
<li><a href="#Reference-Docs">Reference Docs</a></li>
|
||||
<li><a href="#Tutorials">Tutorials</a></li>
|
||||
<li><a href="#Papers-Articles-and-Talks">Papers, Articles, and Talks</a></li>
|
||||
@ -1112,305 +1102,6 @@ Setups can get somewhat complex and are highly dependent on what you're trying t
|
||||
|
||||
---
|
||||
|
||||
# Example Server-To-Server Config with Roaming Devices
|
||||
|
||||
WARNING: **Make sure to change the IP addresses and ranges in your configs before running!**
|
||||
The blocks used in these examples are reserved for documentation purposes by the IETF and should never be used in real network setups.
|
||||
|
||||
- **`192.0.2.0/24`** (TEST-NET-1) IPv4 example range [RFC5737](https://tools.ietf.org/html/rfc5737)
|
||||
- **`2001:DB8::/32`** IPv6 example range [RFC3849](https://tools.ietf.org/html/rfc3849)
|
||||
|
||||
You can use any private range you want instead, e.g. `10.0.44.0/24`, just make sure
|
||||
it doesn't conflict with any of the LAN subnet ranges your peers are on.
|
||||
|
||||
The complete example config for the setup below can be found here: https://github.com/pirate/wireguard-docs/tree/master/full-example (WARNING: do not use it on your devices without changing the public/private keys!).
|
||||
|
||||
## Overview
|
||||
|
||||
### Network Topology
|
||||
|
||||
These 5 devices are used in our example setup to explain how WireGuard supports bridging across a variety of network conditions, they're all under an example domain `example-vpn.dev`, with the following short hostnames:
|
||||
|
||||
- `public-server1` (not behind a NAT, acts as the main VPN bounce server)
|
||||
- `public-server2` (not behind a NAT, joins as a peer without bouncing traffic)
|
||||
- `home-server` (behind a NAT, joins as a peer without bouncing traffic)
|
||||
- `laptop` (behind NAT, sometimes shared w/ home-server/phone, sometimes roaming)
|
||||
- `phone` (behind NAT, sometimes shared w/ home-server/laptop, sometimes roaming)
|
||||
|
||||
### Explanation
|
||||
|
||||
This VPN config simulates setting up a small VPN subnet `192.0.2.1/24` shared by 5 nodes. Two of the nodes (public-server1 and public-server2) are VPS instances living in a cloud somewhere, with public IPs accessible to the internet. home-server is a stationary node that lives behind a NAT with a dynamic IP, but it doesn't change frequently. Phone and laptop are both roaming nodes, that can either be at home in the same LAN as home-server, or out-and-about using public wifi or cell service to connect to the VPN.
|
||||
|
||||
Whenever possible, nodes should connect directly to each other, depending on whether nodes are directly accessible or NATs are between them, traffic will route accordingly:
|
||||
|
||||
### The Public Relay
|
||||
|
||||
`public-server1` acts as an intermediate relay server between any VPN clients behind NATs, it will forward any 192.0.2.1/24 traffic it receives to the correct peer at the system level (WireGuard doesn't care how this happens, it's handled by the kernel `net.ipv4.ip_forward = 1` and the iptables routing rules).
|
||||
|
||||
Each client only needs to define the publicly accessible servers/peers in its config, any traffic bound to other peers behind NATs will go to the catchall `192.0.2.1/24` for the server and will be forwarded accordingly once it hits the main server.
|
||||
|
||||
In summary: only direct connections between clients should be configured, any connections that need to be bounced should not be defined as peers, as they should head to the bounce server first and be routed from there back down the vpn to the correct client.
|
||||
|
||||
## Full Example Code
|
||||
|
||||
To run this full example, simply copy the `full wg0.conf config file for node` section from each node onto each server, enable IP forwarding on the public relay, and then start WireGuard on all the machines.
|
||||
|
||||
For more detailed instructions, see the [Quickstart](#Quickstart) guide and API reference above. You can also download the complete example setup here: https://github.com/pirate/wireguard-docs/tree/master/full-example (WARNING: do not use it on your devices without changing the public/private keys!).
|
||||
|
||||
## Node Config
|
||||
|
||||
### public-server1.example-vpn.tld
|
||||
* public endpoint: `public-server1.example-vpn.tld:51820`
|
||||
* own vpn ip address: `192.0.2.1`
|
||||
* can accept traffic for ips: `192.0.2.1/24`
|
||||
* priv key: `<private key for public-server1.example-vpn.tld>`
|
||||
* pub key: `<public key for public-server1.example-vpn.tld>`
|
||||
* setup required:
|
||||
1. install wireguard
|
||||
2. generate public/private keypair
|
||||
3. create wg0.conf (see below)
|
||||
4. enable kernel ip & arp forwarding, add iptables forwarding rules
|
||||
5. start wireguard
|
||||
* config as remote peer:
|
||||
```ini
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = <public key for public-server1.example-vpn.tld>
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 192.0.2.1/24
|
||||
PersistentKeepalive = 25
|
||||
```
|
||||
* config as local interface:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Address = 192.0.2.1/24
|
||||
ListenPort = 51820
|
||||
PrivateKey = <private key for public-server1.example-vpn.tld>
|
||||
DNS = 1.1.1.1
|
||||
```
|
||||
* peers: public-server2, home-server, laptop, phone
|
||||
* full `wg0.conf` config file for node:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Address = 192.0.2.1/24
|
||||
ListenPort = 51820
|
||||
PrivateKey = <private key for public-server1.example-vpn.tld>
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server2.example-vpn.dev
|
||||
Endpoint = public-server2.example-vpn.dev:51820
|
||||
PublicKey = <public key for public-server2.example-vpn.dev>
|
||||
AllowedIPs = 192.0.2.2/32
|
||||
|
||||
[Peer]
|
||||
# Name = home-server.example-vpn.dev
|
||||
Endpoint = home-server.example-vpn.dev:51820
|
||||
PublicKey = <public key for home-server.example-vpn.dev>
|
||||
AllowedIPs = 192.0.2.3/32
|
||||
|
||||
[Peer]
|
||||
# Name = laptop.example-vpn.dev
|
||||
PublicKey = <public key for laptop.example-vpn.dev>
|
||||
AllowedIPs = 192.0.2.4/32
|
||||
|
||||
[Peer]
|
||||
# phone.example-vpn.dev
|
||||
PublicKey = <public key for phone.example-vpn.dev>
|
||||
AllowedIPs = 192.0.2.5/32
|
||||
```
|
||||
|
||||
### public-server2.example-vpn.dev
|
||||
* public endpoint: `public-server2.example-vpn.dev:51820`
|
||||
* own vpn ip address: `192.0.2.2`
|
||||
* can accept traffic for ips: `192.0.2.2/32`
|
||||
* priv key: `<private key for public-server2.example-vpn.dev>`
|
||||
* pub key: `<public key for public-server2.example-vpn.dev>`
|
||||
* setup required:
|
||||
1. install wireguard
|
||||
2. generate public/private keypair
|
||||
3. create wg0.conf (see below)
|
||||
4. confirm main public relay server is directly accessible
|
||||
4. start wireguard
|
||||
* config as local interface:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = public-server2.example-vpn.dev
|
||||
Address = 192.0.2.2/32
|
||||
ListenPort = 51820
|
||||
PrivateKey = <private key for public-server2.example-vpn.dev>
|
||||
DNS = 1.1.1.1
|
||||
```
|
||||
* config as peer:
|
||||
```ini
|
||||
[Peer]
|
||||
# Name = public-server2.example-vpn.dev
|
||||
Endpoint = public-server2.example-vpn.dev:51820
|
||||
PublicKey = <public key for public-server2.example-vpn.dev>
|
||||
AllowedIPs = 192.0.2.2/32
|
||||
```
|
||||
* peers: public-server1
|
||||
* full `wg0.conf` config file for node:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = public-server2.example-vpn.dev
|
||||
Address = 192.0.2.2/32
|
||||
ListenPort = 51820
|
||||
PrivateKey = <private key for public-server2.example-vpn.dev>
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = <public key for public-server1.example-vpn.tld>
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 192.0.2.1/24
|
||||
PersistentKeepalive = 25
|
||||
```
|
||||
|
||||
### home-server.example-vpn.dev
|
||||
* public endpoint: (none, behind NAT)
|
||||
* own vpn ip address: `192.0.2.3`
|
||||
* can accept traffic for ips: `192.0.2.3/32`
|
||||
* priv key: `<private key for home-server.example-vpn.dev>`
|
||||
* pub key: `<public key for home-server.example-vpn.dev>`
|
||||
* setup required:
|
||||
1. install wireguard
|
||||
2. generate public/private keypair
|
||||
3. create wg0.conf (see below)
|
||||
4. confirm main public relay server is directly accessible
|
||||
4. start wireguard
|
||||
* config as local interface:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = home-server.example-vpn.dev
|
||||
Address = 192.0.2.3/32
|
||||
ListenPort = 51820
|
||||
PrivateKey = <private key for home-server.example-vpn.dev>
|
||||
DNS = 1.1.1.1
|
||||
```
|
||||
* config as peer:
|
||||
```ini
|
||||
[Peer]
|
||||
# Name = home-server.example-vpn.dev
|
||||
Endpoint = home-server.example-vpn.dev:51820
|
||||
PublicKey = <public key for home-server.example-vpn.dev>
|
||||
AllowedIPs = 192.0.2.3/32
|
||||
```
|
||||
* peers: public-server1
|
||||
* full `wg0.conf` config file for node:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = home-server.example-vpn.dev
|
||||
Address = 192.0.2.3/32
|
||||
ListenPort = 51820
|
||||
PrivateKey = <private key for home-server.example-vpn.dev>
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = <public key for public-server1.example-vpn.tld>
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 192.0.2.1/24
|
||||
PersistentKeepalive = 25
|
||||
```
|
||||
|
||||
### laptop.example-vpn.dev
|
||||
* public endpoint: (none, behind NAT)
|
||||
* own vpn ip address: `192.0.2.4`
|
||||
* can accept traffic for ips: `192.0.2.4/32`
|
||||
* priv key: `<private key for laptop.example-vpn.dev>`
|
||||
* pub key: `<public key for laptop.example-vpn.dev>`
|
||||
* setup required:
|
||||
1. install wireguard
|
||||
2. generate public/private keypair
|
||||
3. create wg0.conf (see below)
|
||||
4. confirm main public relay server is directly accessible
|
||||
4. start wireguard
|
||||
* config as local interface:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = laptop.example-vpn.dev
|
||||
Address = 192.0.2.4/32
|
||||
PrivateKey = <private key for laptop.example-vpn.dev>
|
||||
DNS = 1.1.1.1
|
||||
```
|
||||
* config as peer:
|
||||
```ini
|
||||
[Peer]
|
||||
# Name = laptop.example-vpn.dev
|
||||
PublicKey = <public key for laptop.example-vpn.dev>
|
||||
AllowedIPs = 192.0.2.4/32
|
||||
```
|
||||
* peers: public-server1
|
||||
* full `wg0.conf` config file for node:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = laptop.example-vpn.dev
|
||||
Address = 192.0.2.4/32
|
||||
PrivateKey = <private key for laptop.example-vpn.dev>
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = <public key for public-server1.example-vpn.tld>
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 192.0.2.1/24
|
||||
PersistentKeepalive = 25
|
||||
```
|
||||
|
||||
### phone.example-vpn.dev
|
||||
* public endpoint: (none, behind NAT)
|
||||
* own vpn ip address: `192.0.2.5`
|
||||
* can accept traffic for ips: `192.0.2.5/32`
|
||||
* priv key: `<private key for phone.example-vpn.dev>`
|
||||
* pub key: `<public key for phone.example-vpn.dev>`
|
||||
* setup required:
|
||||
1. install wireguard
|
||||
2. generate public/private keypair
|
||||
3. create wg0.conf (see below)
|
||||
4. confirm main public relay server is directly accessible
|
||||
4. start wireguard
|
||||
* config as local interface:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = phone.example-vpn.dev
|
||||
Address = 192.0.2.5/32
|
||||
PrivateKey = <private key for phone.example-vpn.dev>
|
||||
DNS = 1.1.1.1
|
||||
```
|
||||
* config as peer:
|
||||
```ini
|
||||
[Peer]
|
||||
# phone.example-vpn.dev
|
||||
PublicKey = <public key for phone.example-vpn.dev>
|
||||
AllowedIPs = 192.0.2.5/32
|
||||
```
|
||||
* peers: public-server1
|
||||
* full `wg0.conf` config file for node:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = phone.example-vpn.dev
|
||||
Address = 192.0.2.5/32
|
||||
PrivateKey = <private key for phone.example-vpn.dev>
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = <public key for public-server1.example-vpn.tld>
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 192.0.2.1/24
|
||||
PersistentKeepalive = 25
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# Further Reading
|
||||
|
||||
### Reference Docs
|
||||
|
||||
303
example-full/README.md
Normal file
303
example-full/README.md
Normal file
@ -0,0 +1,303 @@
|
||||
# Example Server-To-Server Config with Roaming Devices
|
||||
|
||||
WARNING: **Make sure to change the IP addresses and ranges in your configs before running!**
|
||||
The blocks used in these examples are reserved for documentation purposes by the IETF and should never be used in real network setups.
|
||||
|
||||
- **`192.0.2.0/24`** (TEST-NET-1) IPv4 example range [RFC5737](https://tools.ietf.org/html/rfc5737)
|
||||
- **`2001:DB8::/32`** IPv6 example range [RFC3849](https://tools.ietf.org/html/rfc3849)
|
||||
|
||||
You can use any private range you want instead, e.g. `10.0.44.0/24`, just make sure
|
||||
it doesn't conflict with any of the LAN subnet ranges your peers are on.
|
||||
|
||||
The complete example config for the setup below can be found here: https://github.com/pirate/wireguard-docs/tree/master/full-example (WARNING: do not use it on your devices without changing the public/private keys!).
|
||||
|
||||
## Overview
|
||||
|
||||
### Network Topology
|
||||
|
||||
These 5 devices are used in our example setup to explain how WireGuard supports bridging across a variety of network conditions, they're all under an example domain `example-vpn.dev`, with the following short hostnames:
|
||||
|
||||
- `public-server1` (not behind a NAT, acts as the main VPN bounce server)
|
||||
- `public-server2` (not behind a NAT, joins as a peer without bouncing traffic)
|
||||
- `home-server` (behind a NAT, joins as a peer without bouncing traffic)
|
||||
- `laptop` (behind NAT, sometimes shared w/ home-server/phone, sometimes roaming)
|
||||
- `phone` (behind NAT, sometimes shared w/ home-server/laptop, sometimes roaming)
|
||||
|
||||
### Explanation
|
||||
|
||||
This VPN config simulates setting up a small VPN subnet `192.0.2.1/24` shared by 5 nodes. Two of the nodes (public-server1 and public-server2) are VPS instances living in a cloud somewhere, with public IPs accessible to the internet. home-server is a stationary node that lives behind a NAT with a dynamic IP, but it doesn't change frequently. Phone and laptop are both roaming nodes, that can either be at home in the same LAN as home-server, or out-and-about using public wifi or cell service to connect to the VPN.
|
||||
|
||||
Whenever possible, nodes should connect directly to each other, depending on whether nodes are directly accessible or NATs are between them, traffic will route accordingly:
|
||||
|
||||
### The Public Relay
|
||||
|
||||
`public-server1` acts as an intermediate relay server between any VPN clients behind NATs, it will forward any 192.0.2.1/24 traffic it receives to the correct peer at the system level (WireGuard doesn't care how this happens, it's handled by the kernel `net.ipv4.ip_forward = 1` and the iptables routing rules).
|
||||
|
||||
Each client only needs to define the publicly accessible servers/peers in its config, any traffic bound to other peers behind NATs will go to the catchall `192.0.2.1/24` for the server and will be forwarded accordingly once it hits the main server.
|
||||
|
||||
In summary: only direct connections between clients should be configured, any connections that need to be bounced should not be defined as peers, as they should head to the bounce server first and be routed from there back down the vpn to the correct client.
|
||||
|
||||
## Full Example Code
|
||||
|
||||
To run this full example, simply copy the `full wg0.conf config file for node` section from each node onto each server, enable IP forwarding on the public relay, and then start WireGuard on all the machines.
|
||||
|
||||
For more detailed instructions, see the [Quickstart](#Quickstart) guide and API reference above. You can also download the complete example setup here: https://github.com/pirate/wireguard-docs/tree/master/full-example (WARNING: do not use it on your devices without changing the public/private keys!).
|
||||
|
||||
## Node Config
|
||||
|
||||
### public-server1.example-vpn.tld
|
||||
* public endpoint: `public-server1.example-vpn.tld:51820`
|
||||
* own vpn ip address: `192.0.2.1`
|
||||
* can accept traffic for ips: `192.0.2.1/24`
|
||||
* priv key: `<private key for public-server1.example-vpn.tld>`
|
||||
* pub key: `<public key for public-server1.example-vpn.tld>`
|
||||
* setup required:
|
||||
1. install wireguard
|
||||
2. generate public/private keypair
|
||||
3. create wg0.conf (see below)
|
||||
4. enable kernel ip & arp forwarding, add iptables forwarding rules
|
||||
5. start wireguard
|
||||
* config as remote peer:
|
||||
```ini
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = <public key for public-server1.example-vpn.tld>
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 192.0.2.1/24
|
||||
PersistentKeepalive = 25
|
||||
```
|
||||
* config as local interface:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Address = 192.0.2.1/24
|
||||
ListenPort = 51820
|
||||
PrivateKey = <private key for public-server1.example-vpn.tld>
|
||||
DNS = 1.1.1.1
|
||||
```
|
||||
* peers: public-server2, home-server, laptop, phone
|
||||
* full `wg0.conf` config file for node:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Address = 192.0.2.1/24
|
||||
ListenPort = 51820
|
||||
PrivateKey = <private key for public-server1.example-vpn.tld>
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server2.example-vpn.dev
|
||||
Endpoint = public-server2.example-vpn.dev:51820
|
||||
PublicKey = <public key for public-server2.example-vpn.dev>
|
||||
AllowedIPs = 192.0.2.2/32
|
||||
|
||||
[Peer]
|
||||
# Name = home-server.example-vpn.dev
|
||||
Endpoint = home-server.example-vpn.dev:51820
|
||||
PublicKey = <public key for home-server.example-vpn.dev>
|
||||
AllowedIPs = 192.0.2.3/32
|
||||
|
||||
[Peer]
|
||||
# Name = laptop.example-vpn.dev
|
||||
PublicKey = <public key for laptop.example-vpn.dev>
|
||||
AllowedIPs = 192.0.2.4/32
|
||||
|
||||
[Peer]
|
||||
# phone.example-vpn.dev
|
||||
PublicKey = <public key for phone.example-vpn.dev>
|
||||
AllowedIPs = 192.0.2.5/32
|
||||
```
|
||||
|
||||
### public-server2.example-vpn.dev
|
||||
* public endpoint: `public-server2.example-vpn.dev:51820`
|
||||
* own vpn ip address: `192.0.2.2`
|
||||
* can accept traffic for ips: `192.0.2.2/32`
|
||||
* priv key: `<private key for public-server2.example-vpn.dev>`
|
||||
* pub key: `<public key for public-server2.example-vpn.dev>`
|
||||
* setup required:
|
||||
1. install wireguard
|
||||
2. generate public/private keypair
|
||||
3. create wg0.conf (see below)
|
||||
4. confirm main public relay server is directly accessible
|
||||
4. start wireguard
|
||||
* config as local interface:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = public-server2.example-vpn.dev
|
||||
Address = 192.0.2.2/32
|
||||
ListenPort = 51820
|
||||
PrivateKey = <private key for public-server2.example-vpn.dev>
|
||||
DNS = 1.1.1.1
|
||||
```
|
||||
* config as peer:
|
||||
```ini
|
||||
[Peer]
|
||||
# Name = public-server2.example-vpn.dev
|
||||
Endpoint = public-server2.example-vpn.dev:51820
|
||||
PublicKey = <public key for public-server2.example-vpn.dev>
|
||||
AllowedIPs = 192.0.2.2/32
|
||||
```
|
||||
* peers: public-server1
|
||||
* full `wg0.conf` config file for node:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = public-server2.example-vpn.dev
|
||||
Address = 192.0.2.2/32
|
||||
ListenPort = 51820
|
||||
PrivateKey = <private key for public-server2.example-vpn.dev>
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = <public key for public-server1.example-vpn.tld>
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 192.0.2.1/24
|
||||
PersistentKeepalive = 25
|
||||
```
|
||||
|
||||
### home-server.example-vpn.dev
|
||||
* public endpoint: (none, behind NAT)
|
||||
* own vpn ip address: `192.0.2.3`
|
||||
* can accept traffic for ips: `192.0.2.3/32`
|
||||
* priv key: `<private key for home-server.example-vpn.dev>`
|
||||
* pub key: `<public key for home-server.example-vpn.dev>`
|
||||
* setup required:
|
||||
1. install wireguard
|
||||
2. generate public/private keypair
|
||||
3. create wg0.conf (see below)
|
||||
4. confirm main public relay server is directly accessible
|
||||
4. start wireguard
|
||||
* config as local interface:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = home-server.example-vpn.dev
|
||||
Address = 192.0.2.3/32
|
||||
ListenPort = 51820
|
||||
PrivateKey = <private key for home-server.example-vpn.dev>
|
||||
DNS = 1.1.1.1
|
||||
```
|
||||
* config as peer:
|
||||
```ini
|
||||
[Peer]
|
||||
# Name = home-server.example-vpn.dev
|
||||
Endpoint = home-server.example-vpn.dev:51820
|
||||
PublicKey = <public key for home-server.example-vpn.dev>
|
||||
AllowedIPs = 192.0.2.3/32
|
||||
```
|
||||
* peers: public-server1
|
||||
* full `wg0.conf` config file for node:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = home-server.example-vpn.dev
|
||||
Address = 192.0.2.3/32
|
||||
ListenPort = 51820
|
||||
PrivateKey = <private key for home-server.example-vpn.dev>
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = <public key for public-server1.example-vpn.tld>
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 192.0.2.1/24
|
||||
PersistentKeepalive = 25
|
||||
```
|
||||
|
||||
### laptop.example-vpn.dev
|
||||
* public endpoint: (none, behind NAT)
|
||||
* own vpn ip address: `192.0.2.4`
|
||||
* can accept traffic for ips: `192.0.2.4/32`
|
||||
* priv key: `<private key for laptop.example-vpn.dev>`
|
||||
* pub key: `<public key for laptop.example-vpn.dev>`
|
||||
* setup required:
|
||||
1. install wireguard
|
||||
2. generate public/private keypair
|
||||
3. create wg0.conf (see below)
|
||||
4. confirm main public relay server is directly accessible
|
||||
4. start wireguard
|
||||
* config as local interface:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = laptop.example-vpn.dev
|
||||
Address = 192.0.2.4/32
|
||||
PrivateKey = <private key for laptop.example-vpn.dev>
|
||||
DNS = 1.1.1.1
|
||||
```
|
||||
* config as peer:
|
||||
```ini
|
||||
[Peer]
|
||||
# Name = laptop.example-vpn.dev
|
||||
PublicKey = <public key for laptop.example-vpn.dev>
|
||||
AllowedIPs = 192.0.2.4/32
|
||||
```
|
||||
* peers: public-server1
|
||||
* full `wg0.conf` config file for node:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = laptop.example-vpn.dev
|
||||
Address = 192.0.2.4/32
|
||||
PrivateKey = <private key for laptop.example-vpn.dev>
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = <public key for public-server1.example-vpn.tld>
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 192.0.2.1/24
|
||||
PersistentKeepalive = 25
|
||||
```
|
||||
|
||||
### phone.example-vpn.dev
|
||||
* public endpoint: (none, behind NAT)
|
||||
* own vpn ip address: `192.0.2.5`
|
||||
* can accept traffic for ips: `192.0.2.5/32`
|
||||
* priv key: `<private key for phone.example-vpn.dev>`
|
||||
* pub key: `<public key for phone.example-vpn.dev>`
|
||||
* setup required:
|
||||
1. install wireguard
|
||||
2. generate public/private keypair
|
||||
3. create wg0.conf (see below)
|
||||
4. confirm main public relay server is directly accessible
|
||||
4. start wireguard
|
||||
* config as local interface:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = phone.example-vpn.dev
|
||||
Address = 192.0.2.5/32
|
||||
PrivateKey = <private key for phone.example-vpn.dev>
|
||||
DNS = 1.1.1.1
|
||||
```
|
||||
* config as peer:
|
||||
```ini
|
||||
[Peer]
|
||||
# phone.example-vpn.dev
|
||||
PublicKey = <public key for phone.example-vpn.dev>
|
||||
AllowedIPs = 192.0.2.5/32
|
||||
```
|
||||
* peers: public-server1
|
||||
* full `wg0.conf` config file for node:
|
||||
```ini
|
||||
[Interface]
|
||||
# Name = phone.example-vpn.dev
|
||||
Address = 192.0.2.5/32
|
||||
PrivateKey = <private key for phone.example-vpn.dev>
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = <public key for public-server1.example-vpn.tld>
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 192.0.2.1/24
|
||||
PersistentKeepalive = 25
|
||||
```
|
||||
|
||||
|
||||
<center>
|
||||
|
||||
Suggest changes: https://github.com/pirate/wireguard-docs/issues
|
||||
|
||||
</center>
|
||||
1
example-internet-browsing-vpn/laptop/laptop.key
Normal file
1
example-internet-browsing-vpn/laptop/laptop.key
Normal file
@ -0,0 +1 @@
|
||||
OPmibSXYAAcMIYKNsWqr77zY06Kl750AEB1nWQi1T2o=
|
||||
1
example-internet-browsing-vpn/laptop/laptop.key.pub
Normal file
1
example-internet-browsing-vpn/laptop/laptop.key.pub
Normal file
@ -0,0 +1 @@
|
||||
BV5DjXeCugIrjvEZLo4sZ0hN5wveFTH8kOfZ1AIQ5js=
|
||||
9
example-internet-browsing-vpn/laptop/setup.sh
Normal file
9
example-internet-browsing-vpn/laptop/setup.sh
Normal file
@ -0,0 +1,9 @@
|
||||
#!/bin/bash
|
||||
|
||||
# install wireguard on Ubuntu
|
||||
#add-apt-repository ppa:wireguard/wireguard
|
||||
#apt update
|
||||
#apt install wireguard
|
||||
|
||||
# install wireguard on macOS
|
||||
brew install wireguard-tools
|
||||
5
example-internet-browsing-vpn/laptop/start.sh
Normal file
5
example-internet-browsing-vpn/laptop/start.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick up "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
5
example-internet-browsing-vpn/laptop/stop.sh
Normal file
5
example-internet-browsing-vpn/laptop/stop.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick down "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
13
example-internet-browsing-vpn/laptop/wg0.conf
Normal file
13
example-internet-browsing-vpn/laptop/wg0.conf
Normal file
@ -0,0 +1,13 @@
|
||||
[Interface]
|
||||
# Name = laptop.example-vpn.dev
|
||||
Address = 10.0.0.4/32
|
||||
PrivateKey = OPmibSXYAAcMIYKNsWqr77zY06Kl750AEB1nWQi1T2o=
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = q/+jwmL5tNuYSB3z+t9Caj00Pc1YQ8zf+uNPu/UE1wE=
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 10.0.0.1/24
|
||||
PersistentKeepalive = 25
|
||||
1
example-internet-browsing-vpn/phone/phone.key
Normal file
1
example-internet-browsing-vpn/phone/phone.key
Normal file
@ -0,0 +1 @@
|
||||
WH98AvjKKZ584ZLb69G912bNry2wOda9+kfzm+qbnUw=
|
||||
1
example-internet-browsing-vpn/phone/phone.key.pub
Normal file
1
example-internet-browsing-vpn/phone/phone.key.pub
Normal file
@ -0,0 +1 @@
|
||||
VpjKa2MQKXuvttXRwJIe0LLYrtFYGQRTtmt8okUGm3A=
|
||||
4
example-internet-browsing-vpn/phone/setup.sh
Normal file
4
example-internet-browsing-vpn/phone/setup.sh
Normal file
@ -0,0 +1,4 @@
|
||||
#!/bin/bash
|
||||
|
||||
# install wireguard on iOS/Android
|
||||
echo "Use the iOS App Store / Google Play Store to install WireGuard on your mobile device"
|
||||
3
example-internet-browsing-vpn/phone/start.sh
Normal file
3
example-internet-browsing-vpn/phone/start.sh
Normal file
@ -0,0 +1,3 @@
|
||||
#!/bin/bash
|
||||
|
||||
echo "Use the iOS/Android app to load the wg0.conf file and start Wireguard"
|
||||
3
example-internet-browsing-vpn/phone/stop.sh
Normal file
3
example-internet-browsing-vpn/phone/stop.sh
Normal file
@ -0,0 +1,3 @@
|
||||
#!/bin/bash
|
||||
|
||||
echo "Use the iOS/Android app to load the wg0.conf file and stop Wireguard"
|
||||
13
example-internet-browsing-vpn/phone/wg0.conf
Normal file
13
example-internet-browsing-vpn/phone/wg0.conf
Normal file
@ -0,0 +1,13 @@
|
||||
[Interface]
|
||||
# Name = phone.example-vpn.dev
|
||||
Address = 10.0.0.5/32
|
||||
PrivateKey = WH98AvjKKZ584ZLb69G912bNry2wOda9+kfzm+qbnUw=
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = q/+jwmL5tNuYSB3z+t9Caj00Pc1YQ8zf+uNPu/UE1wE=
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 10.0.0.1/24
|
||||
PersistentKeepalive = 25
|
||||
1
example-internet-browsing-vpn/server/public-server1.key
Normal file
1
example-internet-browsing-vpn/server/public-server1.key
Normal file
@ -0,0 +1 @@
|
||||
2P/3ll/TxGTjGqwcWnqJMnjwPqGw7oX1RaXlPfsf2FQ=
|
||||
@ -0,0 +1 @@
|
||||
q/+jwmL5tNuYSB3z+t9Caj00Pc1YQ8zf+uNPu/UE1wE=
|
||||
17
example-internet-browsing-vpn/server/setup.sh
Normal file
17
example-internet-browsing-vpn/server/setup.sh
Normal file
@ -0,0 +1,17 @@
|
||||
#!/bin/bash
|
||||
|
||||
# install wireguard
|
||||
add-apt-repository ppa:wireguard/wireguard
|
||||
apt update
|
||||
apt install wireguard
|
||||
|
||||
# to enable kernel relaying/forwarding ability on bounce servers
|
||||
echo "net.ipv4.ip_forward = 1" >> /etc/sysctl.conf
|
||||
echo "net.ipv4.conf.all.proxy_arp" >> /etc/sysctl.conf
|
||||
sudo sysctl -p /etc/sysctl.conf
|
||||
|
||||
# to add iptables forwarding rules on bounce servers
|
||||
iptables -A INPUT -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
|
||||
iptables -A FORWARD -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
|
||||
iptables -A FORWARD -i wg0 -o wg0 -m conntrack --ctstate NEW -j ACCEPT
|
||||
iptables -t nat -A POSTROUTING -s 10.0.0.0/24 -o eth0 -j MASQUERADE
|
||||
5
example-internet-browsing-vpn/server/start.sh
Normal file
5
example-internet-browsing-vpn/server/start.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick up "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
5
example-internet-browsing-vpn/server/stop.sh
Normal file
5
example-internet-browsing-vpn/server/stop.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick down "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
28
example-internet-browsing-vpn/server/wg0.conf
Normal file
28
example-internet-browsing-vpn/server/wg0.conf
Normal file
@ -0,0 +1,28 @@
|
||||
[Interface]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Address = 10.0.0.1/24
|
||||
ListenPort = 51820
|
||||
PrivateKey = 2P/3ll/TxGTjGqwcWnqJMnjwPqGw7oX1RaXlPfsf2FQ=
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server2.example-vpn.dev
|
||||
Endpoint = public-server2.example-vpn.dev:51820
|
||||
PublicKey = SceMEaVZaZfOGtGXjMsoJjhwxKHkb++9wjxqN1vm32s=
|
||||
AllowedIPs = 10.0.0.2/32
|
||||
|
||||
[Peer]
|
||||
# Name = home-server.example-vpn.dev
|
||||
Endpoint = home-server.example-vpn.dev:51820
|
||||
PublicKey = 8bSk5fATxg9qdxbK20iTGdrQ7SWvxIBhxdMo+W54pEg=
|
||||
AllowedIPs = 10.0.0.3/32
|
||||
|
||||
[Peer]
|
||||
# Name = laptop.example-vpn.dev
|
||||
PublicKey = BV5DjXeCugIrjvEZLo4sZ0hN5wveFTH8kOfZ1AIQ5js=
|
||||
AllowedIPs = 10.0.0.4/32
|
||||
|
||||
[Peer]
|
||||
# Name = phone.example-vpn.dev
|
||||
PublicKey = VpjKa2MQKXuvttXRwJIe0LLYrtFYGQRTtmt8okUGm3A=
|
||||
AllowedIPs = 10.0.0.5/32
|
||||
1
example-lan-briding/montreal/public-server1.key
Normal file
1
example-lan-briding/montreal/public-server1.key
Normal file
@ -0,0 +1 @@
|
||||
2P/3ll/TxGTjGqwcWnqJMnjwPqGw7oX1RaXlPfsf2FQ=
|
||||
1
example-lan-briding/montreal/public-server1.key.pub
Normal file
1
example-lan-briding/montreal/public-server1.key.pub
Normal file
@ -0,0 +1 @@
|
||||
q/+jwmL5tNuYSB3z+t9Caj00Pc1YQ8zf+uNPu/UE1wE=
|
||||
17
example-lan-briding/montreal/setup.sh
Normal file
17
example-lan-briding/montreal/setup.sh
Normal file
@ -0,0 +1,17 @@
|
||||
#!/bin/bash
|
||||
|
||||
# install wireguard
|
||||
add-apt-repository ppa:wireguard/wireguard
|
||||
apt update
|
||||
apt install wireguard
|
||||
|
||||
# to enable kernel relaying/forwarding ability on bounce servers
|
||||
echo "net.ipv4.ip_forward = 1" >> /etc/sysctl.conf
|
||||
echo "net.ipv4.conf.all.proxy_arp" >> /etc/sysctl.conf
|
||||
sudo sysctl -p /etc/sysctl.conf
|
||||
|
||||
# to add iptables forwarding rules on bounce servers
|
||||
iptables -A INPUT -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
|
||||
iptables -A FORWARD -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
|
||||
iptables -A FORWARD -i wg0 -o wg0 -m conntrack --ctstate NEW -j ACCEPT
|
||||
iptables -t nat -A POSTROUTING -s 10.0.0.0/24 -o eth0 -j MASQUERADE
|
||||
5
example-lan-briding/montreal/start.sh
Normal file
5
example-lan-briding/montreal/start.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick up "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
5
example-lan-briding/montreal/stop.sh
Normal file
5
example-lan-briding/montreal/stop.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick down "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
28
example-lan-briding/montreal/wg0.conf
Normal file
28
example-lan-briding/montreal/wg0.conf
Normal file
@ -0,0 +1,28 @@
|
||||
[Interface]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Address = 10.0.0.1/24
|
||||
ListenPort = 51820
|
||||
PrivateKey = 2P/3ll/TxGTjGqwcWnqJMnjwPqGw7oX1RaXlPfsf2FQ=
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server2.example-vpn.dev
|
||||
Endpoint = public-server2.example-vpn.dev:51820
|
||||
PublicKey = SceMEaVZaZfOGtGXjMsoJjhwxKHkb++9wjxqN1vm32s=
|
||||
AllowedIPs = 10.0.0.2/32
|
||||
|
||||
[Peer]
|
||||
# Name = home-server.example-vpn.dev
|
||||
Endpoint = home-server.example-vpn.dev:51820
|
||||
PublicKey = 8bSk5fATxg9qdxbK20iTGdrQ7SWvxIBhxdMo+W54pEg=
|
||||
AllowedIPs = 10.0.0.3/32
|
||||
|
||||
[Peer]
|
||||
# Name = laptop.example-vpn.dev
|
||||
PublicKey = BV5DjXeCugIrjvEZLo4sZ0hN5wveFTH8kOfZ1AIQ5js=
|
||||
AllowedIPs = 10.0.0.4/32
|
||||
|
||||
[Peer]
|
||||
# Name = phone.example-vpn.dev
|
||||
PublicKey = VpjKa2MQKXuvttXRwJIe0LLYrtFYGQRTtmt8okUGm3A=
|
||||
AllowedIPs = 10.0.0.5/32
|
||||
1
example-lan-briding/newyork/public-server2.key
Normal file
1
example-lan-briding/newyork/public-server2.key
Normal file
@ -0,0 +1 @@
|
||||
eDwURfg8PhpUAdPp+OA9pQ5oZQYqGqY3LToUORMh220=
|
||||
1
example-lan-briding/newyork/public-server2.key.pub
Normal file
1
example-lan-briding/newyork/public-server2.key.pub
Normal file
@ -0,0 +1 @@
|
||||
SceMEaVZaZfOGtGXjMsoJjhwxKHkb++9wjxqN1vm32s=
|
||||
6
example-lan-briding/newyork/setup.sh
Normal file
6
example-lan-briding/newyork/setup.sh
Normal file
@ -0,0 +1,6 @@
|
||||
#!/bin/bash
|
||||
|
||||
# install wireguard
|
||||
add-apt-repository ppa:wireguard/wireguard
|
||||
apt update
|
||||
apt install wireguard
|
||||
5
example-lan-briding/newyork/start.sh
Normal file
5
example-lan-briding/newyork/start.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick up "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
5
example-lan-briding/newyork/stop.sh
Normal file
5
example-lan-briding/newyork/stop.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick down "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
14
example-lan-briding/newyork/wg0.conf
Normal file
14
example-lan-briding/newyork/wg0.conf
Normal file
@ -0,0 +1,14 @@
|
||||
[Interface]
|
||||
# Name = public-server2.example-vpn.dev
|
||||
Address = 10.0.0.2/32
|
||||
ListenPort = 51820
|
||||
PrivateKey = eDwURfg8PhpUAdPp+OA9pQ5oZQYqGqY3LToUORMh220=
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = q/+jwmL5tNuYSB3z+t9Caj00Pc1YQ8zf+uNPu/UE1wE=
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 10.0.0.1/24
|
||||
PersistentKeepalive = 25
|
||||
1
example-lan-briding/vancouver/public-server1.key
Normal file
1
example-lan-briding/vancouver/public-server1.key
Normal file
@ -0,0 +1 @@
|
||||
2P/3ll/TxGTjGqwcWnqJMnjwPqGw7oX1RaXlPfsf2FQ=
|
||||
1
example-lan-briding/vancouver/public-server1.key.pub
Normal file
1
example-lan-briding/vancouver/public-server1.key.pub
Normal file
@ -0,0 +1 @@
|
||||
q/+jwmL5tNuYSB3z+t9Caj00Pc1YQ8zf+uNPu/UE1wE=
|
||||
17
example-lan-briding/vancouver/setup.sh
Normal file
17
example-lan-briding/vancouver/setup.sh
Normal file
@ -0,0 +1,17 @@
|
||||
#!/bin/bash
|
||||
|
||||
# install wireguard
|
||||
add-apt-repository ppa:wireguard/wireguard
|
||||
apt update
|
||||
apt install wireguard
|
||||
|
||||
# to enable kernel relaying/forwarding ability on bounce servers
|
||||
echo "net.ipv4.ip_forward = 1" >> /etc/sysctl.conf
|
||||
echo "net.ipv4.conf.all.proxy_arp" >> /etc/sysctl.conf
|
||||
sudo sysctl -p /etc/sysctl.conf
|
||||
|
||||
# to add iptables forwarding rules on bounce servers
|
||||
iptables -A INPUT -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
|
||||
iptables -A FORWARD -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
|
||||
iptables -A FORWARD -i wg0 -o wg0 -m conntrack --ctstate NEW -j ACCEPT
|
||||
iptables -t nat -A POSTROUTING -s 10.0.0.0/24 -o eth0 -j MASQUERADE
|
||||
5
example-lan-briding/vancouver/start.sh
Normal file
5
example-lan-briding/vancouver/start.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick up "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
5
example-lan-briding/vancouver/stop.sh
Normal file
5
example-lan-briding/vancouver/stop.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick down "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
28
example-lan-briding/vancouver/wg0.conf
Normal file
28
example-lan-briding/vancouver/wg0.conf
Normal file
@ -0,0 +1,28 @@
|
||||
[Interface]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Address = 10.0.0.1/24
|
||||
ListenPort = 51820
|
||||
PrivateKey = 2P/3ll/TxGTjGqwcWnqJMnjwPqGw7oX1RaXlPfsf2FQ=
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server2.example-vpn.dev
|
||||
Endpoint = public-server2.example-vpn.dev:51820
|
||||
PublicKey = SceMEaVZaZfOGtGXjMsoJjhwxKHkb++9wjxqN1vm32s=
|
||||
AllowedIPs = 10.0.0.2/32
|
||||
|
||||
[Peer]
|
||||
# Name = home-server.example-vpn.dev
|
||||
Endpoint = home-server.example-vpn.dev:51820
|
||||
PublicKey = 8bSk5fATxg9qdxbK20iTGdrQ7SWvxIBhxdMo+W54pEg=
|
||||
AllowedIPs = 10.0.0.3/32
|
||||
|
||||
[Peer]
|
||||
# Name = laptop.example-vpn.dev
|
||||
PublicKey = BV5DjXeCugIrjvEZLo4sZ0hN5wveFTH8kOfZ1AIQ5js=
|
||||
AllowedIPs = 10.0.0.4/32
|
||||
|
||||
[Peer]
|
||||
# Name = phone.example-vpn.dev
|
||||
PublicKey = VpjKa2MQKXuvttXRwJIe0LLYrtFYGQRTtmt8okUGm3A=
|
||||
AllowedIPs = 10.0.0.5/32
|
||||
1
example-simple-client-to-server/client/laptop.key
Normal file
1
example-simple-client-to-server/client/laptop.key
Normal file
@ -0,0 +1 @@
|
||||
OPmibSXYAAcMIYKNsWqr77zY06Kl750AEB1nWQi1T2o=
|
||||
1
example-simple-client-to-server/client/laptop.key.pub
Normal file
1
example-simple-client-to-server/client/laptop.key.pub
Normal file
@ -0,0 +1 @@
|
||||
BV5DjXeCugIrjvEZLo4sZ0hN5wveFTH8kOfZ1AIQ5js=
|
||||
9
example-simple-client-to-server/client/setup.sh
Normal file
9
example-simple-client-to-server/client/setup.sh
Normal file
@ -0,0 +1,9 @@
|
||||
#!/bin/bash
|
||||
|
||||
# install wireguard on Ubuntu
|
||||
#add-apt-repository ppa:wireguard/wireguard
|
||||
#apt update
|
||||
#apt install wireguard
|
||||
|
||||
# install wireguard on macOS
|
||||
brew install wireguard-tools
|
||||
5
example-simple-client-to-server/client/start.sh
Normal file
5
example-simple-client-to-server/client/start.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick up "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
5
example-simple-client-to-server/client/stop.sh
Normal file
5
example-simple-client-to-server/client/stop.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick down "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
13
example-simple-client-to-server/client/wg0.conf
Normal file
13
example-simple-client-to-server/client/wg0.conf
Normal file
@ -0,0 +1,13 @@
|
||||
[Interface]
|
||||
# Name = laptop.example-vpn.dev
|
||||
Address = 10.0.0.4/32
|
||||
PrivateKey = OPmibSXYAAcMIYKNsWqr77zY06Kl750AEB1nWQi1T2o=
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = q/+jwmL5tNuYSB3z+t9Caj00Pc1YQ8zf+uNPu/UE1wE=
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 10.0.0.1/24
|
||||
PersistentKeepalive = 25
|
||||
@ -0,0 +1 @@
|
||||
2P/3ll/TxGTjGqwcWnqJMnjwPqGw7oX1RaXlPfsf2FQ=
|
||||
@ -0,0 +1 @@
|
||||
q/+jwmL5tNuYSB3z+t9Caj00Pc1YQ8zf+uNPu/UE1wE=
|
||||
17
example-simple-client-to-server/server/setup.sh
Normal file
17
example-simple-client-to-server/server/setup.sh
Normal file
@ -0,0 +1,17 @@
|
||||
#!/bin/bash
|
||||
|
||||
# install wireguard
|
||||
add-apt-repository ppa:wireguard/wireguard
|
||||
apt update
|
||||
apt install wireguard
|
||||
|
||||
# to enable kernel relaying/forwarding ability on bounce servers
|
||||
echo "net.ipv4.ip_forward = 1" >> /etc/sysctl.conf
|
||||
echo "net.ipv4.conf.all.proxy_arp" >> /etc/sysctl.conf
|
||||
sudo sysctl -p /etc/sysctl.conf
|
||||
|
||||
# to add iptables forwarding rules on bounce servers
|
||||
iptables -A INPUT -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
|
||||
iptables -A FORWARD -m conntrack --ctstate RELATED,ESTABLISHED -j ACCEPT
|
||||
iptables -A FORWARD -i wg0 -o wg0 -m conntrack --ctstate NEW -j ACCEPT
|
||||
iptables -t nat -A POSTROUTING -s 10.0.0.0/24 -o eth0 -j MASQUERADE
|
||||
5
example-simple-client-to-server/server/start.sh
Normal file
5
example-simple-client-to-server/server/start.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick up "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
5
example-simple-client-to-server/server/stop.sh
Normal file
5
example-simple-client-to-server/server/stop.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick down "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
28
example-simple-client-to-server/server/wg0.conf
Normal file
28
example-simple-client-to-server/server/wg0.conf
Normal file
@ -0,0 +1,28 @@
|
||||
[Interface]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Address = 10.0.0.1/24
|
||||
ListenPort = 51820
|
||||
PrivateKey = 2P/3ll/TxGTjGqwcWnqJMnjwPqGw7oX1RaXlPfsf2FQ=
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server2.example-vpn.dev
|
||||
Endpoint = public-server2.example-vpn.dev:51820
|
||||
PublicKey = SceMEaVZaZfOGtGXjMsoJjhwxKHkb++9wjxqN1vm32s=
|
||||
AllowedIPs = 10.0.0.2/32
|
||||
|
||||
[Peer]
|
||||
# Name = home-server.example-vpn.dev
|
||||
Endpoint = home-server.example-vpn.dev:51820
|
||||
PublicKey = 8bSk5fATxg9qdxbK20iTGdrQ7SWvxIBhxdMo+W54pEg=
|
||||
AllowedIPs = 10.0.0.3/32
|
||||
|
||||
[Peer]
|
||||
# Name = laptop.example-vpn.dev
|
||||
PublicKey = BV5DjXeCugIrjvEZLo4sZ0hN5wveFTH8kOfZ1AIQ5js=
|
||||
AllowedIPs = 10.0.0.4/32
|
||||
|
||||
[Peer]
|
||||
# Name = phone.example-vpn.dev
|
||||
PublicKey = VpjKa2MQKXuvttXRwJIe0LLYrtFYGQRTtmt8okUGm3A=
|
||||
AllowedIPs = 10.0.0.5/32
|
||||
@ -0,0 +1 @@
|
||||
WN+bvd3PCWs5Pk3bvl7abWR0c1L6PCWKYRX56mjVYGo=
|
||||
@ -0,0 +1 @@
|
||||
8bSk5fATxg9qdxbK20iTGdrQ7SWvxIBhxdMo+W54pEg=
|
||||
9
example-simple-server-to-server/home-server/setup.sh
Normal file
9
example-simple-server-to-server/home-server/setup.sh
Normal file
@ -0,0 +1,9 @@
|
||||
#!/bin/bash
|
||||
|
||||
# install wireguard on FreeBSD
|
||||
pkg install wireguard
|
||||
|
||||
# install wireguard on Ubuntu
|
||||
#add-apt-repository ppa:wireguard/wireguard
|
||||
#apt update
|
||||
#apt install wireguard
|
||||
5
example-simple-server-to-server/home-server/start.sh
Normal file
5
example-simple-server-to-server/home-server/start.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick up "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
5
example-simple-server-to-server/home-server/stop.sh
Normal file
5
example-simple-server-to-server/home-server/stop.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick down "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
14
example-simple-server-to-server/home-server/wg0.conf
Normal file
14
example-simple-server-to-server/home-server/wg0.conf
Normal file
@ -0,0 +1,14 @@
|
||||
[Interface]
|
||||
# Name = home-server.example-vpn.dev
|
||||
Address = 10.0.0.3/32
|
||||
ListenPort = 51820
|
||||
PrivateKey = WN+bvd3PCWs5Pk3bvl7abWR0c1L6PCWKYRX56mjVYGo=
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = q/+jwmL5tNuYSB3z+t9Caj00Pc1YQ8zf+uNPu/UE1wE=
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 10.0.0.1/24
|
||||
PersistentKeepalive = 25
|
||||
1
example-simple-server-to-server/laptop/laptop.key
Normal file
1
example-simple-server-to-server/laptop/laptop.key
Normal file
@ -0,0 +1 @@
|
||||
OPmibSXYAAcMIYKNsWqr77zY06Kl750AEB1nWQi1T2o=
|
||||
1
example-simple-server-to-server/laptop/laptop.key.pub
Normal file
1
example-simple-server-to-server/laptop/laptop.key.pub
Normal file
@ -0,0 +1 @@
|
||||
BV5DjXeCugIrjvEZLo4sZ0hN5wveFTH8kOfZ1AIQ5js=
|
||||
9
example-simple-server-to-server/laptop/setup.sh
Normal file
9
example-simple-server-to-server/laptop/setup.sh
Normal file
@ -0,0 +1,9 @@
|
||||
#!/bin/bash
|
||||
|
||||
# install wireguard on Ubuntu
|
||||
#add-apt-repository ppa:wireguard/wireguard
|
||||
#apt update
|
||||
#apt install wireguard
|
||||
|
||||
# install wireguard on macOS
|
||||
brew install wireguard-tools
|
||||
5
example-simple-server-to-server/laptop/start.sh
Normal file
5
example-simple-server-to-server/laptop/start.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick up "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
5
example-simple-server-to-server/laptop/stop.sh
Normal file
5
example-simple-server-to-server/laptop/stop.sh
Normal file
@ -0,0 +1,5 @@
|
||||
#!/bin/bash
|
||||
|
||||
PEER_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
||||
wg-quick down "$PEER_DIR"/wg0.conf
|
||||
wg show
|
||||
13
example-simple-server-to-server/laptop/wg0.conf
Normal file
13
example-simple-server-to-server/laptop/wg0.conf
Normal file
@ -0,0 +1,13 @@
|
||||
[Interface]
|
||||
# Name = laptop.example-vpn.dev
|
||||
Address = 10.0.0.4/32
|
||||
PrivateKey = OPmibSXYAAcMIYKNsWqr77zY06Kl750AEB1nWQi1T2o=
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = q/+jwmL5tNuYSB3z+t9Caj00Pc1YQ8zf+uNPu/UE1wE=
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 10.0.0.1/24
|
||||
PersistentKeepalive = 25
|
||||
1
example-simple-server-to-server/phone/phone.key
Normal file
1
example-simple-server-to-server/phone/phone.key
Normal file
@ -0,0 +1 @@
|
||||
WH98AvjKKZ584ZLb69G912bNry2wOda9+kfzm+qbnUw=
|
||||
1
example-simple-server-to-server/phone/phone.key.pub
Normal file
1
example-simple-server-to-server/phone/phone.key.pub
Normal file
@ -0,0 +1 @@
|
||||
VpjKa2MQKXuvttXRwJIe0LLYrtFYGQRTtmt8okUGm3A=
|
||||
4
example-simple-server-to-server/phone/setup.sh
Normal file
4
example-simple-server-to-server/phone/setup.sh
Normal file
@ -0,0 +1,4 @@
|
||||
#!/bin/bash
|
||||
|
||||
# install wireguard on iOS/Android
|
||||
echo "Use the iOS App Store / Google Play Store to install WireGuard on your mobile device"
|
||||
3
example-simple-server-to-server/phone/start.sh
Normal file
3
example-simple-server-to-server/phone/start.sh
Normal file
@ -0,0 +1,3 @@
|
||||
#!/bin/bash
|
||||
|
||||
echo "Use the iOS/Android app to load the wg0.conf file and start Wireguard"
|
||||
3
example-simple-server-to-server/phone/stop.sh
Normal file
3
example-simple-server-to-server/phone/stop.sh
Normal file
@ -0,0 +1,3 @@
|
||||
#!/bin/bash
|
||||
|
||||
echo "Use the iOS/Android app to load the wg0.conf file and stop Wireguard"
|
||||
13
example-simple-server-to-server/phone/wg0.conf
Normal file
13
example-simple-server-to-server/phone/wg0.conf
Normal file
@ -0,0 +1,13 @@
|
||||
[Interface]
|
||||
# Name = phone.example-vpn.dev
|
||||
Address = 10.0.0.5/32
|
||||
PrivateKey = WH98AvjKKZ584ZLb69G912bNry2wOda9+kfzm+qbnUw=
|
||||
DNS = 1.1.1.1
|
||||
|
||||
[Peer]
|
||||
# Name = public-server1.example-vpn.tld
|
||||
Endpoint = public-server1.example-vpn.tld:51820
|
||||
PublicKey = q/+jwmL5tNuYSB3z+t9Caj00Pc1YQ8zf+uNPu/UE1wE=
|
||||
# routes traffic to itself and entire subnet of peers as bounce server
|
||||
AllowedIPs = 10.0.0.1/24
|
||||
PersistentKeepalive = 25
|
||||
@ -0,0 +1 @@
|
||||
2P/3ll/TxGTjGqwcWnqJMnjwPqGw7oX1RaXlPfsf2FQ=
|
||||
@ -0,0 +1 @@
|
||||
q/+jwmL5tNuYSB3z+t9Caj00Pc1YQ8zf+uNPu/UE1wE=
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue
Block a user