YunoHost-Apps/wireguard_ynh
1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/wireguard_ynh.git synced 2024-09-03 20:35:58 +02:00
Code Issues Activity Actions
WireGuard VPN software with a web UI configuration companion, packaged for YunoHost.
137 commits 3 branches 0 tags 575 KiB
Shell 100%
Find a file
tituspijean bdae85a4d9
Merge pull request #40 from YunoHost-Apps/enh 
Enhancements
2021-12-22 15:33:48 +01:00
.github [autopatch] Update issue and PR templates 2021-05-13 22:58:36 +02:00
conf Merge pull request #40 from YunoHost-Apps/enh 2021-12-22 15:33:48 +01:00
doc 4.3 2021-12-09 12:31:02 +01:00
scripts Merge pull request #40 from YunoHost-Apps/enh 2021-12-22 15:33:48 +01:00
.gitignore Initial commit 2020-10-11 14:45:13 +02:00
check_process Fix 2021-09-09 15:03:30 +02:00
LICENSE Initial commit 2020-10-11 14:45:13 +02:00
manifest.json 4.3 2021-12-09 12:31:02 +01:00
README.md Auto-update README 2021-12-09 11:31:08 +00:00
README_fr.md Auto-update README 2021-12-09 11:31:08 +00:00

README.md

WireGuard for YunoHost

Integration level
Install WireGuard with YunoHost

Lire ce readme en français.

This package allows you to install WireGuard quickly and simply on a YunoHost server. If you don't have YunoHost, please consult the guide to learn how to install it.

Overview

WireGuard® is fast and modern VPN that utilizes state-of-the-art cryptography. It aims to be faster, simpler, leaner, and more useful than IPsec. It intends to be considerably more performant than OpenVPN. WireGuard is designed as a general purpose VPN.

Shipped version: 0.3.2~ynh1

Screenshots

Disclaimers / important information

  • WireGuard for YunoHost will add a DMKS module to your Linux kernel.
    • You may need to reboot your server for WireGuard to be able to start.
  • The package includes WireGuard and non-official web UI to configure it.
    • Avoid altering the configuration files via the command line interface, though.
  • Use YunoHost permissions panel to allow users to access the web UI.
  • Only one network interface, wg0, can be managed with this app at the moment.

Make your server share its Internet connection

Enable port forwarding

sudo nano /etc/sysctl.conf
# Uncomment the following lines:
net.ipv4.ip_forward = 1
net.ipv6.conf.all.forwarding = 1
# Save and quit (CTRL+O, CTRL+X)
sudo sysctl -p

Add the following commands in WireGuard Server menu, like in this picture. Replace eth0 with the interface connected to the Internet:

Post Up Script

iptables -A FORWARD -i %i -j ACCEPT; iptables -A FORWARD -o %i -j ACCEPT; iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE

Post Down Script

iptables -D FORWARD -i %i -j ACCEPT; iptables -D FORWARD -o %i -j ACCEPT; iptables -t nat -D POSTROUTING -o eth0 -j MASQUERADE

Documentation and resources

Developer info

Please send your pull request to the testing branch.

To try the testing branch, please proceed like that.

sudo yunohost app install https://github.com/YunoHost-Apps/wireguard_ynh/tree/testing --debug
or
sudo yunohost app upgrade wireguard -u https://github.com/YunoHost-Apps/wireguard_ynh/tree/testing --debug

More info regarding app packaging: https://yunohost.org/packaging_apps