Files
2026-06-26 16:07:47 -04:00

40 lines
1.3 KiB
Markdown

# modules/nixos/server/dns/routing/
Local DNS resolver backed by **dnsmasq**. Serves static domain→IP mappings for the homelab
and forwards everything else upstream.
## Files
```
routing/
└── default.nix # skyg.server.dns.routing.*
```
## Behaviour
- Each `addresses` entry `{ domain, ip }` produces **both** an exact (`/domain/ip`) and a
wildcard (`/.domain/ip`) dnsmasq `address=` line.
- `addressesSecretName` points at an agenix secret (`secrets/<name>.age`) whose decrypted
contents are a dnsmasq fragment, included via `conf-file` — used for records that should
not live in the public repo.
- `upstreamServers` (default `1.1.1.1`, `1.0.0.1`) handle unresolved queries.
- `listenAddresses` (empty = all interfaces) and `openFirewall` (port 53 UDP/TCP) control
exposure.
## Option Namespace
```
skyg.server.dns.routing.enable
skyg.server.dns.routing.addresses # [{ domain, ip }]
skyg.server.dns.routing.addressesSecretName # agenix secret name, or null
skyg.server.dns.routing.upstreamServers
skyg.server.dns.routing.listenAddresses
skyg.server.dns.routing.openFirewall
```
## Conventions
- Put private/sensitive records in the agenix secret, not in `addresses`.
- The `age.secrets` reference resolves relative to the repo `secrets/` directory — manage
that file with `skyg secrets`, never by hand.