Skip to content

Releases

v0.2.1

Choose a tag to compare

@github-actions github-actions released this 02 Aug 17:30

OpenWrt node client for the shadow9 WireGuard hub.

Install it on an OpenWrt 24.10.x or 25.12.x router:

release="$(. /etc/openwrt_release; echo "$DISTRIB_RELEASE")"
machine="$(uname -m)"
case "$machine" in
  x86_64) ipk_arch=x86_64; apk_arch=x86-64 ;;
  aarch64) ipk_arch=aarch64_generic; apk_arch=armsr-armv8 ;;
  mips*) ipk_arch=mipsel_24kc; apk_arch=ramips-mt7621 ;;
  *) echo "No shadow9 package matches $machine"; exit 1 ;;
esac
case "$release" in
  24.10.*) file="shadow9-node_0.2.1-r1_${ipk_arch}.ipk"; package=ipk ;;
  25.12.*) file="shadow9-node-0.2.1-r1_${apk_arch}.apk"; package=apk ;;
  *) echo "No shadow9 package matches OpenWrt $release"; exit 1 ;;
esac
base="https://github.com/regix1/shadow9-manager/releases/download/v0.2.1"
wget -O "/tmp/$file" "$base/$file"
wget -O /tmp/SHA256SUMS "$base/SHA256SUMS"
checksum="$(grep -F "  $file" /tmp/SHA256SUMS)" || {
  echo "SHA256SUMS has no entry for $file"
  exit 1
}
(cd /tmp && printf '%s\n' "$checksum" | sha256sum -c -) || exit 1
case "$package" in
  ipk) opkg install "/tmp/$file" ;;
  apk) apk add --allow-untrusted "/tmp/$file" ;;
esac

Replace the hub address, token, and advertised LAN, then join:

shadow9-node join -hub http://<hub>:8081 -token <token> -advertise 192.168.1.0/24

PBR creates and manages the pbr_wg0 internet-routing table; normal WAN
traffic is unchanged until a policy selects wg0. Add -site-only for only the
tunnel and advertised sites. Policy mode verifies that pbr is installed before
changing UCI.

Two changes break existing joins. Policy mode is IPv4 only, so an IPv6 tunnel
now has to join with -site-only. A -table <id> pin is no longer accepted and
fails the join, because PBR picks that ID itself; drop the flag and, on a node
that was pinned, issue a new token and join again with --keep-key.

shadow9-node uninstall removes only Shadow9-owned UCI sections; other
WireGuard interfaces and PBR policies are left unchanged.

v0.2.0

Choose a tag to compare

@github-actions github-actions released this 02 Aug 16:37

OpenWrt node client for the shadow9 WireGuard hub.

Install it on an OpenWrt 24.10.x or 25.12.x router:

release="$(. /etc/openwrt_release; echo "$DISTRIB_RELEASE")"
machine="$(uname -m)"
case "$machine" in
  x86_64) ipk_arch=x86_64; apk_arch=x86-64 ;;
  aarch64) ipk_arch=aarch64_generic; apk_arch=armsr-armv8 ;;
  mips*) ipk_arch=mipsel_24kc; apk_arch=ramips-mt7621 ;;
  *) echo "No shadow9 package matches $machine"; exit 1 ;;
esac
case "$release" in
  24.10.*) file="shadow9-node_0.2.0-r1_${ipk_arch}.ipk"; package=ipk ;;
  25.12.*) file="shadow9-node-0.2.0-r1_${apk_arch}.apk"; package=apk ;;
  *) echo "No shadow9 package matches OpenWrt $release"; exit 1 ;;
