From e90afae7acb57a0a70317d90314c90403122eb15 Mon Sep 17 00:00:00 2001 From: Katherina Walshe-Grey Date: Thu, 25 Jul 2024 07:52:43 +0100 Subject: [PATCH] birdsong: fully modularise existing wireguard config --- hosts/orm/wireguard.nix | 29 +------ hosts/tohru/wireguard.nix | 4 - hosts/yevaud/configuration.nix | 7 ++ services/birdsong/default.nix | 1 + services/birdsong/hosts.nix | 134 +++++++++++++++++++++++++++++++++ services/birdsong/peer.nix | 74 ++++++++++++------ 6 files changed, 197 insertions(+), 52 deletions(-) create mode 100644 services/birdsong/hosts.nix diff --git a/hosts/orm/wireguard.nix b/hosts/orm/wireguard.nix index be20446..38ef0da 100644 --- a/hosts/orm/wireguard.nix +++ b/hosts/orm/wireguard.nix @@ -3,31 +3,8 @@ { age.secrets.wireguard-hub.file = ../../secrets/wireguard-hub.age; - networking = { - nat = { - enable = true; - externalInterface = "ens3"; - internalInterfaces = [ "wg0" ]; - }; - - firewall.allowedUDPPorts = [ config.networking.wireguard.interfaces.wg0.listenPort ]; - - wireguard.interfaces.wg0 = { - ips = [ "10.127.1.1/24" "fd70:81ca:0f8f:1::1/64" ]; - listenPort = 51820; - privateKeyFile = config.age.secrets.wireguard-hub.path; - peers = [ - { - name = "shaw"; - publicKey = "eD79pROC2zjhKz4tGRS43O95gcFRqO+SFb2XDnTr0zc="; - allowedIPs = [ "10.127.1.2" "fd70:81ca:0f8f:1::2" ]; - } - { - name = "tohru"; - publicKey = "lk3PCQM1jmZoI8sM/rWSyKNuZOUnjox3n9L9geJD+18="; - allowedIPs = [ "10.127.1.3" "fd70:81ca:0f8f:1::3" ]; - } - ]; - }; + birdsong.peer = { + enable = true; + privateKeyFile = config.age.secrets.wireguard-hub.path; }; } diff --git a/hosts/tohru/wireguard.nix b/hosts/tohru/wireguard.nix index bca2cd6..eb7d6d2 100644 --- a/hosts/tohru/wireguard.nix +++ b/hosts/tohru/wireguard.nix @@ -6,10 +6,6 @@ birdsong.peer = { enable = true; privateKeyFile = config.age.secrets.wireguard-peer-tohru.path; - listenPort = 51821; persistentKeepalive = 23; }; - - # TODO: get this from a list of peers, keyed on hostname - networking.wireguard.interfaces.birdsong.ips = [ "10.127.1.3/24" "fd70:81ca:0f8f:1::3/64" ]; } diff --git a/hosts/yevaud/configuration.nix b/hosts/yevaud/configuration.nix index 7abce5a..4fc10f9 100644 --- a/hosts/yevaud/configuration.nix +++ b/hosts/yevaud/configuration.nix @@ -9,6 +9,13 @@ boot.loader.systemd-boot.enable = true; boot.loader.efi.canTouchEfiVariables = true; + age.secrets.wireguard-peer-yevaud.file = ../../secrets/wireguard-peer-yevaud.age; + + birdsong.peer = { + enable = true; + privateKeyFile = config.age.secrets.wireguard-peer-yevaud.path; + }; + qenya.services.forgejo = { enable = true; domain = "git.qenya.tel"; diff --git a/services/birdsong/default.nix b/services/birdsong/default.nix index 4e37405..3a42299 100644 --- a/services/birdsong/default.nix +++ b/services/birdsong/default.nix @@ -1,5 +1,6 @@ { imports = [ ./peer.nix + ./hosts.nix ]; } \ No newline at end of file diff --git a/services/birdsong/hosts.nix b/services/birdsong/hosts.nix new file mode 100644 index 0000000..47b45cf --- /dev/null +++ b/services/birdsong/hosts.nix @@ -0,0 +1,134 @@ +{ config, lib, pkgs, ... }: + +with lib; +{ + options.birdsong.hosts = mkOption { + description = "List of hosts in the birdsong network"; + type = types.attrsOf + (types.submodule { + options = { + hostKey = mkOption { + default = null; + description = "SSH public key of the host, for use in known_hosts files"; + type = with types; nullOr str; + }; + subnet = mkOption { + default = "internet"; + example = "roaming"; + description = '' + Identifier representing a LAN the host belongs to. Hosts in the + same LAN will peer with each other. + + The special value `internet` (the default) will accept peering + from all other hosts. This is to be used for servers that are + accessible from the public internet. + + The special value `roaming` will not peer with other `roaming` + hosts, but will still peer with `internet` hosts. This is to be + used for portable devices like laptops that regularly move between + networks. + ''; + type = types.str; + }; + endpoint = mkOption { + default = null; + example = "example.com"; + description = '' + Address (e.g. IP or domain name) by which the host is reachable + within its LAN. + + If {option}`birdsong.hosts..subnet` is set to `internet`, + the host must be reachable at this address from the public + internet. + + If {option}`birdsong.hosts..subnet` is set to `roaming`, + this option is not used. + ''; + type = with types; nullOr str; + }; + ipv4 = mkOption { + example = "10.127.1.1"; + description = "IPv4 address of this peer within the network"; + type = types.str; + }; + ipv6 = mkOption { + example = "fd70:81ca:0f8f:1::1"; + description = "IPv6 address of this peer within the network"; + type = types.str; + }; + port = mkOption { + default = 51820; + example = 51821; + description = '' + Which port to expose WireGuard on. Change this for peers behind + NAT, to a port not used by another peer in the same LAN. + ''; + type = types.port; + }; + wireguardKey = mkOption { + example = "xTIBA5rboUvnH4htodjb6e697QjLERt1NAB4mZqp8Dg="; + description = "WireGuard public key for this peer, as generated by `wg pubkey`"; + type = types.str; + }; + isRouter = mkOption { + default = false; + description = '' + The host with this flag set is the subnet router. It forwards + packets between WireGuard peers that can't connect directly to + each other. WireGuard's scope doesn't (yet) include full mesh + networking with load-balancing between routers, so only one peer + can hold this status. It should be peered with all other hosts + (i.e., {option}`birdsong.hosts..subnet` set to `internet`). + ''; + type = types.bool; + }; + }; + }); + }; + + config.birdsong.hosts = { + yevaud = { + hostKey = "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAICHUAgyQhl390yUObLUI+jEbuNrZ2U6+8px628DolD+T root@yevaud"; + endpoint = "yevaud.birdsong.network"; + ipv4 = "10.127.1.1"; + ipv6 = "fd70:81ca:0f8f:1::1"; + wireguardKey = "YPJsIs9x4wuWdFi/QRWSJbWvKE0GQAfVL4MNMqHygDw="; + isRouter = true; + }; + + orm = { + hostKey = "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGc9rkcdOVWozBFj3kLVnSyUQQbyyH+UG+bLawanQkRQ root@orm"; + endpoint = "orm.birdsong.network"; + ipv4 = "10.127.1.2"; + ipv6 = "fd70:81ca:0f8f:1::2"; + wireguardKey = "birdLVh8roeZpcVo308Ums4l/aibhAxbi7MBsglkJyA="; + }; + + tohru = { + hostKey = "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIOk8wuGzF0Y7SaH9aimo3SmCz99MTQwL+rEVhx0jsueU root@tohru"; + subnet = "roaming"; + ipv4 = "10.127.2.1"; + ipv6 = "fd70:81ca:0f8f:2::1"; + port = 51821; + wireguardKey = "lk3PCQM1jmZoI8sM/rWSyKNuZOUnjox3n9L9geJD+18="; + }; + + # kilgharrah = { + # # hostKey = ""; + # subnet = "weyrhold"; + # endpoint = "192.168.2.1"; + # ipv4 = "10.127.3.1"; + # ipv6 = "fd70:81ca:0f8f:3::1"; + # # wireguardKey = ""; + # }; + + shaw = { + hostKey = "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIOMC0AomCZZiUV/BCpImiV4p/vGvFaz5QNc+fJLXmS5p root@shaw"; + subnet = "library"; + # endpoint = ""; + ipv4 = "10.127.4.1"; + ipv6 = "fd70:81ca:0f8f:4::1"; + wireguardKey = "eD79pROC2zjhKz4tGRS43O95gcFRqO+SFb2XDnTr0zc="; + }; + }; +} diff --git a/services/birdsong/peer.nix b/services/birdsong/peer.nix index 706310c..d1b659b 100644 --- a/services/birdsong/peer.nix +++ b/services/birdsong/peer.nix @@ -3,12 +3,25 @@ with lib; let cfg = config.birdsong.peer; + hostName = if null != cfg.hostName then cfg.hostName else config.networking.hostName; + hosts = config.birdsong.hosts; + host = hosts.${hostName}; in { options.birdsong.peer = { enable = mkEnableOption "WireGuard peering with the birdsong network"; + hostName = mkOption { + default = null; + description = '' + The hostname of this peer within the network. Must be listed in + {option}`birdsong.hosts`. If not set, defaults to + {option}`networking.hostName`. + ''; + type = with types; nullOr str; + }; interface = mkOption { default = "birdsong"; + example = "wg0"; description = "The name of the network interface to use for WireGuard."; type = types.str; }; @@ -21,40 +34,57 @@ in description = "Path to the private key for this peer, as generated by `wg genkey`."; type = types.path; }; - listenPort = mkOption { - default = 51820; - example = 51821; - description = "Which port to expose WireGuard on. Change this if you are behind NAT, to a port not used by another peer in the same LAN."; - type = types.port; - }; persistentKeepalive = mkOption { default = null; example = 23; - description = "Constantly ping the hub this often, in seconds, in order to keep the WireGuard tunnel open. Set this if you are behind NAT to keep the NAT session active. To avoid syncing, this should ideally be a prime number that is not shared by another peer in the same LAN."; - type = types.nullOr types.int; + description = '' + Constantly ping each peer outside the LAN this often, in seconds, in + order to keep the WireGuard tunnel open. Set this if you are behind NAT + to keep the NAT session active, or if you have a dynamic IP to keep the + other peers aware when your IP changes. To avoid syncing, this should + ideally be a prime number that is not shared by another peer in the same + LAN. + ''; + type = with types; nullOr int; }; }; config = mkIf cfg.enable { - assertions = [{ - assertion = cfg.privateKeyFile != null; - message = "birdsong.peer.privateKeyFile must be set"; - }]; + assertions = [ + { + assertion = cfg ? privateKeyFile; + message = "birdsong.peer.privateKeyFile must be set"; + } + { + assertion = hostName != null; + message = "birdsong.peer.hostName or networking.hostName must be set"; + } + ]; networking = { - firewall.allowedUDPPorts = mkIf cfg.openPorts [ cfg.listenPort ]; + firewall.allowedUDPPorts = mkIf cfg.openPorts [ host.port ]; wireguard.interfaces.${cfg.interface} = { - listenPort = cfg.listenPort; + ips = [ "${host.ipv4}/16" "${host.ipv6}/48" ] + ++ optionals host.isRouter [ "10.127.0.0/16" "fd70:81ca:0f8f::/48" ]; privateKeyFile = cfg.privateKeyFile; - peers = [ - { - publicKey = "birdLVh8roeZpcVo308Ums4l/aibhAxbi7MBsglkJyA="; - allowedIPs = [ "10.127.1.0/24" "fd70:81ca:0f8f:1::/64" ]; - endpoint = "birdsong.network:51820"; - persistentKeepalive = cfg.persistentKeepalive; - } - ]; + listenPort = host.port; + + peers = + let + canDirectPeer = host: peer: peer.subnet == "internet" || (host.subnet != "roaming" && peer.subnet == host.subnet); + in + mapAttrsToList + (name: peer: { + name = name; + publicKey = peer.wireguardKey; + allowedIPs = [ peer.ipv4 peer.ipv6 ] + ++ optionals peer.isRouter [ "10.127.0.0/16" "fd70:81ca:0f8f::/48" ]; + endpoint = mkIf (canDirectPeer host peer) "${peer.endpoint}:${toString peer.port}"; + dynamicEndpointRefreshSeconds = mkIf (canDirectPeer host peer) 5; + persistentKeepalive = mkIf (peer.subnet != host.subnet) cfg.persistentKeepalive; + }) + (filterAttrs (name: peer: peer != host && (host.subnet == "internet" || canDirectPeer host peer)) hosts); }; }; };