Pull request: markup
Merge in DNS/adguard-home-wiki from markup to master Squashed commit of the following: commit 8f18657b46084130eb7d129d57339d0ec7cd5888 Author: Ainar Garipov <A.Garipov@AdGuard.COM> Date: Tue Sep 6 15:11:57 2022 +0300 all: enable adblock markup
parent
7aadbbfcbb
commit
150f60760b
|
@ -101,7 +101,7 @@ On Windows, run `cmd.exe` or PowerShell with admin privileges and run
|
|||
When you run AdGuard Home for the first time, it starts listening to
|
||||
`0.0.0.0:3000` and prompts you to open it in your browser:
|
||||
|
||||
```
|
||||
```none
|
||||
AdGuard Home is available on the following addresses:
|
||||
Go to http://127.0.0.1:3000
|
||||
Go to http://X.X.X.X:3000
|
||||
|
@ -292,7 +292,7 @@ using your Linux distribution's package manager.
|
|||
To allow AdGuard Home running on Linux to listen on port 53 without superuser
|
||||
privileges and bind its DNS servers to a particular interface run:
|
||||
|
||||
```bash
|
||||
```sh
|
||||
sudo setcap 'CAP_NET_BIND_SERVICE=+eip CAP_NET_RAW=+eip' ./AdGuardHome
|
||||
```
|
||||
|
||||
|
|
|
@ -76,7 +76,7 @@ work. -->
|
|||
Using the unspecified IP address (`0.0.0.0`) or a local address (`127.0.0.1`
|
||||
and alike) for a host is basically the same as blocking that host.
|
||||
|
||||
```none
|
||||
```adblock
|
||||
# Returns the IP address 1.2.3.4 for example.org.
|
||||
1.2.3.4 example.org
|
||||
# Blocks example.com by responding with 0.0.0.0.
|
||||
|
@ -161,7 +161,7 @@ rules and used to describe what a rule does.
|
|||
|
||||
Example:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
! This is a comment.
|
||||
# This is also a comment.
|
||||
```
|
||||
|
@ -180,7 +180,7 @@ example.org` rule.
|
|||
|
||||
Examples:
|
||||
|
||||
* ```none
|
||||
* ```adblock
|
||||
||example.org^$important
|
||||
```
|
||||
|
||||
|
@ -191,7 +191,7 @@ Examples:
|
|||
* You may want to use multiple modifiers in a rule. Separate them by commas
|
||||
in this case:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
||example.org^$client=127.0.0.1,dnstype=A
|
||||
```
|
||||
|
||||
|
@ -224,14 +224,14 @@ are two main ways to identify a client:
|
|||
|
||||
The syntax is:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
$client=value1|value2|...
|
||||
```
|
||||
|
||||
You can also exclude clients by adding a `~` character before the value. In
|
||||
this case, the rule is not be applied to this client's DNS requests.
|
||||
|
||||
```none
|
||||
```adblock
|
||||
$client=~value1
|
||||
```
|
||||
|
||||
|
@ -270,7 +270,7 @@ To add multiple domains to one rule, use the `|` character as a separator.
|
|||
|
||||
The syntax is:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
$denyallow=domain1|domain2|...
|
||||
```
|
||||
|
||||
|
@ -279,7 +279,7 @@ blocking rule covers too many domains. You may want to block everything save
|
|||
for a couple of TLD domains. You could use the standard approach, i.e. rules
|
||||
like this:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
! Block everything.
|
||||
/.*/
|
||||
|
||||
|
@ -292,7 +292,7 @@ The problem with this approach is that this way you will also unblock tracking
|
|||
domains that are located on those TLDs (i.e. `google-analytics.com`). Here's
|
||||
how to solve this with `denyallow`:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
*$denyallow=com|net
|
||||
```
|
||||
|
||||
|
@ -314,7 +314,7 @@ this rule will be triggered.
|
|||
|
||||
The syntax is:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
$dnstype=value1|value2|...
|
||||
$dnstype=~value1|~value2|~...
|
||||
```
|
||||
|
@ -324,13 +324,13 @@ actual DNS resource record (RR) types.
|
|||
|
||||
Do not combine exclusion rules with inclusion ones. This:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
$dnstype=~value1|value2
|
||||
```
|
||||
|
||||
is equivalent to this:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
$dnstype=value2
|
||||
```
|
||||
|
||||
|
@ -348,7 +348,7 @@ record itself. That caused issues, since that meant that you could not write
|
|||
rules that would allow certain `CNAME` records in responses in `A` and `AAAA`
|
||||
requests. In **v0.108.0** that behaviour was changed, so now this:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
||canon.example.com^$dnstype=~CNAME
|
||||
```
|
||||
|
||||
|
@ -374,7 +374,7 @@ response modifier have higher priority than other rules in AdGuard Home.
|
|||
|
||||
The shorthand syntax is:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
$dnsrewrite=1.2.3.4
|
||||
$dnsrewrite=abcd::1234
|
||||
$dnsrewrite=example.net
|
||||
|
@ -392,7 +392,7 @@ supported.
|
|||
|
||||
The full syntax is of the form `RCODE;RRTYPE;VALUE`:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
$dnsrewrite=NOERROR;A;1.2.3.4
|
||||
$dnsrewrite=NOERROR;AAAA;abcd::1234
|
||||
$dnsrewrite=NOERROR;CNAME;example.net
|
||||
|
@ -406,7 +406,7 @@ The `CNAME` one is special because AdGuard Home will resolve the host and add
|
|||
its info to the response. That is, if `example.net` has IP `1.2.3.4`, and the
|
||||
user has this in their filter rules:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
||example.com^$dnsrewrite=example.net
|
||||
! Or:
|
||||
||example.com^$dnsrewrite=NOERROR;CNAME;example.net
|
||||
|
@ -431,7 +431,7 @@ Address: 1.2.3.4
|
|||
Next, the `CNAME` rewrite. After that, all other records' values are summed as
|
||||
one response, so this:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
||example.com^$dnsrewrite=NOERROR;A;1.2.3.4
|
||||
||example.com^$dnsrewrite=NOERROR;A;1.2.3.5
|
||||
```
|
||||
|
@ -508,7 +508,7 @@ Examples:
|
|||
|
||||
* In this example:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
||example.org^$important
|
||||
@@||example.org^
|
||||
```
|
||||
|
@ -518,7 +518,7 @@ Examples:
|
|||
|
||||
* In this example:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
||example.org^$important
|
||||
@@||example.org^$important
|
||||
```
|
||||
|
@ -546,14 +546,14 @@ client.
|
|||
|
||||
The syntax is:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
$ctag=value1|value2|...
|
||||
```
|
||||
|
||||
If one of client's tags matches the `ctag` values, this rule applies to the
|
||||
client. The syntax for exclusion is:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
$ctag=~value1|~value2|...
|
||||
```
|
||||
|
||||
|
@ -626,7 +626,7 @@ spellings, shorter hostnames, or generic hostnames (for example, `localhost`).
|
|||
|
||||
Example:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
# This is a comment
|
||||
127.0.0.1 example.org example.info
|
||||
127.0.0.1 example.com
|
||||
|
@ -643,7 +643,7 @@ A simple list of domain names, one name per line.
|
|||
|
||||
Example:
|
||||
|
||||
```none
|
||||
```adblock
|
||||
# This is a comment
|
||||
example.com
|
||||
example.org
|
||||
|
|
Loading…
Reference in New Issue