esac
base="https://github.com/regix1/shadow9-manager/releases/download/v0.2.0"
wget -O "/tmp/$file" "$base/$file"
wget -O /tmp/SHA256SUMS "$base/SHA256SUMS"
checksum="$(grep -F "  $file" /tmp/SHA256SUMS)" || {
  echo "SHA256SUMS has no entry for $file"
  exit 1
}
(cd /tmp && printf '%s\n' "$checksum" | sha256sum -c -) || exit 1
case "$package" in
  ipk) opkg install "/tmp/$file" ;;
  apk) apk add --allow-untrusted "/tmp/$file" ;;
esac

Replace the hub address, token, and advertised LAN, then join:

shadow9-node join -hub http://<hub>:8081 -token <token> -advertise 192.168.1.0/24

PBR creates and manages the pbr_wg0 internet-routing table; normal WAN
traffic is unchanged until a policy selects wg0. Add -site-only for only the
tunnel and advertised sites. Policy mode verifies that pbr is installed before
changing UCI.

Two changes break existing joins. Policy mode is IPv4 only, so an IPv6 tunnel
now has to join with -site-only. A -table <id> pin is no longer accepted and
fails the join, because PBR picks that ID itself; drop the flag and, on a node
that was pinned, issue a new token and join again with --keep-key.

shadow9-node uninstall removes only Shadow9-owned UCI sections; other
WireGuard interfaces and PBR policies are left unchanged.

v0.1.9

Choose a tag to compare

@github-actions github-actions released this 02 Aug 15:31

OpenWrt node client for the shadow9 WireGuard hub.

Install it on an OpenWrt 24.10.x or 25.12.x router:

release="$(. /etc/openwrt_release; echo "$DISTRIB_RELEASE")"
machine="$(uname -m)"
case "$machine" in
  x86_64) ipk_arch=x86_64; apk_arch=x86-64 ;;
  aarch64) ipk_arch=aarch64_generic; apk_arch=armsr-armv8 ;;
  mips*) ipk_arch=mipsel_24kc; apk_arch=ramips-mt7621 ;;
  *) echo "No shadow9 package matches $machine"; exit 1 ;;
esac
case "$release" in
  24.10.*) file="shadow9-node_0.1.9-r1_${ipk_arch}.ipk"; package=ipk ;;
  25.12.*) file="shadow9-node-0.1.9-r1_${apk_arch}.apk"; package=apk ;;
  *) echo "No shadow9 package matches OpenWrt $release"; exit 1 ;;
esac
base="https://github.com/regix1/shadow9-manager/releases/download/v0.1.9"
wget -O "/tmp/$file" "$base/$file"
wget -O /tmp/SHA256SUMS "$base/SHA256SUMS"
checksum="$(grep -F "  $file" /tmp/SHA256SUMS)" || {
  echo "SHA256SUMS has no entry for $file"
  exit 1
}
(cd /tmp && printf '%s\n' "$checksum" | sha256sum -c -) || exit 1
case "$package" in
  ipk) opkg install "/tmp/$file" ;;
  apk) apk add --allow-untrusted "/tmp/$file" ;;
esac

Replace the hub address, token, and advertised LAN, then join:

shadow9-node join -hub http://<hub>:8081 -token <token> -advertise 192.168.1.0/24

PBR creates and manages the pbr_wg0 internet-routing table; normal WAN
traffic is unchanged until a policy selects wg0. Add -site-only for only the
tunnel and advertised sites. Policy mode verifies that pbr is installed before
changing UCI.

Two changes break existing joins. Policy mode is IPv4 only, so an IPv6 tunnel
now has to join with -site-only. A -table <id> pin is no longer accepted and
fails the join, because PBR picks that ID itself; drop the flag and, on a node
that was pinned, issue a new token and join again with --keep-key.

shadow9-node uninstall removes only Shadow9-owned UCI sections; other
WireGuard interfaces and PBR policies are left unchanged.

v0.1.8

Choose a tag to compare

@github-actions github-actions released this 02 Aug 00:16

OpenWrt node client for the shadow9 WireGuard hub.

Install it on an OpenWrt 24.10.x or 25.12.x router:

