40 lines
1.3 KiB
Markdown
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.
|