/ip/dns/static

官方原文约 10 分钟阅读

当前显示英文原文，切换到「中文」可查看译文。

static

Static DNS entries. The router answers queries for these names itself, without asking an upstream server, and applies them also to the targets of CNAME answers from upstream. For a name with a static entry, queries...

ip/dns/static

Type: Directory

Static DNS entries. The router answers queries for these names itself, without asking an upstream server, and applies them also to the targets of CNAME answers from upstream. For a name with a static entry, queries for other record types go to the upstream server, and the router passes the answer on; when the upstream server has no such record, the router answers NOERROR with no records. Create only one entry that matches a given name and record type: when several entries match, the list order does not decide which one answers. For examples, see DNS.

Flag	Name	Description
`D`	dynamic	The entry was added by another service, not by a user.
`X`	disabled	The entry is disabled and the router ignores it. New entries are enabled.

Argument	Type	Description
`name`	string	Domain name of the entry. The router converts query names to lower case before matching, so the match is case-insensitive.
`regexp`	string	Regular expression the query name is matched against, instead of `name`. The router matches it against the name in lower case, so write the expression in lower case: an expression with capital letters never matches. The router creates no PTR record for regular expression entries. Do not let a regular expression overlap with other entries for the same names: the list order does not decide which of several matching entries answers. On the command line, write a backslash as `\\` and a `$` as `\$`; for example, `regexp="^host[0-9]+\\.example\\.com\$"` is stored as `^host[0-9]+\.example\.com$`. Check the stored value with `print`.
`type`	enum (NXDOMAIN \| A \| NS \| CNAME \| MX \| TXT \| AAAA \| SRV \| FWD) { NXDOMAIN:65281, A:1, NS:2, CNAME:5, MX:15, TXT:16, AAAA:28, SRV:33, FWD:65280 }	Type of the entry. - `A` (default) - IPv4 address in `address`. - `AAAA` - IPv6 address in `address`. - `CNAME` - Alias of the name in `cname`. The router answers with the CNAME record and the records of the target, from static entries or from upstream. - `FWD` - Forward queries for the name to the server in `forward-to` instead of the upstream servers. - `MX` - Mail server in `mx-exchange` with `mx-preference`. - `NS` - Name server in `ns`. - `NXDOMAIN` - Answer NXDOMAIN (the name does not exist) for every record type. - `SRV` - Service location in `srv-target`, `srv-port`, `srv-priority` and `srv-weight`. - `TXT` - Text in `text`.
`forward-to`	alt { forwarder: enum , ip: ipAddr , ipv6: ip6Addr , host: string }	Where the router forwards queries of a `FWD` entry: an IPv4 or IPv6 address or a DNS name of a server, or the name of a forwarder in `/ip/dns/forwarders`. Without `forward-to`, the query goes to the normal servers (`servers`, `dynamic-servers` or the DoH server), and the name is exempt from adlists. When the server does not answer within `query-total-timeout`, the client gets a SERVFAIL answer.
`address`	alt { ip: ipAddr , ipv6: ip6Addr }	IPv4 address of an `A` entry or IPv6 address of an `AAAA` entry. For entries with `name`, the router also answers reverse (PTR) queries for the address.
`mx-preference`	num	Preference of the mail server of an `MX` entry; lower values are preferred.
`mx-exchange`	string	Host name of the mail server of an `MX` entry.
`cname`	string	Target name of a `CNAME` entry.
`text`	string	Text of a `TXT` entry.
`ns`	string	Host name of the name server of an `NS` entry.
`srv-priority`	num	Priority of an `SRV` entry; lower values are preferred.
`srv-weight`	num	Weight of an `SRV` entry among entries with the same priority.
`srv-port`	num	TCP or UDP port of the service of an `SRV` entry.
`srv-target`	string	Host name that provides the service of an `SRV` entry.
`ttl`	time	Time to live in the answers for this entry. `cache-max-ttl` in `/ip/dns` does not shorten it. Default: 1d.
`match-subdomain`	bool	Whether the entry also matches every name below `name`, at any depth. With `yes`, an entry for `example.com` also answers `www.example.com` and `a.b.example.com`. Default: no.
`address-list`	string	Firewall address list the router adds the answered addresses to, as dynamic entries with the comment `created for <name>.`. For a `FWD` entry, these are the addresses in the upstream answer. The router removes an entry when the TTL of the answer and `address-list-extra-time` in `/ip/dns` have passed.