release="$(. /etc/openwrt_release; echo "$DISTRIB_RELEASE")"
machine="$(uname -m)"
case "$machine" in
  x86_64) ipk_arch=x86_64; apk_arch=x86-64 ;;
  aarch64) ipk_arch=aarch64_generic; apk_arch=armsr-armv8 ;;
  mips*) ipk_arch=mipsel_24kc; apk_arch=ramips-mt7621 ;;
  *) echo "No shadow9 package matches $machine"; exit 1 ;;
esac
case "$release" in
  24.10.*) file="shadow9-node_0.1.8-r1_${ipk_arch}.ipk"; package=ipk ;;
  25.12.*) file="shadow9-node-0.1.8-r1_${apk_arch}.apk"; package=apk ;;
  *) echo "No shadow9 package matches OpenWrt $release"; exit 1 ;;
esac
base="https://github.com/regix1/shadow9-manager/releases/download/v0.1.8"
wget -O "/tmp/$file" "$base/$file"
wget -O /tmp/SHA256SUMS "$base/SHA256SUMS"
checksum="$(grep -F "  $file" /tmp/SHA256SUMS)" || {
  echo "SHA256SUMS has no entry for $file"
  exit 1
}
(cd /tmp && printf '%s\n' "$checksum" | sha256sum -c -) || exit 1
case "$package" in
  ipk) opkg install "/tmp/$file" ;;
  apk) apk add --allow-untrusted "/tmp/$file" ;;
esac

Replace the hub address, token, and advertised LAN, then join:

shadow9-node join -hub http://<hub>:8081 -token <token> -advertise 192.168.1.0/24

The default route is isolated in the first unused table at or above 51820 for
PBR; normal WAN traffic is unchanged until a policy selects wg0. Add
-site-only for only the tunnel and advertised sites, or -table <id> to pin a
specific table. Policy mode verifies that pbr is installed before changing UCI.
shadow9-node uninstall removes only Shadow9-owned UCI sections; other
WireGuard interfaces and PBR policies are left unchanged.

v0.1.7

Choose a tag to compare

@github-actions github-actions released this 01 Aug 19:47

OpenWrt node client for the shadow9 WireGuard hub.

Install it on an OpenWrt 24.10.x or 25.12.x router:

release="$(. /etc/openwrt_release; echo "$DISTRIB_RELEASE")"
machine="$(uname -m)"
case "$machine" in
  x86_64) ipk_arch=x86_64; apk_arch=x86-64 ;;
  aarch64) ipk_arch=aarch64_generic; apk_arch=armsr-armv8 ;;
  mips*) ipk_arch=mipsel_24kc; apk_arch=ramips-mt7621 ;;
  *) echo "No shadow9 package matches $machine"; exit 1 ;;
esac
case "$release" in
  24.10.*) file="shadow9-node_0.1.7-r1_${ipk_arch}.ipk"; package=ipk ;;
  25.12.*) file="shadow9-node-0.1.7-r1_${apk_arch}.apk"; package=apk ;;
  *) echo "No shadow9 package matches OpenWrt $release"; exit 1 ;;
esac
base="https://github.com/regix1/shadow9-manager/releases/download/v0.1.7"
wget -O "/tmp/$file" "$base/$file"
wget -O /tmp/SHA256SUMS "$base/SHA256SUMS"
checksum="$(grep -F "  $file" /tmp/SHA256SUMS)" || {
  echo "SHA256SUMS has no entry for $file"
  exit 1
}
(cd /tmp && printf '%s\n' "$checksum" | sha256sum -c -) || exit 1
case "$package" in
  ipk) opkg install "/tmp/$file" ;;
  apk) apk add --allow-untrusted "/tmp/$file" ;;
esac

Replace the hub address, token, and advertised LAN, then join:

shadow9-node join -hub http://<hub>:8081 -token <token> -advertise 192.168.1.0/24

v0.1.6

Choose a tag to compare

