mirror of https://github.com/coredns/coredns.git synced 2025-10-31 10:13:14 -04:00

Files

Yong Tang 180a6709a8 Fix readme test by removing extra ~ (#3850 )

This PR removing extra `~` as it was causing test failure:
```
--- FAIL: TestReadme (0.05s)
476    readme_test.go:81: Failed to start server with ../plugin/dns64/README.md, for input "Corefile:6 - Error during parsing: Unknown directive 'Or'":
477        . {
478            dns64 64:1337::/96
479        }
480        ~~~~
481
482        Or
483        . {
484            dns64 {
485                prefix 64:1337::/96
486            }
487        }
488FAIL
```

Signed-off-by: Yong Tang <yong.tang.github@outlook.com>

2020-04-23 21:03:15 -04:00

dns64_test.go

Add dns64 plugin (#3534 )

2020-03-26 08:42:23 +01:00

dns64.go

Add dns64 plugin (#3534 )

2020-03-26 08:42:23 +01:00

metrics.go

Update more metrics names (#3799 )

2020-03-31 20:03:18 +02:00

README.md

Fix readme test by removing extra ~ (#3850 )

2020-04-23 21:03:15 -04:00

setup_test.go

Add dns64 plugin (#3534 )

2020-03-26 08:42:23 +01:00

setup.go

Update more metrics names (#3799 )

2020-03-31 20:03:18 +02:00

README.md

dns64

Name

dns64 - enables DNS64 IPv6 transition mechanism.

Description

The dns64 plugin will when asked for a domain's AAAA records, but only finds A records, synthesizes the AAAA records from the A records.

The synthesis is only performed if the query came in via IPv6.

This translation is for IPv6-only networks that have NAT64.

Syntax

dns64 [PREFIX]

PREFIX defines a custom prefix instead of the default 64:ff9b::/96.

Or use this slightly longer form with more options:

dns64 [PREFIX] {
    [translate_all]
    prefix PREFIX
}

prefix specifies any local IPv6 prefix to use, instead of the well known prefix (64:ff9b::/96)
translate_all translates all queries, including responses that have AAAA results.

Examples

Translate with the default well known prefix. Applies to all queries (if they came in over IPv6).

. {
    dns64
}

Use a custom prefix.

. {
    dns64 64:1337::/96
}

. {
    dns64 {
        prefix 64:1337::/96
    }
}

Enable translation even if an existing AAAA record is present.

. {
    dns64 {
        translate_all
    }
}

Metrics

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

coredns_dns64_requests_translated_total{server} - counter of DNS requests translated

The server label is explained in the prometheus plugin documentation.

Bugs

Not all features required by DNS64 are implemented, only basic AAAA synthesis.

Support "mapping of separate IPv4 ranges to separate IPv6 prefixes"
Resolve PTR records
Follow CNAME records
Make resolver DNSSEC aware. See: RFC 6147 Section 3

Also See

See RFC 6147 for more information on the DNS64 mechanism.