docs: improved documentation

This commit is contained in:
Simon Cornet 2026-05-06 17:01:40 +02:00
commit 07dd7354d9

View file

@ -27,13 +27,33 @@ unbound_zones:
- zone: "internal.example.com" - zone: "internal.example.com"
type: "static" type: "static"
records: records:
# A records (default type)
- name: "server1.internal.example.com" - name: "server1.internal.example.com"
value: "10.0.1.10" value: "10.0.1.10"
# AAAA record
- name: "server2.internal.example.com" - name: "server2.internal.example.com"
value: "10.0.1.11" type: "AAAA"
value: "2001:db8::1"
# CNAME record
- name: "internal.example.com"
type: "CNAME"
value: "server1.internal.example.com"
# MX record
- name: "internal.example.com"
type: "MX"
priority: 10
value: "mail.internal.example.com"
# TXT record
- name: "internal.example.com" - name: "internal.example.com"
type: "TXT" type: "TXT"
value: "v=spf1 include:internal.example.com ~all" value: "v=spf1 include:internal.example.com ~all"
# SRV record
- name: "_sip._tcp.internal.example.com" - name: "_sip._tcp.internal.example.com"
type: "SRV" type: "SRV"
priority: 10 priority: 10
@ -53,3 +73,22 @@ unbound_zones:
| `TXT` | `name`, `value`, `type` | Text record | | `TXT` | `name`, `value`, `type` | Text record |
| `SRV` | `name`, `value`, `type`, `priority`, `weight`, `port` | Service locator | | `SRV` | `name`, `value`, `type`, `priority`, `weight`, `port` | Service locator |
| `PTR` | `name`, `value`, `type` | Pointer record | | `PTR` | `name`, `value`, `type` | Pointer record |
## Reverse DNS
Reverse DNS (PTR) records are **automatically generated** for IPv4 A records in the following networks:
- `192.168.x.x/16`
- `10.8.x.x/16`
- `10.0.x.x/16`
**IPv6 reverse DNS is not auto-generated.** Use manual PTR records in a dedicated zone instead:
```yaml
- zone: "8.b.d.0.1.0.0.2.ip6.arpa"
type: "static"
records:
- name: "1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.b.d.0.1.0.0.2.ip6.arpa"
type: "PTR"
value: "server1.internal.example.com"
```