Scroll to navigation

COREDNS-SIIT(7) CoreDNS Plugins COREDNS-SIIT(7)

NAME

siit - enables AAAA->A translation support for DNS records based on SIIT (IPv6->IPv4 translation).

DESCRIPTION

The siit plugin will when asked for a domain's A record, synthesizes it from a corresponding AAAA record if it belongs to a certain IP range.

It also supports arbitrary mapping IPv6->IPv4.

It is useful when published services are IPv6-only and emit their AAAA record accordingly but IPv4 clients reach them through a siit routing. This plugin generates the associated A records for these clients automatically.

SYNTAX

siit {

ipv6_prefix IPV6PREFIX
eam IPV4 IPV6 }

  • ipv6_prefix specifies any local IPv6 prefix to use, instead of the well known prefix (64:ff9b::/96)
  • eam translates the ipv6 to the corresponding ipv4, it can be set multiple times

EXAMPLES

. {

siit {
ipv6_prefix 64:1337::/96
} }

METRICS

If monitoring is enabled (via the prometheus plugin) then the following metrics are exported:

•
coredns_siit_requests_translated_total{server} - counter of DNS requests translated

The server label is explained in the prometheus plugin documentation.

BUGS

  • Prefix matching in eam is not implemented yet.
  • DNSSEC support is not implemented yet. The problem is the same as DNS64. See: RFC 6147 Section 3 ⟨https://www.rfc-editor.org/info/rfc6147/#section-3⟩

SEE ALSO

See RFC 6052 ⟨https://www.rfc-editor.org/info/rfc6052/⟩ for more information on the SIIT mechanism and RFC 7757 ⟨https://www.rfc-editor.org/info/rfc7757/⟩ about the explicit address mappings (eam) mechanism

NOTES

This plugin is heavily based on dns64 plugin ⟨../dns64⟩.

October 2026 CoreDNS