contrib: add wg-config
Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
This commit is contained in:
parent
9707e5d6af
commit
f03aea7574
13
contrib/wg-config/Makefile
Normal file
13
contrib/wg-config/Makefile
Normal file
|
@ -0,0 +1,13 @@
|
||||||
|
PREFIX ?= /usr
|
||||||
|
DESTDIR ?=
|
||||||
|
SBINDIR ?= $(PREFIX)/sbin
|
||||||
|
|
||||||
|
SCRIPTS := wg-config tungate
|
||||||
|
|
||||||
|
all:
|
||||||
|
@echo "These are shell scripts, so there is nothing to do. Try \"make install\" instead."
|
||||||
|
|
||||||
|
install:
|
||||||
|
@install -v -m0755 -D -t$(DESTDIR)$(SBINDIR) $(SCRIPTS)
|
||||||
|
|
||||||
|
.PHONY: all install
|
140
contrib/wg-config/README
Normal file
140
contrib/wg-config/README
Normal file
|
@ -0,0 +1,140 @@
|
||||||
|
== Installation ==
|
||||||
|
|
||||||
|
# make install
|
||||||
|
|
||||||
|
== Usage ==
|
||||||
|
|
||||||
|
wg-config is a very simple utility for adding and configuring WireGuard
|
||||||
|
interfaces using ip(8) and wg(8).
|
||||||
|
|
||||||
|
Usage: wg-config [ add | del ] INTERFACE [arguments...]
|
||||||
|
|
||||||
|
wg-config add INTERFACE --config=CONFIG_FILE [--address=ADDRESS/CIDR...]
|
||||||
|
[--route=ROUTE/CIDR...] [--no-auto-route-from-allowed-ips]
|
||||||
|
[--env-file=ENV_FILE]
|
||||||
|
|
||||||
|
The add subcommand adds a new WireGuard interface, INTERFACE, replacing
|
||||||
|
any existing interfaces of the same name. The --config argument is
|
||||||
|
required, and its argument is passed to wg(8)'s setconf subcommand. The
|
||||||
|
--address argument(s) is recommended for this utility to be useful. The
|
||||||
|
--route argument is purely optional, as by default this utility will
|
||||||
|
automatically add routes implied by --address and as implied by the
|
||||||
|
allowed-ip entries inside the --config file. To disable this automatic
|
||||||
|
route adding, you may use the option entitled --no-auto-route-from-allowed-ips.
|
||||||
|
|
||||||
|
wg-config del INTERFACE [--config=CONFIG_FILE_TO_SAVE] [--env-file=ENV_FILE]
|
||||||
|
|
||||||
|
The del subcommand removes an existing WireGuard interface. If the
|
||||||
|
optional --config is specified, then the existing configuration is
|
||||||
|
written out to the file specified, via wg(8)'s showconf subcommand.
|
||||||
|
|
||||||
|
Both `add' and del' take the --env-file=ENV_FILE option. If specified,
|
||||||
|
the contents of ENV_FILE are imported into wg-config. This can be used to
|
||||||
|
set variables in a file, instead of needing to pass them on the command
|
||||||
|
line. The following table shows the relation between the command line
|
||||||
|
options described above, and variables that may be declared in ENV_FILE:
|
||||||
|
|
||||||
|
--address=A, --address=B, --address=C ADDRESSES=( "A" "B" "C" )
|
||||||
|
--route=A, --route=B, --route=C ADDITIONAL_ROUTES=( "A" "B" "C" )
|
||||||
|
--config-file=F CONFIG_FILE="F"
|
||||||
|
echo C > /tmp/F, --config-file=/tmp/F CONFIG_FILE_CONTENTS="C"
|
||||||
|
--no-auto-route-from-allowed-ips AUTO_ROUTE=0
|
||||||
|
|
||||||
|
Additionally, ENV_FILE may define the bash functions pre_add, post_add,
|
||||||
|
pre_del, and post_del, which will be called at their respective times.
|
||||||
|
|
||||||
|
|
||||||
|
== Helper Tool ==
|
||||||
|
|
||||||
|
tungate is a separate utility, developed originally not explicitly for
|
||||||
|
WireGuard, which acts as a poor man's way of ensuring 0/1 and 128/1 default
|
||||||
|
route overrides still work with an endpoint going over the original default
|
||||||
|
route. It's quite handy, and wg-config makes use of it for dealing with
|
||||||
|
0.0.0.0/0 routes. At the moment it only supports IPv4, but adding IPv6
|
||||||
|
should be pretty easy.
|
||||||
|
|
||||||
|
== Example ==
|
||||||
|
|
||||||
|
/etc/wireguard/wg-server.conf:
|
||||||
|
|
||||||
|
[Interface]
|
||||||
|
PrivateKey = yAnz5TF+lXXJte14tji3zlMNq+hd2rYUIgJBgB3fBmk=
|
||||||
|
ListenPort = 41414
|
||||||
|
|
||||||
|
[Peer]
|
||||||
|
PublicKey = xTIBA5rboUvnH4htodjb6e697QjLERt1NAB4mZqp8Dg=
|
||||||
|
AllowedIPs = 10.192.122.3/32, 10.192.124.1/24
|
||||||
|
|
||||||
|
[Peer]
|
||||||
|
PublicKey = TrMvSoP4jYQlY6RIzBgbssQqY3vxI2Pi+y71lOWWXX0=
|
||||||
|
AllowedIPs = 10.192.122.4/32, 192.168.0.0/16
|
||||||
|
|
||||||
|
[Peer]
|
||||||
|
PublicKey = gN65BkIKy1eCE9pP1wdc8ROUtkHLF2PfAqYdyYBz6EA=
|
||||||
|
AllowedIPs = 10.10.10.230/32
|
||||||
|
|
||||||
|
/etc/wireguard/wg-server.env:
|
||||||
|
|
||||||
|
CONFIG_FILE="$(dirname "${BASH_SOURCE[0]}")/wg-server.conf"
|
||||||
|
ADDRESSES=( 10.192.122.1/34 10.10.0.1/16 )
|
||||||
|
|
||||||
|
Run at startup:
|
||||||
|
# wg-config add wgserver0 --env-file=/etc/wireguard/wg-server.env
|
||||||
|
Run at shutdown:
|
||||||
|
# wg-config del wgserver0 --env-file=/etc/wireguard/wg-server.env
|
||||||
|
|
||||||
|
== Advanced Example ==
|
||||||
|
|
||||||
|
/etc/wireguard/wg-vpn-gateway.conf:
|
||||||
|
|
||||||
|
[Interface]
|
||||||
|
PrivateKey = 6JiA3fa+NG+x5m6aq7+lxlVaVqVf1mxK6/pDOZdNuXc=
|
||||||
|
|
||||||
|
[Peer]
|
||||||
|
PublicKey = 6NagfTu+s8+TkEKpxX7pNjJuTf4zYtoJme7iQFYIw0A=
|
||||||
|
AllowedIPs = 0.0.0.0/0
|
||||||
|
Endpoint = demo.wireguard.io:29912
|
||||||
|
|
||||||
|
/etc/wireguard/wg-vpn-gateway.env:
|
||||||
|
|
||||||
|
[[ $SUBCOMMAND == add ]] && CONFIG_FILE="$(dirname "${BASH_SOURCE[0]}")/demo-vpn.conf" || true
|
||||||
|
ADDRESSES=( 10.200.100.2/32 )
|
||||||
|
post_add() {
|
||||||
|
printf 'nameserver 10.200.100.1' | cmd resolvconf -a "$INTERFACE" -m 0
|
||||||
|
}
|
||||||
|
post_del() {
|
||||||
|
cmd resolvconf -d "$INTERFACE"
|
||||||
|
}
|
||||||
|
|
||||||
|
Run to flip on the VPN:
|
||||||
|
# wg-config add wgvpn0 --env-file=/etc/wireguard/wg-vpn-gateway.env
|
||||||
|
The config file is not overwritten on shutdown, due to the conditional in the env file:
|
||||||
|
# wg-config del wgvpn0 --env-file=/etc/wireguard/wg-vpn-gateway.env
|
||||||
|
|
||||||
|
== Single File Advanced Example ==
|
||||||
|
|
||||||
|
/etc/wireguard/wg-vpn-gateway.env:
|
||||||
|
|
||||||
|
CONFIG_FILE_CONTENTS="
|
||||||
|
[Interface]
|
||||||
|
PrivateKey = 6JiA3fa+NG+x5m6aq7+lxlVaVqVf1mxK6/pDOZdNuXc=
|
||||||
|
|
||||||
|
[Peer]
|
||||||
|
PublicKey = 6NagfTu+s8+TkEKpxX7pNjJuTf4zYtoJme7iQFYIw0A=
|
||||||
|
AllowedIPs = 0.0.0.0/0
|
||||||
|
Endpoint = demo.wireguard.io:29912
|
||||||
|
"
|
||||||
|
|
||||||
|
ADDRESSES=( 10.200.100.2/32 )
|
||||||
|
|
||||||
|
post_add() {
|
||||||
|
printf 'nameserver 10.200.100.1' | cmd resolvconf -a "$INTERFACE" -m 0
|
||||||
|
}
|
||||||
|
post_del() {
|
||||||
|
cmd resolvconf -d "$INTERFACE"
|
||||||
|
}
|
||||||
|
|
||||||
|
Run to flip on the VPN:
|
||||||
|
# wg-config add wgvpn0 --env-file=/etc/wireguard/wg-vpn-gateway.env
|
||||||
|
Run to flip off the VPN:
|
||||||
|
# wg-config del wgvpn0 --env-file=/etc/wireguard/wg-vpn-gateway.env
|
43
contrib/wg-config/tungate
Executable file
43
contrib/wg-config/tungate
Executable file
|
@ -0,0 +1,43 @@
|
||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
unwind() {
|
||||||
|
ip route del "$1/32" 2>/dev/null
|
||||||
|
exit
|
||||||
|
}
|
||||||
|
|
||||||
|
short_route() {
|
||||||
|
ip route | sed -n "s/$1 \\(.* dev [^ ]\\+\\).*/\\1/p" | head -n 1
|
||||||
|
}
|
||||||
|
|
||||||
|
resolve_ip() {
|
||||||
|
local filter='/^[0-9]\{1,3\}\.[0-9]\{1,3\}\.[0-9]\{1,3\}\.[0-9]\{1,3\}$/{p;q;}'
|
||||||
|
[[ $(sed -n "$filter" <<<"$1") == "$1" ]] && echo "$1" ||
|
||||||
|
host -t a "$1" | cut -d ' ' -f 4 | sed -n "$filter"
|
||||||
|
}
|
||||||
|
|
||||||
|
set_route() {
|
||||||
|
local default_route="$(short_route default)"
|
||||||
|
[[ -n $default_route ]] || { echo "[-] Could not determine default route"; return; }
|
||||||
|
echo "[+] Adding route for $1 to be $default_route"
|
||||||
|
ip route del "$1/32" 2>/dev/null
|
||||||
|
ip route add "$1/32" $default_route
|
||||||
|
}
|
||||||
|
|
||||||
|
check_loop() {
|
||||||
|
local ip="$(resolve_ip "$1")"
|
||||||
|
[[ -n $ip ]] || { echo "[-] Could not determine IP of '$1'" && return 1; }
|
||||||
|
echo "[+] Making sure $ip goes over the default (non-0/1,128/1) route"
|
||||||
|
|
||||||
|
set_route "$ip"
|
||||||
|
trap unwind INT TERM EXIT
|
||||||
|
|
||||||
|
while read; do
|
||||||
|
[[ $(short_route "$ip") != "$(short_route default)" ]] && set_route "$ip"
|
||||||
|
done < <(exec ip monitor route)
|
||||||
|
}
|
||||||
|
|
||||||
|
[[ $# -ne 1 ]] && { echo "Usage: $0 IP|HOST" >&2; exit 1; }
|
||||||
|
[[ $UID -ne 0 ]] && exec sudo "$(readlink -f "$0")" "$@"
|
||||||
|
|
||||||
|
check_loop "$1"
|
||||||
|
exit $?
|
187
contrib/wg-config/wg-config
Executable file
187
contrib/wg-config/wg-config
Executable file
|
@ -0,0 +1,187 @@
|
||||||
|
#!/bin/bash
|
||||||
|
set -e -o pipefail
|
||||||
|
|
||||||
|
export PATH="$(dirname "$(readlink -f "$0")"):$PATH"
|
||||||
|
|
||||||
|
cmd() {
|
||||||
|
echo "[#] $*" >&2
|
||||||
|
"$@"
|
||||||
|
}
|
||||||
|
|
||||||
|
auto_su() {
|
||||||
|
[[ $UID != 0 ]] && exec sudo -p "$PROGRAM must be run as root. Please enter the password for %u to continue: " "$(readlink -f "$0")" "${ARGS[@]}" || true
|
||||||
|
}
|
||||||
|
|
||||||
|
unwind() {
|
||||||
|
set +e
|
||||||
|
[[ -n $INTERFACE && -n $(ip link show dev "$INTERFACE" type wireguard 2>/dev/null) ]] && cmd ip link delete dev "$INTERFACE"
|
||||||
|
exit
|
||||||
|
}
|
||||||
|
|
||||||
|
add_if() {
|
||||||
|
ip link delete dev "$INTERFACE" 2>/dev/null || true
|
||||||
|
cmd ip link add "$INTERFACE" type wireguard
|
||||||
|
}
|
||||||
|
|
||||||
|
del_if() {
|
||||||
|
[[ -n $(ip link show dev "$INTERFACE" type wireguard 2>/dev/null) ]] || { echo "$PROGRAM: \`$INTERFACE' is not a WireGuard interface" >&2; exit 1; }
|
||||||
|
cmd ip link delete dev "$INTERFACE"
|
||||||
|
}
|
||||||
|
|
||||||
|
up_if() {
|
||||||
|
cmd ip link set "$INTERFACE" up
|
||||||
|
}
|
||||||
|
|
||||||
|
add_addr() {
|
||||||
|
cmd ip address add "$1" dev "$INTERFACE"
|
||||||
|
}
|
||||||
|
|
||||||
|
add_route() {
|
||||||
|
cmd ip route add "$1" dev "$INTERFACE"
|
||||||
|
}
|
||||||
|
|
||||||
|
add_default() {
|
||||||
|
if [[ $1 == ::/0 ]]; then
|
||||||
|
echo "tungate: does not yet support IPv6, skipping ::/0" >&2
|
||||||
|
return 0
|
||||||
|
elif [[ $1 == 0.0.0.0/0 ]]; then
|
||||||
|
local endpoint="$(wg show "$INTERFACE" endpoints | grep "^$(wg show "$INTERFACE" allowed-ips | grep 0.0.0.0/0 | head -n 1 | cut -f 1)" | cut -f 2 | cut -d : -f 1)"
|
||||||
|
add_route 0/1
|
||||||
|
add_route 128/1
|
||||||
|
killall tungate 2>/dev/null || true
|
||||||
|
echo "[&] Forking \`tungate' for $endpoint to background" >&2
|
||||||
|
tungate "$endpoint" >/dev/null 2>&1 & disown
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
set_config() {
|
||||||
|
if [[ -n $CONFIG_FILE_CONTENTS ]]; then
|
||||||
|
cmd wg setconf "$INTERFACE" <(echo "$CONFIG_FILE_CONTENTS")
|
||||||
|
else
|
||||||
|
cmd wg setconf "$INTERFACE" "$CONFIG_FILE"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
|
||||||
|
save_config() {
|
||||||
|
local old_umask="$(umask)"
|
||||||
|
umask 077
|
||||||
|
cmd wg showconf "$INTERFACE" > "$CONFIG_FILE.tmp" || { rm -f "$CONFIG_FILE.tmp"; exit 1; }
|
||||||
|
mv "$CONFIG_FILE.tmp" "$CONFIG_FILE" || { rm -f "$CONFIG_FILE.tmp"; exit 1; }
|
||||||
|
umask "$old_umask"
|
||||||
|
}
|
||||||
|
|
||||||
|
cmd_usage() {
|
||||||
|
cat >&2 <<-_EOF
|
||||||
|
Usage: $PROGRAM [ add | del ] INTERFACE [arguments...]
|
||||||
|
|
||||||
|
$PROGRAM add INTERFACE --config=CONFIG_FILE [--address=ADDRESS/CIDR...]
|
||||||
|
[--route=ROUTE/CIDR...] [--no-auto-route-from-allowed-ips]
|
||||||
|
[--env-file=ENV_FILE]
|
||||||
|
|
||||||
|
The add subcommand adds a new WireGuard interface, INTERFACE, replacing
|
||||||
|
any existing interfaces of the same name. The --config argument is
|
||||||
|
required, and its argument is passed to wg(8)'s setconf subcommand. The
|
||||||
|
--address argument(s) is recommended for this utility to be useful. The
|
||||||
|
--route argument is purely optional, as by default this utility will
|
||||||
|
automatically add routes implied by --address and as implied by the
|
||||||
|
allowed-ip entries inside the --config file. To disable this automatic
|
||||||
|
route adding, you may use the option entitled --no-auto-route-from-allowed-ips.
|
||||||
|
|
||||||
|
$PROGRAM del INTERFACE [--config=CONFIG_FILE_TO_SAVE] [--env-file=ENV_FILE]
|
||||||
|
|
||||||
|
The del subcommand removes an existing WireGuard interface. If the
|
||||||
|
optional --config is specified, then the existing configuration is
|
||||||
|
written out to the file specified, via wg(8)'s showconf subcommand.
|
||||||
|
|
||||||
|
$PROGRAM help
|
||||||
|
|
||||||
|
Show this message.
|
||||||
|
|
||||||
|
Both \`add' and ``del' take the --env-file=ENV_FILE option. If specified,
|
||||||
|
the contents of ENV_FILE are imported into $PROGRAM. This can be used to
|
||||||
|
set variables in a file, instead of needing to pass them on the command
|
||||||
|
line. The following table shows the relation between the command line
|
||||||
|
options described above, and variables that may be declared in ENV_FILE:
|
||||||
|
|
||||||
|
--address=A, --address=B, --address=C ADDRESSES=( "A" "B" "C" )
|
||||||
|
--route=A, --route=B, --route=C ADDITIONAL_ROUTES=( "A" "B" "C" )
|
||||||
|
--config-file=F CONFIG_FILE="F"
|
||||||
|
echo C > /tmp/F, --config-file=/tmp/F CONFIG_FILE_CONTENTS="C"
|
||||||
|
--no-auto-route-from-allowed-ips AUTO_ROUTE=0
|
||||||
|
|
||||||
|
Additionally, ENV_FILE may define the bash functions pre_add, post_add,
|
||||||
|
pre_del, and post_del, which will be called at their respective times.
|
||||||
|
_EOF
|
||||||
|
}
|
||||||
|
|
||||||
|
cmd_add() {
|
||||||
|
local i
|
||||||
|
[[ -n $CONFIG_FILE || -n $CONFIG_FILE_CONTENTS ]] || { echo "$PROGRAM: --config is required for add subcommand" >&2; exit 1; }
|
||||||
|
auto_su
|
||||||
|
trap unwind INT TERM EXIT
|
||||||
|
[[ $(type -t pre_add) == function ]] && pre_add || true
|
||||||
|
add_if
|
||||||
|
set_config
|
||||||
|
for i in "${ADDRESSES[@]}"; do
|
||||||
|
add_addr "$i"
|
||||||
|
done
|
||||||
|
up_if
|
||||||
|
if [[ $AUTO_ROUTE -eq 1 ]]; then
|
||||||
|
for i in $(wg show "$INTERFACE" allowed-ips | cut -f 2 | tr -d ,); do
|
||||||
|
if ! add_default "$i" && [[ $(ip route get "$i") != *dev\ $INTERFACE\ * ]]; then
|
||||||
|
add_route "$i"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
fi
|
||||||
|
for i in "${ADDITIONAL_ROUTES[@]}"; do
|
||||||
|
if ! add_default "$i"; then
|
||||||
|
add_route "$i"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
[[ $(type -t post_add) == function ]] && post_add || true
|
||||||
|
trap - INT TERM EXIT
|
||||||
|
}
|
||||||
|
|
||||||
|
cmd_del() {
|
||||||
|
auto_su
|
||||||
|
[[ $(type -t pre_del) == function ]] && pre_del || true
|
||||||
|
killall tungate 2>/dev/null || true
|
||||||
|
[[ -n $CONFIG_FILE ]] && save_config
|
||||||
|
del_if
|
||||||
|
[[ $(type -t post_del) == function ]] && post_del || true
|
||||||
|
}
|
||||||
|
|
||||||
|
declare INTERFACE="$2"
|
||||||
|
declare SUBCOMMAND="$1"
|
||||||
|
declare -a ADDRESSES
|
||||||
|
declare -a ADDITIONAL_ROUTES
|
||||||
|
declare AUTO_ROUTE=1
|
||||||
|
declare CONFIG_FILE
|
||||||
|
declare CONFIG_FILE_CONTENTS
|
||||||
|
declare PROGRAM="${0##*/}"
|
||||||
|
declare -a ARGS=( "$@" )
|
||||||
|
|
||||||
|
[[ -n $INTERFACE && -n $SUBCOMMAND ]] || { cmd_usage; exit 1; }
|
||||||
|
|
||||||
|
shift 2
|
||||||
|
|
||||||
|
for arg; do
|
||||||
|
case "$arg" in
|
||||||
|
--env-file=*) source "${arg#*=}" ;;
|
||||||
|
--config=*) CONFIG_FILE="${arg#*=}" ;;
|
||||||
|
--address=*) ADDRESSES+=( ${arg#*=} ) ;;
|
||||||
|
--route=*) ADDITIONAL_ROUTES+=( ${arg#*=} ) ;;
|
||||||
|
--no-auto-route-from-allowed-ips) AUTO_ROUTE=0 ;;
|
||||||
|
*) cmd_usage; exit 1 ;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
|
||||||
|
case "$SUBCOMMAND" in
|
||||||
|
add) cmd_add ;;
|
||||||
|
del) cmd_del ;;
|
||||||
|
*) cmd_usage; exit 1 ;;
|
||||||
|
esac
|
||||||
|
|
||||||
|
exit 0
|
Loading…
Reference in a new issue