@github-actions github-actions released this 01 Aug 15:26

OpenWrt node client for the shadow9 WireGuard hub.

Install it on an OpenWrt 24.10.x or 25.12.x router:

release="$(. /etc/openwrt_release; echo "$DISTRIB_RELEASE")"
machine="$(uname -m)"
case "$machine" in
  x86_64) ipk_arch=x86_64; apk_arch=x86-64 ;;
  aarch64) ipk_arch=aarch64_generic; apk_arch=armsr-armv8 ;;
  mips*) ipk_arch=mipsel_24kc; apk_arch=ramips-mt7621 ;;
  *) echo "No shadow9 package matches $machine"; exit 1 ;;
esac
case "$release" in
  24.10.*) file="shadow9-node_0.1.6-r1_${ipk_arch}.ipk"; package=ipk ;;
  25.12.*) file="shadow9-node-0.1.6-r1_${apk_arch}.apk"; package=apk ;;
  *) echo "No shadow9 package matches OpenWrt $release"; exit 1 ;;
esac
base="https://github.com/regix1/shadow9-manager/releases/download/v0.1.6"
wget -O "/tmp/$file" "$base/$file"
wget -O /tmp/SHA256SUMS "$base/SHA256SUMS"
checksum="$(grep -F "  $file" /tmp/SHA256SUMS)" || {
  echo "SHA256SUMS has no entry for $file"
  exit 1
}
(cd /tmp && printf '%s\n' "$checksum" | sha256sum -c -) || exit 1
case "$package" in
  ipk) opkg install "/tmp/$file" ;;
  apk) apk add --allow-untrusted "/tmp/$file" ;;
esac

Replace the hub address, token, and advertised LAN, then join:

shadow9-node join -hub http://<hub>:8081 -token <token> -advertise 192.168.1.0/24

v0.1.5

Choose a tag to compare

@github-actions github-actions released this 01 Aug 05:04

OpenWrt node client for the shadow9 WireGuard hub.

Install it on an OpenWrt 24.10.x or 25.12.x router:

release="$(. /etc/openwrt_release; echo "$DISTRIB_RELEASE")"
machine="$(uname -m)"
case "$machine" in
  x86_64) ipk_arch=x86_64; apk_arch=x86-64 ;;
  aarch64) ipk_arch=aarch64_generic; apk_arch=armsr-armv8 ;;
  mips*) ipk_arch=mipsel_24kc; apk_arch=ramips-mt7621 ;;
  *) echo "No shadow9 package matches $machine"; exit 1 ;;
esac
case "$release" in
  24.10.*) file="shadow9-node_0.1.5-r1_${ipk_arch}.ipk"; package=ipk ;;
  25.12.*) file="shadow9-node-0.1.5-r1_${apk_arch}.apk"; package=apk ;;
  *) echo "No shadow9 package matches OpenWrt $release"; exit 1 ;;
esac
base="https://github.com/regix1/shadow9-manager/releases/download/v0.1.5"
wget -O "/tmp/$file" "$base/$file"
wget -O /tmp/SHA256SUMS "$base/SHA256SUMS"
checksum="$(grep -F "  $file" /tmp/SHA256SUMS)" || {
  echo "SHA256SUMS has no entry for $file"
  exit 1
}
(cd /tmp && printf '%s\n' "$checksum" | sha256sum -c -) || exit 1
case "$package" in
  ipk) opkg install "/tmp/$file" ;;
  apk) apk add --allow-untrusted "/tmp/$file" ;;
esac

Replace the hub address, token, and advertised LAN, then join:

shadow9-node join -hub http://<hub>:8081 -token <token> -advertise 192.168.1.0/24

v0.1.4

Choose a tag to compare

@github-actions github-actions released this 01 Aug 04:10

OpenWrt node client for the shadow9 WireGuard hub.

Install it on an OpenWrt 24.10.x or 25.12.x router:

