Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -214,3 +214,37 @@ adguard-cli config show outbound_proxy
Configuring `outbound_proxy` via URL is available starting from AdGuard for Linux v1.1.26 nightly and v1.1 stable release.

:::

## Export and import settings

The export/import functionality allows you to backup your AdGuard CLI configuration and restore it on the same or different system. This includes filters, proxy settings, and other configuration options.

### Export settings

To export current AdGuard CLI settings to a ZIP archive, use:

```sh
adguard-cli export-settings
```

You can specify the output path using the `-o` or `--output` flag. This can be either a specific file path or a directory:

```sh
# Export to a specific file
adguard-cli export-settings -o "/path/to/settings.zip"

# Export to a directory (archive will be created with a standard name)
adguard-cli export-settings -o "/path/to/directory"
```

If no output path is specified, the settings will be exported to the working directory with a standard name. After successful export, the command will display the full path where the archive was created.

### Import settings

To import AdGuard CLI settings from a ZIP archive, use:

```sh
adguard-cli import-settings -i "/path/to/settings.zip"
```

The `-i` or `--input` flag is required and specifies the path to the settings archive to import.
Original file line number Diff line number Diff line change
Expand Up @@ -23,10 +23,16 @@ AdGuard Mini for Mac is a free app present in the Mac App Store. To install it o

2. Press _Get_ → _Install_ → _Open_.

3. In the opened AdGuard Mini window, accept EULA and Privacy policy and click _Continue_.
3. In the opened AdGuard Mini window, accept EULA and Privacy policy. Here you can also choose to help us improve the extension by sending anonymized usage data. Then click _Continue_.

![Onboarding](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/first-open.png)

:::note

If you choose to share app usage data with AdGuard, the extension will collect anonymized information such as UI interactions and session identifiers. This consent is optional and can be withdrawn at any time. All collected data is fully anonymized, used only internally, and never shared with third parties.

:::

4. Click _Open settings_.

![Open settings](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/open-settings.png)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2840,18 +2840,31 @@ If multiple `$urltransform` rules match a single request, we will apply each of

**Syntax**

