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
|
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:
|
`0.0.0.0:3000` and prompts you to open it in your browser:
|
||||||
|
|
||||||
```
|
```none
|
||||||
AdGuard Home is available on the following addresses:
|
AdGuard Home is available on the following addresses:
|
||||||
Go to http://127.0.0.1:3000
|
Go to http://127.0.0.1:3000
|
||||||
Go to http://X.X.X.X: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
|
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:
|
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
|
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`
|
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.
|
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.
|
# Returns the IP address 1.2.3.4 for example.org.
|
||||||
1.2.3.4 example.org
|
1.2.3.4 example.org
|
||||||
# Blocks example.com by responding with 0.0.0.0.
|
# Blocks example.com by responding with 0.0.0.0.
|
||||||
|
@ -161,7 +161,7 @@ rules and used to describe what a rule does.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
! This is a comment.
|
! This is a comment.
|
||||||
# This is also a comment.
|
# This is also a comment.
|
||||||
```
|
```
|
||||||
|
@ -180,7 +180,7 @@ example.org` rule.
|
||||||
|
|
||||||
Examples:
|
Examples:
|
||||||
|
|
||||||
* ```none
|
* ```adblock
|
||||||
||example.org^$important
|
||example.org^$important
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -191,7 +191,7 @@ Examples:
|
||||||
* You may want to use multiple modifiers in a rule. Separate them by commas
|
* You may want to use multiple modifiers in a rule. Separate them by commas
|
||||||
in this case:
|
in this case:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
||example.org^$client=127.0.0.1,dnstype=A
|
||example.org^$client=127.0.0.1,dnstype=A
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -224,14 +224,14 @@ are two main ways to identify a client:
|
||||||
|
|
||||||
The syntax is:
|
The syntax is:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
$client=value1|value2|...
|
$client=value1|value2|...
|
||||||
```
|
```
|
||||||
|
|
||||||
You can also exclude clients by adding a `~` character before the value. In
|
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.
|
this case, the rule is not be applied to this client's DNS requests.
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
$client=~value1
|
$client=~value1
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -270,7 +270,7 @@ To add multiple domains to one rule, use the `|` character as a separator.
|
||||||
|
|
||||||
The syntax is:
|
The syntax is:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
$denyallow=domain1|domain2|...
|
$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
|
for a couple of TLD domains. You could use the standard approach, i.e. rules
|
||||||
like this:
|
like this:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
! Block everything.
|
! 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
|
domains that are located on those TLDs (i.e. `google-analytics.com`). Here's
|
||||||
how to solve this with `denyallow`:
|
how to solve this with `denyallow`:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
*$denyallow=com|net
|
*$denyallow=com|net
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -314,7 +314,7 @@ this rule will be triggered.
|
||||||
|
|
||||||
The syntax is:
|
The syntax is:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
$dnstype=value1|value2|...
|
$dnstype=value1|value2|...
|
||||||
$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:
|
Do not combine exclusion rules with inclusion ones. This:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
$dnstype=~value1|value2
|
$dnstype=~value1|value2
|
||||||
```
|
```
|
||||||
|
|
||||||
is equivalent to this:
|
is equivalent to this:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
$dnstype=value2
|
$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`
|
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:
|
requests. In **v0.108.0** that behaviour was changed, so now this:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
||canon.example.com^$dnstype=~CNAME
|
||canon.example.com^$dnstype=~CNAME
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -374,7 +374,7 @@ response modifier have higher priority than other rules in AdGuard Home.
|
||||||
|
|
||||||
The shorthand syntax is:
|
The shorthand syntax is:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
$dnsrewrite=1.2.3.4
|
$dnsrewrite=1.2.3.4
|
||||||
$dnsrewrite=abcd::1234
|
$dnsrewrite=abcd::1234
|
||||||
$dnsrewrite=example.net
|
$dnsrewrite=example.net
|
||||||
|
@ -392,7 +392,7 @@ supported.
|
||||||
|
|
||||||
The full syntax is of the form `RCODE;RRTYPE;VALUE`:
|
The full syntax is of the form `RCODE;RRTYPE;VALUE`:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
$dnsrewrite=NOERROR;A;1.2.3.4
|
$dnsrewrite=NOERROR;A;1.2.3.4
|
||||||
$dnsrewrite=NOERROR;AAAA;abcd::1234
|
$dnsrewrite=NOERROR;AAAA;abcd::1234
|
||||||
$dnsrewrite=NOERROR;CNAME;example.net
|
$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
|
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:
|
user has this in their filter rules:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
||example.com^$dnsrewrite=example.net
|
||example.com^$dnsrewrite=example.net
|
||||||
! Or:
|
! Or:
|
||||||
||example.com^$dnsrewrite=NOERROR;CNAME;example.net
|
||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
|
Next, the `CNAME` rewrite. After that, all other records' values are summed as
|
||||||
one response, so this:
|
one response, so this:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
||example.com^$dnsrewrite=NOERROR;A;1.2.3.4
|
||example.com^$dnsrewrite=NOERROR;A;1.2.3.4
|
||||||
||example.com^$dnsrewrite=NOERROR;A;1.2.3.5
|
||example.com^$dnsrewrite=NOERROR;A;1.2.3.5
|
||||||
```
|
```
|
||||||
|
@ -508,7 +508,7 @@ Examples:
|
||||||
|
|
||||||
* In this example:
|
* In this example:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
||example.org^$important
|
||example.org^$important
|
||||||
@@||example.org^
|
@@||example.org^
|
||||||
```
|
```
|
||||||
|
@ -518,7 +518,7 @@ Examples:
|
||||||
|
|
||||||
* In this example:
|
* In this example:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
||example.org^$important
|
||example.org^$important
|
||||||
@@||example.org^$important
|
@@||example.org^$important
|
||||||
```
|
```
|
||||||
|
@ -546,14 +546,14 @@ client.
|
||||||
|
|
||||||
The syntax is:
|
The syntax is:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
$ctag=value1|value2|...
|
$ctag=value1|value2|...
|
||||||
```
|
```
|
||||||
|
|
||||||
If one of client's tags matches the `ctag` values, this rule applies to the
|
If one of client's tags matches the `ctag` values, this rule applies to the
|
||||||
client. The syntax for exclusion is:
|
client. The syntax for exclusion is:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
$ctag=~value1|~value2|...
|
$ctag=~value1|~value2|...
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -626,7 +626,7 @@ spellings, shorter hostnames, or generic hostnames (for example, `localhost`).
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
# This is a comment
|
# This is a comment
|
||||||
127.0.0.1 example.org example.info
|
127.0.0.1 example.org example.info
|
||||||
127.0.0.1 example.com
|
127.0.0.1 example.com
|
||||||
|
@ -643,7 +643,7 @@ A simple list of domain names, one name per line.
|
||||||
|
|
||||||
Example:
|
Example:
|
||||||
|
|
||||||
```none
|
```adblock
|
||||||
# This is a comment
|
# This is a comment
|
||||||
example.com
|
example.com
|
||||||
example.org
|
example.org
|
||||||
|
|
Loading…
Reference in New Issue