release="$(. /etc/openwrt_release; echo "$DISTRIB_RELEASE")"
machine="$(uname -m)"
case "$machine" in
  x86_64) ipk_arch=x86_64; apk_arch=x86-64 ;;
  aarch64) ipk_arch=aarch64_generic; apk_arch=armsr-armv8 ;;
  mips*) ipk_arch=mipsel_24kc; apk_arch=ramips-mt7621 ;;
  *) echo "No shadow9 package matches $machine"; exit 1 ;;
esac
case "$release" in
  24.10.*) file="shadow9-node_0.1.4-r1_${ipk_arch}.ipk"; package=ipk ;;
  25.12.*) file="shadow9-node-0.1.4-r1_${apk_arch}.apk"; package=apk ;;
  *) echo "No shadow9 package matches OpenWrt $release"; exit 1 ;;
esac
base="https://github.com/regix1/shadow9-manager/releases/download/v0.1.4"
wget -O "/tmp/$file" "$base/$file"
wget -O /tmp/SHA256SUMS "$base/SHA256SUMS"
checksum="$(grep -F "  $file" /tmp/SHA256SUMS)" || {
  echo "SHA256SUMS has no entry for $file"
  exit 1
}
(cd /tmp && printf '%s\n' "$checksum" | sha256sum -c -) || exit 1
case "$package" in
  ipk) opkg install "/tmp/$file" ;;
  apk) apk add --allow-untrusted "/tmp/$file" ;;
esac

Replace the hub address, token, and advertised LAN, then join:

shadow9-node join -hub http://<hub>:8081 -token <token> -advertise 192.168.1.0/24

v0.1.3

Choose a tag to compare

@github-actions github-actions released this 01 Aug 03:26

OpenWrt node client for the shadow9 WireGuard hub.

Install it on an OpenWrt 24.10.x or 25.12.x router:

release="$(. /etc/openwrt_release; echo "$DISTRIB_RELEASE")"
machine="$(uname -m)"
case "$machine" in
  x86_64) ipk_arch=x86_64; apk_arch=x86-64 ;;
  aarch64) ipk_arch=aarch64_generic; apk_arch=armsr-armv8 ;;
  mips*) ipk_arch=mipsel_24kc; apk_arch=ramips-mt7621 ;;
  *) echo "No shadow9 package matches $machine"; exit 1 ;;
esac
case "$release" in
  24.10.*) file="shadow9-node_0.1.3-r1_${ipk_arch}.ipk"; package=ipk ;;
  25.12.*) file="shadow9-node-0.1.3-r1_${apk_arch}.apk"; package=apk ;;
  *) echo "No shadow9 package matches OpenWrt $release"; exit 1 ;;
esac
base="https://github.com/regix1/shadow9-manager/releases/download/v0.1.3"
wget -O "/tmp/$file" "$base/$file"
wget -O /tmp/SHA256SUMS "$base/SHA256SUMS"
checksum="$(grep -F "  $file" /tmp/SHA256SUMS)" || {
  echo "SHA256SUMS has no entry for $file"
  exit 1
}
(cd /tmp && printf '%s\n' "$checksum" | sha256sum -c -) || exit 1
case "$package" in
  ipk) opkg install "/tmp/$file" ;;
  apk) apk add --allow-untrusted "/tmp/$file" ;;
esac

Replace the hub address, token, and advertised LAN, then join:

shadow9-node join -hub http://<hub>:8081 -token <token> -advertise 192.168.1.0/24

v0.1.2

v0.1.2 Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 01 Aug 02:44

OpenWrt node client for the shadow9 WireGuard hub.

Router File
OpenWrt 24.10.x the .ipk matching your architecture, installed with opkg install
OpenWrt 25.12.x the .apk matching your target, installed with apk add --allow-untrusted

shadow9-node-linux-* are the raw binaries for installing without a package.
SHA256SUMS covers every other file here.

Setup is in docs/SETUP.md.