`$urltransform` syntax is similar to replacement with regular expressions [in Perl](http://perldoc.perl.org/perlrequick.html#Search-and-replace).
`$urltransform` value is a series of one or more transformations separated by `|`. The first transformation is applied to the input URL. Each of the following transformations is applied to the output of the previous one. The output of a failed transformation (for example, if Base64 decoding failed or if substitution found no matches) is its input, unchanged. Formally:

```text
urltransform = "/" regexp "/" replacement "/" modifiers
urltransform = transforms
transforms = transform | transform "|" transforms
transform = substitute | decode
substitute = "/" regexp "/" replacement "/" modifiers
decode = "b64" | "pct"
```

- **`regexp`** — a regular expression.
- **`replacement`** — a string that will be used to replace the string corresponding to `regexp`.
- **`modifiers`** — a regular expression flags. For example, `i` — insensitive search, or `s` — single-line mode.
- **`substitute`** is similar to replacement with regular expressions [in Perl](https://perldoc.perl.org/perlrequick.html#Search-and-replace).
- **`regexp`** — a regular expression.
- **`replacement`** — a string that replaces whatever is matched by `regexp`. `$1`, `$2`, etc. in the replacement string are replaced with the contents of the corresponding capture group.
- **`modifiers`** — regular expression flags, e.g., `i` for case-insensitive search.
- **`b64`** — decodes a [Base64-encoded](https://datatracker.ietf.org/doc/html/rfc4648) string, both the default and the URL-safe alphabets are supported.
- **`pct`** — decodes a [percent-encoded](https://datatracker.ietf.org/doc/html/rfc3986#section-2.1) string.

In the `$urltransform` value, two characters must be escaped: the comma `,` and the dollar sign `$`. Use the backslash character `\` for this. For example, an escaped comma looks like this: `\,`.

:::info Compatibility

AdGuard products that use a [CoreLibs][] version older than 1.20 only support a single `substitute` transformation for the value of the `$urltransform` modifier.

:::

**Changing the origin**

:::info Compatibility
Expand Down Expand Up @@ -4655,6 +4668,33 @@ If `pattern` is not set for `$path`, rule will apply only on the main page of we
- `[$domain=example.com,path=/page.html]##.textad` hides a `div` with the class `textad` at `page.html` of `example.com` and all subdomains but not at `another_page.html`
- `[$path=/\\/(sub1|sub2)\\/page\\.html/]##.textad` hides a `div` with the class `textad` at both `/sub1/page.html` and `/sub2/page.html` of any domain (please note the [escaped special characters](#non-basic-rules-modifiers-syntax))

#### Path-in-domain syntax {#path-in-domain-syntax}

For cosmetic rules, you can use a simplified path-in-domain syntax by specifying the path directly in the domain part of the rule instead of using the `$path` modifier.

**Syntax**

```text
rule = [targets] "##" selector
targets = [target0, target1[, ...[, targetN]]]
target = domain [path]
```

**Examples:**

- `example.org/checkout##.promo-banner` — hides `.promo-banner` elements only on checkout pages
- `news.site.com/article##.sidebar-ad` — hides sidebar ads only on article pages
- `domain1.com,example.org/path##.banner` — applies to all pages on `domain1.com` and only `/path` pages on `example.org`
- `/example\.org\/article\d+/##.ad` — hides ads on article pages with numeric IDs

Path-in-domain syntax works with all types of cosmetic rules (`##`, `#@#`, `#$#`, `$$`, `$@$`, `#%#`, `#@%#`)

:::info Compatibility

Path-in-domain syntax has been introduced in [CoreLibs][] v1.20.

:::

#### `$path` modifier limitations {#non-basic-path-modifier-limitations}

:::caution Limitations
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -214,3 +214,37 @@ adguard-cli config show outbound_proxy
Configuring `outbound_proxy` via URL is available starting from AdGuard for Linux v1.1.26 nightly and v1.1 stable release.

:::

## Export and import settings

The export/import functionality allows you to backup your AdGuard CLI configuration and restore it on the same or different system. This includes filters, proxy settings, and other configuration options.

### Export settings

To export current AdGuard CLI settings to a ZIP archive, use:

```sh
adguard-cli export-settings
```

You can specify the output path using the `-o` or `--output` flag. This can be either a specific file path or a directory:

```sh
# Export to a specific file
adguard-cli export-settings -o "/path/to/settings.zip"

# Export to a directory (archive will be created with a standard name)
adguard-cli export-settings -o "/path/to/directory"
```

If no output path is specified, the settings will be exported to the working directory with a standard name. After successful export, the command will display the full path where the archive was created.

### Import settings

To import AdGuard CLI settings from a ZIP archive, use:

```sh
adguard-cli import-settings -i "/path/to/settings.zip"
```

The `-i` or `--input` flag is required and specifies the path to the settings archive to import.
Original file line number Diff line number Diff line change
Expand Up @@ -23,10 +23,16 @@ AdGuard Mini for Mac is a free app present in the Mac App Store. To install it o

2. Press _Get_ → _Install_ → _Open_.

3. In the opened AdGuard Mini window, accept EULA and Privacy policy and click _Continue_.
3. In the opened AdGuard Mini window, accept EULA and Privacy policy. Here you can also choose to help us improve the extension by sending anonymized usage data. Then click _Continue_.

![Onboarding](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/first-open.png)

:::note

If you choose to share app usage data with AdGuard, the extension will collect anonymized information such as UI interactions and session identifiers. This consent is optional and can be withdrawn at any time. All collected data is fully anonymized, used only internally, and never shared with third parties.

:::

4. Click _Open settings_.

![Open settings](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/open-settings.png)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2840,18 +2840,31 @@ If multiple `$urltransform` rules match a single request, we will apply each of

**Syntax**

`$urltransform` syntax is similar to replacement with regular expressions [in Perl](http://perldoc.perl.org/perlrequick.html#Search-and-replace).
`$urltransform` value is a series of one or more transformations separated by `|`. The first transformation is applied to the input URL. Each of the following transformations is applied to the output of the previous one. The output of a failed transformation (for example, if Base64 decoding failed or if substitution found no matches) is its input, unchanged. Formally:

```text
urltransform = "/" regexp "/" replacement "/" modifiers
urltransform = transforms
transforms = transform | transform "|" transforms
transform = substitute | decode
substitute = "/" regexp "/" replacement "/" modifiers
decode = "b64" | "pct"
```

- **`regexp`** — a regular expression.
- **`replacement`** — a string that will be used to replace the string corresponding to `regexp`.
- **`modifiers`** — a regular expression flags. For example, `i` — insensitive search, or `s` — single-line mode.
- **`substitute`** is similar to replacement with regular expressions [in Perl](https://perldoc.perl.org/perlrequick.html#Search-and-replace).
- **`regexp`** — a regular expression.
- **`replacement`** — a string that replaces whatever is matched by `regexp`. `$1`, `$2`, etc. in the replacement string are replaced with the contents of the corresponding capture group.
- **`modifiers`** — regular expression flags, e.g., `i` for case-insensitive search.
- **`b64`** — decodes a [Base64-encoded](https://datatracker.ietf.org/doc/html/rfc4648) string, both the default and the URL-safe alphabets are supported.
- **`pct`** — decodes a [percent-encoded](https://datatracker.ietf.org/doc/html/rfc3986#section-2.1) string.

In the `$urltransform` value, two characters must be escaped: the comma `,` and the dollar sign `$`. Use the backslash character `\` for this. For example, an escaped comma looks like this: `\,`.

:::info Compatibility

AdGuard products that use a [CoreLibs][] version older than 1.20 only support a single `substitute` transformation for the value of the `$urltransform` modifier.

:::

**Changing the origin**

:::info Compatibility
Expand Down Expand Up @@ -4655,6 +4668,33 @@ If `pattern` is not set for `$path`, rule will apply only on the main page of we
- `[$domain=example.com,path=/page.html]##.textad` hides a `div` with the class `textad` at `page.html` of `example.com` and all subdomains but not at `another_page.html`
- `[$path=/\\/(sub1|sub2)\\/page\\.html/]##.textad` hides a `div` with the class `textad` at both `/sub1/page.html` and `/sub2/page.html` of any domain (please note the [escaped special characters](#non-basic-rules-modifiers-syntax))

#### Path-in-domain syntax {#path-in-domain-syntax}

For cosmetic rules, you can use a simplified path-in-domain syntax by specifying the path directly in the domain part of the rule instead of using the `$path` modifier.

**Syntax**

```text
rule = [targets] "##" selector
targets = [target0, target1[, ...[, targetN]]]
target = domain [path]
```

**Examples:**

- `example.org/checkout##.promo-banner` — hides `.promo-banner` elements only on checkout pages
- `news.site.com/article##.sidebar-ad` — hides sidebar ads only on article pages
- `domain1.com,example.org/path##.banner` — applies to all pages on `domain1.com` and only `/path` pages on `example.org`
- `/example\.org\/article\d+/##.ad` — hides ads on article pages with numeric IDs

Path-in-domain syntax works with all types of cosmetic rules (`##`, `#@#`, `#$#`, `$$`, `$@$`, `#%#`, `#@%#`)

:::info Compatibility

Path-in-domain syntax has been introduced in [CoreLibs][] v1.20.

:::

#### `$path` modifier limitations {#non-basic-path-modifier-limitations}

:::caution Limitations
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -214,3 +214,37 @@ adguard-cli config show outbound_proxy
Nastavení `outbound_proxy` přes URL je dostupné od AdGuardu pro Linux verze 1.1.26 nightly a hlavní verze 1.1.

:::

## Nastavení exportu a importu

Funkce exportu/importu vám umožňuje zálohovat konfiguraci AdGuard CLI a obnovit ji na stejném nebo jiném systému. To zahrnuje filtry, nastavení proxy a další možnosti konfigurace.

### Export nastavení

Chcete-li exportovat aktuální nastavení AdGuard CLI do archivu ZIP, použijte:

```sh
adguard-cli export-settings
```

Výstupní cestu můžete zadat pomocí příznaku `-o` nebo `--output`. Může se jednat buď o konkrétní cestu k souboru, nebo o adresář:

```sh
# Export to a specific file
adguard-cli export-settings -o "/path/to/settings.zip"

# Export to a directory (archive will be created with a standard name)
adguard-cli export-settings -o "/path/to/directory"
```

Pokud není zadána žádná výstupní cesta, nastavení se exportuje do pracovního adresáře se standardním názvem. Po úspěšném exportu příkaz zobrazí úplnou cestu, kde byl archiv vytvořen.

### Import nastavení

Chcete-li importovat nastavení AdGuard CLI ze ZIP archivu, použijte:

```sh
adguard-cli import-settings -i "/path/to/settings.zip"
```

Příznak `-i` nebo `--input` je povinný a určuje cestu k archivu nastavení, který se má importovat.
Original file line number Diff line number Diff line change
Expand Up @@ -9,40 +9,40 @@ Tento článek popisuje AdGuard pro Windows v8.0, multifunkční blokátor rekla

:::

DNS protection gives you more control over how your device connects to the Internet. There are three main reasons why it can be useful:
DNS ochrana vám poskytuje větší kontrolu nad tím, jak se vaše zařízení připojuje k internetu. Existují tři hlavní důvody, proč to může být užitečné:

## 1. Protect your privacy from your ISP
## 1. Ochrana soukromí před ISP

Pokaždé, když otevřete webovou stránku, například `google.com`, váš prohlížeč odešle požadavek na DNS server, aby na oplátku získal IP adresu webové stránky. Usually, the DNS server belongs to your ISP, which means they can track the websites you visit. If you switch to another DNS server, such as AdGuard DNS, your ISP no longer sees your online activity.
Pokaždé, když otevřete webovou stránku, například `google.com`, váš prohlížeč odešle požadavek na DNS server, aby na oplátku získal IP adresu webové stránky. Obvykle patří DNS server vašemu poskytovateli internetových služeb, což znamená, že může sledovat webové stránky, které navštěvujete. Pokud přejdete na jiný DNS server, například AdGuard DNS, váš poskytovatel internetových služeb již neuvidí vaši online aktivitu.

## 2. Encrypt your DNS traffic
## 2. Šifrování datových přenosů DNS

Modern protocols like DNS-over-TLS and DNS-over-HTTPS ensure that your DNS requests are encrypted. This protects them from being intercepted, modified, or spied on by attackers.
Moderní protokoly jako DNS-over-TLS a DNS-over-HTTPS zajišťují šifrování vašich DNS požadavků. To je chrání před zachycením, úpravami nebo špehováním útočníky.

## 3. Block unwanted content at the DNS level
## 3. Blokování nežádoucího obsahu na úrovni DNS

DNS protection can filter out ads, trackers, phishing websites, and other harmful or annoying content before it even loads in your browser or apps. [Learn more about DNS filtering](https://adguard-dns.io/kb/general/dns-filtering/)
DNS ochrana dokáže odfiltrovat reklamy, slídiče, phishingové weby a další škodlivý nebo obtěžující obsah ještě předtím, než se načte do vašeho prohlížeče nebo aplikací. [Další informace o DNS filtrování](https://adguard-dns.io/kb/general/dns-filtering/)

![DNS protection](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/dns.png)

Here’s what you can configure in DNS protection:
V rámci DNS ochrany můžete nakonfigurovat následující:

## Choose a DNS server
## Vybrat DNS server

![DNS servers](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/dns_server.png)

You can select from multiple trusted DNS providers. AdGuard itself offers several options for different needs:
Můžete si vybrat z několika důvěryhodných poskytovatelů DNS. AdGuard sám o sobě nabízí několik možností pro různé potřeby:

- AdGuard DNS — blocks ads and trackers.
- AdGuard DNS — blokuje reklamy a slídiče.

- AdGuard DNS Family Protection — blocks ads, trackers, and adult content.
- AdGuard DNS Family Protection — blokuje reklamy, slídiče a obsah pro dospělé.

- AdGuard DNS Non-filtering — provides a secure and reliable connection without any filtering.
- AdGuard DNS Non-filtering — poskytuje zabezpečené a spolehlivé připojení bez jakéhokoli filtrování.

You can use one of our public servers, add your own custom DNS server, or pick another trusted option from our [list of trusted DNS providers](https://adguard-dns.io/kb/general/dns-providers/).
Můžete použít jeden z našich veřejných serverů, přidat svůj vlastní DNS server nebo vybrat jinou důvěryhodnou možnost z našeho [seznamu důvěryhodných poskytovatelů DNS](https://adguard-dns.io/kb/general/dns-providers/).

## Add DNS filters and rules
## Přidat DNS filtry a pravidla

To fine-tune protection, you can create your own DNS filters using [DNS rule syntax](https://adguard-dns.io/kb/general/dns-filtering-syntax/) or import ready-made [DNS filters](https://filterlists.com).
Pro doladění ochrany můžete vytvořit vlastní DNS filtry pomocí [syntaxe pravidel DNS](https://adguard-dns.io/kb/general/dns-filtering-syntax/) nebo importovat hotové [DNS filtry](https://filterlists.com).

In addition, you can create custom DNS rules to block, unblock, or redirect domains as needed. Use our built-in rule constructor.
Kromě toho můžete vytvořit vlastní pravidla DNS pro blokování, odblokování nebo přesměrování domén podle potřeby. Použijte náš vestavěný nástroj pro tvorbu pravidel.
Loading
Loading