diff --git a/01.general/01.adguard-ad-filters/docs.en.md b/01.general/01.adguard-ad-filters/docs.en.md index 61edd45d..70bba435 100644 --- a/01.general/01.adguard-ad-filters/docs.en.md +++ b/01.general/01.adguard-ad-filters/docs.en.md @@ -45,6 +45,7 @@ Here is [a dedicated page](https://adguard.com/contribute.html) for people willi * **Base filter** — removes ads from websites with English content. Originally based on [EasyList](https://easylist.to/) and modified by us. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_2_English/filter.txt) * **Tracking Protection filter** — comprehensive list of various online counters and web analytics tools. Use it to hide your actions online and avoid tracking. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) +* **URL Tracking filter** — enhances privacy by removing tracking parameters from URLs. When a user opts to block tracking parameters in Stealth Mode, this filter will be enabled automatically. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) * **Social media filter** — removes numerous "Like" and "Tweet" buttons and other social media integrations on popular websites. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) * **Annoyances filter** — blocks irritating elements on webpages, including cookie notices, third-party widgets and in-page popups (except for social media elements). Inspired by Fanboy Annoyances List, but doesn’t duplicate it. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) * **Filter unblocking search ads and self-promotions** — unblocks ads that may be useful to users. Learn more about this filter on [this page](https://kb.adguard.com/en/general/search-ads-and-self-promotion). [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_10_Useful/filter.txt) diff --git a/01.general/01.adguard-ad-filters/docs.ru.md b/01.general/01.adguard-ad-filters/docs.ru.md index e4e78536..c49b635d 100644 --- a/01.general/01.adguard-ad-filters/docs.ru.md +++ b/01.general/01.adguard-ad-filters/docs.ru.md @@ -14,7 +14,7 @@ visible: true ## Введение -This article is about filters that we create to be used in AdGuard and other ad blocking software (e.g. uBlock Origin). Every filter represents a set of rules in text format which are used by AdGuard apps and programs to filter advertising and privacy-threatening content (such as banners, pop-ups, trackers etc.). Rules specific for a particular Internet segment (German filter, Russian filter etc.), or serving a specific purpose (Social media filter, Tracking Protection filter etc.) are combined into one list — filter — and can be enabled/disabled all at once. +Эта статья посвящена фильтрам, которые мы создаём для использования в AdGuard и в других блокировщиках рекламы (например, uBlock Origin). Каждый фильтр представляет собой набор правил в текстовом формате, использующийся приложениями и программами AdGuard для фильтрации рекламного контента и контента, угрожающего приватности (такого, как баннеры, попапы, счётчики и т.д.). Правила, нацеленные на конкретный сегмент интернета (Немецкий фильтр, Русский фильтр и т.д.), либо служащие определённой цели (Фильтр счётчиков и систем аналитики, Фильтр виджетов социальных сетей и т.д.) объединяются в один список, называемый фильтром, и могут быть включены или выключены как единое целое. ## Политика фильтров AdGuard @@ -45,6 +45,7 @@ This article is about filters that we create to be used in AdGuard and other ad * **Базовый фильтр AdGuard** — убирает рекламу с сайтов на английском языке. Изначально основан на фильтре [EasyList](https://easylist.to) и доработан нами исходя из жалоб и пожеланий пользователей. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_2_English/filter.txt) * **Фильтр счетчиков и системы аналитики** — содержит наиболее полный список различных интернет-счётчиков и систем интернет-аналитики. Используйте его, чтобы избежать слежки за вашими действиями онлайн. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_3_Spyware/filter.txt) +* **Фильтр параметров отслеживания** — повышает приватность путём удаления параметров отслеживания из адресов страниц и их ресурсов. Когда пользователь включает блокировку параметров отслеживания в модуле Антитрекинга, автоматически включается этот фильтр. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_17_TrackParam/filter.txt) * **Фильтр виджетов социальных сетей** — скрывает многочисленные кнопки «Мне нравится», «Поделиться» и подобные им интеграции с социальными сетями на популярных сайтах. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_4_Social/filter.txt) * **Фильтр раздражителей** — блокирует раздражающие элементы веб-сайтов, включая уведомления об использовании cookies, всплывающие сообщения внутри страниц и сторонние виджеты, не имеющие отношения к функциональности сайтов (но исключая виджеты и кнопки социальных сетей. Основан на фильтре Fanboy Annoyances List, но не дублирует его. [Посмотреть правила](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_14_Annoyances/filter.txt) diff --git a/01.general/02.how-to-create-your-own-ad-filters/docs.en.md b/01.general/02.how-to-create-your-own-ad-filters/docs.en.md index 273c9c63..490f5181 100644 --- a/01.general/02.how-to-create-your-own-ad-filters/docs.en.md +++ b/01.general/02.how-to-create-your-own-ad-filters/docs.en.md @@ -53,6 +53,7 @@ visible: true * [Generic rules](#generic-rules) * [$generichide](#generichide-modifier) * [$genericblock](#genericblock-modifier) + * [$specifichide](#specifichide-modifier) * [Advanced capabilites](#advanced-modifiers) * [$removeparam](#removeparam-modifier) * [$important](#important-modifier) @@ -65,7 +66,10 @@ visible: true * [$network](#network-modifier) * [$app](#app-modifier) * [$redirect](#redirect-modifier) + * [$redirect-rule](#redirect-rule-modifier) * [$denyallow](#denyallow-modifier) + * [noop](#noop-modifier) + * [$removeheader](#removeheader-modifier) * [Non-basic rules](#non-basic-rules) * [Cosmetic rules](#cosmetic-rules) * [Element hiding rules](#cosmetic-elemhide-rules) @@ -81,8 +85,7 @@ visible: true * [Pseudo-class `:nth-ancestor()`](#extended-css-nth-ancestor) * [Pseudo-class `:upward()`](#extended-css-upward) * [Pseudo-class :remove() and pseudo-property `remove`](#remove-pseudos) - * [Selectors debugging mode](#selectors-debugging-mode) - * [Testing extended selectors](#testing-extended-selectors) + * [Cosmetic rules priority](#cosmetic-rules-priority) * [HTML filtering rules](#html-filtering-rules) * [Syntax](#html-filtering-rules-syntax) * [Special attributes](#html-filtering-rules-attributes) @@ -103,6 +106,11 @@ visible: true * [Hints syntax](#hints_syntax) * [NOT_OPTIMIZED hint](#not_optimized) * [PLATFORM and NOT_PLATFORM hints](#platform_not_platform) +* [How to debug filtering rules](#how-to-debug) + * [Filtering log](#debug-filtering-log) + * [Selectors debugging mode](#selectors-debugging-mode) + * [Testing extended selectors](#testing-extended-selectors) + * [Debugging scriptlets](#debug-scriptlets) * [Good luck with creating filters!](#good-luck) @@ -226,7 +234,7 @@ Cosmetic rules are based on using a special language named CSS, which every brow | ID selector | `#banners` | Matches all elements with `id` attribute equal to `banners`.
![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_id_selector.png) | | Class selector | `.banners` | Matches all elements with `class` attribute containing `banners`.
![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_selector.png) | | Attribute selector | `div[class="banners"]` | Matches all `div` elements with `class` attribute **exactly equal** to `banners`.
![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_attr.png) | -| Attribute substring selector | `div[class^="advert1"] ` | Matches all `div` elements which `class` attribute **starts with** the `advert1` string.
![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_attr_start.png) | +| Attribute substring selector | `div[class^="advert1"]` | Matches all `div` elements which `class` attribute **starts with** the `advert1` string.
![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_attr_start.png) | | Attribute substring selector | `div[class$="banners_ads"]` | Matches all `div` elements which `class` attribute **ends with** the `banners_ads` string.
![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_attr_end.png) | | Attribute substring selector | `a[href^="http://example.com/"]` | Matches all links that are loaded from `http://example.com/` domain.
![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_attr_start.png) | | Attribute selector | `a[href="http://example.com/"]` | Matches all links to **exactly** the `http://example.com/` address.
![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_attr_equal.png) | @@ -262,16 +270,14 @@ modifiers = [modifier0, modifier1[, ...[, modifierN]]] * **`^`** — Separator character mark. Separator character is any character, but a letter, a digit, or one of the following: `_` `-` `.` `%`. In this example separator characters are shown in bold: `http:`**`//`**`example.com`**`/?`**`t=1`**`&`**`t2=t3`. The end of the address is also accepted as separator. * **`|`** — A pointer to the beginning or the end of address. The value depends on the character placement in the mask. For example, a rule `swf|` corresponds to `http://example.com/annoyingflash.swf` , but not to `http://example.com/swf/index.html`. `|http://example.org` corresponds to `http://example.org`, but not to `http://domain.com?url=http://example.org`. -> #### Visual representation -> We recommend to get acquainted with [this article](https://adblockplus.org/filter-cheatsheet#blocking), for better understanding of how such rules should be made. +> **Visual representation.** We also recommend to get acquainted with [this article](https://adblockplus.org/filter-cheatsheet#blocking), for better understanding of how such rules should be made. ### Regular expressions support If you want even more flexibility in making rules, you can use [Regular expressions](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions) instead of a default simplified mask with special characters. -> #### Performance -> Rules with regular expressions work more slowly, therefore it is recommended to avoid them or to limit their scope to specific domains. +> **Performance.** Rules with regular expressions work more slowly, therefore it is recommended to avoid them or to limit their scope to specific domains. If you want a blocker to determine a regular expression, the `pattern` has to look like this: ``` @@ -280,8 +286,7 @@ pattern = "/" regexp "/" For example, `/banner\d+/$third-party` this rule will apply the regular expression `banner\d+` to all third-party requests. Exclusion rule with regular expression looks like this: `@@/banner\d+/`. -> #### Compatibility with different versions of AdGuard -> AdGuard browser extension for Safari and AdGuard for iOS do not fully support regular expressions because of [Content Blocking API restrictions](https://webkit.org/blog/3476/content-blockers-first-look/) (look for "The Regular expression format" section). +> **Compatibility with different versions of AdGuard.** AdGuard browser extension for Safari and AdGuard for iOS do not fully support regular expressions because of [Content Blocking API restrictions](https://webkit.org/blog/3476/content-blockers-first-look/) (look for "The Regular expression format" section). ### Wildcard support for TLD (top-level domains) @@ -290,20 +295,21 @@ Wildcard characters are supported for TLDs of the domains in patterns of cosmeti For example, the cosmetic rule `example.*##.banner` will match any `example.TLD` request (`example.ru`, `example.com`, `example.net`, `example.org`, etc.). For the basic rules the described logic will be applicable only for the domains specified in `$domain` modifier (for example, `||*/banners/*$image,domain=example.*`). +> **Compatibility with different versions of AdGuard.** Supported by: AdGuard for Windows/macOS/Android/Safari/iOS and browser extensions for Chrome/Firefox/Edge. + ### Basic rules examples * `||example.com/ads/*` — a simple rule, which corresponds to addresses like `http://example.com/ads/banner.jpg` and even `http://subdomain.example.com/ads/otherbanner.jpg`. -* `||example.org^$third-party` — a rule that blocks third-party requests to` example.org` and it's subdomains. +* `||example.org^$third-party` — a rule that blocks third-party requests to `example.org` and it's subdomains. * `@@||example.com$document` — general exception rule. It completely disables filtering for `example.com` and all subdomains. There is a number of modifiers which can be used in exception rules. For more details, please follow the link [below](#exceptions-modifiers). ### Modifiers -> #### Attention -> The features described in this section are intended for experienced users. They extend capabilities of "Basic rules", but in order to use them you need to have a basic undestanding of the way your browser works. +> **Attention!** The features described in this section are intended for experienced users. They extend capabilities of "Basic rules", but in order to use them you need to have a basic undestanding of the way your browser works. You can change the behavior of a "basic rule" by using additional modifiers. Modifiers should be located in the end of the rule after a `$` sign and be separated by commas. @@ -334,13 +340,43 @@ If you want the rule not to be applied to certain domains, start a domain name w * `||baddomain.com^$domain=~example.org` — a rule to block requests that match the specified mask, and are sent from any domain except `example.org` or it's subdomains. * `||baddomain.com^$domain=example.org|~foo.example.org` — this rule blocks requests that are sent from `example.org` and all it's subdomains, except the subdomain `foo.example.org`. +###### `domain` modifier matching target domain + +In some cases the `$domain` modifier can match not only the referrer domain, but also the target domain. This happens when all of the following is true: + +1) The request has `document` type +2) The rule's pattern doesn't match any particular domain(s) +3) The rule's pattern doesn't contain regular expressions + +When all these conditions are met, the `domain` modifier will match both the referrer doman **and** the target domain. + +If some of the conditions above aren't met but the rule contains modifiers `cookie` or `csp`, the target domain will still be matched. + +If the referrer matches a rule with `domain` that explicitly excludes the referrer domain, then the rule won't be applied even if the target domain also matches the rule. This affects rules with `cookie` and `csp` modifiers, too. + +**Examples:** + +* `*$cookie,domain=example.org|example.com` will block cookies for all requests to and from `example.org` and `example.com`. +* `*$document,domain=example.org|example.com` will block all requests to and from `example.org` and `example.com`. + +In the following examples it's implied that requests are sent from `http://example.org/page`(the referrer) and the target URL is `http://targetdomain.com/page`. + +* `page$domain=example.org` will be matched, as it matches the referrer domain. +* `page$domain=targetdomain.com` will be matched, as it matches the target domain but satisfies all requirements mentioned above. +* `||*page$domain=targetdomain.com` will not be matched, as the pattern `||*page` matches specific domains. +* `||*page$domain=targetdomain.com,cookie` will be matched despite the pattern `||*page` matches specific domains because it contains `$cookie` modifier. +* `/banner\d+/$domain=targetdomain.com` will not be matched as it contains a regular expression. +* `page$domain=targetdomain.com|~example.org` will not be matched because the referrer domain is explicitly excluded. + +> **Important!** Safari doesn't support the simultaneous use of allowed and disallowed domains, so rules like `||baddomain.com^$domain=example.org|~foo.example.org` will not work in AdGuard for Safari. + + ##### **`third-party`** A restriction of third-party and own requests. A third-party request is a request from different domain. For example, a request to `example.org`, from `domain.com` is a third-party request. -> #### Subdomains -> Please note that request from domain to it's subdomain (or vice versa) is not considered a third-party request. For example, a request to `subdomain.example.org`, sent from the domain` example.org` is not a third-party request. +> **Subdomains.** Please note that request from domain to it's subdomain (or vice versa) is not considered a third-party request. For example, a request to `subdomain.example.org`, sent from the domain `example.org` is not a third-party request. If there is a `third-party` modifier, the rule is only applied to third-party request. @@ -357,12 +393,16 @@ If there is a `~third-party` modifier, the rule is only applied to the requests ##### **`popup`** -AdGuard will try to close the browser tab with any address that matches a blocking rule with this modifier. Please note, that not all the tabs can be closed. +AdGuard will try to close the browser tab with any address that matches a blocking rule with this modifier. Please note that not all the tabs can be closed. ###### `popup`examples * `||domain.com^$popup` — if you try to go to `http://domain.com/` from any page in the browser, a new tab in which specified site has to be opened will be closed by this rule. +> It may not work if the popped up page is cached by the browser. It also will not work with some tricky popup methods. In such cases, it is better to use [AdGuard Popup Blocker](https://github.com/AdguardTeam/PopupBlocker) extension. + +> **Important!** Unlike with browser extensions, `$popup` modifier is very unreliable when used with AdGuard apps for Windows, Mac and Android. In AdGuard for Safari and iOS, `$popup` rules will simply block the page right away. + ##### **`match-case`** @@ -377,8 +417,7 @@ This modifier defines a rule which applies only to addresses that match the case There is a set of modifiers, which can be used to limit the rule's application area to certain type of content. These modifiers can also be combined to cover, for example, both images and scripts. -> #### Compatibility with different versions of AdGuard -> Please note that there is a big difference in how AdGuard determines the content type on different platforms. For browser extensions, content type for every request is provided by browser. AdGuard for Windows, Mac and Android use following method: first we try to determine the type of request by filename extension. If the request is not blocked at this stage, the type will be determined using the `Content-Type` header at the beginning of the server response. +> **Compatibility with different versions of AdGuard.** Please note that there is a big difference in how AdGuard determines the content type on different platforms. For browser extensions, content type for every request is provided by browser. AdGuard for Windows, Mac and Android use following method: first we try to determine the type of the request by the `Sec-Fetch-Dest` request header or by the filename extension. If the request is not blocked at this stage, the type will be determined using the `Content-Type` header at the beginning of the server response. ##### Content type modifiers examples @@ -412,8 +451,7 @@ The rule corresponds to browser plugins resourses. (e.g. Java or Flash). The rule corresponds to requests by browser plugins (it's usually Flash). -> #### Compatibility with different versions of AdGuard -> AdGuard for Windows, macOS and Android often can't accurately detect this type and defines it as `other`. +> **Compatibility with different versions of AdGuard.** AdGuard for Windows, macOS and Android often can't accurately detect this type and defines it as `other`. ##### **`font`** @@ -435,22 +473,22 @@ The rule corresponds to requests for built-in pages (HTML tags `frame` and `ifra The rule corresponds to requests caused by either `navigator.sendBeacon()` or the `ping` attribute on links. -> #### Compatibility with different versions of AdGuard -> AdGuard for Windows, macOS and Android often can't accurately detect `navigator.sendBeacon()`. For reliable detection, use AdGuard browser extensions. +> **Compatibility with different versions of AdGuard.** AdGuard for Windows, macOS and Android often can't accurately detect `navigator.sendBeacon()`. For reliable detection, use AdGuard browser extensions. ##### **`xmlhttprequest`** The rule applies only to ajax requests (requests sent via javascript object `XMLHttpRequest`). -> #### Compatibility with different versions of AdGuard -> AdGuard for Windows, macOS and Android often can't accurately detect this type and defines it as `other` or `script`. +> **Compatibility with different versions of AdGuard.** AdGuard for Windows, macOS and Android often can't accurately detect this type and sometimes detects it as `other` or `script`. ##### **`websocket`** The rule applies only to WebSocket connections. +> **Compatibility with different versions of AdGuard.** AdGuard for Safari and iOS cannot properly apply this modifier due to Safari limitations. + ##### **`webrtc`** @@ -463,6 +501,8 @@ The rule applies only to WebRTC connections. * `||example.com^$webrtc,domain=example.org` - this rule blocks webRTC connectios to `example.com` for `example.org`. * `@@*$webrtc,domain=example.org` - this rule disables the RTC wrapper for `example.org`. +> **Deprecation notice.** This modifier is deprecated and will be removed in the future. If you need to suppress WebRTC, consider using the `$nowebrtc` scriptlet. + ##### **`other`** @@ -473,8 +513,7 @@ The rule applies to requests for which the type has not been determined or doesn Exception rules disable the other basic rules for the addresses to which they correspond. They begin with a `@@` mark. All the basic modifiers listed above can be applied to them and they also have a few special modifiers. -> #### Visual representation -> We recommend to get acquainted with [this article](https://adblockplus.org/filter-cheatsheet#blocking), for better understanding of how exception rules should be made. +> **Visual representation.** We recommend to get acquainted with [this article](https://adblockplus.org/filter-cheatsheet#blocking), for better understanding of how exception rules should be made. ##### **`elemhide`** @@ -488,7 +527,7 @@ Disables any cosmetic rules on the pages matching the rule. You will find the in ##### **`content`** -Disables HTML filtering rules on the pages matching the rule. You will find the information about HTML filtering rules [further](#html-filtering-rules). +Disables HTML filtering rules and replace rules on the pages that match the rule. You will find the information about HTML filtering rules [here](#html-filtering-rules) and about replace rules [here](#replace-modifier). ###### `content` example @@ -515,7 +554,7 @@ Disables blocking of all requests sent from the pages matching the rule. ##### **`extension`** -Disables all userscripts on the pages matching this rule. +Disables all userscripts on the pages matching this rule. Note, that this modifier only makes sense in AdGuard products that can work as userscript hosts (AdGuard for Windows/macOS/Android). ###### `extension` example @@ -534,24 +573,28 @@ Completely disables blocking on corresponding pages. It is equal to simultaneous ##### **`stealth`** -Disables the Stealth Mode for all corresponding pages and requests. - -> #### Compatibility with different versions of AdGuard -> Stealth Mode is currently available in AdGuard for Windows, Mac, Android and AdGuard browser extension. For now, the products that do not support Stealth Mode will ignore the rules with this modifier. +Disables the Stealth Mode module for all corresponding pages and requests. ###### `stealth` examples -* `@@||example.com^$stealth` — disables `Stealth Mode` for `example.com` (and subdomains) requests. -* `@@||domain.com^$script,stealth,domain=example.com` — disables `Stealth Mode` only for script `domain.com` (and subdomains) requests on `example.com` and all subdomains. +* `@@||example.com^$stealth` — disables `Stealth Mode` for `example.com` (and subdomains) requests, except for blocking cookies and hiding tracking parameters (see below). +* `@@||domain.com^$script,stealth,domain=example.com` — disables `Stealth Mode` only for script requests to `domain.com` (and its subdomains) on `example.com` and all its subdomains. +* Please note that blocking cookies and removing tracking parameters is achieved by using rules with `$cookie` and `$removeparam` modifiers. Exceptions with only `$stealth` modifier won't do those things. If you want to completely disable all Stealth Mode features for a given URL, you need to include all three modifiers: `@@||example.org^$stealth,removeparam,cookie` + +> **Compatibility with different versions of AdGuard.** Stealth Mode is currently available in AdGuard for Windows, Mac, Android and AdGuard browser extensions for Chrome, Firefox, Edge. For now, the products that do not support Stealth Mode will ignore the rules with this modifier. ##### Generic rules Before we can proceed to the next modifiers, we have to make a definition of _generic rules_. The rule is generic if it is not limited to specific domains. +Wildcard character `*` is supported as well. For example, these rules are generic: ``` ###banner +*###banner +#@#.adsblock +*#@#.adsblock ~domain.com###banner ||domain.com^ ||domain.com^$domain=~example.com @@ -577,77 +620,82 @@ Disables generic basic rules on pages that correspond to exception rule. * `@@||example.com^$genericblock` — disables generic basic rules on any pages at `example.com` and all subdomains. + +##### **`specifichide`** + +Has an opposite effect to [`generichide`](#generichide-modifier). Disables all specific element hiding and CSS rules, but not general ones. + +* `@@||example.org^$specifichide` — will disable `example.org##.banner` but not `##.banner`. + +> Please note that [`$elemhide` modifier](#elemhide-modifier) can disable all cosmetic rules at once. + +> **Compatibility with different versions of AdGuard.** Rules with this modifier are supported by AdGuard for Windows, Mac, Android, and AdGuard browser extensions for Chrome, Firefox, Edge. **Developer builds only at this moment.** + ### Advanced capabilities These modifiers are able to completely change the behaviour of basic rules. - #### **`removeparam`** -Rules with `$removeparam` modifier are intended to effectively extend Stealth Mode's capabilities to strip tracking parameters from pages’ URLs. *Please note*, that such rules are only applied to `GET` requests. +>`$removeparam` and `$queryprune` are completely interchangeable and are aliases to each other. -> #### Compatibility with different versions of AdGuard -> Rules with `$removeparam` modifier are supported by AdGuard for Windows, Mac, and Android. - -> #### Multiple rules matching a single request -> In case if multiple `$removeparam` rules match a single request, we will apply each of them one by one. - -> #### Restrictions -> Please note that this type of rules can be used **only in trusted filters**. This category includes your own **User filter** and all the filters created by AdGuard Team. - -> #### Compatibility with other modifiers -> `$removeparam` rules are not compatible with any other modifiers except `$domain`, `$third-party`, `$app`, `$important` and `$match-case`. The rules which have any other modifiers are considered invalid and will be rejected. +Rules with `$removeparam` modifier are intended to to strip query parameters from pages’ URLs. Please note that such rules are only applied to `GET`, `HEAD`, and `OPTIONS` requests. ##### Syntax -To specify a parameter affected by the rule one should use the following syntax: +###### Basic syntax -* `$removeparam=param` -- removes parameter with name `param` from URL queries of any request, e.g. a request to `http://example.com/page?param=1&another=2` will be transformed to - `http://example.com/page?another=2`. +* `$removeparam=param` -- removes query parameter with the name `param` from URLs of any request, e.g. a request to `http://example.com/page?param=1&another=2` will be transformed to `http://example.com/page?another=2`. -Use `|` to separate parameters: +> `$removeparam` basic syntax is supported starting with v1.7 of [CoreLibs](https://adguard.com/en/blog/introducing-corelibs.html) and v3.6 of AdGuard Browser Extension. -* `$removeparam=p1|p2` -- removes parameters `p1` and `p2` from URL queries of any request, e.g. a request to `http://example.com/page?p1=1&p2&p3` will be transformed to `http://example.com/page?p3`. +###### Regular expressions -> **Please note** that a blocking rule with `$removeparam` parameter must have at least one parameter specified. For example, rule such as `example.com$removeparam` is considered invalid and will be rejected. +You can also use regular expressions to match query parameters and/or their values: -Parameters are matched lexicographically. It means that the rule `$removeparam=param` won't strip the parameter named `Param` or `some_param`. If you want to overcome this behavior, you can use regular expressions: +* `$removeparam=/regex/[options]` -- removes query parameters matching the regex regular expression from URLs of any request. Unlike basic syntax, it means *"remove query parameters normalized to a `name=value` string which match the regex regular expression"*. `[options]` here is the list of regular expression options. At the moment, the only supported option is `i` which makes matching case-insensitive. -``` -removeparam = "/" regex "/" options -``` +> `$removeparam` syntax for regular expressions will be supported starting with v1.8 of CoreLibs and v4.0 of AdGuard Browser Extension. For now, use the simplified version: `$removeparam=param`. -, where +> **Escaping special characters**: don't forget to escape special characters like `,`, `/` and `$` in the regular expressions. Use `\` character for that purpose. For example, an escaped comma should look like this: `\,`. -* `regex` - a regular expression according to [Perl syntax](http://perldoc.perl.org/perlrequick.html#Search-and-replace), -* `options` - regular expression options. +> Important: note that regex-type rules target both parameter's name and value. In order to minimize the chance of mistakes, it is safer to start every regex with `/^` unless you specifically target parameter values. -The list of supported options for regular expressions: +> We will try to detect and ignore unescaped `$` automatically using a simple rule of thumb: +> It is not an options delimiter if all three are true: +> 1. It looks like `$/`, +> 2. There's another slash character (`/`) to the left of it, +> 3. There's another unescaped `$` character to the left of that slash character. -* `i` - makes matching case-insensitive. +###### Remove all query parameters -Examples: +Specify naked `$removeparam` to remove all query parameters: -* `$removeparam=/param/` -- removes parameters matching the pattern `param` from URL queries of any request, e.g. a request to `http://example.com/page?param=1&some_pArAm=2` will be transformed to `http://example.com/page?some_pArAm=2` -* `$removeparam=/param/i` -- removes parameters matching the pattern `param` case-insensitively from URL queries of any request, e.g. a request to `http://example.com/page?param=1&some_pArAm=2` will be transformed to `http://example.com/page` +* `||example.org^$removeparam` -- removes all query parameters from URLs matching `||example.org^`. -> **Important:** don't forget to escape special characters like `,`, `/` and `$` in regular expressions. Use `\` character for it. For example, escaped comma should look like this: `\,`. +###### Inversion -`|`-separated lists also support regular expressions: `$removeparam=p1|/p2/i|/p3/|p4`. +Use `~` to apply inversion: -Use exceptions if you don't want to strip some URLs: +* `$removeparam=~param` -- removes all query parameters with the name different from `param`. +* `$removeparam=~/regex/` -- removes all query parameters that do not match the regex regular expression. -1) Example 1: +###### Negating `$removeparam` -``` -$removeparam=gclid|yclid|fbclid -@@||example.com^$removeparam=gclid -``` -With these rules Google, Yandex and Facebook Click IDs will be stripped out, except that requests to `example.com` won't be stripped of Google Click ID. E.g. `http://google.com/page?gclid=1&fbclid=2&yclid=3` will be transformed to `http://google.com/page`, but `http://example.com/page?gclid=1&fbclid=2&yclid=3` will be transformed to `http://example.com/page?gclid=1`. +This sort of rules work pretty much the same way it works with [`$csp`](#csp-modifier) and [`$redirect`](#redirect-modifier) modifiers. -2) Example 2: +Use `@@` to negate `$removeparam`: + +* `@@||example.org^$removeparam` -- negates all `$removeparam` rules for URLs that match `||example.org^`. +* `@@||example.org^$removeparam=param` -- negates the rule with `$removeparam=param` for any request matching `||example.org^`. +* `@@||example.org^$removeparam=/regex/` -- negates the rule with `$removeparam=/regex/` for any request matching `||example.org^`. + +>**Multiple rules matching a single request** +>In the case when multiple `$removeparam` rules match a single request, each of them will be applied one by one. + +##### Examples ``` $removeparam=utm_source|utm_medium|utm_term @@ -656,8 +704,40 @@ $removeparam=utm_content|utm_campaign|utm_referrer ``` With these rules some [UTM parameters](https://en.wikipedia.org/wiki/UTM_parameters) will be stripped out from any request, except that requests to `example.com` won't be stripped at all, e.g. `http://google.com/page?utm_source=s&utm_referrer=fb.com&utm_content=img` will be transformed to `http://google.com/page`, but `http://example.com/page?utm_source=s&utm_referrer=fb.com&utm_content=img` won't be affected by the blocking rule. -> **Please note** that blocking `$removeparam` rules can also be disabled by `$document` and `$urlblock` exception rules. But basic exception rules without modifiers don't do that. For example, `@@||example.com^` will not disable `$removeparam=p` for requests to example.com, but `@@||example.com^$urlblock` will. +* `$removeparam=utm_source` -- removes `utm_source` query parameter from all requests. +* `$removeparam=/utm_.*/` -- removes all `utm_* query` parameters from URL queries of any request, e.g. a request to `http://example.com/page?utm_source=test` will be transformed to `http://example.com/page`. + +* `$removeparam=/^utm_source=campaign$/` -- removes `utm_source` query parameter with the value equal to `campaign`. It does not touch other `utm_source` parameters. + +Negating one `$removeparam` rule and replacing it with a different rule: + +``` +$removeparam=/^(gclid|yclid|fbclid)=/ +@@||example.com^$removeparam=/^(gclid|yclid|fbclid)=/ +||example.com^$removeparam=/^(yclid|fbclid)=/ +``` + +With these rules, Google, Yandex, and Facebook Click IDs will be removed from all requests. There's one exception: Google Click ID (gclid) will not be removed from requests to example.com. + +Negating `$removeparam` for all parameters: + +``` +$removeparam=/^(utm_source|utm_medium|utm_term)=/ +$removeparam=/^(utm_content|utm_campaign|utm_referrer)=/ +@@||example.com^$removeparam +``` + +With these rules, specified UTM parameters will be removed from any request save for requests to example.org. + +> **Compatibility with other modifiers** +> `$removeparam` rules are not compatible with any other modifiers except `$domain`, `$third-party`, `$app`, `$important` and `$match-case`. The rules which have any other modifiers are considered invalid and will be discarded. + +> Please note that `$removeparam` rules can also be disabled by `$document` and `$urlblock` exception rules. But basic exception rules without modifiers don't do that. For example, `@@||example.com^` will not disable `$removeparam=p` for requests to **example.com**, but `@@||example.com^$urlblock` will. + +> **Compatibility with different versions of AdGuard.** Rules with this modifier are supported by AdGuard for Windows, Mac, Android, and AdGuard browser extensions for Chrome, Firefox, Edge. **Developer builds only at this moment.** + +> **Restrictions.** Please note that this type of rules can be used **only in trusted filters**. This category includes your own **User filter** and all the filters created by AdGuard Team. #### **`important`** @@ -696,20 +776,30 @@ If a request to `example.org` is sent from the `test.org` domain, the rule won't #### **`badfilter`** -> #### Compatibility with different versions of AdGuard -> `badfilter` modifier is currently only available in AdGuard browser extensions. It will be added to other AdGuard products later. - The rules with the `badfilter` modifier disable other basic rules to which they refer. It means that the text of the disabled rule should match the text of the `badfilter` rule (without the `badfilter` modifier). -##### `badfilter` examples +**Examples:** * `||example.com$badfilter` disables `||example.com` * `||example.com$image,badfilter` disables `||example.com,image` * `@@||example.com$badfilter` disables `@@||example.com` * `||example.com$domain=domain.com,badfilter` disables `||example.com$domain=domain.com` -> #### Compatibility with different versions of AdGuard -> Below modifiers from this section are only available in AdGuard for Windows, macOS and Android. Browser extension capabilities are limited by browser itself and some methods are just not available to them. +Rules with `$badfilter` modifier can disable other basic rules for specific domains if they fulfil the following conditions: + +* The rule has a `$domain` modifier +* The rule does not have a negated domain `~` in `$domain` modifier's value. + +In that case, the `$badfilter` rule will disable the corresponding rule for domains specified in both the `$badfilter` and basic rules. Please note, that [wildcard-TLD logic](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#wildcard-for-tld) works here as well. + +**Examples:** + +* `/some$domain=example.com|example.org|example.io` is disabled for `example.com` by `/some$domain=example.com,badfilter` +* `/some$domain=example.com|example.org|example.io` is disabled for `example.com` and `example.org` by `/some$domain=example.com|example.org,badfilter` +* `/some$domain=example.com|example.org` and `/some$domain=example.io` are disabled completely by `/some$domain=example.com|example.org|example.io,badfilter` +* `/some$domain=example.com|example.org|example.io` is disabled completely by `/some$domain=example.*,badfilter` +* `/some$domain=example.*` is disabled for `example.com` and `example.org` by `/some$domain=example.com|example.org,badfilter` +* `/some$domain=example.com|example.org|example.io` is NOT disabled for `example.com` by `/some$domain=example.com|~example.org,badfilter` because the value of `domain` modifier contains a negated domain #### **`empty`** @@ -720,6 +810,10 @@ Usually, blocked requests look like a server error to browser. If you use `empty * `||example.org^$empty` — returns an empty response to all requests to `example.org` and all subdomains. +> **Deprecation notice.** Rules with this modifier are deprecated in favor of the `$redirect` modifier. Please note that it will be removed in the future. + +> **Compatibility with different versions of AdGuard.** Rules with this modifier are not supported by AdGuard for Safari and iOS. + #### **`mp4`** @@ -729,6 +823,10 @@ As a response to blocked request AdGuard returns a short video placeholder. * `||example.com/videos/$mp4` — block a video downloads from `||example.com/videos/*` and changes the response to a video placeholder. +> **Deprecation notice.** Rules with this modifier are deprecated in favor of the `$redirect` modifier. Please note that it will be removed in the future. + +> **Compatibility with different versions of AdGuard.** Rules with this modifier are not supported by AdGuard for Safari and iOS. + #### **`replace`** @@ -737,10 +835,6 @@ This modifier completely changes the rule behavior. If it is applied, the rule w > #### Please note > You will need some knowledge of regular expressions to use this modifier. -> #### Compatibility with different versions of AdGuard -> Rules are supported by AdGuard for Windows, Mac, Android and by the AdGuard's Firefox add-on. -> This type of rules don't work in extensions for other browsers because they are unable to modify content on the network level. - ##### `$replace` rules features * `$replace` rules apply to any text response, but will not apply to binary (`media`, `image`, `object`, etc). @@ -751,8 +845,7 @@ This modifier completely changes the rule behavior. If it is applied, the rule w > `$replace` value can be empty in the case of exception rules. See examples section for further information. -> #### Multiple rules matching a single request -> In case if multiple `$replace` rules match a single request, we will apply each of them. **The order is defined alphabetically.** +> **Multiple rules matching a single request.** In case if multiple `$replace` rules match a single request, we will apply each of them. **The order is defined alphabetically.** ##### **$replace Syntax** @@ -777,7 +870,7 @@ In the `$replace` value, two characters must be escaped: comma (`,`) and (`$`). There are three parts in this rule: * Regular expression: `()(.|\s)*<\/VAST>` -* Replacement: `\$1<\/VAST>` (please note, that `$` is escaped) +* Replacement: `\$1<\/VAST>` (please note that `$` is escaped) * Regular expression flags: `i` (insensitive search) You can see how this rule works here: @@ -797,6 +890,10 @@ http://regexr.com/3cesk * `@@||example.org^$replace` will disable all `$replace` rules matching `||example.org^`. * `@@||example.org^$document` or `@@||example.org^$content` will disable all `$replace` rules **originated from** pages of `example.org` **including the page itself**. +> **Compatibility with different versions of AdGuard.** These rules are supported by AdGuard for Windows, Mac, Android and by the AdGuard's Firefox add-on. This type of rules don't work in extensions for other browsers because they are unable to modify content on the network level. + +> **Restrictions.** Please note that this type of rules can be used **only in trusted filters**. This category includes your own **User filter** and all the filters created by AdGuard Team. + #### **`csp`** @@ -806,8 +903,7 @@ This modifier completely changes the rule behavior. If it is applied to a rule, For the requests matching a `$csp` rule, we will strengthen response's security policy by adding additional content security policy equal to the `$csp` modifier contents. `$csp` rules are applied independently from any other rule type. Other basic rules have no influence on it **save for document-level exceptions** (see the examples section). ->Multiple rules matching a single request. ->In case if multiple `$csp` rules match a single request, we will apply each of them. +> **Multiple rules matching a single request.** In case if multiple `$csp` rules match a single request, we will apply each of them. ##### **`csp` syntax** @@ -817,7 +913,7 @@ For the requests matching a `$csp` rule, we will strengthen response's security >Limitations ->1. Please note, that there're a few characters forbidden in the `$csp` value: (`,`), (`$`) +>1. Please note that there're a few characters forbidden in the `$csp` value: (`,`), (`$`) >2. `csp` rules support limited list of modifiers: `domain`, `important`, `subdocument` >3. Rules with `report-*` directives are considered invalid. @@ -834,8 +930,7 @@ For the requests matching a `$csp` rule, we will strengthen response's security The `$cookie` modifier completely changes rule behavior. Instead of blocking a request, this modifier makes us suppress or modify the `Cookie` and `Set-Cookie` headers. -> **Multiple rules matching a single request** -> In case if multiple `$cookie` rules match a single request, we will apply each of them one by one. +> **Multiple rules matching a single request.** In case if multiple `$cookie` rules match a single request, we will apply each of them one by one. ##### `$cookie` syntax The rule syntax depends on whether we are going to block all cookies or to remove a single cookie. The rule behavior can be changed with `maxAge` and `sameSite` modifiers. @@ -856,22 +951,20 @@ The rule syntax depends on whether we are going to block all cookies or to remov * `@@||example.org^$cookie=NAME` -- unblocks a single cookie named `NAME` * `@@||example.org^$cookie=/regular_expression/` -- unblocks every cookie matching a given regular expression -> **Limitations** -> `$cookie` rules support a limited list of modifiers: `domain`, `~domain`, `important`, `third-party`, `~third-party`. +> **Limitations:** `$cookie` rules support a limited list of modifiers: `domain`, `~domain`, `important`, `third-party`, `~third-party`. ##### Real-life examples * `$cookie=__cfduid` -- blocks CloudFlare cookie everywhere * `$cookie=/__utm[a-z]/` -- blocks Google Analytics cookies everywhere * `||facebook.com^$third-party,cookie=c_user` -- prevents Facebook from tracking you even if you are logged in +> **Compatibility with different versions of AdGuard.** This type of rules is not supported by AdGuard for iOS and Safari. + #### **`network`** This is basically a Firewall-kind of rules allowing to fully block or unblock access to a specified remote address. -> #### Compatibility with different versions of AdGuard -> Only AdGuard for Windows, Mac, Android are technically capable of using this type of rules. - 1. `$network` rules match **IP addresses only**! You cannot use it to block or unblock access to a domain. 2. To match an IPv6 address, you have to use the collapsed syntax, e.g. use `[2001:4860:4860::8888]$network` instead of `[2001:4860:4860:0:0:0:0:8888]$network`. 3. A whitelist `$network` rule makes AdGuard bypass data to the matching endpoint, e.g. there will be no further filtering at all. @@ -883,6 +976,8 @@ This is basically a Firewall-kind of rules allowing to fully block or unblock ac * `174.129.166.49$network` - blocks access to `174.129.166.49:*`. * `@@174.129.166.49$network` - makes AdGuard bypass data to the endpoint. No other rules will be applied. +> **Compatibility with different versions of AdGuard.** Only AdGuard for Windows, Mac, Android are technically capable of using this type of rules. + #### **`app`** @@ -908,8 +1003,11 @@ If you want the rule not to be applied to certain apps, start the app name with * `||baddomain.com^$app=~org.example.app` — a rule to block requests that match the specified mask, and are sent from any app save for the `org.example.app`. * `||baddomain.com^$app=~org.example.app1|~org.example.app2` — same as above, but now two apps are excluded: `org.example.app1` and `org.example.app2`. +> **Compatibility with different versions of AdGuard.** Only AdGuard for Windows, Mac, Android are technically capable of using this type of rules. + -#### `redirect` + +#### **`redirect`** AdGuard is able to redirect web requests to a local "resource". @@ -921,7 +1019,7 @@ AdGuard uses the same filtering rules syntax as uBlock Origin. Also, it is compa > The value of the `$redirect` modifier must be the name of the resource that will be used for redirection. -> `$redirect` rules' priority is higher than the regular basic blocking rules' priority. This means that if there's a basic blocking rule (even with `$important` modifier), `$redirect` rule will prevail over it. If there's a whitelist (@@) rule matching the same URL, it will disable redirecting as well (unless the `$redirect` rule is also marked as `$important`). +> `$redirect` rules' priority is higher than the regular basic blocking rules' priority. This means that if there's a basic blocking rule (even with `$important` modifier), `$redirect` rule will prevail over it. If there's a whitelist (`@@`) rule matching the same URL, it will disable redirecting as well (unless the `$redirect` rule is also marked as `$important`). ##### Disabling `$redirect` rules @@ -933,15 +1031,33 @@ AdGuard uses the same filtering rules syntax as uBlock Origin. Also, it is compa ``` ||example.org/script.js$script,redirect=noopjs ``` -This rule redirects all requests to script.js to the resource named noop.js. + +This rule redirects all requests to `example.org/script.js` to the resource named `noopjs`. ``` ||example.org/test.mp4$media,redirect=noopmp4-1s ``` -This rule redirects all requests to example.org/test.mp4 to the resource named noopmp4-1s. + +This rule redirects all requests to `example.org/test.mp4` to the resource named `noopmp4-1s`. > More information on scriptlets, redirects, and their usage is available in [this GitHub section](https://github.com/AdguardTeam/Scriptlets#redirect-resources). +> **Compatibility with different versions of AdGuard.** This type of rules is not supported by AdGuard for iOS and Safari. + + +#### **`redirect-rule`** +This is basically an alias to `$redirect` since it has the same "redirection" values and the logic is almost similar. The difference is that `$redirect-rule` is applied only in the case when the target request is blocked by a different basic rule. + +> Negating `$redirect-rule` works exactly the same way as for regular `$redirect` rules. Even more than that, `@@||example.org^$redirect` will negate both `$redirect` and `$redirect-rule` rules. + +Examples: + +``` +||example.org/script.js +||example.org^$redirect-rule=noopjs +``` + +In this case, only requests to `example.org/script.js` will be "redirected". All other requests to `example.org` will be kept intact. @@ -970,6 +1086,119 @@ The above filter tells the network filtering engine that when the context is `a. > @@||y.com$script,domain=a.com|~b.com > ``` + +#### **`noop`** + +`noop` modifier does nothing and can be used solely to increase rules' readability. It consists of a sequence of underscore characters (`_`) of any length and can appear in a rule as many times as needed. + +##### `noop` examples: + +``` +||example.com$_,removeparam=/^ss\\$/,_,image +||example.com$replace=/bad/good/,___,~third-party +``` + +> **Compatibility with different versions of AdGuard.** Available in **Developer builds only at this moment.** + + +#### **`$removeheader`** + +Rules with `$removeheader` modifier are intended to remove headers from HTTP requests and responses. The initial motivation for this rule type is to be able to get rid of the `Refresh` header which is often used to redirect users to an undesirable location. However, this is not the only case where this modifier can be useful. + +Just like `$csp`, `$redirect`, `$removeparam`, and `$cookie`, this modifier exists independently, rules with it do not depend on the regular basic rules, i.e. regular exception or blocking rules will not affect it. By default, it only affects response headers. However, you can also change it to remove headers from HTTP requests as well. + +##### Syntax + +**Basic syntax** + +* `||example.org^$removeheader=header-name` — removes a **response** header called `header-name` +* `||example.org^$removeheader=request:header-name` — removes a **request** header called `header-name` + +Please note, that `$removeheader` is case-insensitive, but we suggest always using lower case. + +**Negating `$removeheader`** + +This type of rules works pretty much the same way it works with `$csp` and `$redirect` modifiers. + +Use `@@` to negate `$removeheader`: + +* `@@||example.org^$removeheader` — negates **all** `$removeheader` rules for URLs that match `||example.org^`. +* `@@||example.org^$removeheader=header` — negates the rule with `$removeheader=header` for any request matching `||example.org^`. +* `$removeheader` rules can also be disabled by `$document` and `$urlblock` exception rules. But basic exception rules without modifiers don't do that. For example, `@@||example.com^` will not disable `$removeheader=p` for requests to `example.com`, but `@@||example.com^$urlblock` will. + +> **Multiple rules matching a single request** +> In case of multiple `$removeheader` rules matching a single request, we will apply each of them one by one. + +##### Restrictions + +1. Please note that this type of rules can be used **only in trusted filters**. This category includes your own User rules and all the filters created by AdGuard Team. +2. In order to avoid compromising the security `$removeheader` cannot remove headers from the list below: + +* `access-control-allow-origin` +* `access-control-allow-credentials` +* `access-control-allow-headers` +* `access-control-allow-methods` +* `access-control-expose-headers` +* `access-control-max-age` +* `access-control-request-headers` +* `access-control-request-method` +* `origin` +* `timing-allow-origin` +* `allow` +* `cross-origin-embedder-policy` +* `cross-origin-opener-policy` +* `cross-origin-resource-policy` +* `content-security-policy` +* `content-security-policy-report-only` +* `expect-ct` +* `feature-policy` +* `origin-isolation` +* `strict-transport-security` +* `upgrade-insecure-requests` +* `x-content-type-options` +* `x-download-options` +* `x-frame-options` +* `x-permitted-cross-domain-policies` +* `x-powered-by` +* `x-xss-protection` +* `public-key-pins` +* `public-key-pins-report-only` +* `sec-websocket-key` +* `sec-websocket-extensions` +* `sec-websocket-accept` +* `sec-websocket-protocol` +* `sec-websocket-version` +* `p3p` +* `sec-fetch-mode` +* `sec-fetch-dest` +* `sec-fetch-site` +* `sec-fetch-user` +* `referrer-policy` +* `content-type` +* `content-length` +* `accept` +* `accept-encoding` +* `host` +* `connection` +* `transfer-encoding` +* `upgrade` + +3. `$removeheader` rules are not compatible with any other modifiers except `$domain`, `$third-party`, `$app`, `$important`, `$match-case`, and content type modifiers (e.g. `$script`, `$stylesheet`, etc). The rules which have any other modifiers are considered invalid and will be discarded. + +##### Examples + +* `||example.org^$removeheader=refresh` — removes `Refresh` header from all HTTP responses returned by `example.org` and it's subdomains. +* `||example.org^$removeheader=request:x-client-data` — removes `X-Client-Data` header from all HTTP requests. +* This block of rules removes `Refresh` and `Location` headers from all HTTP responses returned by `example.org` save for requests to `example.org/path/*`, for which no headers will be removed: + + ``` + ||example.org^$removeheader=refresh + ||example.org^$removeheader=location + @@||example.org/path/$removeheader + ``` + +> **Compatibility with different versions of AdGuard.** Available in **Developer builds only at this moment.** + # Non-basic rules @@ -985,6 +1214,8 @@ However, the capabilities of the basic rules may not be sufficient to block ads. Element hiding rules are used to hide the elements of web pages. It is similar to applying `{ display: none; }` style to selected element. +> Note that element hiding rules may operate differently [depending on the platform](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#cosmetic-rules-priority). + #### Syntax @@ -1005,8 +1236,7 @@ If you want the rule not to be applied to certain domains, start a domain name w You can use both approaches in a single rule. For example, `example.org,~subdomain.example.org##domain` will work for `example.org` and all subdomains, **except `subdomain.example.org`**. -> #### Please note -> Element hiding rules are not dependent on each other. If there is a rule `example.org##selector` in the filter and you add `~example.org##selector` both rules will be applied independently. +> **Please note,** element hiding rules are not dependent on each other. If there is a rule `example.org##selector` in the filter and you add `~example.org##selector` both rules will be applied independently. #### Examples @@ -1015,6 +1245,8 @@ You can use both approaches in a single rule. For example, `example.org,~subdoma * `example.com,example.org###adblock` - hides an element with attribute `id` equals `adblock` at `example.com`, `example.org` and all subdomains. * `~example.com##.textad` - hides an element with a class `textad` at all domains, except `example.com` and it's subdomains. +> **Important!** Safari doesn't support both permitted and restricted domains. So the rules like `example.org,~foo.example.org##.textad` are invalid in AdGuard for Safari. + #### Exceptions @@ -1030,11 +1262,16 @@ If you want to disable it for `example.com`, you can create an exception rule: example.com#@#.textad ``` -Sometimes, it may be necessary to disable all restriction rules. For example, to conduct tests. To do this, use the exclusion rule without specifying a domain. +Sometimes, it may be necessary to disable all restriction rules. For example, to conduct tests. To do this, use the exclusion rule without specifying a domain. It will completely disable matching CSS elemhide rule on ALL domains: ``` #@#.textad ``` +The same can be achieved by adding this rule: +``` +*#@#.textad +``` + We recommend to use this kind of exceptions only if it is not possible to change the hiding rule itself. In other cases it is better to change the original rule, using domain restrictions. @@ -1042,8 +1279,11 @@ We recommend to use this kind of exceptions only if it is not possible to change Sometimes, simple hiding of an element is not enough to deal with advertising. For example, blocking an advertising element can just break the page layout. In this case AdGuard can use rules that are much more flexible than hiding rules. With this rules you can basically add any CSS styles to the page. -> #### Restrictions -> Styles that lead to loading any resource are forbidden. Basically, it means that you cannot use any `` type of value in the style. +> **Restrictions.** Styles that lead to loading any resource are forbidden. Basically, it means that you cannot use any `` type of value in the style. + +> **Compatibility with different versions of AdGuard.** CSS rules are not supported by AdGuard for iOS. + +> Note that CSS rules may operate differently [depending on the platform](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#cosmetic-rules-priority). #### Syntax @@ -1089,18 +1329,20 @@ We recommend to use this kind of exceptions only if it is not possible to change CSS 3.0 is not always enough to block ads. To solve this problem AdGuard extends CSS capabilities by adding support for the new pseudo-elements. To use extended CSS selectors we have developed a separate open source [module](https://github.com/AdguardTeam/ExtendedCss). -> #### Backward compatibility -> In common filters we use so-called backward compatible syntax. The thing is, extended pseudo-classes can break cosmetic rules in previous versions of AdGuard or in other ad blockers that do not support extended CSS. For example, instead of pseudo-class `:has(selector)` it is possible to use `[-ext-has="selector"]` attribute. +> **Application area.** Extended selectors can be used in any cosmetic rule, whether they are [element hiding rules](#cosmetic-elemhide-rules) or [CSS rules](#cosmetic-css-rules). -> #### Application area -> Extended selectors can be used in any cosmetic rule, whether they are [element hiding rules](#cosmetic-elemhide-rules) or [CSS rules](#cosmetic-css-rules). +> **Compatibility with different versions of AdGuard.** Note that CSS rules are not supported by AdGuard for iOS. #### Syntax + Regardless of the CSS pseudo-classes you are using in the rule, you can use special markers to make these rules use the "Extended CSS" engine. It is recommended to use these markers for all "extended CSS" cosmetic rules so that it was easier to find them. The syntax for extended CSS rules: + * `#?#` — for element hiding (`#@?#` — for exceptions ) * `#$?#` — for CSS injection (`#@$?#` — for exceptions ) +We **strongly recommend** using these markers any time when you use an extended CSS selector. + #### Examples * `example.org#?#div:has(> a[target="_blank"][rel="nofollow"])` — this rule will block all `div` elements that contain link as a child node with `[target="_blank"][rel="nofollow"]` attributes. The rule will only work for `example.org` and all it's subdomains. @@ -1108,9 +1350,12 @@ The syntax for extended CSS rules: * `example.net#?#.banner:matches-css(width: 360px)` — this rule will block all `.banner` elements that contain `width: 360px` style property. The rule will only work for `example.net` and all it's subdomains. * `example.net#@?#.banner:matches-css(width: 360px)` — this rule will disable the previous rule. -> Please note, that now you can apply simple selectors using the ExtCss engine by using a rule like this: +> Please note that now you can apply simple selectors using the ExtCss engine by using a rule like this: > `#?#div` +> For more information on how to debug ExtendedCSS selectors, jump to [this section](#selectors-debugging-mode) of the artcile. + + ##### Pseudo-class `:has()` @@ -1158,7 +1403,7 @@ This pseudo-class is basically a shortcut for `:not(:has())`. It is supported by ##### Pseudo-class `:contains()` -This pseudo-class principle is very simple: it allows to select the elements that contain specified text or which content matches a specified regular expression. Regex flags are supported. Please note, that this pseudo-class uses `textContent` element property for matching (and not the `innerHTML`). +This pseudo-class principle is very simple: it allows to select the elements that contain specified text or which content matches a specified regular expression. Regex flags are supported. Please note that this pseudo-class uses `textContent` element property for matching (and not the `innerHTML`). **Syntax** ``` @@ -1493,50 +1738,25 @@ div:contains(target text) { remove: true; } div[class]:has(> a:not([id])) { remove: true; } ``` -> Please note, that all style properties will be ignored if `:remove()` pseudo-class or `remove` pseudo-property is used. +> Please note that all style properties will be ignored if `:remove()` pseudo-class or `remove` pseudo-property is used. - -##### Selectors debugging mode + +### Cosmetic rules priority -Sometimes, you might need to check the performance of a given selector or a stylesheet. In order to do it without interacting with javascript directly, you can use a special `debug` style property. When `ExtendedCss` meets this property, it enables the "debug"-mode either for a single selector or for all selectors depending on the `debug` value. +The way **element hiding** and **CSS rules** are applied is platform-specific. -**Debugging a single selector** -``` -#$#.banner { display: none; debug: true; } -``` +**In AdGuard for Windows, Mac, and Android**, we use a stylesheet injected into the page. The priority of cosmetic rules is the same as any other websites' CSS stylesheet. But there is a limitation: [element hiding](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#elemhide-rules) and [CSS](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#cosmetic-css-rules) rules cannot override inline styles. In such cases, it's recommended to use extended selectors or HTML filtering. -**Enabling global debug** -``` -#$#.banner { display: none; debug: global; } -``` +**In AdGuard browser extensions**, the so called "user stylesheets" are used. They have higher priority than even the inline styles. - -##### Testing extended selectors - -To load ExtendedCss to a current page, copy and execute the following code in a browser console: -``` -!function(E,x,t,C,s,s_){C=E.createElement(x),s=E.getElementsByTagName(x)[0],C.src=t, -C.onload=function(){alert('ExtCss loaded successfully')},s.parentNode.insertBefore(C,s)} -(document,'script','https://AdguardTeam.github.io/ExtendedCss/extended-css.min.js') -``` - -Alternatively, install an "ExtendedCssDebugger" userscript: https://github.com/AdguardTeam/Userscripts/blob/master/extendedCssDebugger/extended-css.debugger.user.js - -You can now use the `ExtendedCss` constructor in the global scope, and its method `ExtendedCss.query` as `document.querySelectorAll`. -``` -var selectorText = "div.block[-ext-has='.header:matches-css-after(content: Anzeige)']"; - -ExtendedCss.query(selectorText) // returns an array of Elements matching selectorText -``` +**Extended CSS selectors** use Javascript to work and basically add an inline style themselves, therefore they can override any style. ## HTML filtering rules In most cases, the basis and cosmetic rules are enough to filter ads. But sometimes it is necessary to change the HTML-code of the page itself before it is loaded. This is when you need filtering rules for HTML content. They allow to indicate the HTML elements to be cut out before the browser loads the page. -> #### Compatibility with different versions of AdGuard -> Rules are supported by AdGuard for Windows, Mac, Android and by the AdGuard's Firefox add-on. -> This type of rules don't work in extensions for other browsers because they are unable to modify content on network level. +> **Compatibility with different versions of AdGuard.** Rules are supported by AdGuard for Windows, Mac, Android and by the AdGuard's Firefox add-on. This type of rules don't work in extensions for other browsers because they are unable to modify content on network level. ### Syntax @@ -1591,8 +1811,7 @@ Following rule will delete all `script` elements with a `banner` substring in th $$script[tag-content="banner"] ``` -> #### Nested elements -> If we are dealing with multiple nested elements and they all fall within the same HTML filtering rule, they all are going to be deleted. +> **Nested elements.** If we are dealing with multiple nested elements and they all fall within the same HTML filtering rule, they all are going to be deleted. ##### `wildcard` @@ -1612,14 +1831,13 @@ It will check, if the element's code contains two consecutive substrings `banner Specifies the maximum length for content of HTML element. If this parameter is set and the content length exceeds the value - a rule does not apply to the element. -> #### Default setting -> If this parameter is not specified, the `max-length` is considered to be 8192. +> **Default value.** If this parameter is not specified, the `max-length` is considered to be 8192. For example: ``` $$div[tag-content="banner"][max-length="400"] ``` -This rule will remove all the `div` elements, whose code contains the substring` banner` and the length of which does not exceed `400` characters. +This rule will remove all the `div` elements, whose code contains the substring `banner` and the length of which does not exceed `400` characters. ##### `min-length` @@ -1631,7 +1849,7 @@ For example: $$div[tag-content="banner"][min-length="400"] ``` -This rule will remove all the `div` elements, whose code contains the substring` banner` and the length of which exceeds `400` characters. +This rule will remove all the `div` elements, whose code contains the substring `banner` and the length of which exceeds `400` characters. #### Exceptions @@ -1661,8 +1879,11 @@ We recommend to use this kind of exceptions only if it is not possible to change AdGuard supports a special type of rules that allows you to inject any javascript code to websites pages. -> #### Restrictions -> Please note that this type of rules can be used **only in trusted filters**. This category includes your own **User filter** and all the filters created by AdGuard Team. +> **Restrictions.** Please note that this type of rules can be used **only in trusted filters**. This category includes your own **User filter** and all the filters created by AdGuard Team. + +> **Compatibility with different versions of AdGuard.** Javascript rules aren't supported by AdGuard for iOS. + +We **strongly recommend** using scriptlets instead of Javascript rules whenever possible. JS rules are supposed to help with debugging, but as a long-time solution a scriptlet rule should be used. ### Syntax @@ -1707,7 +1928,9 @@ We recommend to use this kind of exceptions only if it is not possible to change Scriptlet is a JavaScript function that provides extended capabilities for content blocking. These functions can be used in a declarative manner in AdGuard filtering rules. ->AdGuard supports a lot of different scriptlets. Please note, that in order to achieve cross-blocker compatibility, we also support syntax of uBO and ABP. +> AdGuard supports a lot of different scriptlets. Please note that in order to achieve cross-blocker compatibility, we also support syntax of uBO and ABP. + +> **Compatibility with different versions of AdGuard.** Scriptlet rules aren't supported by AdGuard for iOS. ### Syntax @@ -1728,6 +1951,9 @@ This rule will be applied to example.org pages (and its subdomains) and will exe More information about scriptlets can be found [on GitHub](https://github.com/AdguardTeam/Scriptlets#scriptlets). +> For more information on how to debug scriptlets, jump to [this section](#debug-scriptlets) of the artcile. + + (#) ## Modifiers Each rule can be modified using the modifiers described in the following paragraphs. @@ -1753,9 +1979,8 @@ this: `\]`. ### app `app` lets you narrow the rule coverage down to a specific application (or a list of applications). -The modifier's behavior and syntax perfectly match the corresponding -[$app modifier](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#app) of basic -rules. + +The modifier's behavior and syntax perfectly match the corresponding [$app modifier](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#app) of basic rules. `app` examples: * `[$app=org.example.app]example.com##.textad` - hides a `div` with a class `textad` at `example.com` and all subdomains in requests sent from the `org.example.app` Android app. @@ -1763,6 +1988,8 @@ rules. * `[$app=com.apple.Safari]example.org#%#//scriptlet('prevent-setInterval', 'check', '!300')`. This rule will apply the corresponding scriptlet only in Safari browser on Mac. * `[$app=org.example.app]#@#.textad` — disables all `##.textad` rules for all domains while using `org.example.app`. +> **Compatibility with different versions of AdGuard.** This type of rules is supported by AdGuard for Windows, Mac and Android. **Developer builds only at this moment.** + ### domain @@ -1783,10 +2010,12 @@ Please note that there are 2 ways to specify domain restrictions for non-basic r But rules with mixed style domains restriction are considered invalid. So, for example, the rule `[$domain=example.org]example.com##.textad` will be rejected. +> **Compatibility with different versions of AdGuard.** This type of rules is supported by AdGuard for Windows, Mac and Android. **Developer builds only at this moment.** + ## Information for filters maintainers -If you maintain a third-party filter that is known to AdGuard, you might be interested in the information presented in this section. Please note, that hints will be applied to registered filters only. The filter is considered to be registered and known by AdGuard, if it is present in the [known filters index](https://filters.adtidy.org/extension/chromium/filters.json). If you want your filter to be registered, please file an issue to [AdguardFilters repo](https://github.com/AdguardTeam/AdguardFilters). +If you maintain a third-party filter that is known to AdGuard, you might be interested in the information presented in this section. Please note that hints will be applied to registered filters only. The filter is considered to be registered and known by AdGuard, if it is present in the [known filters index](https://filters.adtidy.org/extension/chromium/filters.json). If you want your filter to be registered, please file an issue to [AdguardFilters repo](https://github.com/AdguardTeam/AdguardFilters). ### Pre-processor directives @@ -2024,6 +2253,98 @@ This rule will be available for every platform except Safari extension, iOS, and ||example.org^ ``` + + +## How to debug filtering rules + +It may be possible to create simple filtering rules "in your head", but for anything even slightly more complicated you'd need additional tools to debug and iterate them. There are tools to assist you with that. You can use DevTools in Chrome and its analogs in other browsers, but most AdGuard products provide another one: Filtering log. + + +### Filtering log + +Filtering log is an advanced tool that will be helpful mostly to filter developers. It lists all web requests that pass through AdGuard, gives you exhaustive information on each of them, offers multiple sorting options, and has other useful features. + +Depending on which AdGuard product you're using, Filtering log can be located in different places. + +* In **AdGuard for Windows** you'll find it inside *Ad Blocker* tab or via the tray menu; +* In **AdGuard for Mac** it's under *Settings > Advanced > Filtering log*; +* In **AdGuard for Android** it's a separate item in the side menu, also filtering log for a specific app or website is accessible from the Assistant. +* In **AdGuard browser extensions** it's accessible from the *Miscellaneous* settings tab or by right-clicking the extension icon. Only Chromium- and Firefox-based browsers show applied **element hiding rules** (including CSS, ExtCSS) and **JS rules and scriptlets** in their Filtering logs. + +> In **AdGuard for iOS** and in **AdGuard for Safari** Filtering log does not exist because of the way content blockers are implemented in Safari. AdGuard doesn't see the web requests and therefore can't display them. + + +### Selectors debugging mode + +Sometimes, you might need to check the performance of a given selector or a stylesheet. In order to do it without interacting with javascript directly, you can use a special `debug` style property. When `ExtendedCss` meets this property, it enables the debug mode either for a single selector or for all selectors, depending on the `debug` value. Open the browser console while on a web page to see the timing statistics for selector(s) that were applied there. Debugging mode displays the following stats for each of the debugged selectors: + +`array`: time that it took to apply the selector on the page, for each of the instances that it's been applied (in milliseconds) +`length`: total number of times that the selector has been applied on the page +`mean`: mean time that it took to apply the selector on the page +`stddev`: standard deviation +`squaredSum`: sum of squared deviations from the mean +`sum`: total time it took to apply the selector on the page across all instances + + +#### Examples + +**Debugging a single selector** + +When the value of the `debug` property is `true`, only information about this selector will be shown in the browser console. + +``` +#$?#.banner { display: none; debug: true; } +``` + +**Enabling global debug** + +When the value of the `debug` property is `global`, the console will display information about all ExtendedCSS selectors that have matches on the current page, for all ExtendedCSS rules from any of the enabled filters. + +``` +#$?#.banner { display: none; debug: global; } +``` + + +#### Testing extended selectors without AdGuard + +If you don't have AdGuard installed, you can still test extended selectors, but you'll have to load ExtendedCSS to the current page first. To do so, copy and execute the following code in the browser console: + +``` +!function(E,x,t,C,s,s_){C=E.createElement(x),s=E.getElementsByTagName(x)[0],C.src=t, +C.onload=function(){alert('ExtCss loaded successfully')},s.parentNode.insertBefore(C,s)} +(document,'script','https://AdguardTeam.github.io/ExtendedCss/extended-css.min.js') +``` + +Alternatively, install an "ExtendedCssDebugger" userscript: https://github.com/AdguardTeam/Userscripts/blob/master/extendedCssDebugger/extended-css.debugger.user.js + +You can now use the `ExtendedCss` constructor in the global scope, and its method `ExtendedCss.query` as `document.querySelectorAll`. +``` +var selectorText = "div.block[-ext-has='.header:matches-css-after(content: Anzeige)']"; + +ExtendedCss.query(selectorText) // returns an array of Elements matching selectorText +``` + + +### Debugging scriptlets + +If you're using AdGuard browser extension and want to debug a [scriptlet rule](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters#scriptlets), you can get additional information by simpy having the Filtering log opened. In that case, scriptlets will switch to debug mode and will write more information to the browser's console. + +The following scriptlets may be especially useful for debug purposes: + +[`debug-current-inline-script`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#debug-current-inline-script) +[`debug-on-property-read`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#debug-on-property-read) +[`debug-on-property-write`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#abort-on-property-write) +[`log-addEventListener`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#log-addEventListener) +[`log-eval`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#log-eval) +[`log`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#log) + +The following scriptlets may be used for debug purposes when applied without any parameters: + +[`requestAnimationFrame`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#prevent-requestanimationframe) +[`prevent-setInterval`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#prevent-setinterval) +[`prevent-setTimeout`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#prevent-settimeout) + + ## Good luck with creating filters! diff --git a/01.general/02.how-to-create-your-own-ad-filters/docs.ru.md b/01.general/02.how-to-create-your-own-ad-filters/docs.ru.md index 38b48b24..b8c7f282 100644 --- a/01.general/02.how-to-create-your-own-ad-filters/docs.ru.md +++ b/01.general/02.how-to-create-your-own-ad-filters/docs.ru.md @@ -53,6 +53,7 @@ visible: true * [Generic правила](#generic-rules) * [$generichide](#generichide-modifier) * [$genericblock](#genericblock-modifier) + * [$specifichide](#specifichide-modifier) * [Расширенные возможности](#advanced-modifiers) * [$removeparam](#removeparam-modifier) * [$important](#important-modifier) @@ -66,6 +67,9 @@ visible: true * [$app](#app-modifier) * [$redirect](#redirect-modifier) * [$denyallow](#denyallow-modifier) + * [$redirect-rule](#redirect-rule-modifier) + * [noop](#noop-modifier) + * [$removeheader](#removeheader-modifier) * [Другие правила](#non-basic-rules) * [Косметические правила](#cosmetic-rules) * [Правила скрытия элементов](#cosmetic-elemhide-rules) @@ -81,8 +85,7 @@ visible: true * [Псевдокласс `:nth-ancestor()`](#extended-css-nth-ancestor) * [Псевдокласс `:upward()`](#extended-css-upward) * [Псевдокласс `:remove()` и псевдо-свойство `remove`](#remove-pseudos) - * [Режим отладки селекторов](#selectors-debugging-mode) - * [Тестирование расширенных селекторов](#testing-extended-selectors) + * [Приоритетность косметических правил](#cosmetic-rules-priority) * [Правила фильтрации HTML](#html-filtering-rules) * [Синтаксис](#html-filtering-rules-syntax) * [Специальные атрибуты](#html-filtering-rules-attributes) @@ -103,6 +106,11 @@ visible: true * [Синтаксис Hints](#hints_syntax) * [Оптимизация фильтров и NOT_OPTIMIZED hint](#not_optimized) * [PLATFORM и NOT_PLATFORM hints](#platform_not_platform) +* [Как отлаживать работу фильтров](#how-to-debug) + * [Журнал фильтрации](#debig-filtering-log) + * [Режим отладки селекторов](#selectors-debugging-mode) + * [Тестирование расширенных селекторов](#testing-extended-selectors) + * [Отладка скриптлетов](#debug-scriptlets) * [Удачи в составлении своих фильтров!](#good-luck) @@ -192,7 +200,7 @@ visible: true * `http://example.org/banner.png` даже если для этого адреса есть правило блокировки. -> Обратите внимание, что правила блокировки с модификатором [`$important`](#important-modifier) все равно будут приоритетнее чем обычные правила разблокировки. +> Обратите внимание, что правила блокировки с модификатором [`$important`](#important-modifier) все равно будут приоритетнее, чем обычные правила разблокировки. ### Разблокировка всего сайта @@ -226,7 +234,7 @@ visible: true | ID selector | `#banners` | Соответствует всем элементам с атрибутом `id` равным `banners`.
![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_id_selector.png) | | Class selector | `.banners` | Соответствует всем элементам типа `class` содержащих `banners`.
![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_selector.png) | | Attribute selector | `div[class="banners"]` | Соответствует всем `div` элементам с `class` **равным** `banners`.
![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_attr.png) | -| Attribute substring selector | `div[class^="advert1"] ` | Соответствует всем `div` элементам класс `class` которых **начинается** с `advert1` строки.
![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_attr_start.png) | +| Attribute substring selector | `div[class^="advert1"]` | Соответствует всем `div` элементам класс `class` которых **начинается** с `advert1` строки.
![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_attr_start.png) | | Attribute substring selector | `div[class$="banners_ads"]` | Соответствует всем `div` элементам `class` которых **заканчивается** на `banners_ads`.
![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_class_attr_end.png) | | Attribute substring selector | `a[href^="http://example.com/"]` | Соответствует всем ссылкам загруженным с `http://example.com/`
![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_attr_start.png) | | Attribute selector | `a[href="http://example.com/"]` | Соответствует всем ссылкам **конкретно** `http://example.com/` .
![](https://cdn.adguard.com/public/Adguard/kb/en/rules_syntax/css_attr_equal.png) @@ -262,16 +270,14 @@ visible: true * **`^`** — указатель для разделительного символа. Разделителем может быть любой символ кроме буквы, цифры и следующих символов: `_` `-` `.` `%`. Например, в адресе `http:`**`//`**`example.com`**`/?`**`t=1`**`&`**`t2=t3` жирным выделены разделительные символы. Конец адреса также принимается в качестве разделителя. * **`|`** — указатель на начало или конец адреса. Значение зависит от того, находится этот символ в начале или конце маски. Например, правило `swf|` соответствует `http://example.com/annoyingflash.swf` , но не `http://example.com/swf/index.html`. `|http://example.org` соответствует `http://example.org`, но не `http://domain.com?url=http://example.org`. -> #### Визуальное представление -> Советуем ознакомиться с [этой статьей](https://adblockplus.org/filter-cheatsheet#blocking), чтобы лучше понять, как должны строиться такие правила. +> **Визуальное представление**. Также советуем ознакомиться с [этой статьей](https://adblockplus.org/filter-cheatsheet#blocking), чтобы лучше понять, как должны строиться такие правила. ### Поддержка регулярных выражений Если вы хотите добиться еще большей гибкости при составлении правил, вы можете использовать [регулярные выражения](https://developer.mozilla.org/ru/docs/Web/JavaScript/Guide/Regular_Expressions) вместо упрощенной маски со специальными символами, которая используется по умолчанию. -> #### Производительность -> Такие правила работают медленнее обычных, поэтому рекомендуется избегать их, или хотя бы ограничивать их область действия конкретными доменами. +> **Производительность**. Такие правила работают медленнее обычных, поэтому рекомендуется избегать их, или хотя бы ограничивать их область действия конкретными доменами. Чтобы блокировщик определил, что вы хотите использовать регулярное выражение, необходимо, чтобы `pattern` имел особый вид: ``` @@ -280,8 +286,7 @@ pattern = "/" regexp "/" Например, правило `/banner\d+/$third-party` применит регулярное выражение `banner\d+` ко всем сторонним запросам. Правила-исключения с использованием регулярных выражений выглядят вот так: `@@/banner\d+/`. -> #### Совместимость -> Браузерные расширения AdGuard для Safari и AdGuard для iOS не полностью поддерживают регулярные выражения в силу [ограничений Content Blocking API](https://webkit.org/blog/3476/content-blockers-first-look/) (в статье по ссылке найдите раздел "The Regular expression format"). +> **Совместимость с различными версиями AdGuard.** Браузерные расширения AdGuard для Safari и AdGuard для iOS не полностью поддерживают регулярные выражения в силу [ограничений Content Blocking API](https://webkit.org/blog/3476/content-blockers-first-look/) (в статье по ссылке найдите раздел "The Regular expression format"). ### Поддержка wildcard для доменов верхнего уровня (TLD) @@ -289,6 +294,8 @@ pattern = "/" regexp "/" Вы можете использовать wildcard-символ для доменов верхнего уровня в паттернах косметических, html и js правил. Например, правило `example.*##.banner` будет соответствовать всем `example.TLD` доменам: `example.ru`, `example.com`, `example.net`, `example.org` и т.д. При составлении базовых правил вы можете использовать *wildcard-символ для TLD* только вместе с модификатором `$domain`. Например, `||*/banners/*$image,domain=example.*` +> **Совметимость с различными версиями AdGuard.** Поддерживается: AdGuard для Windows/macOS/Android/Safari/iOS и браузрными расширениями для Chrome/Firefox/Edge. + ### Примеры базовых правил @@ -301,8 +308,7 @@ pattern = "/" regexp "/" ### Модификаторы -> #### Обратите внимание -> Возможности, описанные в этом разделе, обычно используются опытными пользователями. Они расширяют возможности «Общих правил», но для их применения необходимо иметь начальное представление о работе браузера. +> **Обратите внимание!** Возможности, описанные в этом разделе, обычно используются опытными пользователями. Они расширяют возможности «Общих правил», но для их применения необходимо иметь начальное представление о работе браузера. Вы можете изменить поведение «общего правила», используя дополнительные модификаторы. Список этих параметров располагается в конце правила за знаком доллара `$` и разделяется запятыми. @@ -311,8 +317,7 @@ pattern = "/" regexp "/" ||domain.com^$popup,third-party ``` -> #### Визуальное представление -> Советуем ознакомиться с [этой статьей](https://adblockplus.org/filter-cheatsheet#options), чтобы лучше понять, как должны применяться модификаторы. +> **Визуальное представление**. также советуем ознакомиться с [этой статьей](https://adblockplus.org/filter-cheatsheet#options), чтобы лучше понять, как должны применяться модификаторы. #### Базовые модификаторы @@ -336,13 +341,42 @@ pattern = "/" regexp "/" * `||baddomain.com^$domain=~example.org` — правило для блокировки запросов, которые соответствуют указанной маске, и отправленных с любого домена, кроме `example.org` и его поддоменов. * `||baddomain.com^$domain=example.org|~foo.example.org` — в данном примере правило будет соответствовать запросам, отправленным с домена `example.org` и всех его поддоменов, кроме поддомена `foo.example.org`. +###### Когда `domain` соответствует целевому домену + +В некоторых случаях модификатор `$domain` может соответствовать не только домену-рефереру, но и целевому домену. Это происходит в случае, когда всё из перечисленного верно: + +1) Запрос имеет тип `document` +2) Паттерн правила не соответствует какому-либо или каким-либо конкретным доменам +3) Паттерн правила не содержит регулярных выражений + +Если все условия выполнены, модификатор `domain` будет соответствовать как рефереру, так и целевому домену. + +Если какие-либо из условий выше не выполнены, но правило содержит модификатор `cookie` или `csp`, модификатор `domain` всё равно будет соответствовать целевому домену. + +Если реферер соответствует правилу с `domain`, которое явно исключает домен реферера, то правило не сработает, даже если целевой домен тоже ему соответствует. Это также касается правил с модификаторами `cookie` и `csp`. + +**Примеры:** + +* `*$cookie,domain=example.org|example.com` заблокирует cookies для всех запросов от и к `example.org` и `example.com`. +* `*$document,domain=example.org|example.com` заблокирует все запросы от и к `example.org` и `example.com`. + +В следующих примерах предполагается, что запросы отправляются от `http://example.org/page`(реферер), а целевой URL - `http://targetdomain.com/page`. + +* `page$domain=example.org` сработает, так как соответствует рефереру. +* `page$domain=targetdomain.com` сработает, так как соответствует целевому домену, но выполнены все условия, перечисленные выше. +* `||*page$domain=targetdomain.com` не сработает, поскольку паттерн `||*page` указывает на конкретные домены. +* `||*page$domain=targetdomain.com,cookie` сработает несмотря на то, что паттерн `||*page` указывает на кокретные домены, поскольку правило содержит модификатор `$cookie`. +* `/banner\d+/$domain=targetdomain.com` не сработает, поскольку правило содержит регулярное выражение. +* `page$domain=targetdomain.com|~example.org` не сработает, так как домен реферера явно исключён. + +> **Важно!** Safari не поддерживает одновременно разрешенные и запрещенные домены, поэтому правила вида `||baddomain.com^$domain=example.org|~foo.example.org` не действуют в AdGuard для Safari. + ##### **`third-party`** Ограничение на сторонние или собственные запросы. Сторонним является запрос, отправленный с другого сайта. Например, запрос к домену `example.org`, отправленный с домена `domain.com`, является сторонним. -> #### Поддомены -> Обратите внимание, что запрос, отправленный на поддомен того же домена (или наоборот), сторонним не является. Например, запрос к `subdomain.example.org`, отправленный с домена `example.org`, не является сторонним. +> **Поддомены**. Запрос, отправленный на поддомен того же домена (или наоборот), сторонним не является. Например, запрос к `subdomain.example.org`, отправленный с домена `example.org`, не является сторонним. Если указан модификатор `third-party`, то правило применяется только к сторонним запросам. @@ -365,6 +399,11 @@ AdGuard будет пытаться закрыть браузерную вкла * `||domain.com^$popup` — при попытке перехода на сайт `http://domain.com` с любой страницы в браузере, новая вкладка, в которой должен открыться указанный сайт, будет закрыта. +>Модификатор может не работать, если всплывающая страница закэширована браузером. Также модификатор может не сработать, если для показа попапа используются нестандартные методы. В такие случаях лучше использовать расширение [AdGuard Popup Blocker](https://github.com/AdguardTeam/PopupBlocker). + +>**Важно!** В отличие от браузерных расширений, модификатор `$popup` крайне нестабильно работает с приложениями AdGuard для Windows, Mac и Android. В AdGuard для Safari и iOS `$popup`-правила просто заблокируют страницу. + + ##### **`match-case`** @@ -379,8 +418,7 @@ AdGuard будет пытаться закрыть браузерную вкла Существует целый набор модификаторов, которые ограничивают действие правила только запросами к ресурсам определенного типа. Эти модификаторы можно комбинировать, например распространить правило одновременно на картинки и скрипты. -> #### Совместимость с разными версиями AdGuard -> Обратите внимание, что существует большая разница в том, как разные версии AdGuard определяют тип контента. В случае браузерных расширений тип контента для каждого запроса предоставляется самим браузером. В случае AdGuard для Windows, macOS и Android для определения используется следующая методика: вначале мы пытаемся определить тип запроса по расширению загружаемого файла. Если запрос не заблокирован на этом этапе, то тип запроса уточняется с использованием заголовка `Content-Type` в начале ответа, полученного от сервера. +> **Совместимость с разными версиями AdGuard.** Существует большая разница в том, как разные версии AdGuard определяют тип контента. В случае браузерных расширений тип контента для каждого запроса предоставляется самим браузером. В случае AdGuard для Windows, macOS и Android для определения используется следующая методика: вначале мы пытаемся определить тип запроса по расширению загружаемого файла. Если запрос не заблокирован на этом этапе, то тип запроса уточняется с использованием заголовка `Content-Type` в начале ответа, полученного от сервера. ##### Примеры ограничений @@ -437,22 +475,22 @@ AdGuard будет пытаться закрыть браузерную вкла Правило будет соответствовать запросам, сделанным либо `navigator.sendBeacon()`, либо атрибутом ссылки `ping`. -> #### Совместимость с разными версиями AdGuard -> AdGuard для Windows, macOS и Android не всегда могут корректно определить `navigator.sendBeacon()`. Для надёжного определения используйте браузерные расширения AdGuard. +> **Совместимость с разными версиями AdGuard.** AdGuard для Windows, macOS и Android не всегда могут корректно определить `navigator.sendBeacon()`. Для надёжного определения используйте браузерные расширения AdGuard. ##### **`xmlhttprequest`** Правило применяется только к ajax-запросам. То есть к запросам, отправленным с помощью javascript-объекта `XMLHttpRequest`. -> #### Совместимость с разными версиями AdGuard -> AdGuard для Windows, macOS и Android не всегда могут корректно определить этот тип контента, и определяют его как `other` или `script`. +> **Совместимость с разными версиями AdGuard.** AdGuard для Windows, macOS и Android не всегда могут корректно определить этот тип контента, и определяют его как `other` или `script`. ##### **`websocket`** Правило применяется только к WebSocket-соединениям. +> **Совместимость с разными версиями AdGuard.** AdGuard для Safari и iOS не могут правильно применять этот модификтор из-за ограничений Safari. + ##### **`webrtc`** @@ -465,6 +503,8 @@ AdGuard будет пытаться закрыть браузерную вкла * `||example.com^$webrtc,domain=example.org` - это правило блокирует WebRTC-соединения c `example.com` для `example.org`. * `@@*$webrtc,domain=example.org` - это правило отменяет блокировку всех WebRTC-соединений для `example.org`. +> **Предупреждение об устаревании.** Этот модификатор устарел и в будущем его поддержка будет убрана. Если вы хотите блокировать WebRTC, рассмотрите возможность использования скриптлета `$nowebrtc`. + ##### **`other`** @@ -475,8 +515,7 @@ AdGuard будет пытаться закрыть браузерную вкла Правила-исключения отключают действие других базовых правил для адресов, которым они соответствуют. Отличаются правила-исключения тем, что они начинаются со специального маркера `@@`. Для таких правил работают все базовые модификаторы, перечисленные выше. Также добавляется несколько специальных модификаторов, которые будут описаны ниже. -> #### Визуальное представление -> Советуем ознакомиться с [этой статьей](https://adblockplus.org/filter-cheatsheet#exceptions), чтобы лучше понять, как должны строиться правила-исключения. +> **Визуальное представление**. Также советуем ознакомиться с [этой статьей](https://adblockplus.org/filter-cheatsheet#exceptions), чтобы лучше понять, как должны строиться правила-исключения. ##### **`elemhide`** @@ -490,7 +529,7 @@ AdGuard будет пытаться закрыть браузерную вкла ##### **`content`** -Отключает правила фильтрации HTML-элементов на страницах, подходящих под правило. О правилах фильтрации HTML-элементов речь [пойдет ниже](#html-filtering-rules). +Отключает правила фильтрации HTML-элементов и replace-правила на страницах, подходящих под правило. О правилах фильтрации HTML-элементов речь пойдёт [здесь](#html-filtering-rules), а о replace-правилах — [здесь](#replace-modifier). ###### Примеры `content` @@ -517,7 +556,7 @@ AdGuard будет пытаться закрыть браузерную вкла ##### **`extension`** -Отключает все пользовательские скрипты на страницах, подходящих под это правило. +Отключает все пользовательские скрипты на страницах, подходящих под это правило. Этот модификатор имеет смысл только в продуктах AdGuard, которые могут работать как userscript hosts (AdGuard для Windows/macOS/Android). ###### `extension` example @@ -538,21 +577,26 @@ AdGuard будет пытаться закрыть браузерную вкла Отключает модуль "Антитрекинг" для всех страниц и запросов, подходящих под это правило. -> #### Совместимость с разными версиями AdGuard -> Модуль "Антитрекинг" на данный момент доступен в приложениях AdGuard для Windows, Mac, Android и браузерном расширении AdGuard. В продуктах без поддержки модуля "Антитрекинг" правила с этим модификатором игнорируются. - ###### Примеры `stealth` -* `@@||example.com^$stealth` — полностью отключает модуль `Антитрекинг` для запросов к `example.com` и поддоменам. -* `@@||domain.com^$script,stealth,domain=example.com` — полностью отключает модуль `Антитрекинг` только для script-запросов к `domain.com` (и поддоменам) на `example.com` и всех его поддоменах. +* `@@||example.com^$stealth` — полностью отключает модуль `Антитрекинг` для запросов к `example.com` и поддоменам (кроме блокировки cookies и скрытия параметров отслеживания, см.ниже). +* `@@||domain.com^$script,stealth,domain=example.com` — отключает модуль `Антитрекинг` только для script-запросов к `domain.com` (и поддоменам) на `example.com` и всех его поддоменах. +* Блокировка cookies и скрытие параметров отслеживания достигается использованием правил с модификаторами `$cookie` и `$removeparam`. Правила-исключения только с модификатором `$stealth` не дадут желаемого результата. Если вы хотите полностью отключить все функции Антитрекинга для определённого домена, вам надо включить в правило все три модификатора: `@@||example.org^$stealth,removeparam,cookie` + +> **Совместимость с разными версиями AdGuard.** Антитрекинг на данный момент доступен в AdGuard для Windows, Mac, Android и в браузерных расширениях AdGuard для Chrome, Firefox, Edge. Пока что продукты, не поддерживающие Антитрекинг, будут игнорировать этот модификатор. ##### Generic правила Перед тем, как перейти к описанию следующих модификаторов, необходимо ввести определение _"generic правил"_. Правило является "generic", если его действие не ограничено конкретными доменами. +Также поддерживается wildcard-символ `*`. + Например, следующие правила являются "generic": ``` ###banner +*###banner +#@#.adsblock +*#@#.adsblock ~domain.com###banner ||domain.com^ ||domain.com^$domain=~example.com @@ -578,80 +622,104 @@ domain.com###banner * `@@||example.com^$genericblock` — отключает "generic" базовые правила на страницах сайта `example.com` и всех его поддоменах. + +##### **`specifichide`** + +Имеет эффект, проитвоположный [`generichide`](#generichide-modifier). Отключает все "specific" правила сокрытия элементов и CSS-правила, но не отключает "general"-правила. + +* `@@||example.org^$specifichide` — отключит `example.org##.banner`, но не `##.banner`. + +> Обратите внимание, что [модификатор `$elemhide`](#elemhide-modifier) может отключить все косметические правила разом. + +> **Совместимость с разными версиями AdGuard.** Правила с этим модификатором поддерживаются AdGuard для Windows, Mac, Android,а также браузерными расширениями AdGuard для Chrome, Firefox, Edge. **На данный момент только в девелопер-сборках.** + ### Расширенные возможности Модификаторы, описанные в этом разделе, полностью меняют поведение базовых правил, к которым эти модификаторы применены. - #### **`removeparam`** -Правила с модификатором `$removeparam` предназначены для того, чтобы расширить возможности Антитрекинга по блокированию параметров отслеживания на URL-страницах. *Обратите внимание*, что подобные правила применяются только к запросам типа `GET`. +>`$removeparam` и `$queryprune` полностью взаимозаменяемы и по сути являются одинаковыми модификаторами с различными названиями. -> #### Совместимость с разными версиями AdGuard -> Правила с модификаторами `$removeparam` поддерживаются в AdGuard для Windows, Mac и Android. - -> #### Несколько правил в одном запросе -> В случае, если несколько правил `$removeparam` соответствуют одному запросу, мы применим каждый из них поочередно. - -> #### Ограничения -> Обратите внимание, что этот тип правил может быть использован **только в проверенных фильтрах**. В эту категорию входят ваш собственный **Пользовательский фильтр** и все фильтры, созданные командой AdGuard. - -> #### Совместимость с другими модификаторами -> Правила `$removeparam` совместимы только с модификаторами: `$domain`, `$third-party`, `$app`, `$important` и `$match-case`. Правила с любыми другими модификаторами будут считаться неверными и применяться не будут. +Правила с модификатором `$removeparam` предназначены для того, чтобы убирать параметры из URL страниц. Такие правила применяются *только* к запросам типов `GET`, `HEAD`, и `OPTIONS`. ##### Синтаксис -Чтобы уточнить параметр, на который должно влиять правило, следует использовать следующий синтаксис: +###### Базовый синтаксис -* `$removeparam=param` -- убирает параметр с названием `param` из URL любого запроса. Например, запрос к `http://example.com/page?param=1&another=2` будет преобразован в `http://example.com/page?another=2`. +* `$removeparam=param` -- убирает параметр запроса с именем `param` из URL любого запроса. Например, запрос к `http://example.com/page?param=1&another=2` будет преобразован в `http://example.com/page?another=2`. -Используйте `|` для разделения параметров: +> Базовый синтаксис `$removeparam` поддерживается начиная с версии 1.7 [CoreLibs](https://adguard.com/ru/blog/introducing-corelibs.html) и версии 3.6 Браузерного расширения AdGuard. -* `$removeparam=p1|p2` -- убирает параметры `p1` и `p2` из URL любого запроса. Например, запрос к `http://example.com/page?p1=1&p2&p3` будет преобразован в `http://example.com/page?p3`. +###### Регулярные выражения -> **Обратите внимание**, что блокирующее правило с параметром `$removeparam` должно содержать хотя бы один уточнённый параметр. Например, правило вроде `example.com$removeparam` будет считаться неверным и применяться не будет. +Вы также можете использовать регулярные выражения для соответствия параметрам запроса и/или их значениям: -Параметры сопоставляются лексикографически. Это значит, что правило `$removeparam=param` не станет убирать параметр с названием `Param` или `some_param`. Если вы хотите обойти этот момент, вы можете использовать регулярные выражения: +* `$removeparam=/regex/[options]` -- убирает все параметры, соответствующие регулярному выражению из URL любого запроса. В отличие от базового синтаксиса, это означает *"убрать параметры запроса, нормализованные к строке `name=value`, которая соответствует регулярному выражению"*. Здесь `[options]` -- это список опций регулярного выражения. На данный момент, единственная поддерживаемая опция — это `i`, делающая соответствие нечувствительным к регистру. + +> Cинтаксис `$removeparam` для регулярных выражений будет доступен начиная с версии 1.8 CoreLibs и версии 4.0. Браузерного расширения AdGuard, а пока используйте упрощенный вариант: `$removeparam=param`. + +> **Экранирование специальных символов**: не забудьте экранировать специальные символы в регулярных выражениях, такие как `,`, `/` и `$`. Для этой цели используйте символ `\`. Например, экранированная запятая должна выглядеть так: `\,`. + +> Важно: заметьте, что правила с регулярными выражениями смотрят как на имя, так и на значение параметра. Чтобы минимизировать риск ошибки, рекомендуем начинать регулярное выражение с `/^`, если только вы не хотите специально работать с значениями параматетров. + +> Мы будем стараться обнаруживать и игнорировать неэкранированные символы `$` автоматически, используя следующее правило большого пальца: +> Это не является разделителем опций, если: +> Оно выглядит как `$/`, +> Существует другой символ слэша (`/`) слева от него, +> Существует другой неэкранированный символ `$` слева от этого символа слэша. + +###### Убрать все параметры запроса + +Укажите "голый" `$removeparam`, чтобы убрать все параметры запроса: + +* `||example.org^$removeparam` -- убирает все параметры запроса из URL, соответствующего `||example.org^`. + +###### Инверсия + +Используйте символ `~`, чтобы применить инверсию: + +* `$removeparam=~param` -- убирает все параметры запроса с именем, отличным от `param`. +* `$removeparam=~/regex/` -- убирает все параметры запроса, которые не соответствуют регулярному выражению. + +###### Отмена `$removeparam` + +Этот тип правил работает практически так же, как и в случае с модификаторами [`$csp`](#csp-modifier) и [`$redirect`](#redirect-modifier). + +Используйте `@@`, чтобы отменить `$removeparam`: + +* `@@||example.org^$removeparam` -- отменяет все правила `$removeparam` для URL, соответствующих `||example.org^`. +* `@@||example.org^$removeparam=param` -- отменяет правило с `$removeparam=param` для любого запроса, соответствующего `||example.org^`. +* `@@||example.org^$removeparam=/regex/` -- отменяет правило с `$removeparam=/regex/` для любого запроса, соответствующего `||example.org^`. + +> **Многочисленные правила, соответствующие одному запросу** +> В случае, когда несколько правил с `$removeparam` соответствуют одному запросу, они все будут применены по очереди. + +##### Примеры + +* `$removeparam=utm_source` -- убирает параметр `utm_source` из всех запросов. + +* `$removeparam=/utm_.*/` -- убирает все параметры `utm_* query` из URL любого запроса, например, запрос `http://example.com/page?utm_source=test` будет трансформирован в `http://example.com/page`. + +* `$removeparam=/^utm_source=campaign$/` -- убирает параметр `utm_source` с значением `campaign`. Не затрагивает другие параметры `utm_source`. + +Отмена одного правила `$removeparam` и замена его другим: ``` -removeparam = "/" regex "/" options +$removeparam=/^(gclid|yclid|fbclid)=/ +@@||example.com^$removeparam=/^(gclid|yclid|fbclid)=/ +||example.com^$removeparam=/^(yclid|fbclid)=/ ``` -В этом случае: +При помощи этих правил из всех запросов убираются Click ID от Google, Yandex, и Facebook. Есть одно исключение: Google Click ID (gclid) не будет убран для запросов к example.com. -* `regex` - это регулярное выражение согласно [синтаксису Perl](http://perldoc.perl.org/perlrequick.html#Search-and-replace), -* `options` - опции регулярного выражения. - -Список поддерживаемых опций для регулярных выражений: - -* `i` - делает сопоставление без учета регистра. - -Примеры: - -* `$removeparam=/param/` -- убирает параметры, соответствующие шаблону `param`, из URL любых запросов. Например, запрос к `http://example.com/page?param=1&some_pArAm=2` будет преобразован в `http://example.com/page?some_pArAm=2` -* `$removeparam=/param/i` -- убирает параметры, соответствующие шаблону `param` (без учета регистра) из URL любых запросов. Например, запрос к `http://example.com/page?param=1&some_pArAm=2` будет преобразован в `http://example.com/page` - -> **Важно:** в случае использования регулярных выражений необходимо экранировать следующие символы: запятая `,`, `/` и `$`. Используйте для этого символ `\`. Например, "запятая" будет в этом случае выглядеть так: `\,`. - -Списки, разделенные с помощью `|` - также поддерживают регулярные выражения: `$removeparam=p1|/p2/i|/p3/|p4`. - -Используйте исключения, если вы не хотите очищать от параметров некоторые URL: - -1) Пример 1: -``` -$removeparam=gclid|yclid|fbclid -@@||example.com^$removeparam=gclid -``` - -С этими правилами метки метрик компаний Google, Yandex и Facebook будут удалены, кроме меток Google для запросов к `example.com`. Например: `http://google.com/page?gclid=1&fbclid=2&yclid=3` будет преобразован в `http://google.com/page`, но `http://example.com/page?gclid=1&fbclid=2&yclid=3` будет преобразован в `http://example.com/page?gclid=1`. - -2) Пример 2: +Отмена `$removeparam` для всех параметров: ``` -$removeparam=utm_source|utm_medium|utm_term -$removeparam=utm_content|utm_campaign|utm_referrer +$removeparam=/^(utm_source|utm_medium|utm_term)=/ +$removeparam=/^(utm_content|utm_campaign|utm_referrer)=/ @@||example.com^$removeparam ``` @@ -659,11 +727,14 @@ $removeparam=utm_content|utm_campaign|utm_referrer > **Обратите внимание**, что блокировку правил `$removeparam` также можно отключить с помощью правил исключений `$document` и `$urlblock`. Но базовые правила исключений без модификаторов не могут этого сделать. Например, `@@||example.com^` не отключит `$removeparam=p` для запросов к example.com, а вот `@@||example.com^$urlblock` - отключит. +> **Совместимость с различными версиями AdGuard.** Правила с этим модификатором поддерживаются AdGuard для Windows, Mac, Android, а также браузерными расширениями AdGuard для Chrome, Firefox, Edge. **На данный момент только девелопер-сборки.** + +> **Ограничения.** Этот тип правил может быть использован **только в доверенных фильтрах** — то есть в **Пользовательских правилах** и всех фильтрах, разработанных командой AdGuard. ##### **`important`** -Модификатор `$important`, применённый к правилу, повышает его приоритет отсноительно любого другого правила без модификатора `$important`, даже относительно базовых правил-исключений. +Модификатор `$important`, применённый к правилу, повышает его приоритет относительно любого другого правила без модификатора `$important`, даже относительно базовых правил-исключений. ###### Пример 1: @@ -697,20 +768,30 @@ $removeparam=utm_content|utm_campaign|utm_referrer ##### **`badfilter`** -> #### Совместимость с разными версиями AdGuard -> Модификатор `badfilter` на данный момент работает только в браузерных расширениях AdGuard. Мы планируем в скором времени добавить поддержку этого модификатора и другими продуктами AdGuard. - Правила, содержащие модификатор `badfilter`, отключают базовые правила, на которые они ссылаются. Это означает, что текст отключенного правила должен соответствовать тексту `badfilter`-правила (за исключением самого модификатора `badfilter`). -###### Примеры `badfilter` +**Примеры:** * `||example.com$badfilter` отключает `||example.com` * `||example.com$image,badfilter` отключает `||example.com,image` * `@@||example.com$badfilter` отключает `@@||example.com` * `||example.com$domain=domain.com,badfilter` отключает `||example.com$domain=domain.com` -> #### Совместимость с разными версиями AdGuard -> Модификаторы ниже из этого раздела доступны только в AdGuard для Windows, macOS и Android. Браузерные расширения ограничены возможностями, предоставляемыми браузерами, и некоторые функции им просто недоступны. +Правила с модификатором `$badfilter` могут отключать другие базовые правила для определённых доменов, если они выполняют следующие условия: + +* Правило имеет модификатор `$domain` +* Правило не имеет отрицания домена `~` в значении модификатора `$domain`. + +В этом случае, правило с `$badfilter` отключит соответствующее базовое правило для доменов, указанных как в правиле с `$badfilter`, так и в базовом правиле. Обратите внимание, что [логика wildcard для доменов верхнего уровня (TLD)](https://kb.adguard.com/ru/general/how-to-create-your-own-ad-filters#wildcard-for-tld) здесь также применима. + +**Примеры:** + +* `/some$domain=example.com|example.org|example.io` отключно для `example.com` правилом `/some$domain=example.com,badfilter` +* `/some$domain=example.com|example.org|example.io` отключено для `example.com` и `example.org` правилом `/some$domain=example.com|example.org,badfilter` +* `/some$domain=example.com|example.org` и `/some$domain=example.io` полностью отключены правилом `/some$domain=example.com|example.org|example.io,badfilter` +* `/some$domain=example.com|example.org|example.io` полностью отключено правилом `/some$domain=example.*,badfilter` +* `/some$domain=example.*` отключено для `example.com` и `example.org` правилом `/some$domain=example.com|example.org,badfilter` +* `/some$domain=example.com|example.org|example.io` НЕ отключено для `example.com` правилом `/some$domain=example.com|~example.org,badfilter`, поскольку в значении модификатора `domain` содержится отрицание домена ##### **`empty`** @@ -726,24 +807,27 @@ $removeparam=utm_content|utm_campaign|utm_referrer В качестве ответа на заблокированный запрос AdGuard возвращает короткое видео-заглушку. +> **Предупреждение об устаревании.** Правила с этим модификатором считаются устаревшими. Вместо них теперь используется модификатор `$redirect`. Учтите, что скоро поддержка модификатора mp4 прекратится. + +> **Совместимость с различными версиями AdGuard.** Правила с этим модификатором не поддерживаются в AdGuard для Safari и для iOS. + ###### Примеры `mp4` * `||example.com/videos/$mp4` — блокирует загрузку видео с адресов `||example.com/videos/*` и заменяет ответ на видео-заглушку. +> **Предупреждение об устаревании.** Правила с этим модификатором считаются устаревшими. Вместо них теперь используется модификатор `$redirect`. Учтите, что скоро поддержка модификатора mp4 прекратится. + +> **Совместимость с различными версиями AdGuard.** Правила с этим модификатором не поддерживаются в AdGuard для Safari и для iOS. + ##### **`replace`** Этот модификатор полностью меняет поведение страницы. Когда он применяется, правило не блокирует запрос. Вместо этого ответ будет модифицирован. -> #### Обратите внимание -> Вам потребуется некоторое знание регулярных выражений, чтобы использовать этот модификатор. - -> #### Совместимость с различными версиями AdGuard -> Такие правила поддерживаются продуктами AdGuard для Windows, AdGuard для Mac, AdGuard для Android и расширением AdGuard для Firefox. -> Этот тип правил не будет работать в расширениях для других браузеров, потому что они не могут изменять содержимое страницы на сетевом уровне. - ###### Особенности правил `$replace` +> Вам потребуется знание регулярных выражений, чтобы использовать этот модификатор. + * Правила `$replace` применяются к любому текстовому ответу, но не будут применяться к binary (`media`, `image`, `object` и т.д.). * Правила `$replace` не применяются, если размер оригинального ответа превышает 3Мб. * Правила `$replace` имеют более высокий приоритет, чем другие базовые правила (**включая** правила-исключения). Так что если запрос соответствует двум различным правилам, одно из которых имеет модификатор `$replace`, применится именно это правило. @@ -752,8 +836,7 @@ $removeparam=utm_content|utm_campaign|utm_referrer > Значение `$replace` может быть пустым в случае правил-исключений. Смотрите раздел с примерами за дополнительной информацией. -> #### Несколько правил, соотвтествующих одному запросу -> В случае, когда несколько правил `$replace` соответствуют одному запросу, мы применим каждое из них. **Правила будут применяться в алфавитном порядке.** +> **Несколько правил, соотвтествующих одному запросу**. В случае, когда несколько правил `$replace` соответствуют одному запросу, мы применим каждое из них. **Правила будут применяться в алфавитном порядке.** ###### **Синтаксис $replace** @@ -798,27 +881,30 @@ http://regexr.com/3cesk * `@@||example.org^$replace` отключит все правила `$replace`, соответствующие `||example.org^`. * `@@||example.org^$document` или `@@||example.org^$content` отключит все правила `$replace`, **исходящие** со страниц домена `example.org`, **включая саму эту страницу**. +> **Совместимость с различными версиями AdGuard.** Эти правила поддерживаются AdGuard для Windows, Mac, Android и браузерным расширением AdGuard для Firefox. Этот тип правил не работает в расширениях для других браузеров, потому что они не могут модифицировать содержимое страниц на сетевом уровне. + +> **Ограничения.** Пожалуйста, заметьте, чтоэтот тип правил может быть использован **только в доверенных фильтрах**. Эта категория включает в себя **Пользовательские правила**, а также все фильтры, разработанные командой AdGuard. + ##### **`csp`** -Этот модификатор полностью меняет поведение правила. Будучи применённым к правилу, он не заблокирует попадший под него запрос. Вместо этого будут изменены заголовки ответа. +Этот модификатор полностью меняет поведение правила. Будучи применённым к правилу, он не заблокирует попавший под него запрос. Вместо этого будут изменены заголовки ответа. > Чтобы использовать правила этого типа, необходимо базовое понимание слоя безопасности [Политики Безопасности Контента](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy). Для запросов, подходящих под `$csp`-правило, мы усилим политику безопасности ответа, добавив дополнительную политику, равнозначную содержимому модификатора `$csp`. Правила `$csp` применяются независимо от правил любого другого типа. Прочие базовые правила никак на них не влияют, **кроме правил исключений уровня document** (смотрите примеры ниже). ->Когда несколько правил соответствуют одному запросу. ->В случае, когда несколько `$csp`-правил соответствуют одному запросу, мы применяем их все. +> **Когда несколько правил соответствуют одному запросу**. В случае, когда несколько `$csp`-правил соответствуют одному запросу, мы применяем их все. -**Синтаксис csp** +**Синтаксис `$csp`** -Синтаксис занчений `$csp` похож на синтаксис заголовков Политики Безопасности Контента. +Синтаксис значений `$csp` похож на синтаксис заголовков Политики Безопасности Контента. Значение `$csp` может быть пустым в случае правил-исключений. Смотрите примеры ниже для более подробной информации. >Ограничения ->1. Пожалуйста, обратите внимание, что некоторые символы запрещены в значении `$csp`: (`,`), (`$`) +>1. Некоторые символы запрещены в значении `$csp`: (`,`), (`$`) >2. `$csp`-правила поддерживают ограниченный список модификаторов: `domain`, `important`, `subdocument` >3. Правила с директивами `report-*` считаются некорректными. @@ -835,13 +921,12 @@ http://regexr.com/3cesk Модификатор `$cookie` полностью меняет поведение правила. Вместо того, чтобы блокировать запрос, этот модификатор позволяет нам блокировать или изменять заголовки `Cookie` или `Set-Cookie`. -> **Несколько правил, соотвтествующих одному запросу** -> В случае, когда несколько правил `$cookie` соответствуют одному запросу, мы применим каждое из них по очереди. +> **Несколько правил, соотвтествующих одному запросу**. В случае, когда несколько правил `$cookie` соответствуют одному запросу, мы применим каждое из них по очереди. -### синтаксис `$cookie` +### Синтаксис `$cookie` Синтаксис правила зависит от того, собираемся ли мы заблокировать все cookie или удалить один cookie. Поведение правила можно изменить с помощью модификаторов `maxAge` и `sameSite`. -* `||example.org^$cookie=NAME;maxAge=3600;sameSite=lax` -- каждый раз, когда AdGuard встречает cookie с именем `NAME` в запросе к` example.org`, он будет делать следующее: +* `||example.org^$cookie=NAME;maxAge=3600;sameSite=lax` -- каждый раз, когда AdGuard встречает cookie с именем `NAME` в запросе к `example.org`, он будет делать следующее: * Установит дату истечения срока хранения на текущее время плюс `3600` секунд * Позволяет cookie использовать [Same-Site](https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies#SameSite_cookies) "lax" стратегию. @@ -865,14 +950,13 @@ http://regexr.com/3cesk * `$cookie=/__utm[a-z]/` -- блокирует Google Analytics cookie везде * `||facebook.com^$third-party,cookie=c_user` -- не позволяет Facebook'у отслеживать вас, даже если вы вошли в систему +> **Совместимость с различными версиями AdGuard.** Этот тип правил не поддерживается AdGuard для iOS и для Safari. + ##### **`network`** Правила этого типа позволяют полностью блокировать доступ к указанному удалённому адресу, то есть фактически работают как Брандмауэр. -> #### Совместимость с различными версиями AdGuard -> Только версии AdGuard для Windows, Mac и Android имеют техническую возможность использовать правила такого типа. - 1. `$network`-правила соответствуют **только IP-адресам**! Эти правила не получится использовать для блокирования или разблокирования доступа к домену. 2. Чтобы задать соответствие IPv6-адресу, вам надо использовать "сколлапсированный" синтаксис, например, используйте `[2001:4860:4860::8888]$network` вместо `[2001:4860:4860:0:0:0:0:8888]$network`. 3. Разблокирующее `$network`-правило заставит AdGuard направлять трафик в подходящую под соответствие конечную точку, например, тем самым можно прекратить всю последующую фильтрацию. @@ -884,6 +968,8 @@ http://regexr.com/3cesk * `174.129.166.49$network` - блокирует доступ к `174.129.166.49:*`. * `@@174.129.166.49$network` - заставляет AdGuard направлять трафик в конечную точку. Никакие другие правила не будут применены. +> **Совместимость с различными версиями AdGuard.** Только AdGuard для Windows, Mac, Android имеют технические возможности для поддержки этого типа правил. + ##### **`app`** @@ -907,17 +993,22 @@ http://regexr.com/3cesk * `||baddomain.com^$app=~org.example.app` — правило, блокирующее запросы, подходящие под заданную маску и посылаемые любым приложением кроме `org.example.app`. * `||baddomain.com^$domain=~org.example.app1|~org.example.app2` — аналогично, но в исключениях два приложения: `org.example.app1` и `org.example.app2`. +> **Совместимость с различными версиями AdGuard.** Только AdGuard для Windows, Mac, Android имеют технические возможности для поддержки этого типа правил. + -#### `redirect` +#### **`redirect`** + +AdGuard может перенаправлять веб-запросы к локальному "ресурсу". + ##### Синтаксис `redirect` -AdGuard использует тот ж синтаксис правил фильтрации, что и uBlock Origin. Он совместим с модификатором `$rewrite=abp-resource` Adblock Plus. +AdGuard использует тот же синтаксис правил фильтрации, что и uBlock Origin. Он совместим с модификатором `$rewrite=abp-resource` Adblock Plus. `$redirect` – это модификатор для [базовых правил](https://kb.adguard.com/ru/general/how-to-create-your-own-ad-filters#basic-rules), поэтому правила с ним поддерживают все остальные базовые модификаторы, такие как `$domain`, `$third-party`, `$script`, и т.д. > Значение модификатора `$redirect` должно быть именем ресурса, который будет использован для переадресации. -> Приоритетность правил `$redirect` выше, чем у обычных базовых правил блокировки. Это означает, что, если есть базовое правило (даже с модификатором`$important`), `$redirect` будет иметь над ним преимущество. Если есть белый список (@@) с совпадающим URL, он также заблокирует переадресацию (только если правило `$redirect` также не отмечено как `$important`). +> Приоритетность правил `$redirect` выше, чем у обычных базовых правил блокировки. Это означает, что, если есть базовое правило (даже с модификатором`$important`), `$redirect` будет иметь над ним преимущество. Если есть белый список (`@@`) с совпадающим URL, он также заблокирует переадресацию (только если правило `$redirect` также не отмечено как `$important`). ###### Отключение правил `$redirect` @@ -929,15 +1020,31 @@ AdGuard использует тот ж синтаксис правил филь ``` ||example.org/script.js$script,redirect=noopjs ``` -Это правило перенаправляет все запросы script.js к ресурсу noopjs. +Это правило перенаправляет все запросы к `example.org/script.js` к ресурсу `noopjs`. ``` ||example.org/test.mp4$media,redirect=noopmp4-1s ``` -Это правило перенаправляет все запросы example.org/test.mp4 к ресурсу noopmp4-1s. +Это правило перенаправляет все запросы `example.org/test.mp4` к ресурсу `noopmp4-1s`. > Больше информации о скриптлетах, редиректах и их использовании доступно [в этом разделе GitHub](https://github.com/AdguardTeam/Scriptlets#redirect-resources). +> **Совместимость с различными версиями AdGuard.** Этот тип правил не поддерживается AdGuard для iOS и для Safari. + + +#### **`redirect-rule`** +По сути, это тот же `$redirect`, поскольку у него тоже есть свойства "перенаправления" и логика у них практически аналогичная. Разница в том, что `$redirect-rule` применяется только в случае, если целевой запрос заблокирован другим базовым правилом. + +> Отключение `$redirect-rule` работает точно так же, как для обычных правил `$redirect`. Даже более того, `@@||example.org^$redirect` будет отключать как правило `$redirect`, так и правило `$redirect-rule`. + +Примеры: + +``` +||example.org/script.js +||example.org^$redirect-rule=noopjs +``` + +В этом случае только запросы к `example.org/script.js` будут перенаправлены. Все остальные запросы к `example.org` изменены не будут. @@ -964,6 +1071,119 @@ AdGuard использует тот ж синтаксис правил филь > @@||y.com$script,domain=a.com|~b.com > ``` + +#### **`noop`** + +Модификатор `noop` не делает ничего и может быть использован исключительно в целях улучшения читабельности правил. Он состоит из последовательности символов нижнего подчёркивания (`_`) любой длины и может фигурировать в правиле столько раз, сколько требуется. + +##### Примеры `noop`: + +``` +||example.com$_,removeparam=/^ss\\$/,_,image +||example.com$replace=/bad/good/,___,~third-party +``` + +> **Совместимость с различными версиями AdGuard.** На данный момент доступен **только в девелоперских сборках**. + + +#### **`$removeheader`** + +Правила с модификатором `$removeheader` предназначены для того, чтобы убирать заголовки HTTP-запросов и ответов. Изначальная мотивация для создания этого типа правил заключалась в том, чтобы иметь возможность избавиться от заголовка `Refresh`, который часто используется для перенаправления пользователей на нежелаемую страницу. Однако, применение данного модификатора не ограничивается этим случаем. + +Как и в случае с `$csp`, `$redirect`, `$removeparam` и `$cookie`, этот модификатор существует независимо, правила с ним не зависят от обычных базовых правил, то есть регулярные выражения или блокирующие правила никак на них не повлияют. По умолчанию, они работают только применительно к заголовкам ответов. Однако, вы также можете использовать модификатор `$removeheader`, чтобы убирать заголовки запросов. + +##### Синтаксис + +**Базовый синтаксис** + +* `||example.org^$removeheader=header-name` — убирает заголовок **ответа** с названием `header-name` +* `||example.org^$removeheader=request:header-name` — убирает заголовок **запроса** с названием `header-name` + +> Обратите внимание, что `$removeheader` нечувствителен к регистру, но мы настоятельно рекомендуем всегда использовать нижний регистр. + +**Отрицание `$removeheader`** + +Этот тип правил работает практически точно так же, как с модификаторами `$csp` и `$redirect`. + +Используйте `@@`, чтобы добавить отрицание `$removeheader`: + +* `@@||example.org^$removeheader` — отменяет **все** правила `$removeheader` для URL, соответствующих `||example.org^`. +* `@@||example.org^$removeheader=header` — отменяет все правила с `$removeheader=header` для любого запроса, соответствующего `||example.org^`. +* Правила с `$removeheader` также можно отключить, используя правила-исключения `$document` и `$urlblock`. Но базовые правила-исключения без модификаторов не смогут этого сделать. Например, `@@||example.com^` не отключит `$removeheader=p` для запросов к `example.com`, а `@@||example.com^$urlblock` отключит. + +> **Множественные правила, соответствующие одному запросу** +> В случае, когда несколько правил с `$removeheader` соответствуют одному запросу, мы будем применять их все по очереди. + +##### Ограничения + +1. Пожалуйста, учтите, что этот тип правил может быть использован **только в доверенных фильтрах**. Эта категория включает в себя ваши Собственные правила и все фильтры, разработанные командой AdGuard. +2. Чтобы избежать потенциальных проблем с безопасностью, `$removeheader` не может убрать заголовки из списка ниже: + +* `access-control-allow-origin` +* `access-control-allow-credentials` +* `access-control-allow-headers` +* `access-control-allow-methods` +* `access-control-expose-headers` +* `access-control-max-age` +* `access-control-request-headers` +* `access-control-request-method` +* `origin` +* `timing-allow-origin` +* `allow` +* `cross-origin-embedder-policy` +* `cross-origin-opener-policy` +* `cross-origin-resource-policy` +* `content-security-policy` +* `content-security-policy-report-only` +* `expect-ct` +* `feature-policy` +* `origin-isolation` +* `strict-transport-security` +* `upgrade-insecure-requests` +* `x-content-type-options` +* `x-download-options` +* `x-frame-options` +* `x-permitted-cross-domain-policies` +* `x-powered-by` +* `x-xss-protection` +* `public-key-pins` +* `public-key-pins-report-only` +* `sec-websocket-key` +* `sec-websocket-extensions` +* `sec-websocket-accept` +* `sec-websocket-protocol` +* `sec-websocket-version` +* `p3p` +* `sec-fetch-mode` +* `sec-fetch-dest` +* `sec-fetch-site` +* `sec-fetch-user` +* `referrer-policy` +* `content-type` +* `content-length` +* `accept` +* `accept-encoding` +* `host` +* `connection` +* `transfer-encoding` +* `upgrade` + +3. Правила с `$removeheader` несовместимы с любыми другими модификаторами, кроме `$domain`, `$third-party`, `$app`, `$important`, `$match-case`, а также модификаторами, ограничивающими по типу контента (`$script`, `$stylesheet` и т.д.). Правила с `$removeheader`, имеющие другие модификаторы, считаются некорректными и будут игнорироваться. + +##### Примеры + +* `||example.org^$removeheader=refresh` — убирает заголовок `Refresh` из всех HTTP-ответов, возвращённых `example.org` и его поддоменами. +* `||example.org^$removeheader=request:x-client-data` — убирает заголовок `X-Client-Data` из всех HTTP-запросов. +* Данный блок правил убирает заголовки `Refresh` и `Location` из всех HTTP-ответов, возвращённых `example.org`, кроме запросов к `example.org/path/*`, для которого заголовки не будут убраны: + + ``` + ||example.org^$removeheader=refresh + ||example.org^$removeheader=location + @@||example.org/path/$removeheader + ``` + +> **Совместимость с различными версиями AdGuard.** На данный момент доступен **только в девелоперских сборках**. + # Другие правила @@ -980,6 +1200,8 @@ AdGuard использует тот ж синтаксис правил филь Правила скрытия элементов предназначены, как это следует из их названия, для скрытия элементов веб-страниц. По сути это аналогично применению стиля `{ display: none; }` к выбранному элементу. +> Обратите внимание, что правила скрытия элементов работают по-разному и их приоритетность меняется [в зависимости от платформы](https://kb.adguard.com/ru/general/how-to-create-your-own-ad-filters#cosmetic-rules-priority). + #### Синтаксис правил скрытия @@ -997,10 +1219,9 @@ domains = [domain0, domain1[, ...[, domainN]]] Если вы хотите запретить действие правила на определенном домене, используйте символ `~` перед именем домена. Например: `~example.org##selector`. -Обратите внимание, что вы можете использовать оба подхода в одном правиле. Например, правило `example.org,~subdomain.example.org##domain` будет работать для домена `example.org` и всех его поддоменов, **кроме `subdomain.example.org`**. +Вы можете использовать оба подхода в одном правиле. Например, правило `example.org,~subdomain.example.org##domain` будет работать для домена `example.org` и всех его поддоменов, **кроме `subdomain.example.org`**. -> #### Обратите внимание -> Правила скрытия не зависят друг от друга. Если в фильтре есть правило `example.org##selector`, и вы добавляете правило `~example.org##selector`, то оба этих правила будут применены независимо друг от друга. +> **Важно**. Правила скрытия не зависят друг от друга. Если в фильтре есть правило `example.org##selector`, и вы добавляете правило `~example.org##selector`, то оба этих правила будут применены независимо друг от друга. #### Примеры правил скрытия @@ -1009,6 +1230,8 @@ domains = [domain0, domain1[, ...[, domainN]]] * `example.com,example.org###adblock` - скроет элемент с атрибутом `id` равным `adblock` на доменах `example.com`, `example.org` и всех их поддоменах. * `~example.com##.textad` - скроет элемент с классом `textad` на всех доменах, кроме `example.com` и всех его поддоменах. +> **Важно!** Safari не поддерживает одновременно разрешенные и запрещенные домены, поэтому правила вида `example.org,~foo.example.org##.textad` не действуют в AdGuard для Safari. + #### Исключения для правил скрытия @@ -1024,11 +1247,17 @@ domains = [domain0, domain1[, ...[, domainN]]] example.com#@#.textad ``` -В некоторых случаях может потребоваться отключение всех запрещающих правил. Например, на время тестирования. Для этого следует воспользоваться правилом исключения без указания домена. +В некоторых случаях может потребоваться отключение всех запрещающих правил. Например, на время тестирования. Для этого следует воспользоваться правилом исключения без указания домена. Оно полностью отключит соответствующее косметическое правило на ВСЕХ доменах: + ``` #@#.textad ``` +Правило такого вида даст аналогичный результат: +``` +*#@#.textad +``` + Применять такие исключения рекомендуется только в случае, когда изменить само правило скрытия не представляется возможным. Во всех остальных случаях лучше изменить исходное правило, используя ограничение на домены. @@ -1036,8 +1265,11 @@ example.com#@#.textad Иногда недостаточно просто скрыть какой-либо элемент, чтобы заблокировать рекламу. Например, блокировка рекламного элемента может просто сломать верстку сайта. Для таких случаев AdGuard позволяет использовать гораздо более гибкие правила, чем обычные правила скрытия. По сути, с помощью таких правил вы можете добавить на страницу любой CSS-стиль. -> #### Ограничения -> Запрещено использование стилей, которые могут приводить к загрузке каких-либо ресурсов. По сути это означает, что запрещено использование атрибутов типа ``. +> **Ограничения**. Запрещено использование стилей, которые могут приводить к загрузке каких-либо ресурсов. По сути это означает, что запрещено использование атрибутов типа ``. + +> **Совместимость с различными версиями AdGuard.** Заметьте, что CSS-правила не поддерживаются AdGuard для iOS. + +> Обратите внимание, что правила CSS-стилей работают по-разному и их приоритетность меняется [в зависимости от платформы](https://kb.adguard.com/ru/general/how-to-create-your-own-ad-filters#cosmetic-rules-priority). #### Синтаксис @@ -1082,18 +1314,21 @@ example.com#@$#.textad { visibility: hidden; } Возможностей CSS 3.0 не всегда хватает для блокировки рекламы. Чтобы решить эту проблему, AdGuard расширяет возможности CSS, добавляя поддержку новых псевдо-элементов. Для поддержки расширенных CSS-селекторов нами был разработан отдельный модуль [с открытым кодом](https://github.com/AdguardTeam/ExtendedCss). -> #### Обратная совместимость -> В общедоступных фильтрах мы используем так называемый обратно-совместимый синтаксис. Дело в том, что использование расширенных псевдоклассов может помешать применению косметических правил в старых версиях AdGuard или других блокировщиках рекламы, не поддерживающих расширенный CSS. Например, вместо псевдокласса `:has(selector)` можно использовать атрибут `[-ext-has="selector"]`. +> **Область применения**. Расширенные селекторы можно применять в любом косметическом правиле, будь то [правила скрытия](#cosmetic-elemhide-rules) или [правила CSS стилей](#cosmetic-css-rules). -> #### Область применения -> Расширенные селекторы можно применять в любом косметическом правиле, будь то [правила скрытия](#cosmetic-elemhide-rules) или [правила CSS стилей](#cosmetic-css-rules). +> **Совместимость с различными версиями AdGuard.** Заметьте, что CSS-правила не поддерживаются AdGuard для iOS. #### Синтаксис + Независимо от того, какие CSS-псевдоклассы вы используете в правилах, вы можете использовать специальные маркеры, чтобы эти правила обрабатывались движком "Extended CSS". Рекомендуется использовать эти маркеры для всех косметических расширенных CSS-правил, чтобы их было легче отличить. + Синтаксис расширенных CSS-правил: + * `#?#` — для скрытия элементов (`#@?#` - для исключений) * `#$?#` — для вставки CSS (`#@$?#` - для исключений) +Мы **Крайне рекомендуем** использовать этим маркеры каждый раз, когда вы используете CSS-селектор. + ##### Примеры * `example.org#?#div:has(> a[target="_blank"][rel="nofollow"])` — это правило блокирует все элементы `div`, которые содержат дочерний элемент ссылку с атрибутами `[target="_blank"][rel="nofollow"]`. При этом правило будет работать только для домена `example.org` и всех его поддоменов. @@ -1101,8 +1336,10 @@ example.com#@$#.textad { visibility: hidden; } * `example.net#?#.banner:matches-css(width: 360px)` — это правило блокирует все элементы `.banner`, которые содержат стиль `width: 360px`. При этом правило будет работать только для домена `example.net` и всех его поддоменов. * `example.net#@?#.banner:matches-css(width: 360px)` — это правило отменяет действие предыдущего правила. -> Обратите внимание, что вы можете использовать движок ExtCss для простых селекторов, применяя правило вида: -> `#?#div` +> Обратите внимание, что вы можете использовать движок ExtCss для простых селекторов, применяя правило вида: `#?#div`. + +> Информация об отладке ExtendedCSS-селекторов доступна в [этой секции](#selectors-debugging-mode) статьи. + ##### Псевдокласс `:has()` @@ -1486,50 +1723,25 @@ div:contains(target text) { remove: true; } div[class]:has(> a:not([id])) { remove: true; } ``` -> Пожалуйста, обратите внимание, если используется псевдокласс `:remove()` или псевдо-свойство `remove`, то другие свойства этого стиля будут проигнорированы. +> Обратите внимание, если используется псевдокласс `:remove()` или псевдо-свойство `remove`, то другие свойства этого стиля будут проигнорированы. - -#### Режим отладки селекторов + +### Приоритетность косметических правил -Иногда вам может понадобиться проверить работу того или иного селектора или стиля. Чтобы сделать это без прямого взаимодействия с javascript, вы можете воспользоваться особым свойством стиля `debug`. Когда `ExtendedCss` сталкивается с этим свойством, он включает режим отладки, либо для отдельного селектора, либо для всех селекторов — в зависимости от значения `debug`. +То, как применяются **правила скрытия элементов** и **правила CSS-стилей**, зависит от платформы. -**Отладка отдельного селектора** -``` -#$#.banner { display: none; debug: true; } -``` +**На AdGuard для Windows, Mac и Android** мы используем таблицу стилей, встроенную в страницу. Приоритет у косметических правил такой же, как и у любых других таблиц стилей CSS на сайтах. Но есть ограничение: [правила скрытия элементов](https://kb.adguard.com/ru/general/how-to-create-your-own-ad-filters#elemhide-rules) и [CSS-стили](https://kb.adguard.com/ru/general/how-to-create-your-own-ad-filters#cosmetic-css-rules) не могут обходить встроенные стили. В таких случаях рекомендуется использовать расширенные селекторы или HTML-фильтрацию. -**Включение глобальной отладки** -``` -#$#.banner { display: none; debug: global; } -``` +**В браузерных расширениях AdGuard** используются так называемые "пользовательские таблицы стилей". Их приоритетность выше, даже чем у встроенных стилей. - -#### Тестирование расширенных селекторов +**Расширенные CSS-селекторы** используют для работы Javascript и добавляют встроенные стили сами, поэтому могут игнорировать любой стиль. -Чтобы загрузить ExtendedCss на текущую страницу, скопируйте и запустите в браузерной консоли следующий код: -``` -!function(E,x,t,C,s,s_){C=E.createElement(x),s=E.getElementsByTagName(x)[0],C.src=t, -C.onload=function(){alert('ExtCss loaded successfully')},s.parentNode.insertBefore(C,s)} -(document,'script','https://AdguardTeam.github.io/ExtendedCss/extended-css.min.js') -``` - -Как вариант, установите пользовательский скрипт "ExtendedCssDebugger": https://github.com/AdguardTeam/Userscripts/blob/master/extendedCssDebugger/extended-css.debugger.user.js - -Вы теперь можете использовать конструктор `ExtendedCss` в глобальном масштабе, а его метод `ExtendedCss.query` — как `document.querySelectorAll`. -``` -var selectorText = "div.block[-ext-has='.header:matches-css-after(content: Anzeige)']"; - -ExtendedCss.query(selectorText) // returns an array of Elements matching selectorText -``` - ## Правила фильтрации HTML В большинстве случаев достаточно использовать базовые и косметические правила. Но иногда для фильтрации рекламы необходимо изменять HTML-код самой страницы до того, как он будет загружен браузером. Для того чтобы сделать это, применяются правила фильтрации HTML-контента. Они позволяют указать, какие HTML-элементы необходимо вырезать из страницы перед тем, как страница попадет в браузер. -> #### Совместимость -> Правила поддерживаются приложениями AdGuard для Windows, Mac, Android и расширением AdGuard для Firefox. -> Правила этого типа не работают в расширениях для других браузеров, т.к. они не могут модифицировать контент на сетевом уровне. +> **Совместимость с различными версиями AdGuard.** Правила этого типа поддерживаются приложениями AdGuard для Windows, Mac, Android и расширением AdGuard для Firefox. Они не работают в расширениях для других браузеров, т.к. они не могут модифицировать контент на сетевом уровне. ### Синтаксис @@ -1584,8 +1796,7 @@ example.org$$script[data-src="banner"] $$script[tag-content="banner"] ``` -> #### Вложенные элементы -> Если мы имеем дело с несколькими вложенными друг в друга элементами, каждый из которых подходит под одно и то же правило фильтрации HTML-контента, то удалены будут все эти элементы. +> **Вложенные элементы**. Если мы имеем дело с несколькими вложенными друг в друга элементами, каждый из которых подходит под одно и то же правило фильтрации HTML-контента, то удалены будут все эти элементы. ##### `wildcard` @@ -1605,8 +1816,7 @@ $$script[tag-content="banner"] Задает максимальную длину содержимого HTML-элемента. Если этот параметр задан, и длина содержимого превышает заданное значение — правило не применяется к элементу. -> #### Значение по умолчанию -> Если этот параметр не задан, то `max-length` считается равным 8192. +> **Значение по умолчанию**. Если этот параметр не задан, то `max-length` считается равным 8192. Например, возьмем следующее правило: ``` @@ -1654,8 +1864,11 @@ $@$script[tag-content="banner"] AdGuard поддерживает специальный тип правил, позволяющий вставить любой javascript-код на страницы интернет-сайтов. -> #### Ограничения -> Обратите внимание, что этот тип правил может быть использован **только в доверенных фильтрах**. В эту категорию попадает ваш собственный **пользовательский фильтр**, и фильтры, которые создаются командой AdGuard. +> **Ограничения**. Этот тип правил может быть использован **только в доверенных фильтрах**. В эту категорию попадают ваши собственные **Пользовательские правила**, и фильтры, которые создаются командой AdGuard. + +> **Совместимость с различными версиями AdGuard.** Javascript-правила не поддерживаются AdGuard для iOS. + +Мы **крайне рекомендуем** использовать скриптлеты вместо Javascript-правил везде, где это возможно. JS-правила предназначены для помощи в процессе дебаггинга, но в качестве полноценного решения в долгосрочной перспективе следует использовать скриптлеты. ### Синтаксис @@ -1697,9 +1910,11 @@ example.com#@%#window.__gaq = undefined; ## Скриптлеты -Скриптлет — это функция JavaScript, которая предоставляет расширенные возможности для блокирования контента. Эта функции могут использоваться в декларативной манере в правилах фильтрации AdGuard. +Скриптлет — это функция JavaScript, которая предоставляет расширенные возможности для блокирования контента. Такие функции могут использоваться в декларативной манере в правилах фильтрации AdGuard. ->AdGuard поддерживает множество различных криптлетов. Пожалуйста, обратите внимание, что для того, чтобы добиться совместимости между различными блокировщиками, мы также поддерживаем синтаксис uBO и ABP. +> AdGuard поддерживает множество различных скриптлетов. Чтобы добиться совместимости между различными блокировщиками, мы также поддерживаем синтаксис uBO и ABP. + +> **Совместимость с различными версиями AdGuard.** Javascript-правила не поддерживаются AdGuard для iOS. ### Синтаксис @@ -1726,6 +1941,8 @@ example.org#%#//scriptlet("abort-on-property-read", "alert") Больше информации о редиректах можно найти [на GitHub](https://github.com/AdguardTeam/Scriptlets#scriptlets). +> Информация об отладке скриптлетов доступна в [этом разделе](#debug-scriptlets) статьи. + ## Модификаторы @@ -1748,14 +1965,15 @@ modifiers = modifier0[, modifier1[, ...[, modifierN]]] ### app -Модификатор `app` ограничивает действие правила до конкретного приложения (или списка приложений). -Поведение и синтаксис модификатора полностью совпадают с соответствующим [модификатором $app](https://kb.adguard.com/ru/general/how-to-create-your-own-ad-filters#app) для базовых правил. +Модификатор `app` ограничивает действие правила до конкретного приложения (или списка приложений). Поведение и синтаксис модификатора полностью совпадают с соответствующим [модификатором $app](https://kb.adguard.com/ru/general/how-to-create-your-own-ad-filters#app) для базовых правил. Примеры использования `app`: * `[$app=org.example.app]example.com##.textad` — скрывает `div` и заменяет его на класс `textad` на `example.com` и всех поддоменах в запросах, посланных из `org.example.app` приложения Android. * `[$app=~org.example.app1|~org.example.app2]example.com##.textad` — скрывает `div` и заменяет его на класс `textad` на `example.com` и всех поддоменах в запросах, посланных из любого приложения кроме `org.example.app1` и `org.example.app2`. * `[$app=org.example.app]#@#.textad` — отключит все правила `##.textad` для всех доменов при использовании приложения `org.example.app`. +> **Совместимость с различными версиями AdGuard.** Этот тип правил поддерживается AdGuard для Windows, Mac и Android. **На данный момент только в девелоперских сборках.** + ### domain @@ -1767,7 +1985,7 @@ modifiers = modifier0[, modifier1[, ...[, modifierN]]] * `[$domain=example.com|example.org]###adblock` — скрывает элемент с атрибутом `id`, равным `adblock`, на `example.com`, `example.org` и всех поддоменах. * `[$domain=~example.com]##.textad` — скрывает `div` и заменяет его на класс `textad` на всех доменах кроме `example.com` и его поддоменов. -Пожалуйста, обратите внимание, что существует 2 способа указать доменные ограничения для косметических правил: +Существует 2 способа указать доменные ограничения для косметических правил: 1) «классический»: обозначить ограничение на домены перед маской и атрибутами правила: `example.com##.textad`; 2) с помощью модификаторов: обозначить ограничение на домены через модификатор `domain`: `[$domain=example.com]##.textad`. @@ -1801,6 +2019,7 @@ AdGuard использует тот же синтаксис правил фил >Дополнительная информация о скриптлетах, редиректах и их использовании доступна в [соответствующем разделе на GitHub](https://github.com/AdguardTeam/Scriptlets#adguard-scriptlets-and-redirect-resources). +> **Совместимость с различными версиями AdGuard.** Этот тип правил поддерживается AdGuard для Windows, Mac и Android. **На данный момент только в девелоперских сборках.** ## Информация для разработчиков фильтров @@ -1953,10 +2172,12 @@ example.org#@#.adBanner #### Синтаксис Hints + ``` !+ HINT_NAME1(PARAMS) HINT_NAME2(PARAMS) ``` -Обратите внимание: вы можете использовать несколько комментариев hint. + +> Обратите внимание: вы можете использовать несколько комментариев hint. #### NOT_OPTIMIZED hint @@ -2046,6 +2267,97 @@ example.org#@#.adBanner ||example.org^ ``` + +## Как отлаживать правила фильтрации + +Хоть самые простые правила фильтрации и возможно придумать "в голове", для чего-либо даже немного более сложного вам потребуются дополнительная помощь в отладке и итерировании. Для этой цели существуют различные инструменты. Вы можете использовать Инструменты разработчиа в Chrome и их аналоги в других браузерах, но большинство продуктов AdGuard предоставляют и другой инструмент: Журнал фильтрации. + + +### Журнал фильтрации + +Журнал фильтрации — продвинутый инструмент, который полезен в основном для разработчиков фильтров. В нём отображаются все веб-запросы, проходящие через AdGuard, даётся исчерпывающая информация по каждому из них, предлагаются различные опции сортировки и другие полезные возможности. + +В зависимости от используемого вами продукта AdGuard, Журнал фильтрации может находиться в различных пунктах меню. + +* В **AdGuard для Windows** вы найдёте его во вкладке настроек *Антибаннер* или через меню трея; +* В **AdGuard для Mac** он располагается в разделе *Настройки > Дополнительно > Журнал запросов*; +* В **AdGuard для Android** это отдельный пункт бокового меню. Также в журнал фильтрации отдельного приложения или сайта можно перейти из Помощника. +* В **Браузерных расширениях AdGuard** он находится во вкладке настроек *Дополнительно*, а также доступен после правого клика по иконке расширения. Только браузеры на основе Chromium и Firefox отображают **правила скрытия элементов** (включая CSS, ExtCSS) и **JS-правила и скриптлеты** в своих Журналах фильтрации. + +> В **AdGuard для iOS** и в **AdGuard для Safari** Журнал фильтрации отсутствует из-за особенностей реализации блокировщиков контента в Safari. AdGuard сам не видит веб-запросы и поэтому не может отображать их. + + +### Режим отладки селекторов + +Иногда у вас может возникнуть необходимость проверить быстродействие того или иного селектора или таблицы стилей. Чтобы сделать это без непосредственного взаимодействия с JavaScript, вы можете использовать свойство стиля `debug`. Когда `ExtendedCSS` встречает это свойство, он включает режим отладки для конкретного селектора или для всех селекторов, в зависимости от значения `debug`. Откройте консоль браузера, находясь на веб-странице, чтобы посмотреть статистику по времени, затраченному на применение селектора(-ов). Режим отладки покажет следующую статистику для каждого из отлаживаемых селекторов: + +`array`: время, которое ушло на применение селектора на странице, для каждого из случаев применения этого селектора (в миллисекундах) +`length`: общее количество раз, когда на странице был применён данный селектор +`mean`: среднее время, ушедшее на применение данного селектора на странице +`stddev`: стандартное отклонение +`squaredSum`: сумма квадратичных отклонений от среднего значения +`sum`: общее время, ушедшее на все применения данного селектора на текущей странице + + +#### Примеры + +**Отладка конкретного селектора** + +Когда значение свойства `debug` равно `true`, информация только по этому селектору будет отображена в консоли браузера. + +``` +#$?#.banner { display: none; debug: true; } +``` + +**Включение глобальной отладки** + +Когда значение свойства `debug` равно `global`, в консоли будет отображаться информация по всем ExtendedCSS-селекторам, которые были применены на данной странице, для всех ExtendedCSS-правил из любого из включённых фильтров. + +``` +#$?#.banner { display: none; debug: global; } +``` + + +#### Тестирование расширенных селекторов без AdGuard + +Если у вас не установлен AdGuard, вы всё равно можете тестировать расширенные селекторы, но для этого вам потребуется сначала загрузить в текущую страницу ExtendedCSS. ЧТобы сделать это, скопируйте и запустите следующий код в консоли браузера: + +``` +!function(E,x,t,C,s,s_){C=E.createElement(x),s=E.getElementsByTagName(x)[0],C.src=t, +C.onload=function(){alert('ExtCss loaded successfully')},s.parentNode.insertBefore(C,s)} +(document,'script','https://AdguardTeam.github.io/ExtendedCss/extended-css.min.js') +``` + +В качестве альтернативы вы можете установить пользовательский скрипт "ExtendedCssDebugger": https://github.com/AdguardTeam/Userscripts/blob/master/extendedCssDebugger/extended-css.debugger.user.js + +Теперь вы можете использовать конструктор `ExtendedCss` в глобальном масштабе, а его метод `ExtendedCss.query` как `document.querySelectorAll`. +``` +var selectorText = "div.block[-ext-has='.header:matches-css-after(content: Anzeige)']"; + +ExtendedCss.query(selectorText) // returns an array of Elements matching selectorText +``` + + +### Отладка скриптлетов + +Если вы используете браузерное расширение AdGuard и хотите отладить [скриптлет-правило](https://kb.adguard.com/ru/general/how-to-create-your-own-ad-filters#scriptlets), вы можете получить дополнительную информацию, просто открыв Журнал фильтрации. В этом случае, скриптлеты переключатся в режим отладки и будут писать больше информации в браузерную консоль. + +Следующие скриптлеты могут быть особенно полезны в целях отладки: + +[`debug-current-inline-script`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#debug-current-inline-script) +[`debug-on-property-read`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#debug-on-property-read) +[`debug-on-property-write`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#abort-on-property-write) +[`log-addEventListener`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#log-addEventListener) +[`log-eval`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#log-eval) +[`log`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#log) + +Следующие скриптлеты могут быть полезны в целях отладки, когда применяются без каких бы то ни было параметров: + +[`requestAnimationFrame`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#prevent-requestanimationframe) +[`prevent-setInterval`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#prevent-setinterval) +[`prevent-setTimeout`](https://github.com/AdguardTeam/Scriptlets/blob/master/wiki/about-scriptlets.md#prevent-settimeout) + + ## Удачи в составлении своих фильтров! diff --git a/01.general/05.adguard-filter-policy/docs.en.md b/01.general/05.adguard-filter-policy/docs.en.md index 226b2e58..90646968 100644 --- a/01.general/05.adguard-filter-policy/docs.en.md +++ b/01.general/05.adguard-filter-policy/docs.en.md @@ -65,6 +65,23 @@ If a rule is subject to the list of limitations described below, then it won’t - Rules that are specific to a particular website will be added only if the website has sufficient traffic. Traffic is determined by open statistics (if it has such) or in other ways, for example social media following. Website’s traffic is considered sufficient when it has 30 thousands visitors a month. +## AdGuard URL Tracking filter + +##### What shall be blocked with this filter? + +- This filter shall strip all tracking parameters from URLs. + +We define **tracking** as collection of data regarding an individual’s identity or activity across one or more websites. Even if such data is not believed to be personally identifiable, it’s still tracking. + +##### Limitations and Exceptions + +If a rule is subject to the list of limitations described below, then it won’t be added to this filter. + +- Rules that would risk lowering user's security level will be removed. +- Rules that cause problems with functioning of websites will be removed. +- Rules that are specific to a particular website will be added only if the website has sufficient traffic. Traffic is determined by open statistics (if it has such) or in other ways, for example social media following. Website’s traffic is considered sufficient when it has 30 thousands visitors a month. + + ## Social Media filter ##### What shall be blocked with this filter? diff --git a/01.general/05.adguard-filter-policy/docs.ru.md b/01.general/05.adguard-filter-policy/docs.ru.md index 583487a6..6079e9bb 100644 --- a/01.general/05.adguard-filter-policy/docs.ru.md +++ b/01.general/05.adguard-filter-policy/docs.ru.md @@ -66,6 +66,23 @@ visible: true - Правила, специфичные для конкретного сайта, будут добавляться, только если сайт обладает достаточной посещаемостью. Посещаемость определяется по открытой статистике (если таковая присутствует), либо по косвенным признакам, например таким, как количество подписчиков в социальных сетях. Достаточной считается посещаемость от 30 тысяч посетителей в месяц. +## Фильтр параметров отслеживания + +##### Что должно блокироваться этим фильтром? + +- Фильтр должен повышает приватность путём удаления параметров отслеживания (трекинга) из адресов страниц и их ресурсов. + +Мы определяем **трекинг** как сбор данных относительно личности и действий человека на одном или нескольких сайтах. Даже если по этим данным невозможно идентифицировать личность человека, подобные действия всё равно считаются трекингом. + +##### Ограничения и исключения + +Если правило подпадает под описанный ниже список ограничений, то оно не будет добавлено в фильтр. + +- Правила, которые имеют риск понизить безопасность пользователя, будут удаляться. +- Правила, которые часто вызывают проблемы с работой каких-либо сайтов, будут удаляться. +- Правила, специфичные для конкретного сайта, будут добавляться, только если сайт обладает достаточной посещаемостью. Посещаемость определяется по открытой статистике (если таковая присутствует), либо по косвенным признакам, например таким, как количество подписчиков в социальных сетях. Достаточной считается посещаемость от 30 тысяч посетителей в месяц. + + ## Фильтр виджетов социальных сетей ##### Что должно блокироваться этим фильтром? diff --git a/01.general/07.how-ad-blocking-works/docs.en.md b/01.general/07.how-ad-blocking-works/docs.en.md index c07771df..16d9c93b 100644 --- a/01.general/07.how-ad-blocking-works/docs.en.md +++ b/01.general/07.how-ad-blocking-works/docs.en.md @@ -7,73 +7,76 @@ visible: true --- * [Introduction](#introduction) -* [Ad filtering](#filtering) -* [Page code filtering](#html) -* [Request blocking](#block) -* [CSS Injection and Javascript](#inject) -* [Post-processing of pages](#cosmetic) -* [Do you want to help?](#report) +* [General principle](#general) +* [Filter lists](#filter-lists) +* [Types of filtering rules](#types-filtering) + * [Basic filtering rules](#basic) + * [Cosmetic filtering rules](#cosmetic) + * [HTML filtering rules](#html) ## Introduction -One of the main functions of AdGuard is filtering ads on websites. In this article, we will describe in details how exactly AdGuard filters online advertising. +There are many different AdGuard ad blocker products for various platforms, each has its one unique features. But what unites them all is that they block ads and trackers. This article describes how ad blocking works from inside. -Adguard's work is based on the use of various advertising filters that define rules, based on which the program removes ads. AdGuard may use a variety of different ad filters. We create some of them ourselves (you can learn more about it on [this page](/general/adguard-ad-filters.html)), some of the filters are created by enthusiasts. +> We don't cover DNS filtering here. It's a different way of blocking ads, with its own advantages and disadvantages. Follow this link to [learn more about DNS filtering](https://kb.adguard.com/en/general/dns-filtering). + + + +## General principle + +At the core of any ad blocker lie filter lists, also called filters. Filters are literally lists of rules written in a special syntax. Ad blockers can understand this complex syntax. They interpret filtering rules and perform actions with web traffic based on what the rules tell them to do: block specific elements, alter web pages in certain ways, etc. + + + + + +## Filter lists + +To better understand ad blocking, it's important to know the underlying principles of how filters work. + +Filtering rules, which filters consist of, aren't created automatically. They are a product of filter maintainers' work, both professionals and volunteers. They use browsers' developer consoles and other tools (like AdGuard's Filtering log) to determine what rule would block a particular ad or tracker. This is a very simplified description of the process, as some ads are especially hard to block, require multiple rules, multiple iterations, and the use of complex syntax. + +And even when a rule finally gets added to the filter, it doesn't mean that it stays there forever. Ads change, ways to serve the same ads on the same websites change, and so filter rules have to change too. Sometimes rules get obsolete, sometimes a new ad appears, sometimes a new filtering rule is needed to block the same ad. Filters are often maintained by a single person, but even for a team of maintainers it's impossible to constantly monitor the entire web. This is why many ad blockers have tools to help users easily report any filter-related issues they encounter. + + + +AdGuard users [have access to a special web reporting tool](https://reports.adguard.com/new_issue.html). Thanks to user complaints, filter developers can focus on correcting their filter lists and not on scouring the Internet for new and old unblocked ads. + +Filters can do more than just block ads. There are filters that block tracking, social media widgets, annoyances like cookie notices, etc. Different users may choose different combinations of filters to match their personal preferences. There are websites like [filterlists.com](https://filterlists.com/) that are dedicated to filter lists and have a huge database. + +> We develop and maintain [our own set of filter lists](https://kb.adguard.com/en/general/adguard-ad-filters) that can be used with AdGuard or other ad blockers. + - +## Types of filtering rules -## Ad filtering +There are many types of filtering rules that serve different purposes. Depending on the ad blocker you use, and especially on your OS, certain types of rules may not by supported. -Ad filtering mechanism depends on what product you use. Browser extensions rely on the capabilities that browsers provide them with. AdGuard for Windows, Mac and Android works independently of your browser, using a completely different filtering algorithm. Below we describe all the stages of ad filtering that AdGuard uses. + +### Basic filtering rules +To be displayed on a web page or in an app, the ad has to be loaded from a server first. To do so, the browser or the app needs to send a web request. The most basic way of preventing an ad from appearing on your screen is to block this request so it never reaches the server, and thus there's no reply. - - -#### Page code filtering - -Before a page is loaded into browser, AdGuard processes its code removing elements according to the ad filtering rules. Thus browser does not recognize that there were actually those elements on this page and will not try to load them. - -![Adguard: Page code filtering](https://images.adguard.com/public/Adguard/Common/page_filtering.png) - -Page code filtering technology is used **only in AdGuard for Windows, Mac or Android (if high quality filtering is enabled)**. That is because of the fact that capabilities of browser extensions are limited, and they can not change the page code before the browser processed it. - - - - - -#### Request blocking - -Browser loads all the necessary elements on a page, defined by the page code. Based on filtering rules, AdGuard can block the load of advertising elements, such as banners ads or Flash objects. - -![Adguard: Blocking of queries](https://images.adguard.com/public/Adguard/Common/url_filtering.png) - - - - - -#### CSS Injection and Javascript - -Not all advertising can be blocked within the first two steps. For instance, there is such a kind of advertising that is embedded in the page dynamically with the help of Javascript, and does not require loading of additional items that we could block. - -CSS is a special language used for web pages design. Display style of elements on a web page can be set by rules. By style we mean color, font, location, and even the visibility of the element. And that is of interest to us, because we want to hide the banner from you. Javascript is also a special language that allows you to dynamically change any element on the page. - - +Basically, all AdGuard ad blocker products can block web requests (according to the active filter rules). This method is very effective at stopping the ad but shows some drawbacks, the most obvious one is that whatever place the ad was taking up will be left empty or occupied by an ad leftover. -#### Post-processing of pages +### Cosmetic filtering rules -This is an approach for browser extensions only. It is necessary, because the first step of processing (page code filtering) is unavailable to them. During post-processing, the browser extension removes all the elements, loading of which was blocked, from a web page. If we didn't remove them, you would see not fully loaded elements, such as "broken" graphic. +Every web page has a DOM ("document object model"), basically an HTML document that contains the page's structure and all its elements. Ads on the page are also elements and therefore reflected in the DOM. Ad blockers can remove parts of the DOM, and filtering rules help them understand which parts are ads and should be removed, and which shouldn't be messed with. +This method allows to avoid whitespaces and ad leftovers mentioned above, but also to perform other, more complicated tasks. + - +### HTML filtering rules -## Do you want to help? +In most cases, the aforementioned basic and cosmetic rules are enough to filter ads. But sometimes it is necessary to change the HTML code of the page itself before it is loaded. This is when you need filtering rules for HTML content. These rules allow to indicate the HTML elements to be cut out before the browser even loads the page. -All ad filters are created manually, based on complaints on ads from users. You can send us a complaint via the program itself or write about it [on our Forum](http://forum.adguard.com/forumdisplay.php?51-Filter-Rules). \ No newline at end of file +This kind of rules is quite complicated and demands that the ad blocker possesses certain rights, so not all platforms support it. Such rules work only in AdGuard apps for Windows, Mac, and Android, and for AdGuard Firefox add-on. + +> There are more types of filtering rules, but they require even more technical knowledge to understand how they operate. If you're interested, [you can find the exhaustive guide on filtering rules in the linked article](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters). \ No newline at end of file diff --git a/01.general/07.how-ad-blocking-works/docs.ru.md b/01.general/07.how-ad-blocking-works/docs.ru.md index 01feda09..b435aa00 100644 --- a/01.general/07.how-ad-blocking-works/docs.ru.md +++ b/01.general/07.how-ad-blocking-works/docs.ru.md @@ -1,5 +1,5 @@ --- -title: 'Как работает защита от рекламы' +title: 'Как работает блокировка рекламы' taxonomy: category: - docs @@ -7,72 +7,75 @@ visible: true --- * [Введение](#introduction) -* [Удаление рекламы](#filtering) -* [Фильтрация кода страницы](#html) -* [Блокировка запросов](#block) -* [Инъекция CSS и Javascript](#inject) -* [Постобработка страницы](#cosmetic) -* [Хотите нам помочь?](#report) +* [Общие принципы](#general) +* [Фильтры](#filter-lists) +* [Типы правил фильтрации](#types-filtering) + * [Базовые правила](#basic) + * [Косметические правила](#cosmetic) + * [HTML-правила](#html) ## Введение -Одной из основных функций AdGuard является блокировка рекламы на интернет-сайтах. В этой статье мы детально опишем, как именно AdGuard фильтрует рекламу. +В семействе блокировщиков AdGuard есть много продуктов для разных платформ, у каждого из них свои уникальные особенности. Но что их объединяет — они все блокируют рекламу и трекинг. Эта статья описывает, как устроена блокировка рекламы изнутри. -Работа AdGuard основана на использовании различных рекламных фильтров, задающих правила, основываясь на которых программа удаляет рекламу. AdGuard может использовать множество различных рекламных фильтров. Часть из них мы создаем самостоятельно (подоробнее о них вы можете узнать на [этой странице](http://testkb.adguard.com/ru/general/adguard-ad-filters)), часть фильтров создается энтузиастами. +> В этой статье мы не касаемся DNS-фильтрации. Это альтернативный способ блокировать рекламу, со своими преимуществами и недостатками. Переходите по этой ссылке, чтобы [узнать больше про DNS-фильтрацию](https://kb.adguard.com/ru/general/dns-filtering). + - +## Общие принципы -## Удаление рекламы +В основе любого блокировщика лежат фильтры. Фильтры — это буквально списки правил, написанные в соответствии с определённым синтаксисом. Блокировщики понимают этот сложный синтаксис. Они интерпретируют правила и на их основе совершают те или иные действия с веб-трафиком: блокируют элементы, изменяют вид веб-страниц и т.д. -Механизм удаления рекламы зависит от того, какой продукт вы используете. Браузерные расширения полагаются на те возможности, которые предоставляют им сами браузеры. AdGuard для Windows, macOS или Android работает независимо от вашего браузера, на основе совершенно другого алгоритма фильтрации. Ниже мы опишем все этапы фильтрации рекламы, которые использует AdGuard. + + +## Фильтры - +Чтобы понимать, как работает блокировка рекламы, вначале надо разобраться в основополагающих принципах работы фильтров. -#### Фильтрация кода страницы +Правила фильтрации, из которых состоят фильтры, не создаются сами собой. Они являются результатом кропотливой работы разработчиков фильтров, как профессионалов, так и волонтёров. Разработчики используют консоль браузеров и другие инструменты (такие, как Журнал фильтрации AdGuard), чтобы определять, какое правило нужно для блокировки конкретной рекламы или трекера. Это очень упрощённое описание процесса: в особо трудных случаях могут потребоваться сразу несколько правил, множество итераций и использование сложного синтаксиса, чтобы заблокировать элемент. -Перед тем как страница будет получена браузером, AdGuard обрабатывает ее код, удаляя элементы в соответствии с рекламными фильтрами. Таким образом браузер не узнает о том, что на странице вообще были эти элементы, и не будет пытаться их подгрузить. +Даже когда правило попадает в фильтр, оно не остаётся там навсегда. Реклама и способ её подачи могут поменяться, и правила фильтрации должны меняться вслед за ними. Иногда правила устаревают и больше не нужны, иногда появляется новая реклама и требуются новые правила, а иногда уже существующее правила требуется доработать. Поэтому фильтры требуют постоянной поддержки, и часто эту поддержку осуществляет всего один человек. Но даже в случае с целой командой разработчиков фильтров невозможно представить, чтобы они постоянно мониторили все сайты в интернете. Поэтому многие блокировщики имеют встроенный функционал, чтобы дать пользователям простой способ сообщать о пропущенной рекламе и любых других проблемах с фильтрами, с которыми они сталкиваются. -![Adguard: фильтрация кода страницы](https://images.adguard.com/public/Adguard/Common/page_filtering.png) + -Этот механизм используется **только в AdGuard для Windows, macOS и Android (при включенном высоком качестве фильтрации)**. Дело в том, что возможности браузерных расширений ограничены, и они не могут изменять код страницы до того, как ее обработает браузер. +Пользователи AdGuard [могут отправлять такие отчёты при помощи специальной веб-утилиты](https://reports.adguard.com/new_issue.html). Благодаря жалобам пользователей разработчики могут сфокусироваться на исправлении и дополнении фильтров, а не на поиске пропущенной рекламы по всей сети. +Фильтры могут гораздо больше, чем просто блокировать рекламные элементы. Существуют фильтры для блокировки трекеров, виджетов социальных сетей, раздражающих элементов (вроде уведомлений о cookie) и т.д. Разные пользователи могут выбирать разные комбинации фильтров, чтобы подстроить фильтрацию под свои нужды. Существуют специальные сайты, такие, как [filterlists.com](https://filterlists.com/), где собраны огромные базы всевозможных фильтров. +> Мы разрабатываем и поддерживаем [свой собственный набор фильтров](https://kb.adguard.com/ru/general/adguard-ad-filters), которые можно использовать как внутри AdGuard, так и с другими блокировщиками. - + -#### Блокировка запросов +## Типы правил фильтрации -Браузер подгружает на страницу все необходимые элементы, основываясь на полученном коде. AdGuard, основываясь на правилах фильтрации, может заблокировать загрузку рекламных элементов, например, баннеров или флэш-объектов. +Существует множество видов правил фильтрации, служащих различным целям. В зависимости от используемого вами блокировщика и в особенности от вашей операционной системы, те или иные виды правил могут не поддерживаться. -![Adguard: блокировка запросов](https://images.adguard.com/public/Adguard/Common/url_filtering.png) + +### Базовые правила +Чтобы вы увидели рекламу на веб-странице или в приложении, её сначала необходимо загрузить с сервера. Для этого браузер или приложение должны отправить веб-запрос. Самый простой способ предотвратить загрузку рекламы — заблокировать этот запрос, так что он никогда не попадёт на сервер, а значит и реклама не загрузится. - - -#### Инъекция CSS и Javascript - -Не вся реклама может быть заблокирована на первых двух этапах. Иногда встречается такая реклама, которая внедряется в страницу динамически, с помощью Javascript, и не требует подгрузки дополнительных элементов, которые мы могли бы заблокировать. - -CSS - это специальный язык, используемый для оформления веб-страниц. Стиль отображения элементов веб-страницы можно задавать с помощью правил. Под стилем мы понимаем цвет, шрифт, расположение, и даже видимость элемента. Именно это нас и интересует — мы же хотим скрыть баннер от ваших глаз. Javascript - это также специальный язык, который позволяет динамически изменять любой элемент на странице. - - +Практически все продукты из семейства AdGuard могут блокировать веб-запросы в соответствии с активными правилами фильтрации. Этот метод является одним из самых эффективных в плане блокировки рекламы, но у него есть и недостатки. Самый очевидный из всех — на месте заблокированной рекламы может остаться пустое место. -#### Постобработка страницы +### Косметические правила -Этот этап применяется только браузерными расширениями. Необходимость в нем обусловлена тем, что первый этап обработки (фильтрация кода страницы) для них недоступен. Во время постобработки браузерное расширение удаляет с веб-страницы все элементы, загрузка которых была заблокирована. Если мы не будем их удалять, вы можете увидеть на странице недогруженные элементы, например "битые" изображения. +Каждая веб-страница имеет так называемый DOM ("document object model" или "объектная модель документа"), по сути — HTML-документ, содержащий структуру страницы и всех её элементов. Реклама на странице тоже является элементом и, следовательно, отображается в DOM. Блокировщики могут убирать часть DOM, а правила фильтрации помогают им понять, какие именно куски DOM соответствуют рекламе и требуют удаления, а какие не стоит трогать. +Этот метод позволяет, например, избежать остатков рекламы, вроде пустых кусков страницы, но также и выполнять другие, более сложные задачи. + - +### HTML-правила -## Хотите нам помочь? +В большинстве случаев вышеупомянутых базовых и косметических правил достаточно, чтобы скрыть или заблокировать всю рекламу. Но иногда требуется изменить сам HTML-код страницы ещё до того, как она будет загружена. Для этого существуют правила фильтрации HTML-контента. Такие правила указывают блокировщику на элементы HTML, которые нужно вырезать из кода ещё до загрузки страницы браузером. -Все рекламные фильтры создаются вручную, основываясь на жалобах пользователей на рекламу. Вы можете отправить нам жалобу на рекламу с помощью самой программы, или написать об этом [на нашем форуме](http://forum.adguard.com/forumdisplay.php?69-%D0%A4%D0%B8%D0%BB%D1%8C%D1%82%D1%80%D1%8B-Adguard). \ No newline at end of file +Это весьма сложный тип правил, и он требует от блокировщика наличия определённых прав, поэтому поддерживается не на всех платформах. HTML-правила работают в приложениях AdGuard для Windows, Mac и Android, а также в браузерном расширении AdGuard для Firefox. + +> Есть и другие типы правил фильтрации, но для их понимания необходим ещё более высокий уровент технической подготовки. Если вам интересно, [вы можете ознакомиться с подробным описанием правил фильтрации](https://kb.adguard.com/ru/general/how-to-create-your-own-ad-filters) в статье по ссылке. \ No newline at end of file diff --git a/01.general/09.license-key/docs.ko.md b/01.general/09.license-key/docs.ko.md index 17e5410e..8706ec01 100644 --- a/01.general/09.license-key/docs.ko.md +++ b/01.general/09.license-key/docs.ko.md @@ -174,12 +174,22 @@ AdGuard 계정을 사용하여 라이선스 키와 컴퓨터간의 결합 상태 AdGuard [개인 계정](https://auth.adguard.com/login.html)에서 라이선스 키 목록과 현재 상태를 확인할 수 있습니다. -라이선스 키 아래에 라이선스 키가 활성화된 컴퓨터 목록이 표시됩니다. 라이선스 키는 정해진 수의 컴퓨터에서만 활성화할 수 있으며, 재사용 전 이용하지 않는 컴퓨터 중 하나에서 결합을 해제해주세요. +AdGuard 라이선스 및 구독을 관리하는 방법은 다음과 같습니다. -컴퓨터에서 라이선스 키의 결합을 해제하려면 아래 그림에 표시된 대로 "X" 버튼을 클릭하세요. +## 갱신 또는 업그레이드 +라이선스 키를 1년 더 연장하고 평생 또는 가족 라이선스(최대 9개의 기기에서 사용 가능)로 전환할 수 있습니다. +## 기기와의 연동을 해제 +라이선스 키 아래에 라이선스 키가 활성화된 기기 목록이 표시됩니다. 라이선스 키는 정해진 수의 기기에서만 활성화할 수 있으며, 재사용 전 이용하지 않는 기기 중 하나에서 결합을 해제해주세요. +기기에서 라이선스 키의 결합을 해제하려면 아래 그림에 표시된 대로 "X" 버튼을 클릭하세요. - + + +## 카드 정보 변경 또는 구독 취소 + +카드 정보를 변경하거나 구독을 취소하려면 이 구독을 찾아 카드 아이콘을 클릭하세요. + + @@ -187,8 +197,6 @@ AdGuard [개인 계정](https://auth.adguard.com/login.html)에서 라이선스 AdGuard를 1년 더 갱신한 경우 프로그램/앱을 다시 시작하거나 '라이선스' 섹션으로 이동하여 라이선스 상태를 새로 고쳐 주세요. - - #### 결제 방법 diff --git a/01.general/09.license-key/docs.ru.md b/01.general/09.license-key/docs.ru.md index 6322450a..f033a2e3 100644 --- a/01.general/09.license-key/docs.ru.md +++ b/01.general/09.license-key/docs.ru.md @@ -112,7 +112,7 @@ visible: true - Восстановить покупки (Восстанавливает лицензию, если вы удалили приложение и установили его повторно). 3) После того как вы нажмёте **«Активировать Премиум»**, вам будут представлены несколько вариантов активации: -- Активация путём введения **логина** и **лароля** от **учётной записи AdGuard**. +- Активация путём введения **логина** и **пароля** от **учётной записи AdGuard**. - Авторизация с помощью одной из социальных сетей (**Twitter, Google Account, Facebook, Яндекс, VK**). @@ -239,4 +239,4 @@ _Также предоставляется возможность оплаты ## Правила возврата -Для осуществления возврата денежных средств обратитесь в [службу подедржки](mailto:support@adguard.com) и укажите, какой способ оплаты вы использовали. Примите во внимание, что в возврате может быть отказано, если вы приобретали ключ более, чем 60 дней назад. +Для осуществления возврата денежных средств обратитесь в [службу поддержки](mailto:support@adguard.com) и укажите, какой способ оплаты вы использовали. Примите во внимание, что в возврате может быть отказано, если вы приобретали ключ более, чем 60 дней назад. diff --git a/01.general/09.license-key/docs.zh.md b/01.general/09.license-key/docs.zh.md new file mode 100644 index 00000000..ed23cc06 --- /dev/null +++ b/01.general/09.license-key/docs.zh.md @@ -0,0 +1,225 @@ +--- +title: 'AdGuard 许可密钥' +taxonomy: + category: + - docs +visible: true +--- + +* [什么是 AdGuard 许可密钥？](#key) +* [如何使用许可密钥激活 AdGuard ？](#activation) +* [如何恢复我的许可密钥？](#recovery) +* [如何注册 AdGuard 帐号？](#account) +* [AdGuard 帐号有什么可用的功能？](#account-functions) +* [更新密钥后，该做什么？](#renewal) +* [支付方式](#payment) +* [退款政策](#refund) + + +#### 什么是 AdGuard 许可密钥？ +许可密钥是一串用于激活 AdGuard 的独一无二的字符。试用期到期后，需要使用许可密钥才能全面运行 AdGuard。有两种类型的许可： +1. **个人**。 该许可密钥让您可以**在任意三台**设备上激活 AdGuard。 +2. **家庭**。该许可密钥让您可以**在任意九台**设备上激活 AdGuard。 +>**请注意**：许可密钥都是通用的。您可以在不同操作系统使用许可，包括 Windows、Mac、Android 或 iOS 等平台上激活 AdGuard。 + +您可以通过 [AdGuard 帐号](http://adguard.com/login.html) 管理许可密钥。 +点击[这里](https://adguard.com/license.html)，购买 AdGuard 许可密钥。 + + + +## 如何使用许可密钥激活 AdGuard ？ +* [激活适用于 Windows 的 AdGuard](#activation_windows) +* [激活适用于 Mac 的 AdGuard](#activation_mac) +* [激活适用于 Android 的 AdGuard](#activation_android) +* [激活适用于 iOS 的AdGuard](#activation_iOS) +* [把许可密钥绑定到另一台设备](#activation_info) + + + + +#### 激活适用于 Windows 的 AdGuard + +1. 开启软件 + +请鼠标双击桌面上的 AdGuard 图标： + + + +或也可以在通知栏双击 AdGuard 图标： + + + +2. 前往右上角主菜单中的**许可**，点击**激活许可**。 + + +3. 您有两种激活方式： +- 输入您 AdGuard 帐号的电子邮件地址和密码。 + + + +- 输入**许可密钥**。 + + + + + +#### 激活适用于 Mac 的 AdGuard + +1. 打开 AdGuard 菜单 + +在菜单栏点击 AdGuard 图标。 + +2. 点击齿轮图标打开选项菜单，选择**许可...**。 + + + +3. 在弹出的窗口中点击**激活授权码**。 + + + +4. 您有两种激活方式： +- 使用 **AdGuard 个人帐号**的**用户名**和**密码**激活软件。 + + + + +- 使用**许可密钥**。 + + + + + +#### 激活适用于 Android 的 AdGuard + +1. 打开应用程序，前往许可菜单。 + +在屏幕上的顶部点击**获取高级版**。 + +您也可以通过点击“许可状态”前往许可菜单： + + + +2. 点击屏幕**右上角**的三点。 +在弹出的小窗口中陈列三种选项： + + + +- 免费试用（试用期为14天）。 +- 激活**高级版本**。 +- 恢复购买（若您重新安装应用程序，需要恢复许可）。 + +3. 点击**激活高级版本**后，您有几种激活方式： + +- 输入 **AdGuard 帐号**的**电子邮件地址**和**密码**。 +- 通过社交媒体登录（**Twitter、Google 账户、Facebook、Yandex、VK**)。 + + + +- 使用许可密钥激活软件。 + + + + + + +#### 激活适用于 iOS 的 AdGuard + +1. 打开应用的菜单，点击屏幕右上角的**齿轮图标**。 + +2. 前往 **关于** > **许可**。您将会看到一个窗口： + + + +3. 您也可以在 **AppStore** 直接购买许可或通过**登录 AdGuard 帐号**激活高级版本。 +> 注意：为了激活成功，您帐号最少需要有一个**可用**的许可。 + + + + + +#### 把许可绑定到另一台设备 + +通过许可密钥激活软件后，该密钥会绑定到您使用的设备。许可密钥可以在一定数量的设备上被激活。如果该许可密钥已达到设备使用数量的上限，则重新使用该密钥前，您要在 [AdGuard 帐号](#account-functions)重新设置它。 + + +## 如何恢复我的许可密钥？ + +在 [AdGuard 帐号](#account)里可以很容易查找您的许可密钥。 + +许可密钥通过您购买 AdGuard 时输入的电子邮件地址绑定到帐号。 + +**请注意**，一般只查找您的许可密钥是不够的。如您已经在另一台电脑上使用过该密钥的话，首先需要登录 [AdGuard 帐号](#account)，把许可密钥从该电脑中解绑。 + + +## 如何注册 AdGuard 帐号？ + +如您购买了 AdGuard 许可密钥，您的帐号就已经通过您购买 AdGuard 时输入的电子邮件地址注册成功了。彼时，您将会收到电子邮件通知您已自动注册个人账号。邮件内容还会包括激活链接。如您没收到该电子邮件或忘记了密码，可以[恢复您的密码](http://adguard.com/recovery_password.html)。 + +如您没有 AdGuard 帐号，我们建议您点击[此链接](http://adguard.com/register.html)进行注册。 + +AdGuard 帐号为您提供管理许可密钥并其绑定到设备的机会。 + +[于以下](#account-functions)查找更多帐号的功能。 + + +## AdGuard 帐号有什么可用的功能？ + +当您进入 [AdGuard 个人帐号](https://adguard.com/en/login.html)后，可以看到您的许可密钥的列表和其当前状态。 + +查看管理 AdGuard 许可密钥和订阅的方式。 + +#### 续订或升级 + +您可以将许可密钥再续订一年，切换到终生保护或将许可升级成家庭（绑定更多设备）。 + +#### 取消绑定 + +如许可密钥是在一台或几台设备被激活的话，您可以在许可密钥下方看到设备列表。许可密钥可以在一定数量的设备上被激活。再次使用前，您需要把密钥从其中一台设备上解绑。 + +您只要点击叉号，就可以把许可密钥从电脑中解绑。参考这张截图： + + + +#### 修改信用卡信息或取消订阅 + +找到您要修改的订阅并点击旁边的卡图标: + + + + +## 更新密钥后，该做什么？ + +当 AdGuard 续订一年后，您需要重新启动应用程序或转到“许可证”部分并刷新许可状态，以使更改生效。 + + + +#### 支付方式 + +您可以在我们的官方网站购买 AdGuard 许可： + +1\. 前往[购买页](http://adguard.com/license.html)。 + +2\. 根据您是否打算延长现有许可密钥或是购买新许可密钥，选择适当的选项。 + +3\. 选择许可类型。当前，我们具有**两种**许可类型：**个人**和**家庭**。 + +4\. 选择您想用的货币、许可期间和您想把 AdGuard 绑定到设备的数量。 + +5\. 输入并确认您的电子邮件地址。 + + +_**注意！** 请您谨慎对待您输入的邮箱地址。我们会自动用它创建您个人的 AdGuard 帐号。确保没有任何错误。_ + +6\. 选择支付方式。 + +我们提供用信用卡或 PayPal 的支付方式。 + +#### 许可密钥的激活 + +购买成功的许可密钥将会被发送到指定的电子邮件地址。您需要使用该许可密钥激活 AdGuard。点击[此处](#activation)获取更详细的信息。 + + + +## 退款政策 + +以退款，您需要联系我们的[支持团队](mailto:support@adguard.com)并说明您之前使用的支付方式。请注意！如您购买许可密钥的时间超过六十天的话，退款会被拒绝。 diff --git a/01.general/10.why-is-adguard-better/docs.zh.md b/01.general/10.why-is-adguard-better/docs.zh.md new file mode 100644 index 00000000..452104ca --- /dev/null +++ b/01.general/10.why-is-adguard-better/docs.zh.md @@ -0,0 +1,47 @@ +--- +title: '为什么 AdGuard 比其他广告过滤器更好' +taxonomy: + category: + - docs +visible: true +--- + +AdGuard 经常被与众所周知的浏览器拓展 -- Adblock 和 Adblock Plus 作比较。在这篇文章里，我们将比较 AdGuard 所具有的主要优势而它的竞争者却不具备的。 + +AdGuard 的优势主要是源于采用基于浏览器的拓展的限制。Adblock 和 Adblock Plus 从技术上来说并不能删除网页里的所有广告。这是因为 AdGuard 在页面被加载到浏览器之前就删除了所有的广告元素。拓展基于浏览器的广告过滤功能的一种与 AdGuard 不同的原理工作。这就是为什么需要额外的页面后期处理来隐藏被阻止的元素。如果你曾经使用过 Adblock，那么你一定注意过隐藏横幅是如何“闪烁”的。 + + + +AdGuard 的第二个优势在于它是一个单独的程序，而不是一个浏览器拓展。AdGuard 可以拦截任何浏览器里的广告。无论你使用什么浏览器，无论它是 Google Chrome、Mozilla Firefox、Opera、Internet Explorer 还是 Yandex 等等，有了 AdGuard 你就可以忘掉烦人的在线广告了。 + +如果你使用一个小众的浏览器，对于 Adblock 和 Adblock Plus 来说可能是个问题，因为这些拓展只能在最流行的浏览器中使用。使用 AdGuard 你就没有这些问题了。你可以很轻易地把你的浏览器添加到保护列表里。 + + + +这还不是所有的。AdGuard 可以拦截 Skype、uTorrent 和许多其他的应用程序里的广告。只需要将他们添加到浏览器列表并且重启。 + +除了拦截广告，AdGuard 提供了许多额外的工具。可能最重要的就是网络钓鱼过滤器。这个模块的运行建立在使用不断更新的恶意网站和钓鱼网站黑名单的基础之上。AdGuard 使用两个主要的资源。一个是谷歌安全浏览列表，一个是 AdGuard 自己的黑名单。我们一直在监控有关网站安全性的数据并且迅速改进我们的过滤器。 + + + +一些用户使用 AdGuard 替代反病毒软件，一些一起使用。在任何情况下，AdGuard 都认真地提升你的电脑在网络上的安全性。 + +又一个常见的误解是 Adblock 和 Adblock Plus 几乎不消耗资源。但是真的是这样吗？ + +为了验证这一点我们将使用 Google Chrome 浏览器里的 Task Manager。 + + + +请注意即使在最简单的设置和一个过滤器启用的情况下，拓展消耗了 100M 的 RAM。AdGuard 消耗了几乎相同的资源的同时还提供了更多的功能。 + +总结： + +**1. AdGuard 在它们加载到浏览器之前就过滤广告。** + +**2. AdGuard 可以节省你的流量。** + +**3. AdGuard 可以在任何浏览器里工作。** + +**4. AdGuard 可以移除来自 Skype、uTorrent 和其他软件的广告。** + +**5. AdGuard 可以保护你远离病毒和钓鱼网站。** diff --git a/01.general/15.dns-filtering-android/DNSCrypt-ru.png b/01.general/15.dns-filtering-android/DNSCrypt-ru.png deleted file mode 100644 index ed7e49e7..00000000 Binary files a/01.general/15.dns-filtering-android/DNSCrypt-ru.png and /dev/null differ diff --git a/01.general/15.dns-filtering-android/DNSCrypt.png b/01.general/15.dns-filtering-android/DNSCrypt.png deleted file mode 100644 index fea16c3e..00000000 Binary files a/01.general/15.dns-filtering-android/DNSCrypt.png and /dev/null differ diff --git a/01.general/15.dns-filtering-android/How_DNS_Filtering_works-ru.png b/01.general/15.dns-filtering-android/How_DNS_Filtering_works-ru.png deleted file mode 100644 index 8bc51382..00000000 Binary files a/01.general/15.dns-filtering-android/How_DNS_Filtering_works-ru.png and /dev/null differ diff --git a/01.general/15.dns-filtering-android/How_DNS_Filtering_works.png b/01.general/15.dns-filtering-android/How_DNS_Filtering_works.png deleted file mode 100644 index b2faf59c..00000000 Binary files a/01.general/15.dns-filtering-android/How_DNS_Filtering_works.png and /dev/null differ diff --git a/01.general/15.dns-filtering-android/How_DNS_works-ru.png b/01.general/15.dns-filtering-android/How_DNS_works-ru.png deleted file mode 100644 index 9753df32..00000000 Binary files a/01.general/15.dns-filtering-android/How_DNS_works-ru.png and /dev/null differ diff --git a/01.general/15.dns-filtering-android/How_DNS_works.png b/01.general/15.dns-filtering-android/How_DNS_works.png deleted file mode 100644 index b960edb9..00000000 Binary files a/01.general/15.dns-filtering-android/How_DNS_works.png and /dev/null differ diff --git a/01.general/15.dns-filtering-android/docs.en.md b/01.general/15.dns-filtering-android/docs.en.md deleted file mode 100644 index 0e4c7f5d..00000000 --- a/01.general/15.dns-filtering-android/docs.en.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: "DNS filtering" -taxonomy: - category: - - docs -published: true -visible: true ---- -### What is DNS? - -DNS stands for 'Domain name system', and its purpose is to translate websites 'names' into something browser can understand, i.e. IP addresses. Thus, each time you go to a website, your browser sends a request to a special server. That server either redirects the request to another server or replies with an IP address. Very schematically it can be represented like this: - -![dns-scheme](How_DNS_works.png) - -The same applies, of course, to all apps and programs that send any web requests. - -### How does DNS filtering work? - -Usually, your ISP provides a DNS server that does all the job of returning the IP addresses in response to web requests by your apps and browsers. In reality, you are free to use any DNS server for this purpose, and there are plenty of them to choose from (in fact, AdGuard has its own DNS servers - you can read about AdGuard DNS in [another article](https://kb.adguard.com/en/dns/overview)). Some of these DNS servers are designed to do more than just return IP addresses, for example ad blocking. - -The best part is, you don't even need to choose a special DNS server to block ads if you are using DNS filtering. How is it possible? Let's have a look at this diagram: - -![dns-scheme](How_DNS_Filtering_works.png) - -For example, let's imagine you have AdGuard for Android app installed on your device. If you have DNS filtering enabled, all DNS requests will pass through AdGuard before reaching the DNS server. AdGuard has a special 'DNS filter' containing a large amount of ad and tracker domains, which it uses in conjunction with User filter to recognize 'bad' requests. Every request is checked against this filter, and if there's a hit, instead of forwarding it to the DNS server, it is being rerouted to a 'blackhole'. Mind you, all this happens locally on your device! - -The main advantage of this approach is it is extremely economical and saving. Once a domain is blocked, it won't be requested again within an hour. The disadvantage being the roughness of this method: specific URLs can't be blocked, only whole domains. It can sometimes lead to 'breaking' of a websites functionality. - -### What is DNSCrypt and why is it important? - -If you use regular client-server protocol, you are at risk of your DNS requests being intercepted and, subsequently, eavesdropped and/or altered. The experiments [show that](https://blog.adguard.com/dns-track-you/) the DNS tracking can even be used to collect a 'profile of interests' for any user. Luckily, AdGuard offers [DNSCrypt](https://dnscrypt.info/) - a special protocol that encrypts communication with the DNS server, thus preventing tampering and tracking by any third party including your ISP. - -![dnscrypt-scheme](DNSCrypt.png) - -If you care about your online privacy, we strongly recommend using DNSCrypt as an important part of your defence suit. - diff --git a/01.general/15.dns-filtering-android/docs.ru.md b/01.general/15.dns-filtering-android/docs.ru.md deleted file mode 100644 index 7b1f2858..00000000 --- a/01.general/15.dns-filtering-android/docs.ru.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: 'DNS-фильтрация на устройствах c Android' -taxonomy: - category: - - docs -published: true -visible: true ---- -### Что такое DNS? - -DNS означает "Domain name system" (система доменных имён) - это система, которая переводит названия сайтов на язык, понятный браузеру, т.е. IP-адреса. Таким образом, каждый раз, когда вы переходите на веб-сайт, ваш браузер посылает запрос к специальному серверу. Этот сервер либо перенаправляет запрос к вышестоящему серверу, либо посылает обратно ответ, содержащий IP-адрес. Схематично это можно изобразить так: - -![dns-scheme](How_DNS_works-ru.png) - -То же самое относится, разумеется, и ко всем приложениям и программам, которые посылают веб-запросы. - -### Как работает DNS фильтрация? - -Обычно, ваш интернет-провайдер предоставляет DNS сервер, который и выполняет всю работу по возврату IP-адресов в ответ на запросы ваших приложений и браузеров. На самом деле, вы можете использовать любой DNS сервер для этой цели, их существует огромное множество (кстати, у AdGuard тоже есть собственные DNS серверы - вы можете прочитать об AdGuard DNS в [другой статье](https://kb.adguard.com/ru/dns/overview)). Некоторые из этих серверов могут выполнять дополнительную работу, например, блокировать рекламу. - -И более того, вам даже не нужен специальный DNS сервер, чтобы блокировать рекламу, если вы используете DNS фильтрацию. Как это возможно? Давайте посмотрим на эту диаграмму: - -![dns-filtering](How_DNS_Filtering_works-ru.png) - -Давайте представим, например, что у вас установлен AdGuard для Android. Если вы включите в нём DNS фильтрацию, все DNS запросы будут пропускаться через AdGuard перед тем, как попасть на DNS сервер. AdGuard имеет специальный "Упрощенный фильтр доменов", содержащий большое количество рекламных доменов и доменов счетчиков. Совместно с Пользовательским фильтром, он используется для блокировки "плохих" запросов. Каждый запрос проверяется на присутствие в этом списке, и в случае совпадения запрос, вместо отправки по назначению, направляется в "пустоту". При этом весь процесс происходит локально на вашем устройстве! - -Главное преимущество этого подхода в том, что он крайне экономичен в плане расхода батареи. Если домен был заблокирован, он больше не будет запрашиваться повторно в течение часа. Минус данного метода в его "грубости". С его помощью невозможно заблокировать конкретные страницы, только домены целиком. Иногда это может привести к "поломке" функционала того или иного сайта. - -### Что такое DNSCrypt и почему это важно? - -Если вы используете обычный протокол обмена взаимодействия клиент-сервер, ваши DNS запросы могут быть перехвачены, прочитаны и даже подменены. Эксперименты [показали](https://blog.adguard.com/dns-track-you/), что с помощью DNS-слежки можно получить "профиль интересов" любого пользователя. К счастью, AdGuard позволяет использовать [DNSCrypt](https://dnscrypt.info/) - специальный протокол, который шифрует общение с DNS сервером, тем самым предотвращая возможную слежку со стороны третьей стороны, в том числе вашего интернет-провайдера. - -![dnscrypt](DNSCrypt-ru.png) - -Мы настоятельно рекомендуем использовать DNSCrypt для защиты ваших персональных данных от прослушивания и перехвата третьими лицами. diff --git a/01.general/15.dns-filtering/docs.en.md b/01.general/15.dns-filtering/docs.en.md new file mode 100644 index 00000000..c2e336a5 --- /dev/null +++ b/01.general/15.dns-filtering/docs.en.md @@ -0,0 +1,80 @@ +--- +title: "DNS filtering" +taxonomy: + category: + - docs +published: true +visible: true +--- + +* [What is DNS?](#what-is-dns) +* [How does DNS filtering work?](#dns-filtering) + * [DNS servers](#dns-servers) + * [Local DNS blocklists](#dns-blocklists) +* [Comparing DNS filtering to network filtering](#compare) + +To better understand DNS filtering, first, we should answer the question "What is DNS"? + + +### What is DNS? + +DNS stands for "Domain name system", and its purpose is to translate websites' names into something browsers can understand, i.e. IP addresses. Thus, each time you go to a website, your browser sends a request to a special server (DNS server). That server looks at the requested domain name and replies with a corresponding IP address. Very schematically it can be represented like this: + + + +The same applies, of course, to all apps and programs that send any web requests, not just browsers. + + +### How does DNS filtering work? + +When you use one of the AdGuard apps that supports DNS filtering, it acts as a buffer between your device and the DNS server. All DNS requests that your browsers or apps are about to send first get processed by AdGuard. If you're using the default DNS server provided by your ISP, your DNS traffic is likely not encrypted and vulnerable to snooping and hijacking. AdGuard will encrypt all your DNS requests before they leave your device, so that no malefactor could get access to their contents. On top of that, AdGuard can identify requests to ad, tracking, and/or adult domains and redirect them to a "blackhole" instead of forwarding them to the DNS server. More on that [later](#dns-blocklists). + + + +DNS filtering is a powerful tool and it's supported by all major AdGuard apps: [AdGuard for Windows](https://adguard.com/en/adguard-windows/overview.html), [AdGuard for Mac](https://adguard.com/en/adguard-mac/overview.html), [AdGuard for Android](https://adguard.com/en/adguard-android/overview.html) and [AdGuard for iOS](https://adguard.com/en/adguard-ios/overview.html). + +DNS filtering can be broken down into two separate functions: to encrypt and reroute DNS traffic to DNS servers, and to block some domains locally by applying DNS blocklists. + + +#### DNS servers + +There are thousands of DNS servers to choose from, and they are all unique in their properties and purposes. Most simply return the IP address of the requested domain, but some have additional functions: they block ad, tracking, adult domains and so on. Nowadays all major DNS servers employ one or more reliable encryption protocols: DNS-over-HTTPS, DNS-over-TLS. AdGuard also provides a [DNS service](https://adguard.com/en/adguard-dns/overview.html), and it was the world's first to offer the very new and promising [DNS-over-QUIC](https://adguard.com/en/blog/dns-over-quic.html) encryption protocol. AdGuard has different servers for different goals. This diagram illustrates how AdGuard blocking servers work: + + + +Other DNS providers may work differently, so learn more about them before commiting to this or that DNS server. You can find the list of some of the most popular DNS providers in [this article](https://kb.adguard.com/en/general/dns-providers). All AdGuard apps that support DNS functionality also have a list of DNS servers to choose from, or even allow to select any custom DNS server that you'd like. + + +#### Local DNS blocklists + +But by relying on DNS servers only to filter your DNS traffic you lose all flexibility. If the selected server blocks a domain, you can't access it. With AdGuard, you don't even need to configure any specific DNS server to filter DNS traffic. All AdGuard products let you employ DNS blocklists, be it simple hosts files or lists that use [more advanced syntax](https://kb.adguard.com/en/general/dns-filtering-syntax). They work similarly to regular blocklists: when a DNS request matches one of the rules in the active filter list, it gets blocked. To be more precise, it gets rerouted to a "blackhole". + +>In AdGuard for iOS, first you have to enable "Advanced mode" in settings in order to get access to DNS blocking. + +You can add as many custom blocklists as you wish. For instance, you can use [AdGuard DNS filter](https://github.com/AdguardTeam/AdGuardSDNSFilter). It quite literally blocks everything that AdGuard DNS server does, but in this case you are free to use any other DNS server. Plus, this way you can add more filters or create custom exception rules, all of which would be impossible with a simple "use a blocking DNS server" setup. + +>There are hundreds of different DNS blocklists, you can look for them [here](https://filterlists.com/). + + +### Comparing DNS filtering to network filtering + +Network filtering is what we call the 'regular' way AdGuard standalone apps process network traffic, hence the name. Feel free to brush up on it by reading [this article](https://kb.adguard.com/en/general/how-ad-blocking-works). + +First of all, we have to mention that with AdGuard you don't have to choose. You can always use both regular network filtering and DNS filtering at the same time. However, it's important to understand key differencies between the two. DNS filtering has both its unique advantages and drawbacks: + +**Pros of DNS filtering:** + +1. On some platforms this is the only way to achieve system-wide filtering. For example, on iOS only the Safari browser supports content blocking in the familiar sense, for everything else there's only DNS filtering. +2. Some forms of tracking (like [CNAME-cloaked tracking](https://adguard.com/en/blog/cname-tracking.html)) can only be dealt with by DNS filtering. +3. The stage of processing a DNS request is the earliest you could possibly deal with an ad or a tracker, this helps save a little bit of battery life and traffic. + +**Cons of DNS filtering:** + +1. DNS filtering is "rough", meaning that it won't remove whitespaces that are left behind a blocked ad, or apply any sorts of cosmetic filtering. Many of the more complicated ads can't be blocked on DNS level (or rather, they can, but only by blocking the entire domains which are being used for other purposes). + + +

An example of difference between DNS and network filtering

+ +2. It's not possible to know the origin of a DNS request, which means you can't distinguish between different apps on the DNS level. This harms the statistics and makes it impossible to create app-specific filtering rules. + +We recommend to use DNS filtering in addition to network filtering, not instead of it, whenever possible. diff --git a/01.general/15.dns-filtering/docs.ru.md b/01.general/15.dns-filtering/docs.ru.md new file mode 100644 index 00000000..80093e3d --- /dev/null +++ b/01.general/15.dns-filtering/docs.ru.md @@ -0,0 +1,80 @@ +--- +title: 'DNS-фильтрация' +taxonomy: + category: + - docs +published: true +visible: true +--- + +* [Что такое DNS?](#what-is-dns) +* [Как работает DNS-фильтрация?](#dns-filtering) + * [DNS-серверы](#dns-servers) + * [Локальные DNS-фильтры](#dns-blocklists) +* [Сравнение DNS-фильтрации с сетевой фильтрацией](#compare) + +Чтобы лучше понимать DNS-фильтрацию, надо сначала ответить на вопрос "Что такое DNS"? + + +### Что такое DNS? + +DNS расшифровывается как "Domain name system", или "Система доменных имён". Её цель — переводить имена доменов, понятные человеку, в нечто, что понятно браузерам, т.е. в IP-адреса. Таким образом, каждый раз, когда вы переходите на сайт, ваш браузер посылает запрос на специальный сервер (DNS-сервер). Этот сервер смотрит на имя запрашиваемого домена и отвечает соответствующим IP-адресом. Очень схематично это выглядит так: + + + +Всё то же самое применимо, разумеется, и к приложениям и программам, которые посылают какие-либо веб-запросы, а не только к браузерам. + + +### Как работает DNS-фильтрация? + +Когда вы используете одно из приложений AdGuard, поддерживающее DNS-фильтрацию, оно работает как буфер между вашим устройством и DNS-сервером. Все DNS-запросы, которые ваши браузеры и приложения собираются отправить, сначала обрабатываются AdGuard. Если вы используете DNS-сервер, предоставленный по умолчанию вашим интернет-провайдером, ваш DNS-трафик, скорее всего, не зашифрован и уязвим для подслушивания и перехвата. AdGuard зашифрует все ваши DNS-запросы до того, как они будут отправлены, так что никакие злоумышленники не смогут получить доступ к их содержимому. Кроме того, AdGuard может идентифицировать запросы по рекламным, трекинговым и взрослым сайтам и перенаправить их "в никуда" вместо того, чтобы переслать на DNS-сервер. Подробнее об этом [позднее](#dns-blocklists). + + + +DNS-фильтрация — это мощный инструмент, который поддерживается всеми основными приложениями AdGuard: [AdGuard для Windows](https://adguard.com/ru/adguard-windows/overview.html), [AdGuard для Mac](https://adguard.com/ru/adguard-mac/overview.html), [AdGuard для Android](https://adguard.com/ru/adguard-android/overview.html) и [AdGuard для iOS](https://adguard.com/ru/adguard-ios/overview.html). + +DNS-фильтрация может быть условно разделена на две основные функции: шифрование DNS-трафика и его перенаправление на DNS-сервер, а также блокировка определённых доменов с помощью локальных DNS-фильтров. + + +#### DNS-серверы + +В мире существуют тысячи DNS-серверов, и все они уникальны по своим свойствам и целям. Большинство просто возвращает IP-адрес запрошенного домена, но некоторые имеют дополнительные функции: они блокируют рекламные, трекинговые, взрослые домены и т.д. Сегодня все крупные DNS-провайдеры поддерживают различные протоколы для шифрования DNS-трафика: DNS-over-HTTPS, DNS-over TLS. AdGuard также предоставляет свой [DNS-сервис](https://adguard.com/ru/adguard-dns/overview.html), и он стал самым первым DNS-провайдером в мире, который добавил поддержку нового и многообещающего протокола шифрования [DNS-over-QUIC](https://adguard.com/ru/blog/dns-over-quic.html). AdGuard имеет несколько разных серверов для разных целей. Эта диаграмма иллюстрирует работу блокирующих серверов AdGuard DNS: + + + +Другие DNS-провайдеры могут работать иначе, так что узнайте все подробности перед тем, как делать выбор в пользу того или иного сервера. Вы можете найти список некоторых популярных DNS-провайдеров в [этой статье](https://kb.adguard.com/ru/general/dns-providers). Все приложения AdGuard, которые поддерживают DNS-функционал, также предоставляют на выбор список проверенных DNS-серверов и даже дают возможность вручную указать любой предпочитаемый вами DNS-сервер. + + +#### Локальные DNS-фильтры + +Но если полагаться только на DNS-серверы в вопросе фильтрации DNS-трафика, то неизбежны потери в гибкости. Если выбранный сервер блокирует какой-либо домен, вы не сможете на него перейти, пока не переключитесь на другой сервер. С AdGuard же вам даже не обязательно настраивать какой-то конкретный DNS-сервер, чтобы фильтровать DNS-трафик. Все продукты AdGuard позволяют добавлять локальные DNS-фильтры, будь то простые файлы hosts или фильтры, использующие более сложный [DNS-синтаксис](https://kb.adguard.com/ru/general/dns-filtering-syntax). Они работают сходным образом с обычными рекламными фильтрами: когда DNS-запрос подходит под одно из правил в активном фильтре, он блокируется. Чтобы быть более точным, перенаправляется "в никуда". + +>Чтобы получить доступ к DNS-фильтрации в AdGuard для iOS, вам сначала потребуется включить "Расширенный режим" в настройках. + +Вы можете добавлять столько собственных DNS-фильтров, сколько захотите. Например, вы можете задействовать [DNS-фильтр AdGuard](https://github.com/AdguardTeam/AdGuardSDNSFilter). Он буквально блокирует всё то же самое, что и сервер AdGuard DNS, но в данном случае вы вольны использовать любой другой DNS-сервер. Плюс, при использовании данного метода вы можете добавить больше фильтров или же создать собственные правила-исключения. Всё это было бы невозможно в случае с использованием только DNS-сервера. + +>Существуют сотни различных DNS-фильтров, вы можете выбрать нужные вам [здесь](https://filterlists.com/). + + +### Сравнение DNS-фильтрации с сетевой фильтрацией + +Мы называем сетевой фильтрацией "обычный" способ, которым самостоятельные приложения AdGuard (кроме браузерных расширений) фильтруют весь сетевой трафик, отсюда и название. Освежить знания о сетевой фильтрации можно, прочитав [эту статью](https://kb.adguard.com/ru/general/how-ad-blocking-works). + +Во-первых, мы сразу хотим оговориться, что с AdGuard вам не нужно выбирать между ними. Вы всегда можете использовать обычную сетевую фильтрацию и DNS-фильтрацию одновременно. Однако важно понимать разницу между этими двумя подходами. DNS-фильтрация обладает как своими уникальными преимуществами, так и недостатками. + +**Плюсы DNS-фильтрации:** + +1. На некоторых платформах это единственный способ фильтровать весь системный трафик. Например, на iOS только Safari поддерживает блокировку контента в привычном смысле. Фильтровать трафик всех остальных браузеров и приложений поможет только DNS-фильтрация. +2. С некоторыми формами слежки (такими как [CNAME-трекинг](https://adguard.com/ru/blog/cname-tracking.html)) может справиться только DNS-фильтрация. +3. Этап обработки DNS-запроса — самое раннее, когда можно заблокировать рекламу или трекер. Это помогает немного сэкономить время жизни батареи и трафик. + +**Недостатки DNS-фильтрации:** + +1. DNS-фильтрация — "грубый" метод. Это означает, что с её помощью не получится убрать, например, белые пустые блоки, остающиеся после заблокированной рекламы. Также не получится применить никакие косметические правила. Многие виды более сложной рекламы не могут быть заблокированы на уровне DNS (точнее, могут, но только ценой полной блокировки домена, который также используется для других, полезных целей). + + +

Пример разницы между DNS-фильтрацией и сетевой фильтрацией

+ +2. Невозможно определить источник DNS-запроса, то есть вы не сможете различать трафик разных приложений на DNS-уровне. Это помешает ведению подробной статистики и сделает невозможным создание правил, работающих только для конкретных приложений. + +Мы рекомендуем использовать DNS-фильтрацию вместе с сетевой фильтрацией, а не вместо неё, если это возможно. diff --git a/01.general/16.adguard-translations/docs.en.md b/01.general/16.adguard-translations/docs.en.md index 99a90f57..0b306e8a 100644 --- a/01.general/16.adguard-translations/docs.en.md +++ b/01.general/16.adguard-translations/docs.en.md @@ -12,7 +12,7 @@ visible: true * [Who are Proofreaders?](#proofreaders) * [Reward system](#rewards) ->**Disclaimer:** you can ask us any questions about translating AdGuard by sending an email to [translate@adguard.com](mailto:translate@adguard.com) or by joining our [Telegram chat](https://t.me/joinchat/CBcY6FgDNkjwGBAmxriwXg). +>**Disclaimer:** you can ask us any questions about translating AdGuard by sending an email to [translate@adguard.com](mailto:translate@adguard.com) or by joining our [Telegram chat](https://t.me/joinchat/UVYTLcHbr8JmOGIy). ### About AdGuard translation program diff --git a/01.general/17.dns-providers/docs.en.md b/01.general/17.dns-providers/docs.en.md index 4ead142f..92e17958 100644 --- a/01.general/17.dns-providers/docs.en.md +++ b/01.general/17.dns-providers/docs.en.md @@ -34,7 +34,7 @@ AdGuard users can configure any DNS server to be used instead of the system defa * [Ali DNS](#ali-dns) * [CFIEC Public DNS](#cfiec-dns) * [Nawala Childprotection DNS](#nawala-childprotection-dns) -* [DNSCEPAT.ID](#dnscepat.id) + * [360 Secure DNS](#360-dns) * [IIJ.JP DNS](#iij-dns) * [DNSPod](#dnspod-dns) @@ -62,9 +62,14 @@ AdGuard users can configure any DNS server to be used instead of the system defa * [DNS Privacy](#dnsprivacy.org-dns) * [PI-DNS](#pi-dns) * [Seby DNS](#seby-dns) -* [Evilvibes DNS](#evilvibes-dns) * [puntCAT DNS](#puntcat-dns) * [DNSlify DNS](#dnslify-dns) +* [NextDNS](#nextdns) +* [RethinkDNS](#rethinkdns) +* [ControlD DNS](#controld) +* [Mullvad](#mullvad) +* [Small personal resolvers](#small-resolvers) + * [Arapurayil](#arapurayil) @@ -106,10 +111,10 @@ These servers provide a secure and reliable connection, but they don't filter an |----------------|----------------------------------------------------|----------------| | DNS, IPv4 | `94.140.14.140` and `94.140.14.141` | Add to AdGuard | | DNS, IPv6 | `2a10:50c0::1:ff` and `2a10:50c0::2:ff` | Add to AdGuard | -| DNSCrypt, IPv4 | Provider: `2.dnscrypt.default.ns1.adguard.com` IP: `176.103.130.136:5443`| Add to AdGuard | +| DNSCrypt, IPv4 | Provider: `2.dnscrypt.unfiltered.ns1.adguard.com` IP: `94.140.14.140:5443`| Add to AdGuard | | DNSCrypt, IPv6 | Provider: `2.dnscrypt.default.ns2.adguard.com` IP: `[2a00:5a60::01:ff]:5443`| Add to AdGuard | | DNS-over-HTTPS | `https://dns-unfiltered.adguard.com/dns-query` | Add to AdGuard | -| DNS-over-TLS | `tls://dns-unfiltered.adguard.com` | Add to AdGuard | +| DNS-over-TLS | `tls://dns-unfiltered.adguard.com` | Add to AdGuard | @@ -162,7 +167,7 @@ Blocks access to all adult, pornographic and explicit sites, including proxy & V | DNSCrypt, IPv4 | Provider: `cleanbrowsing.org` IP: `185.228.168.168:8443`| Add to AdGuard | | DNSCrypt, IPv6 | Provider: `cleanbrowsing.org` IP: `[2a0d:2a00:1::]:8443`| Add to AdGuard | | DNS-over-HTTPS | `https://doh.cleanbrowsing.org/doh/family-filter/` | Add to AdGuard | -| DNS-over-TLS | `tls://family-filter-dns.cleanbrowsing.org` | Add to AdGuard | +| DNS-over-TLS | `tls://family-filter-dns.cleanbrowsing.org` | Add to AdGuard | #### Adult Filter @@ -172,10 +177,10 @@ Less restrictive than the Family filter, it only blocks access to adult content |----------------|----------------------------------------------------|----------------| | DNS, IPv4 | `185.228.168.10` and `185.228.169.11` | Add to AdGuard | | DNS, IPv6 | `2a0d:2a00:1::1` and `2a0d:2a00:2::1` | Add to AdGuard | -| DNSCrypt, IPv4 | Provider: `cleanbrowsing.org` IP: `185.228.168.10:8443`| Add to AdGuard | +| DNSCrypt, IPv4 | Provider: `cleanbrowsing.org` IP: `185.228.168.10:8443`| Add to AdGuard | | DNSCrypt, IPv6 | Provider: `cleanbrowsing.org` IP: `[2a0d:2a00:1::1]:8443`| Add to AdGuard | | DNS-over-HTTPS | `https://doh.cleanbrowsing.org/doh/adult-filter/` | Add to AdGuard | -| DNS-over-TLS | `tls://adult-filter-dns.cleanbrowsing.org` | Add to AdGuard | +| DNS-over-TLS | `tls://adult-filter-dns.cleanbrowsing.org` | Add to AdGuard | #### Security Filter @@ -186,7 +191,7 @@ Blocks phishing, spam and malicious domains | DNS, IPv4 | `185.228.168.9` and `185.228.169.9` | Add to AdGuard | | DNS, IPv6 | `2a0d:2a00:1::2` and `2a0d:2a00:2::2` | Add to AdGuard | | DNS-over-HTTPS | `https://doh.cleanbrowsing.org/doh/security-filter/` | Add to AdGuard | -| DNS-over-TLS | `tls://security-filter-dns.cleanbrowsing.org` | Add to AdGuard | +| DNS-over-TLS | `tls://security-filter-dns.cleanbrowsing.org` | Add to AdGuard | @@ -201,9 +206,9 @@ Blocks phishing, spam and malicious domains -### Neustar UltraDNS +### Neustar Recursive DNS -[Neustar UltraDNS](https://www.security.neustar/digital-performance/dns-services/recursive-dns) is a free cloud-based recursive DNS service that delivers fast and reliable access to sites and online applications with built-in security and threat intelligence. +[Neustar Recursive DNS](https://www.security.neustar/digital-performance/dns-services/recursive-dns) is a free cloud-based recursive DNS service that delivers fast and reliable access to sites and online applications with built-in security and threat intelligence. #### Reliability & Performance 1 @@ -314,6 +319,7 @@ OpenDNS servers that provide adult content blocking | DNS, IPv4 | `1.1.1.2` and `1.0.0.2` | Add to AdGuard | | DNS, IPv6 | `2606:4700:4700::1112` and `2606:4700:4700::1002` | Add to AdGuard | | DNS-over-HTTPS| `https://security.cloudflare-dns.com/dns-query` | Add to AdGuard | +| DNS-over-TLS | `tls://security.cloudflare-dns.com` | Add to AdGuard | #### Malware and adult content blocking @@ -322,6 +328,7 @@ OpenDNS servers that provide adult content blocking | DNS, IPv4 | `1.1.1.3` and `1.0.0.3` | Add to AdGuard | | DNS, IPv6 | `2606:4700:4700::1113` and `2606:4700:4700::1003` | Add to AdGuard | | DNS-over-HTTPS, IPv4 | `https://family.cloudflare-dns.com/dns-query` | Add to AdGuard | +| DNS-over-TLS | `tls://family.cloudflare-dns.com` | Add to AdGuard | @@ -340,20 +347,7 @@ Regular DNS servers which provide protection from phishing and spyware. It inclu | DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.quad9.net` IP: `9.9.9.9:8443`| Add to AdGuard | | DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.quad9.net` IP: `[2620:fe::fe]:8443` | Add to AdGuard | | DNS-over-HTTPS | `https://dns.quad9.net/dns-query` | Add to AdGuard | -| DNS-over-TLS | `tls://dns.quad9.net` | Add to AdGuard | - -#### Standard 2 - -Regular DNS servers which provide protection from phishing and spyware. It include blocklist, DNSSEC validation. - -| Protocol | Address | | -|----------------|----------------------------------------------------|----------------| -| DNS, IPv4 | `9.9.9.9` and `149.112.112.9` | Add to AdGuard | -| DNS, IPv6 | `2620:fe::9` IP: `2620:fe::fe:9` | Add to AdGuard | -| DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.quad9.net` IP: `149.112.112.9:8443` | Add to AdGuard | -| DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.quad9.net` IP: `[2620:fe::9]:8443` | Add to AdGuard | -| DNS-over-HTTPS | `https://dns9.quad9.net/dns-query` | Add to AdGuard | -| DNS-over-TLS | `tls://149.112.112.9` | Add to AdGuard | +| DNS-over-TLS | `tls://dns.quad9.net` | Add to AdGuard | #### Unsecured @@ -366,11 +360,11 @@ Unsecured DNS servers provide no security blocklist, no DNSSEC, No EDNS client-S | DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.quad9.net` IP: `9.9.9.10:8443` | Add to AdGuard | | DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.quad9.net` IP: `[2620:fe::fe:10]:8443` | Add to AdGuard | | DNS-over-HTTPS | `https://dns10.quad9.net/dns-query` | Add to AdGuard | -| DNS-over-TLS | `tls://dns10.quad9.net` | Add to AdGuard | +| DNS-over-TLS | `tls://dns10.quad9.net` | Add to AdGuard | #### [ECS](https://en.wikipedia.org/wiki/EDNS_Client_Subnet) support -EDNS Client-Subnet is a method that includes components of end-user IP address data in requests that are sent to authoritative DNS servers. It provide security blocklist, DNSSEC, EDNS Client-Subnet. +EDNS Client-Subnet is a method that includes components of end-user IP address data in requests that are sent to authoritative DNS servers. It provides security blocklist, DNSSEC, EDNS Client-Subnet. | Protocol | Address | | |----------------|----------------------------------------------------|----------------| @@ -379,7 +373,7 @@ EDNS Client-Subnet is a method that includes components of end-user IP address d | DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.quad9.net` IP: `9.9.9.11:8443` | Add to AdGuard | | DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.quad9.net` IP: `[2620:fe::11]:8443` | Add to AdGuard | | DNS-over-HTTPS | `https://dns11.quad9.net/dns-query` | Add to AdGuard | -| DNS-over-TLS | `tls://dns11.quad9.net` | Add to AdGuard | +| DNS-over-TLS | `tls://dns11.quad9.net` | Add to AdGuard | @@ -403,7 +397,7 @@ EDNS Client-Subnet is a method that includes components of end-user IP address d | DNS, IPv4 | Provider: `dns.switch.ch` IP: `130.59.31.248` | Add to AdGuard | | DNS, IPv6 | Provider: `dns.switch.ch` IPv6: `2001:620:0:ff::2`| Add to AdGuard | | DNS-over-HTTPS | `https://dns.switch.ch/dns-query` | Add to AdGuard | -| DNS-over-TLS | Hostname: `dns.switch.ch` IP: `130.59.31.248` and IPv6: `2001:620:0:ff::2` | Add to AdGuard | +| DNS-over-TLS | Hostname: `tls://dns.switch.ch` IP: `130.59.31.248` and IPv6: `2001:620:0:ff::2` | Add to AdGuard | @@ -451,7 +445,7 @@ EDNS Client-Subnet is a method that includes components of end-user IP address d | DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.dns.comss.one` IP: `94.176.233.93:443` | Add to AdGuard | | DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.dns.comss.one` IP: `[2a02:7b40:5eb0:e95d::1]:443` | Add to AdGuard | | DNS-over-HTTPS | `https://dns.comss.one/dns-query` | Add to AdGuard | -| DNS-over-TLS | `tls://dns.comss.one` | Add to AdGuard | +| DNS-over-TLS | `tls://dns.comss.one` | Add to AdGuard | #### East DNS Server (Siberia and Far East) @@ -460,7 +454,7 @@ EDNS Client-Subnet is a method that includes components of end-user IP address d | DNS, IPv4 | `92.223.109.31` and `91.230.211.67` | Add to AdGuard | | DNS, IPv6 | `2a03:90c0:b5::1a` and `2a04:2fc0:39::47` | Add to AdGuard | | DNS-over-HTTPS | `https://dns.east.comss.one/dns-query` | Add to AdGuard | -| DNS-over-TLS | `tls://dns.east.comss.one` | Add to AdGuard | +| DNS-over-TLS | `tls://dns.east.comss.one` | Add to AdGuard | @@ -476,7 +470,7 @@ EDNS Client-Subnet is a method that includes components of end-user IP address d ### CIRA Canadian Shield DNS -[CIRA Shield DNS](https://www.cira.ca/cybersecurity-services/canadianshield/how-works) protect against theft of personal and financial data. Keep viruses, ransomware, and other malware out of your home. +[CIRA Shield DNS](https://www.cira.ca/cybersecurity-services/canadianshield/how-works) protects against theft of personal and financial data. Keep viruses, ransomware, and other malware out of your home. #### Private @@ -487,7 +481,7 @@ In "Private" mode, DNS resolution only | DNS, IPv4 | `149.112.121.10` and `149.112.122.10` | Add to AdGuard | | DNS, IPv6 | `2620:10A:80BB::10` and `2620:10A:80BC::10` | Add to AdGuard | | DNS-over-HTTPS | `https://private.canadianshield.cira.ca/dns-query` | Add to AdGuard | -| DNS-over-TLS - Private | Hostname: `private.canadianshield.cira.ca` IP: `149.112.121.10` and IPv6: `2620:10A:80BB::10` | Add to AdGuard | +| DNS-over-TLS - Private | Hostname: `tls://private.canadianshield.cira.ca` IP: `149.112.121.10` and IPv6: `2620:10A:80BB::10` | Add to AdGuard | #### Protected @@ -498,7 +492,7 @@ In "Protected" mode, malware and phishing protection | DNS, IPv4 | `149.112.121.20` and `149.112.122.20` | Add to AdGuard | | DNS, IPv6 | `2620:10A:80BB::20` and `2620:10A:80BC::20` | Add to AdGuard| | DNS-over-HTTPS | `https://protected.canadianshield.cira.ca/dns-query` | Add to AdGuard | -| DNS-over-TLS - Protected | Hostname: `protected.canadianshield.cira.ca` IP: `149.112.121.20` and IPv6: `2620:10A:80BB::20` | Add to AdGuard | +| DNS-over-TLS - Protected | Hostname: `tls://protected.canadianshield.cira.ca` IP: `149.112.121.20` and IPv6: `2620:10A:80BB::20` | Add to AdGuard | #### Family @@ -509,7 +503,7 @@ In "Family" mode, Protected + blocking adult content | DNS, IPv4 | `149.112.121.30` and `149.112.122.30` | Add to AdGuard| | DNS, IPv6 | `2620:10A:80BB::30` and `2620:10A:80BC::30` | Add to AdGuard| | DNS-over-HTTPS | `https://family.canadianshield.cira.ca/dns-query` | Add to AdGuard | -| DNS-over-TLS - Family | Hostname: `protected.canadianshield.cira.ca` IP: `149.112.121.30` and IPv6: `2620:10A:80BB::30` | Add to AdGuard | +| DNS-over-TLS - Family | Hostname: `tls://protected.canadianshield.cira.ca` IP: `149.112.121.30` and IPv6: `2620:10A:80BB::30` | Add to AdGuard | @@ -534,23 +528,23 @@ In "Family" mode, Protected + blocking adult content |----------------|-------------------------------------|----------------| | DNS-over-TLS, IPv4 | Hostname: `tls://dot-fi.blahdns.com` IP: `95.216.212.177` | Add to AdGuard | | DNS-over-HTTPS, IPv4 | Hostname: `https://doh-fi.blahdns.com/dns-query` IP: `95.216.212.177` | Add to AdGuard | -| DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.blahdns.com` IP: `95.216.212.177:8443`| Add to AdGuard | -| DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.blahdns.com` IP: `2a01:4f9:c010:43ce::1:8443`| Add to AdGuard | +| DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.blahdns.com` IP: `95.216.212.177:8443`| Add to AdGuard | +| DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.blahdns.com` IP: `2a01:4f9:c010:43ce::1:8443`| Add to AdGuard | #### Japan DNS Server | Protocol | Address | | |----------------|-------------------------------------|----------------| -| DNS-over-TLS, IPv4 | Hostname: `tls://dot-jp.blahdns.com` IP: `45.32.55.94` | Add to AdGuard | -| DNS-over-HTTPS, IPv4 | Hostname: `https://doh-jp.blahdns.com/dns-query` IP: `45.32.55.94` | Add to AdGuard | -| DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.blahdns.com` IP: `45.32.55.94:8443`| Add to AdGuard | -| DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.blahdns.com` IP: `2001:19f0:7001:3259:5400:02ff:fe71:0bc9:8443`| Add to AdGuard | +| DNS-over-TLS, IPv4 | Hostname: `tls://dot-jp.blahdns.com` IP: `139.162.112.47` | Add to AdGuard | +| DNS-over-HTTPS, IPv4 | Hostname: `https://doh-jp.blahdns.com/dns-query` | Add to AdGuard | +| DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.blahdns.com` IP: `139.162.112.47:8443`| Add to AdGuard | +| DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.blahdns.com` IP: `[2400:8902::f03c:92ff:fe27:344b]:8443`| Add to AdGuard | #### Germany DNS Server | Protocol | Address | | |----------------|-------------------------------------|----------------| -| DNS-over-TLS, IPv4 | Hostname: `dot-de.blahdns.com` IP: `159.69.198.101` | Add to AdGuard | +| DNS-over-TLS, IPv4 | Hostname: `tls://dot-de.blahdns.com` IP: `159.69.198.101` | Add to AdGuard | | DNS-over-HTTPS, IPv4 | Hostname: `https://doh-de.blahdns.com/dns-query` IP: `159.69.198.101` | Add to AdGuard | | DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.blahdns.com` IP: `159.69.198.101:8443` | Add to AdGuard | | DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.blahdns.com` IP: `2a01:4f8:1c1c:6b4b::1:8443`| Add to AdGuard | @@ -564,19 +558,19 @@ In "Family" mode, Protected + blocking adult content | Protocol | Address | | |----------------|----------------------------------------------------|----------------| | DNS-over-HTTPS | `https://fi.doh.dns.snopyta.org/dns-query` IP: `95.216.24.230` and IPv6: `2a01:4f9:2a:1919::9301` | Add to AdGuard | -| DNS-over-TLS | `tls://fi.dot.dns.snopyta.org` IP: `95.216.24.230` and IPv6: `2a01:4f9:2a:1919::9301` | Add to AdGuard | +| DNS-over-TLS | `tls://fi.dot.dns.snopyta.org` IP: `95.216.24.230` and IPv6: `2a01:4f9:2a:1919::9301` | Add to AdGuard | ### DNS for Family -[DNS for Family](https://dnsforfamily.com/) aims to block websites which are considered as adult related. It helps to children and everyone for safely surf internet without worrying about get followed to harmful websites.. +[DNS for Family](https://dnsforfamily.com/) aims to block websites which are considered as adult related. It helps to children and everyone for safely surf internet without worrying about get followed to harmful websites. | Protocol | Address | | |----------------|----------------------------------------------------|----------------| | DNS-over-HTTPS | `https://dns-doh.dnsforfamily.com/dns-query` | Add to AdGuard | -| DNS-over-TLS | `dns-dot.dnsforfamily.com` | Add to AdGuard | +| DNS-over-TLS | `tls://dns-dot.dnsforfamily.com` | Add to AdGuard | | DNS, IPv4 | `94.130.180.225` and `78.47.64.161` | Add to AdGuard | | DNS, IPv6 | `2a01:4f8:1c0c:40db::1` and `2a01:4f8:1c17:4df8::1` | Add to AdGuard | | DNSCrypt, IPv4 | Provider: `dnsforfamily.com` IP: `94.130.180.225`| Add to AdGuard | @@ -593,7 +587,7 @@ In "Family" mode, Protected + blocking adult content | DNS, IPv4 | `193.17.47.1` and `185.43.135.1` | Add to AdGuard | | DNS, IPv6 | `2001:148f:ffff::1` and `2001:148f:fffe::1` | Add to AdGuard | | DNS-over-HTTPS | `https://odvr.nic.cz/doh` | Add to AdGuard | -| DNS-over-TLS | `tls://odvr.nic.cz` | Add to AdGuard | +| DNS-over-TLS | `tls://odvr.nic.cz` | Add to AdGuard | @@ -606,7 +600,7 @@ In "Family" mode, Protected + blocking adult content | DNS, IPv4 | `223.5.5.5` and `223.6.6.6` | Add to AdGuard | | DNS, IPv6 | `2400:3200::1` and `2400:3200:baba::1` | Add to AdGuard | | DNS-over-HTTPS | `https://dns.alidns.com/dns-query` | Add to AdGuard | -| DNS-over-TLS | `tls://dns.alidns.com` | Add to AdGuard | +| DNS-over-TLS | `tls://dns.alidns.com` | Add to AdGuard | @@ -667,7 +661,7 @@ IPv6-based anycast DNS service with strong security capabilities and protection | DNS, IPv4 | `101.226.4.6` and `218.30.118.6` | Add to AdGuard | | DNS, IPv4 | `123.125.81.6` and `140.207.198.6` | Add to AdGuard | | DNS-over-HTTPS | `https://doh.360.cn/dns-query` | Add to AdGuard | -| DNS-over-TLS | `tls://dot.360.cn` | Add to AdGuard | +| DNS-over-TLS | `tls://dot.360.cn` | Add to AdGuard | @@ -678,7 +672,7 @@ IPv6-based anycast DNS service with strong security capabilities and protection | Protocol | Address | | |----------------|----------------------------------------------------|----------------| | DNS-over-HTTPS | `https://public.dns.iij.jp/dns-query` | Add to AdGuard | -| DNS-over-TLS | `tls://public.dns.iij.jp` | Add to AdGuard | +| DNS-over-TLS | `tls://public.dns.iij.jp` | Add to AdGuard | @@ -691,7 +685,7 @@ IPv6-based anycast DNS service with strong security capabilities and protection | DNS, IPv4 | `119.29.29.29` and `119.28.28.28` | Add to AdGuard | | DNS-over-HTTPS | `https://doh.pub/dns-query` | Add to AdGuard | | DNS-over-HTTPS | `https://dns.pub/dns-query` | Add to AdGuard | -| DNS-over-TLS | `dot.pub` | Add to AdGuard | +| DNS-over-TLS | `tls://dot.pub` | Add to AdGuard | @@ -770,6 +764,7 @@ These servers block adult websites and inappropriate contents. | DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.dns.tiar.app` IP: `[2400:6180:0:d0::5f6e:4001]`| Add to AdGuard | | DNS-over-HTTPS | `https://doh.tiarap.org/dns-query` (cached via third-party) | Add to AdGuard | | DNS-over-HTTPS | `https://doh.tiar.app/dns-query` | Add to AdGuard | +| DNS-over-Quic | `quic://doh.tiar.app` | Add to Adguard | | DNS-over-TLS | `tls://dot.tiar.app` | Add to AdGuard | #### Japan DNS Server @@ -779,7 +774,7 @@ These servers block adult websites and inappropriate contents. | DNS, IPv4 | `172.104.93.80` | Add to AdGuard | | DNS, IPv6 | `2400:8902::f03c:91ff:feda:c514` | Add to AdGuard | | DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.jp.tiar.app` IP: `172.104.93.80`| Add to AdGuard | -| DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.jp.tiar.app` IP: `[2400:8902::f03c:91ff:feda:c514]`| Add to AdGuard | +| DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.jp.tiar.app` IP: `[2400:8902::f03c:91ff:feda:c514]:1443`| Add to AdGuard | | DNS-over-HTTPS | `https://jp.tiarap.org/dns-query` | Add to AdGuard | | DNS-over-HTTPS | `https://jp.tiar.app/dns-query` | Add to AdGuard | | DNS-over-TLS | `tls://jp.tiar.app` | Add to AdGuard | @@ -945,7 +940,7 @@ These servers provide no blocking ads, keeps no logs and DNSSEC enabled | Protocol | Address | | |----------------|----------------------------------------------------|----------------| | DNS-over-HTTPS | `https://kaitain.restena.lu/dns-query` IP: `158.64.1.29` and IPv6: `2001:a18:1::29` | Add to AdGuard | -| DNS-over-TLS| `kaitain.restena.lu` IP: `158.64.1.29` and IPv6: `2001:a18:1::29` | Add to AdGuard | +| DNS-over-TLS| `tls://kaitain.restena.lu` IP: `158.64.1.29` and IPv6: `2001:a18:1::29` | Add to AdGuard | @@ -966,8 +961,10 @@ These servers provide no blocking ads, keeps no logs and DNSSEC enabled | Protocol | Address | | |----------------|----------------------------------------------------|----------------| -| DNS-over-TLS, IPv4 | Hostname: `dot.ffmuc.net` IP: `195.30.94.28` | Add to AdGuard | -| DNS-over-HTTPS, IPv4 | Hostname: `https://doh.ffmuc.net/dns-query` IP: `195.30.94.28` | Add to AdGuard | +| DNS-over-TLS, IPv4 | Hostname: `tls://dot.ffmuc.net` | Add to AdGuard | +| DNS-over-HTTPS, IPv4 | Hostname: `https://doh.ffmuc.net/dns-query` | Add to AdGuard | +| DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.ffmuc.net` IP: `5.1.66.255:8443` | Add to AdGuard | +| DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.ffmuc.net` IP: `[2001:678:e68:f000::]:8443` | Add to AdGuard | @@ -1001,7 +998,7 @@ These servers provide no blocking ads, keeps no logs and DNSSEC enabled | Protocol | Address | | |----------------|----------------------------------------------------|----------------| -| DNS-over-TLS, IPv4 | Hostname: `ibksturm.synology.me` IP: `83.77.85.7` | Add to AdGuard | +| DNS-over-TLS, IPv4 | Hostname: `tls://ibksturm.synology.me` IP: `83.77.85.7` | Add to AdGuard | | DNS-over-HTTPS, IPv4 | Hostname: `https://ibksturm.synology.me/dns-query` IP: `178.82.102.190` | Add to AdGuard | | DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.ibksturm` IP: `83.77.85.7:8443` | Add to AdGuard | | DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.ibksturm` IP: `[2a02:1205:5055:de60:b26e:bfff:fe1d:e19b]:8443` | Add to AdGuard | @@ -1016,25 +1013,25 @@ DNS servers run by the [Stubby developers](https://getdnsapi.net/) | Protocol | Address | | |----------------|----------------------------------------------------|----------------| -| DNS-over-TLS | Hostname: `getdnsapi.net` IP: `185.49.141.37` and IPv6: `2a04:b900:0:100::37` | Add to AdGuard | -| DNS-over-TLS | Provider: `Surfnet` Hostname `dnsovertls.sinodun.com` IP: `145.100.185.15` and IPv6: `2001:610:1:40ba:145:100:185:15` | Add to AdGuard | -| DNS-over-TLS | Provider: `Surfnet` Hostname `dnsovertls1.sinodun.com` IP: `145.100.185.16` and IPv6: `2001:610:1:40ba:145:100:185:16` | Add to AdGuard | +| DNS-over-TLS | Hostname: `tls://getdnsapi.net` IP: `185.49.141.37` and IPv6: `2a04:b900:0:100::37` | Add to AdGuard | +| DNS-over-TLS | Provider: `Surfnet` Hostname `tls://dnsovertls.sinodun.com` IP: `145.100.185.15` and IPv6: `2001:610:1:40ba:145:100:185:15` | Add to AdGuard | +| DNS-over-TLS | Provider: `Surfnet` Hostname `tls://dnsovertls1.sinodun.com` IP: `145.100.185.16` and IPv6: `2001:610:1:40ba:145:100:185:16` | Add to AdGuard | Other DNS servers with 'no logging' policy | Protocol | Address | | |----------------|----------------------------------------------------|----------------| -| DNS-over-TLS | Provider: `UncensoredDNS` Hostname `unicast.censurfridns.dk` IP: `89.233.43.71 ` and IPv6: `2a01:3a0:53:53::0` | Add to AdGuard | -| DNS-over-TLS | Provider: `UncensoredDNS` Hostname `anycast.censurfridns.dk` IP: `91.239.100.100` and IPv6: `2001:67c:28a4::` | Add to AdGuard | -| DNS-over-TLS | Provider: `dkg` Hostname `dns.cmrg.net` IP: `199.58.81.218`and IPv6: `2001:470:1c:76d::53` | Add to AdGuard | -| DNS-over-TLS, IPv4 | Hostname: `dns.larsdebruin.net` IP: `51.15.70.167` | Add to AdGuard | -| DNS-over-TLS | Hostname `dns-tls.bitwiseshift.net` IP: `81.187.221.24` and IPv6: `2001:8b0:24:24::24` | Add to AdGuard | -| DNS-over-TLS | Hostname `ns1.dnsprivacy.at` IP: `94.130.110.185` and IPv6: `2a01:4f8:c0c:3c03::2` | Add to AdGuard | -| DNS-over-TLS | Hostname `ns2.dnsprivacy.at` IP: `94.130.110.178` and IPv6: `2a01:4f8:c0c:3bfc::2` | Add to AdGuard | -| DNS-over-TLS, IPv4 | Hostname: `dns.bitgeek.in ` IP: `139.59.51.46` | Add to AdGuard | -| DNS-over-TLS | Hostname `dns.neutopia.org` IP: `89.234.186.112` and IPv6: `2a00:5884:8209::2` | Add to AdGuard | +| DNS-over-TLS | Provider: `UncensoredDNS` Hostname `tls://unicast.censurfridns.dk` IP: `89.233.43.71 ` and IPv6: `2a01:3a0:53:53::0` | Add to AdGuard | +| DNS-over-TLS | Provider: `UncensoredDNS` Hostname `tls://anycast.censurfridns.dk` IP: `91.239.100.100` and IPv6: `2001:67c:28a4::` | Add to AdGuard | +| DNS-over-TLS | Provider: `dkg` Hostname `tls://dns.cmrg.net` IP: `199.58.81.218`and IPv6: `2001:470:1c:76d::53` | Add to AdGuard | +| DNS-over-TLS, IPv4 | Hostname: `tls://dns.larsdebruin.net` IP: `51.15.70.167` | Add to AdGuard | +| DNS-over-TLS | Hostname `tls://dns-tls.bitwiseshift.net` IP: `81.187.221.24` and IPv6: `2001:8b0:24:24::24` | Add to AdGuard | +| DNS-over-TLS | Hostname `tls://ns1.dnsprivacy.at` IP: `94.130.110.185` and IPv6: `2a01:4f8:c0c:3c03::2` | Add to AdGuard | +| DNS-over-TLS | Hostname `tls://ns2.dnsprivacy.at` IP: `94.130.110.178` and IPv6: `2a01:4f8:c0c:3bfc::2` | Add to AdGuard | +| DNS-over-TLS, IPv4 | Hostname: `tls://dns.bitgeek.in ` IP: `139.59.51.46` | Add to AdGuard | +| DNS-over-TLS | Hostname `tls://dns.neutopia.org` IP: `89.234.186.112` and IPv6: `2a00:5884:8209::2` | Add to AdGuard | | DNS-over-TLS | Provider: `Go6Lab` Hostname `tls://privacydns.go6lab.si` IPv6: `2001:67c:27e4::35` | Add to AdGuard | -| DNS-over-TLS | Hostname: `dot.securedns.eu` IP: `146.185.167.43` and IPv6: `2a03:b0c0:0:1010::e9a:3001` | Add to AdGuard | +| DNS-over-TLS | Hostname: `tls://dot.securedns.eu` IP: `146.185.167.43` and IPv6: `2a03:b0c0:0:1010::e9a:3001` | Add to AdGuard | DNS servers with minimal logging/limitations. These servers use some logging, self-signed certs or no support for strict mode. @@ -1110,7 +1107,7 @@ PI-DNS currently provide a DoH endpoint delivered through Cloudflare’s CDN. Th |----------------|-------------------------------------|----------------| | DNS-over-HTTPS | `https://doh.pi-dns.com/dns-query` | Add to AdGuard | -(Only this endpoint (doh.pi-dns.com) goes through Cloudflare). +*Only this endpoint (doh.pi-dns.com) goes through Cloudflare.* @@ -1135,16 +1132,6 @@ PI-DNS currently provide a DoH endpoint delivered through Cloudflare’s CDN. Th | DNS-over-HTTPS | `https://doh-2.seby.io/dns-query` | Add to AdGuard | | DNS-over-TLS | `tls://dot.seby.io` | Add to AdGuard | - - -### Evilvibes DNS - -[Evilvibes](https://github.com/evilvibes/dnscrypt_stamps) is a non-logging, uncensored DNS resolver provided by [evilvibes.com](evilvibes.com) - -| Protocol | Address | Location | | -|----------------|-------------------------------------|---------------|----------------| -| DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.evilvibes.com` IP: `104.36.148.2192` | `Vancouver, Canada` | Add to AdGuard | - ### puntCAT DNS @@ -1190,3 +1177,106 @@ Family mode provide family oriented filtering offering the protection of "Safe" |----------------|----------------------------------------------------|----------------| | DNS, IPv4 | `185.235.81.5` and `185.235.81.6` | Add to AdGuard | | DNS, IPv6 | `2a0d:4d00:81::5` and `2a0d:4d00:81::6` | Add to AdGuard | + + + +### NextDNS + +[NextDNS](https://nextdns.io/) provides publicly accessible unfiltered resolvers with no logging in addition to its freemium configurable filtering resolvers with optional logging. + +#### Unfiltered + +| Protocol | Address | | +|----------------|----------------------------------------------------|----------------| +|DNS-over-HTTPS|`dns.nextdns.io`|Add to AdGuard| +|DNS-over-TLS|`tls://dns.nextdns.io`|Add to AdGuard| + + + +### RethinkDNS + +[RethinkDNS](https://www.bravedns.com/configure) provides DNS-over-HTTPS service running as Cloudflare Worker with configurable blocklists. + +#### Unfiltered + +| Protocol | Address | | +|----------------|----------------------------------------------------|----------------| +|DNS-over-HTTPS|`https://basic.bravedns.com/`|Add to AdGuard| + + + +### ControlD DNS + +[ControlD](https://controld.com/) is a customizable DNS service that can be used to block unwanted categories of sites (like ads or porn), popular online services like Facebook or TikTok, or any domain of your choice. + +#### Unfiltered + +| Protocol | Address | | +|----------------|----------------------------------------------------|----------------| +| DNS, IPv4 | `76.76.2.0` | Add to AdGuard | +| DNS-over-HTTPS | `https://freedns.controld.com/p0` | Add to AdGuard | +| DNS-over-TLS | `tls://p0.freedns.controld.com` | Add to AdGuard | + +#### Block malware + +| Protocol | Address | | +|----------------|----------------------------------------------------|----------------| +| DNS, IPv4 | `76.76.2.1` | Add to AdGuard | +| DNS-over-HTTPS | `https://freedns.controld.com/p1` | Add to AdGuard | +| DNS-over-TLS | `tls://p1.freedns.controld.com` | Add to AdGuard | + +##### Block malware + ads + +| Protocol | Address | | +|----------------|----------------------------------------------------|----------------| +| DNS, IPv4 | `76.76.2.2` | Add to AdGuard | +| DNS-over-HTTPS | `https://freedns.controld.com/p2` | Add to AdGuard | +| DNS-over-TLS | `tls://p2.freedns.controld.com` | Add to AdGuard | + +##### Block malware + ads + social + +| Protocol | Address | | +|----------------|----------------------------------------------------|----------------| +| DNS, IPv4 | `76.76.2.3` | Add to AdGuard | +| DNS-over-HTTPS | `https://freedns.controld.com/p3` | Add to AdGuard | +| DNS-over-TLS | `tls://p3.freedns.controld.com` | Add to AdGuard | + + + +### Mullvad + +[Mullvad](https://mullvad.net/en/help/dns-over-https-and-dns-over-tls/) provides publicly accessible DNS with QNAME minimization, endpoints located in Australia, Germany, Singapore, Sweden, United Kingdom and United States (New York and Los Angeles). + +#### Non-filtering + +| Protocol | Address | | +|----------------|----------------------------------------------------|----------------| +| DNS-over-HTTPS | `https://doh.mullvad.net/dns-query` | Add to AdGuard | +| DNS-over-TLS | `tls://doh.mullvad.net` | Add to AdGuard | + +#### Ad blocking + +| Protocol | Address | | +|----------------|----------------------------------------------------|----------------| +| DNS-over-HTTPS | `https://adblock.doh.mullvad.net/dns-query` | Add to AdGuard | +| DNS-over-TLS | `tls://adblock.doh.mullvad.net` | Add to AdGuard | + + + + +### Small personal resolvers + +In this section we list small, mostly personal DNS resolvers. They often have only one or very few servers and worse uptime than 'big' providers. We won't be able to proper monitor their availability. **Use them at your own risk!** + + + +#### Arapurayil + +[Arapurayil](https://dns.arapurayil.com) is a personal DNS service hosted in Mumbai, India. + +Non-logging | Filters ads,trackers,phishing,etc | DNSSEC | QNAME Minimization | No EDNS Client-Subnet. + +| Protocol | Address | | +|----------------|------------------------------------------------------------------|------------------| +| DNSCrypt, IPv4 | Host: `2.dnscrypt-cert.dns.arapurayil.com` IP: `3.7.156.128:8443` | Add to AdGuard | +| DNS-over-HTTPS | Host: `https://dns.arapurayil.com/dns-query` | Add to AdGuard | diff --git a/01.general/17.dns-providers/docs.ru.md b/01.general/17.dns-providers/docs.ru.md index 6b3e9495..b686a183 100644 --- a/01.general/17.dns-providers/docs.ru.md +++ b/01.general/17.dns-providers/docs.ru.md @@ -35,9 +35,14 @@ visible: true * [ibksturm](#ibksturm-dns) * [switch.ch](#switch.ch-dns) * [DNS-over-TLS by dnsprivacy.org](#dnsprivacy.org-dns) -* [evilvibes.com](#evilvibes.com) * [cira.ca](#cira.ca-dns) * [ffmuc.net](#ffmuc.net) +* [NextDNS](#nextdns) +* [RethinkDNS](#rethinkdns) +* [ControlD DNS](#controld) +* [Mullvad](#mullvad) +* [Небольшие персональные резолверы](#small-resolvers) + * [Arapurayil](#arapurayil) @@ -130,7 +135,7 @@ visible: true | Протокол | Адрес | | |----------------|----------------------------------------------------|----------------| | DNS, IPv4 | `185.228.168.168` и `185.228.169.168 ` | Добавить в AdGuard| -| DNS, IPv6 | `2a0d:2a00:1::1` и `2a0d:2a00:2::1` | Добавить в AdGuard| +| DNS, IPv6 | `2a0d:2a00:1::` и `2a0d:2a00:2::` | Добавить в AdGuard| | DNSCrypt, IPv4 | Имя провайдера: `cleanbrowsing.org` IP: `185.228.168.168:8443`| Добавить в AdGuard | | DNSCrypt, IPv6 | Имя провайдера: `cleanbrowsing.org` IP: `[2a0d:2a00:1::]:8443`| Добавить в AdGuard | | DNS-over-HTTPS | `https://doh.cleanbrowsing.org/doh/family-filter/` | Добавить в AdGuard | @@ -141,11 +146,12 @@ visible: true | Протокол | Адрес | | |----------------|----------------------------------------------------|----------------| -| DNS, IPv4 | `185.228.168.10` и `185.228.169.10` | Добавить в AdGuard | -| DNS, IPv6 | `2a0d:2a00:1::` и `2a0d:2a00:2::` | Добавить в AdGuard | +| DNS, IPv4 | `185.228.168.10` и `185.228.169.10` | Добавить в AdGuard | +| DNS, IPv6 | `2a0d:2a00:1::1` и `2a0d:2a00:2::2` | Добавить в AdGuard | | DNSCrypt, IPv4 | Имя провайдера: `cleanbrowsing.org` IP: `185.228.168.10:8443`| Добавить в AdGuard | | DNSCrypt, IPv6 | Имя провайдера: `cleanbrowsing.org` IP: `[2a0d:2a00:1::1]:8443`| Добавить в AdGuard | | DNS-over-HTTPS | `https://doh.cleanbrowsing.org/doh/adult-filter/` | Добавить в AdGuard | +| DNS-over-TLS | `tls://adult-filter-dns.cleanbrowsing.org` | Добавить в AdGuard | #### Безопасный фильтр @@ -156,6 +162,7 @@ visible: true | DNS, IPv4 | `185.228.168.9` и `185.228.169.9` | Добавить в AdGuard | | DNS, IPv6 | `2a0d:2a00:1::2` и `2a0d:2a00:2::2` | Добавить в AdGuard | | DNS-over-HTTPS | `https://doh.cleanbrowsing.org/doh/security-filter/` | Добавить в AdGuard | +| DNS-over-TLS | `tls://security-filter-dns.cleanbrowsing.org` | Добавить в AdGuard | @@ -224,6 +231,7 @@ DNS-серверы с фильтрацией, защищающей ваше ус | DNS, IPv6 | `2620:119:35::35` и `2620:119:53::53` | Добавить в AdGuard | | DNSCrypt, IPv4 | Имя провайдера: `2.dnscrypt-cert.opendns.com` IP: `208.67.220.220`| Добавить в AdGuard | | DNSCrypt, IPv6 | Имя провайдера: `2.dnscrypt-cert.opendns.com` IP: `[2620:0:ccc::2]`| Добавить в AdGuard | +| DNS-over-HTTPS | `https://doh.opendns.com/dns-query` | Добавить в AdGuard | #### FamilyShield @@ -233,6 +241,7 @@ OpenDNS серверы с функцией блокировки контента |----------------|----------------------------------------------------|----------------| | DNS, IPv4 | `208.67.222.123` и `208.67.220.123` | Добавить в AdGuard | | DNSCrypt, IPv4 | Имя провайдера: `2.dnscrypt-cert.opendns.com` IP: `208.67.220.123`| Добавить в AdGuard | +| DNS-over-HTTPS | `https://doh.familyshield.opendns.com/dns-query` | Добавить в AdGuard | @@ -270,6 +279,7 @@ OpenDNS серверы с функцией блокировки контента | DNS, IPv4 | `1.1.1.2` and `1.0.0.2` | Добавить в AdGuard | | DNS, IPv6 | `2606:4700:4700::1112` and `2606:4700:4700::1002` | Добавить в AdGuard | | DNS-over-HTTPS| `https://security.cloudflare-dns.com/dns-query` | Добавить в AdGuard | +| DNS-over-TLS | `tls://security.cloudflare-dns.com` | Добавить в AdGuard | #### Блокировка вредоносных и "взрослых" доменов @@ -278,6 +288,7 @@ OpenDNS серверы с функцией блокировки контента | DNS, IPv4 | `1.1.1.3` and `1.0.0.3` | Добавить в AdGuard | | DNS, IPv6 | `2606:4700:4700::1113` and `2606:4700:4700::1003` | Добавить в AdGuard | | DNS-over-HTTPS, IPv4 | `https://family.cloudflare-dns.com/dns-query` | Добавить в AdGuard | +| DNS-over-TLS | `tls://family.cloudflare-dns.com` | Добавить в AdGuard | @@ -292,33 +303,37 @@ OpenDNS серверы с функцией блокировки контента | Протокол | Адрес | | |----------------|----------------------------------------------------|----------------| | DNS, IPv4 | `9.9.9.9` и `149.112.112.112` | Добавить в AdGuard | -| DNS-over-TLS | `tls://dns.quad9.net` | Добавить в AdGuard | +| DNS, IPv6 | `2620:fe::fe` IP: `2620:fe::fe:9`| Добавить в AdGuard | +| DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.quad9.net` IP: `9.9.9.9:8443`| Добавить в AdGuard | +| DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.quad9.net` IP: `[2620:fe::fe]:8443` | Добавить в AdGuard | +| DNS-over-HTTPS | `https://dns.quad9.net/dns-query` | Добавить в AdGuard | +| DNS-over-TLS | `tls://dns.quad9.net` | Добавить в AdGuard | -#### Зашифрованный DNSSec/без логгирования/фильтр - -| Протокол | Адрес | | -|----------------|----------------------------------------------------|----------------| -| DNSCrypt, IPv4 | Имя провайдера: `2.dnscrypt-cert.quad9.net` IP: `9.9.9.9:8443`| Добавить в AdGuard | -| DNSCrypt, IPv4 | Имя провайдера: `2.dnscrypt-cert.quad9.net` IP: `149.112.112.9:8443`| Добавить в AdGuard | -| DNSCrypt, IPv6 | Имя провайдера: `2.dnscrypt-cert.quad9.net` IP: `[2620:fe::9]:8443`| Добавить в AdGuard | -| DNSCrypt, IPv6 | Имя провайдера: `2.dnscrypt-cert.quad9.net` IP: `[2620:fe::fe:9]:8443`| Добавить в AdGuard | -| DNS-over-HTTPS, IPv4 | `dns9.quad9.net:443/dns-query`| Добавить в AdGuard | -| DNS-over-HTTPS, IPv4 | `dns9.quad9.net:443/dns-query`| Добавить в AdGuard | -| DNS-over-HTTPS, IPv6 | `dns9.quad9.net:443/dns-query`| Добавить в AdGuard | -| DNS-over-HTTPS, IPv6 | `dns9.quad9.net:443/dns-query`| Добавить в AdGuard | - -#### Зашифрованный no-DNSSec/без логгирования/фильтр +#### Незащищенный | Протокол | Адрес | | |----------------|----------------------------------------------------|----------------| +| DNS, IPv4 | `9.9.9.10` and `149.112.112.10` | Добавить в AdGuard | +| DNS, IPv6 | `2620:fe::10` IP: `2620:fe::fe:10` | Добавить в AdGuard | | DNSCrypt, IPv4 | Имя провайдера: `2.dnscrypt-cert.quad9.net` IP: `9.9.9.10:8443`| Добавить в AdGuard | -| DNSCrypt, IPv4 | Имя провайдера: `2.dnscrypt-cert.quad9.net` IP: `149.112.112.10:8443`| Добавить в AdGuard | -| DNSCrypt, IPv6 | Имя провайдера: `2.dnscrypt-cert.quad9.net` IP: `[2620:fe::9]:8443`| Добавить в AdGuard | -| DNSCrypt, IPv6 | Имя провайдера: `2.dnscrypt-cert.quad9.net` IP: `[2620:fe::fe:9]:8443`| Добавить в AdGuard | -| DNS-over-HTTPS, IPv4 | `dns9.quad9.net:443/dns-query`| Добавить в AdGuard | -| DNS-over-HTTPS, IPv4 | `dns9.quad9.net:443/dns-query`| Добавить в AdGuard | -| DNS-over-HTTPS, IPv6 | `dns9.quad9.net:443/dns-query`| Добавить в AdGuard | -| DNS-over-HTTPS, IPv6 | `dns9.quad9.net:443/dns-query`| Добавить в AdGuard | +| DNSCrypt, IPv6 | Имя провайдера: `2.dnscrypt-cert.quad9.net` IP: `[2620:fe::9]:8443`| Добавить в AdGuard | +| DNS-over-HTTPS | `https://dns10.quad9.net/dns-query` | Добавить в AdGuard | +| DNS-over-TLS | `tls://dns10.quad9.net` | Добавить в AdGuard | + + +#### Защищенный (ECS) + +EDNS Client-Subnet - это метод, который включает компоненты данных IP-адреса конечного пользователя в запросы, отправляемые на авторитетные DNS-серверы. Предоставляет черный список для блокировки, DNSSEC, клиент-подсеть EDNS. + +| Протокол | Адрес | | +|----------------|----------------------------------------------------|----------------| +| DNS, IPv4 | `9.9.9.11` and `149.112.112.11` | Добавить в AdGuard | +| DNS, IPv6 | `2620:fe::11` IP: `2620:fe::fe:11` | Добавить в AdGuard | +| DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.quad9.net` IP: `9.9.9.11:8443` | Добавить в AdGuard | +| DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.quad9.net` IP: `[2620:fe::11]:8443` | Добавить в AdGuard | +| DNS-over-HTTPS | `https://dns11.quad9.net/dns-query` | Добавить в AdGuard | +| DNS-over-TLS | `tls://dns11.quad9.net` | Добавить в AdGuard | + @@ -384,6 +399,8 @@ OpenDNS серверы с функцией блокировки контента |----------------|----------------------------------------------------|----------------| | DNS, IPv4 | `101.101.101.101` и `101.102.103.104` | Добавить в AdGuard | | DNS, IPv6 | `2001:de4::101` и `2001:de4::102` | Добавить в AdGuard | +| DNS-over-HTTPS | `https://dns.twnic.tw/dns-query` | Добавить в AdGuard | +| DNS-over-TLS | `tls://101.101.101.101` | Добавить в AdGuard | @@ -434,6 +451,8 @@ OpenDNS серверы с функцией блокировки контента | Протокол | Адрес | | |----------------|----------------------------------------------------|----------------| | DNS, IPv4 | `104.155.237.225` и `104.197.28.121` | Добавить в AdGuard | +| DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.safesurfer.co.nz` IP: `104.197.28.121`| Добавить в AdGuard | + @@ -464,20 +483,42 @@ OpenDNS серверы с функцией блокировки контента | Протокол | Адрес | | |----------------|----------------------------------------------------|----------------| +| DNS, IPv4 | `180.131.144.144` and `180.131.145.145` | Добавить в AdGuard | | DNSCrypt, IPv4 | Имя провайдера: `2.dnscrypt-cert.nawala.id` IP: `180.131.144.144` | Добавить в AdGuard | -### blahdns (germany) +### BlahDNS -[blahdns (germany)](https://blahdns.com/) Сервер для блокировки рекламы с поддержкой DNS-over-TLS, DNS-over-HTTPS и DNSCrypt +[BlahDNS](https://blahdns.com/) Сервер для блокировки рекламы с поддержкой DNS-over-TLS, DNS-over-HTTPS и DNSCrypt -| Протокол | Адрес | | -|----------------|----------------------------------------------------|----------------| -| DNS-over-TLS, IPv4 | Хост: `dot-de.blahdns.com` IP: `159.69.198.101` Имя провайдера: `dot-de.blahdns.com` | Добавить в AdGuard | -| DNS-over-HTTPS, IPv4 | Хост: `https://doh-de.blahdns.com/dns-query` IP: `159.69.198.101` | Добавить в AdGuard | -| DNSCrypt, IPv4 | Имя провайдера: `2.dnscrypt-cert.blahdns.com` IP: `159.69.198.101:8443` | Добавить в AdGuard | +#### DNS Server (Финляндия) + +| Протокол | Адрес | | +|----------------|-------------------------------------|----------------| +| DNS-over-TLS, IPv4 | Hostname: `tls://dot-fi.blahdns.com` IP: `95.216.212.177` | Добавить в AdGuard | +| DNS-over-HTTPS, IPv4 | Hostname: `https://doh-fi.blahdns.com/dns-query` IP: `95.216.212.177` | Добавить в AdGuard | +| DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.blahdns.com` IP: `95.216.212.177:8443`| Добавить в AdGuard | +| DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.blahdns.com` IP: `2a01:4f9:c010:43ce::1:8443`| Добавить в AdGuard | + +#### DNS Server (Япония) + +| Протокол | Адрес | | +|----------------|-------------------------------------|----------------| +| DNS-over-TLS, IPv4 | Hostname: `tls://dot-jp.blahdns.com` IP: `139.162.112.47` | Добавить в AdGuard | +| DNS-over-HTTPS, IPv4 | Hostname: `https://doh-jp.blahdns.com/dns-query` | Добавить в AdGuard | +| DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.blahdns.com` IP: `139.162.112.47:8443`| Добавить в AdGuard | +| DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.blahdns.com` IP: `[2400:8902::f03c:92ff:fe27:344b]:8443`| Добавить в AdGuard | + +#### DNS Server (Германия) + +| Протокол | Адрес | | +|----------------|-------------------------------------|----------------| +| DNS-over-TLS, IPv4 | Hostname: `tls://dot-de.blahdns.com` IP: `159.69.198.101` | Добавить в AdGuard | +| DNS-over-HTTPS, IPv4 | Hostname: `https://doh-de.blahdns.com/dns-query` IP: `159.69.198.101` | Добавить в AdGuard | +| DNSCrypt, IPv4 | Provider: `2.dnscrypt-cert.blahdns.com` IP: `159.69.198.101:8443` | Добавить в AdGuard | +| DNSCrypt, IPv6 | Provider: `2.dnscrypt-cert.blahdns.com` IP: `2a01:4f8:1c1c:6b4b::1:8443`| Добавить в AdGuard | @@ -487,14 +528,14 @@ OpenDNS серверы с функцией блокировки контента | Протокол | Адрес | | |----------------|----------------------------------------------------|----------------| -| DNS-over-TLS, IPv4 | Хост: `ibksturm.synology.me` IP: `83.77.85.7` | Добавить в AdGuard | +| DNS-over-TLS, IPv4 | Хост: `tls://ibksturm.synology.me` IP: `83.77.85.7` | Добавить в AdGuard | | DNS-over-HTTPS, IPv4 | Хост: `https://ibksturm.synology.me/dns-query` IP: `178.82.102.190` | Добавить в AdGuard | | DNSCrypt, IPv4 | Хост: `2.dnscrypt-cert.ibksturm` IP: `83.77.85.7` | Добавить в AdGuard | | DNSCrypt, IPv6 | Хост: `2.dnscrypt-cert.ibksturm` IP: `83.77.85.7` | Добавить в AdGuard | -### DNS-over-TLS Серверы от switch.ch +### SWITCH DNS [DNS-over-TLS от switch.ch](https://www.switch.ch/security/info/public-dns/) Швейцарский DNS-over-TLS сервер. @@ -502,7 +543,8 @@ OpenDNS серверы с функцией блокировки контента |----------------|----------------------------------------------------|----------------| | DNS, IPv4 | Имя провайдера: `dns.switch.ch` IP: `130.59.31.248` | Добавить в AdGuard | | DNS, IPv6 | Имя провайдера: `dns.switch.ch` IPv6: `2001:620:0:ff::2`| Добавить в AdGuard | -| DNS-over-TLS | Хост: `dns.switch.ch` IP: `130.59.31.248` и IPv6: `2001:620:0:ff::2` | Добавить в AdGuard | +| DNS-over-HTTPS | `https://dns.switch.ch/dns-query` | Добавить в AdGuard | +| DNS-over-TLS | Хост: `tls://dns.switch.ch` IP: `130.59.31.248` и IPv6: `2001:620:0:ff::2` | Добавить в AdGuard | @@ -515,72 +557,187 @@ DNS-серверы, оперируемые [Stubby developers](https://getdnsapi | Протокол | Адрес | | |----------------|----------------------------------------------------|----------------| -| DNS-over-TLS | Хост: `getdnsapi.net` IP: `185.49.141.37` и IPv6: `2a04:b900:0:100::37` | Добавить в AdGuard | -| DNS-over-TLS | Имя провайдера: `Surfnet` Хост `dnsovertls.sinodun.com` IP: `145.100.185.15` и IPv6: `2001:610:1:40ba:145:100:185:15` | Добавить в AdGuard | -| DNS-over-TLS | Имя провайдера: `Surfnet` Хост `dnsovertls1.sinodun.com` IP: `145.100.185.16` и IPv6: `2001:610:1:40ba:145:100:185:16` | Добавить в AdGuard | +| DNS-over-TLS | Хост: `tls://getdnsapi.net` IP: `185.49.141.37` и IPv6: `2a04:b900:0:100::37` | Добавить в AdGuard | +| DNS-over-TLS | Имя провайдера: `Surfnet` Хост `tls://dnsovertls.sinodun.com` IP: `145.100.185.15` и IPv6: `2001:610:1:40ba:145:100:185:15` | Добавить в AdGuard | +| DNS-over-TLS | Имя провайдера: `Surfnet` Хост `tls://dnsovertls1.sinodun.com` IP: `145.100.185.16` и IPv6: `2001:610:1:40ba:145:100:185:16` | Добавить в AdGuard | Другие DNS-серверы с политикой 'без логирования': | Протокол | Адрес | | |----------------|----------------------------------------------------|----------------| -| DNS-over-TLS | Имя провайдера: `UncensoredDNS` Хост `unicast.censurfridns.dk` IP: `89.233.43.71 ` и IPv6: `2a01:3a0:53:53::0` | Добавить в AdGuard | -| DNS-over-TLS | Имя провайдера: `UncensoredDNS` Хост `anycast.censurfridns.dk` IP: `91.239.100.100` и IPv6: `2001:67c:28a4::` | Добавить в AdGuard | -| DNS-over-TLS | Имя провайдера: `dkg` Хост `dns.cmrg.net` IP: `199.58.81.218`и IPv6: `2001:470:1c:76d::53` | Добавить в AdGuard | -| DNS-over-TLS, IPv4 | Хост: `dns.larsdebruin.net` IP: `51.15.70.167` | Добавить в AdGuard | -| DNS-over-TLS | Хост `dns-tls.bitwiseshift.net` IP: `81.187.221.24` и IPv6: `2001:8b0:24:24::24` | Добавить в AdGuard | -| DNS-over-TLS| Имя провайдера: `Fondation RESTENA` Хост: `kaitain.restena.lu` IP: `158.64.1.29` и IPv6: `2001:a18:1::29` | Добавить в AdGuard | -| DNS-over-TLS | Хост `ns1.dnsprivacy.at` IP: `94.130.110.185` и IPv6: `2a01:4f8:c0c:3c03::2` | Добавить в AdGuard | -| DNS-over-TLS | Хост `ns2.dnsprivacy.at` IP: `94.130.110.178` и IPv6: `2a01:4f8:c0c:3bfc::2` | Добавить в AdGuard | -| DNS-over-TLS, IPv4 | Хост: `dns.bitgeek.in ` IP: `139.59.51.46` | Добавить в AdGuard | -| DNS-over-TLS | Хост `dns.neutopia.org` IP: `89.234.186.112` и IPv6: `2a00:5884:8209::2` | Добавить в AdGuard | +| DNS-over-TLS | Имя провайдера: `UncensoredDNS` Хост `tls://unicast.censurfridns.dk` IP: `89.233.43.71 ` и IPv6: `2a01:3a0:53:53::0` | Добавить в AdGuard | +| DNS-over-TLS | Имя провайдера: `UncensoredDNS` Хост `tls://anycast.censurfridns.dk` IP: `91.239.100.100` и IPv6: `2001:67c:28a4::` | Добавить в AdGuard | +| DNS-over-TLS | Имя провайдера: `dkg` Хост `tls://dns.cmrg.net` IP: `199.58.81.218`и IPv6: `2001:470:1c:76d::53` | Добавить в AdGuard | +| DNS-over-TLS, IPv4 | Хост: `tls://dns.larsdebruin.net` IP: `51.15.70.167` | Добавить в AdGuard | +| DNS-over-TLS | Хост `tls://dns-tls.bitwiseshift.net` IP: `81.187.221.24` и IPv6: `2001:8b0:24:24::24` | Добавить в AdGuard | | +| DNS-over-TLS | Хост `tls://ns1.dnsprivacy.at` IP: `94.130.110.185` и IPv6: `2a01:4f8:c0c:3c03::2` | Добавить в AdGuard | +| DNS-over-TLS | Хост `tls://ns2.dnsprivacy.at` IP: `94.130.110.178` и IPv6: `2a01:4f8:c0c:3bfc::2` | Добавить в AdGuard | +| DNS-over-TLS, IPv4 | Хост: `tls://dns.bitgeek.in ` IP: `139.59.51.46` | Добавить в AdGuard | +| DNS-over-TLS | Хост `tls://dns.neutopia.org` IP: `89.234.186.112` и IPv6: `2a00:5884:8209::2` | Добавить в AdGuard | | DNS-over-TLS | Имя провайдера: `Go6Lab` Хост `tls://privacydns.go6lab.si` IPv6: `2001:67c:27e4::35` | Добавить в AdGuard | -| DNS-over-TLS | Хост: `dot.securedns.eu` IP: `146.185.167.43` и IPv6: `2a03:b0c0:0:1010::e9a:3001` | Добавить в AdGuard | +| DNS-over-TLS | Хост: `tls://dot.securedns.eu` IP: `146.185.167.43` и IPv6: `2a03:b0c0:0:1010::e9a:3001` | Добавить в AdGuard | DNS-серверы с минимальным/ограниченным логированием. Эти серверы осуществляют логирование в какой-либо форме, имеют самоподписанные сертификаты или не поддерживают strict mode. | Протокол | Адрес | | |----------------|----------------------------------------------------|----------------| -| DNS-over-TLS | Имя провайдера: `NIC Chile` Хост `dnsotls.lab.nic.cl` IP: `200.1.123.46` и IPv6: `2001:1398:1:0:200:1:123:46` | Добавить в AdGuard | -| DNS-over-TLS | Имя провайдера: `OARC` Хост `tls-dns-u.odvr.dns-oarc.net` IP: `184.105.193.78` и IPv6: `2620:ff:c000:0:1::64:25` | Добавить в AdGuard | - - - - - -### evilvibes.com - -[evilvibes.com](https://github.com/evilvibes/dnscrypt_stamps) — нелогирующий, неблокирующий DNS-резолвер от провайдера evilvibes.com. - -| Протокол | Адрес | Локация | | -|----------------|-------------------------------------|---------------|----------------| -| DNSCrypt, IPv4 | Провайдер: `2.dnscrypt-cert.evilvibes.com` IP: `23.111.74.205` | Локация: `Vancouver, Canada` | Добавить в AdGuard | -| DNSCrypt, IPv4 | Провайдер: `2.dnscrypt-cert.evilvibes.com` IP: `66.85.30.115` | Локация: `Toronto, Canada` | Добавить в AdGuard | - +| DNS-over-TLS | Имя провайдера: `NIC Chile` Хост `tls://dnsotls.lab.nic.cl` IP: `200.1.123.46` и IPv6: `2001:1398:1:0:200:1:123:46` | Добавить в AdGuard | +| DNS-over-TLS | Имя провайдера: `OARC` Хост `tls://tls-dns-u.odvr.dns-oarc.net` IP: `184.105.193.78` и IPv6: `2620:ff:c000:0:1::64:25` | Добавить в AdGuard | -### DNS-over-TLS and DNS-over-HTTPS Servers by cira.ca +### CIRA Canadian Shield DNS -[DNS-over-TLS и DNS-over-HTTPS серверы от cira.ca](https://www.cira.ca/cybersecurity-services/canadianshield/how-works), официального канадского TLD-провайдера. Предлагает различные DoH и DoT DNS-серверы. +[CIRA Canadian Shield DNS](https://www.cira.ca/cybersecurity-services/canadianshield/how-works) защищает от кражи личных данных. Помогает справиться с вирусами, программами-вымогателями и другими вредоносными программами. + +#### Приватный + +В "приватном" режиме - только обработка DNS | Протокол | Адрес | | |----------------|----------------------------------------------------|----------------| -| DNS-over-TLS - Private | Имя провайдера: `private.canadianshield.cira.ca` IP: `149.112.121.10` и IPv6: `2620:10A:80BB::10` | Добавить в AdGuard | -| DNS-over-TLS - Protected | Имя провайдера: `protected.canadianshield.cira.ca` IP: `149.112.121.20` и IPv6: `2620:10A:80BB::20` | Добавить в AdGuard | -| DNS-over-TLS - Family | Имя провайдера: `protected.canadianshield.cira.ca` IP: `149.112.121.30` и IPv6: `2620:10A:80BB::30` | Добавить в AdGuard | -| DNS-over-HTTPS - Private | Имя провайдера: `https://private.canadianshield.cira.ca/dns-query` IP: `149.112.121.10` и IPv6: `2620:10A:80BB::10` | Добавить в AdGuard | -| DNS-over-HTTPS - Protected | Имя провайдера: `https://protected.canadianshield.cira.ca/dns-query` IP: `149.112.121.20` и IPv6: `2620:10A:80BB::20` | Добавить в AdGuard | -| DNS-over-HTTPS - Family | Имя провайдера: `https://family.canadianshield.cira.ca/dns-query` IP: `149.112.121.30` и IPv6: `2620:10A:80BB::30` | Добавить в AdGuard | +| DNS, IPv4 | `149.112.121.10` and `149.112.122.10` | Добавить в AdGuard | +| DNS, IPv6 | `2620:10A:80BB::10` and `2620:10A:80BC::10` | Добавить в AdGuard | +| DNS-over-HTTPS | `https://private.canadianshield.cira.ca/dns-query` | Добавить в AdGuard | +| DNS-over-TLS - Private | Hostname: `tls://private.canadianshield.cira.ca` IP: `149.112.121.10` and IPv6: `2620:10A:80BB::10` | Добавить в AdGuard | + +#### Защищенный + +В "защищенном" режиме - защита от вредоносных и фишинговых программ + +| Протокол | Адрес | | +|----------------|----------------------------------------------------|----------------| +| DNS, IPv4 | `149.112.121.20` and `149.112.122.20` | Добавить в AdGuard | +| DNS, IPv6 | `2620:10A:80BB::20` and `2620:10A:80BC::20` | Добавить в AdGuard| +| DNS-over-HTTPS | `https://protected.canadianshield.cira.ca/dns-query` | Добавить в AdGuard | +| DNS-over-TLS - Protected | Hostname: `tls://protected.canadianshield.cira.ca` IP: `149.112.121.20` and IPv6: `2620:10A:80BB::20` | Добавить в AdGuard | + +#### Семейный + +В "семейном" режиме - то же, что в "защищенном" режиме + блокировка взрослого контента + +| Протокол | Адрес | | +|----------------|----------------------------------------------------|----------------| +| DNS, IPv4 | `149.112.121.30` and `149.112.122.30` | Добавить в AdGuard| +| DNS, IPv6 | `2620:10A:80BB::30` and `2620:10A:80BC::30` | Добавить в AdGuard| +| DNS-over-HTTPS | `https://family.canadianshield.cira.ca/dns-query` | Добавить в AdGuard | +| DNS-over-TLS - Family | Hostname: `tls://protected.canadianshield.cira.ca` IP: `149.112.121.30` and IPv6: `2620:10A:80BB::30` | Добавить в AdGuard | -### ffmuc.net +### FFMUC DNS -[ffmuc.net](https://ffmuc.net/) — DNS-over-TLS и DNS-over-HTTPS серверы от Freifunk München +[FFMUC DNS](https://ffmuc.net/) — DNS-over-TLS и DNS-over-HTTPS серверы от Freifunk München | Протокол | Адрес | | |----------------|----------------------------------------------------|----------------| -| DNS-over-TLS, IPv4 | Имя провайдера: `dot.ffmuc.net` IP: `195.30.94.28` | Добавить в AdGuard | -| DNS-over-HTTPS, IPv4 | Имя провайдера: `https://doh.ffmuc.net/dns-query` IP: `195.30.94.28` | Добавить в AdGuard | +| DNS-over-TLS, IPv4 | Имя провайдера: `tls://dot.ffmuc.net` | Добавить в AdGuard | +| DNS-over-HTTPS, IPv4 | Имя провайдера: `https://doh.ffmuc.net/dns-query` | Добавить в AdGuard | +| DNSCrypt, IPv4 | Провайдер: `2.dnscrypt-cert.ffmuc.net` IP: `5.1.66.255` | Добавить в AdGuard | +| DNSCrypt, IPv6 | Провайдер: `2.dnscrypt-cert.ffmuc.net` IP: `2001:678:e68:f000::` | Добавить в AdGuard | + + + +### NextDNS + +[NextDNS](https://nextdns.io/) предоставляет публично доступные нефильтрующие резолверы без логирования вдобавок к настраиваемым фримиум фильтрующим серверам с опциональным логированием. + +#### Нефильтрующие + +| Протокол | Адрес | | +|----------------|----------------------------------------------------|----------------| +|DNS-over-HTTPS| Хост `dns.nextdns.io`|Добавить в AdGuard| +|DNS-over-TLS| Хост `tls://dns.nextdns.io`|Добавить в AdGuard| + + + +### RethinkDNS + +[RethinkDNS](https://www.bravedns.com/configure) предоставляет DNS-over-HTTPS сервис, работающий как Cloudflare Worker с настраиваемыми списками блокировки. + +#### Нефильтрующий + +| Протокол | Адрес | | +|----------------|----------------------------------------------------|----------------| +|DNS-over-HTTPS| Хост `basic.bravedns.com/`|Добавить в AdGuard| + + + +### ControlD DNS + +[ControlD](https://controld.com/) — это настраиваемый DNS-сервис, который можно использовать для блокировки нежелательных категорий сайтов (рекламные, 18+ и т.д.), популярных сервисов (Facebook, TikTok) или любых доменов по вашему выбору. + +#### Нефильтрующий + +| Протокол | Адрес | | +|----------------|----------------------------------------------------|----------------| +| DNS, IPv4 | Хост: `76.76.2.0` | Добавить в AdGuard | +| DNS-over-HTTPS | Хост: `https://freedns.controld.com/p0` | Добавить в AdGuard | +| DNS-over-TLS | Хост: `tls://p0.freedns.controld.com` | Добавить в AdGuard | + +#### Блокирует вредоносные сайты + +| Протокол | Адрес | | +|----------------|----------------------------------------------------|----------------| +| DNS, IPv4 | Хост: `76.76.2.1` | Добавить в AdGuard | +| DNS-over-HTTPS | Хост: `https://freedns.controld.com/p1` | Добавить в AdGuard | +| DNS-over-TLS | Хост: `tls://p1.freedns.controld.com` | Добавить в AdGuard | + +##### Блокирует вредоносные сайты + рекламу + +| Протокол | Адрес | | +|----------------|----------------------------------------------------|----------------| +| DNS, IPv4 | Хост: `76.76.2.2` | Добавить в AdGuard | +| DNS-over-HTTPS | Хост: `https://freedns.controld.com/p2` | Добавить в AdGuard | +| DNS-over-TLS | Хост: `tls://p2.freedns.controld.com` | Добавить в AdGuard | + +##### Блокирует вредоносные сайты + рекламу + соцмедиа + +| Протокол | Адрес | | +|----------------|----------------------------------------------------|----------------| +| DNS, IPv4 | Хост: `76.76.2.3` | Добавить в AdGuard | +| DNS-over-HTTPS | Хост: `https://freedns.controld.com/p3` | Добавить в AdGuard | +| DNS-over-TLS | Хост: `tls://p3.freedns.controld.com` | Добавить в AdGuard | + + + +### Mullvad + +[Mullvad](https://mullvad.net/ru/help/dns-over-https-and-dns-over-tls/) предоставляет публично доступный DNS-сервис с минимизацией QNAME, с эндпоинтами в Австралии, Германии, Сингапуре, Швеции, Соединённом Королевстве и США (Нью-Йорк и Лос-Анджелес). + +#### Нефильтрующий + +| Протокол | Адрес | | +|----------------|----------------------------------------------------|----------------| +| DNS-over-HTTPS | Хост: `https://doh.mullvad.net/dns-query` | Добавить в AdGuard | +| DNS-over-TLS | Хост: `tls://doh.mullvad.net` | Добавить в AdGuard | + +#### Блокирующий + +| Протокол | Адрес | | +|----------------|----------------------------------------------------|----------------| +| DNS-over-HTTPS | Хост: `https://adblock.doh.mullvad.net/dns-query` | Добавить в AdGuard | +| DNS-over-TLS | Хост: `tls://adblock.doh.mullvad.net` | Добавить в AdGuard | + + + + +### Небольшие персональные резолверы + +В этой секции собраны маленькие, в основном персональные DNS-резолверы. Они часто имеют всего один или очень мало серверов и в целом обладают худшим аптаймом в сравнении с "большими" провайдерами. Мы не имеем возможности должным образом следить за их доступностью. **Используйте на свой страх и риск!** + + + + +#### Arapurayil + +[Arapurayil](https://dns.arapurayil.com) — персональный DNS-сервис, расположенный в Мумбаи, Индия. + +Без логирования | Фильтрующий рекламу, трекеры, фишинг и т.д. | DNSSEC | Минимизация QNAME | Без EDNS Client-Subnet. + +| Протокол | Адрес | | +|----------------|------------------------------------------------------------------|------------------| +| DNSCrypt, IPv4 | Хост: `2.dnscrypt-cert.dns.arapurayil.com` IP: `3.7.156.128` | Добавить в AdGuard | +| DNS-over-HTTPS | Хост: `https://dns.arapurayil.com/dns-query` | Добавить в AdGuard | diff --git a/01.general/18.stealth-mode/docs.en.md b/01.general/18.stealth-mode/docs.en.md index 41346425..2102b2d0 100644 --- a/01.general/18.stealth-mode/docs.en.md +++ b/01.general/18.stealth-mode/docs.en.md @@ -99,12 +99,11 @@ You can also set Referer of your choice by typing it into the Custom Referer fie **Hide your User-Agent ** -When you visit a website, your browser send the server its information. It looks like a text line that is a part of HTTP request beginning with “User-Agent:”. It usually includes the name and version of the browser, operating system, and language settings. We always replace your operating system with Linux as we consider \*nix system users as less interesting for advertisers. +When you visit a website, your browser send the server its information. It looks like a text line that is a part of HTTP request beginning with “User-Agent:”. It usually includes the name and version of the browser, operating system, and language settings. We strip User-Agent from identifying information so that advertisers can't obtain it. You can also set User-Agent of your choice by typing it into the Custom User-Agent field. Leave the field empty to use the default User-Agent. **Hide your IP address** Stealth Mode cannot hide your IP address. However, we can conceal it so that websites you visit will take you for a proxy server. Sometimes, it helps, and websites ignore your real IP. -You can set a random IP that you would like to be perceived as yours by simply typing it into the corresponding field. Leave the field empty to use the default IP address. - +You can set a random IP that you would like to be perceived as yours by simply typing it into the corresponding field. Leave the field empty to use the default IP address. \ No newline at end of file diff --git a/01.general/18.stealth-mode/docs.ru.md b/01.general/18.stealth-mode/docs.ru.md index 0ff74809..340b7bf7 100644 --- a/01.general/18.stealth-mode/docs.ru.md +++ b/01.general/18.stealth-mode/docs.ru.md @@ -105,7 +105,7 @@ Referer - один из HTTP-заголовков запроса браузер **Скрыть User-Agent** -При посещении веб-сайта браузер посылает серверу информацию о себе. Это текстовая строка, являющаяся частью HTTP-запроса и начинающаяся с "User-Agent:". Обычно она включает в себя название и версию браузера, операционной системы компьютера и сведения о языковых настройках. Мы всегда заменяем информацию о вашей операционной системе на Linux, так как считаем, что пользователи *nix-систем меньше интересуют рекламодателей. +При посещении веб-сайта браузер посылает серверу информацию о себе. Это текстовая строка, являющаяся частью HTTP-запроса и начинающаяся с "User-Agent:". Обычно она включает в себя название и версию браузера, операционной системы компьютера и сведения о языковых настройках. Мы убираем из User-Agent всю информацию, по которой вас можно идентифицировать, чтобы рекламодатели не могли получить к ней доступ. Вы также можете установить произвольный User-Agent, введя его в поле "Настроить User-Agent". Оставьте поле пустым, чтобы использовать User-Agent по умолчанию. @@ -113,4 +113,4 @@ Referer - один из HTTP-заголовков запроса браузер Антитрекинг не может скрыть ваш IP адрес. Но мы можем замаскировать вас таким образом, что посещаемый сайт будет воспринимать вас как прокси-сервер. В некоторых случаях это помогает, и сайт игнорирует ваш настойщий IP адрес. -Вы можете установить произвольный IP адрес, который желаете выдать за свой, просто введя его в соответствующее поле. Оставьте поле пустым, чтобы использовать IP адрес по умолчанию. +Вы можете установить произвольный IP адрес, который желаете выдать за свой, просто введя его в соответствующее поле. Оставьте поле пустым, чтобы использовать IP адрес по умолчанию. \ No newline at end of file diff --git a/01.general/19.dns-filtering-syntax/docs.en.md b/01.general/19.dns-filtering-syntax/docs.en.md index 0ed37ee5..fca4afec 100644 --- a/01.general/19.dns-filtering-syntax/docs.en.md +++ b/01.general/19.dns-filtering-syntax/docs.en.md @@ -7,27 +7,39 @@ visible: true --- -[AdGuard for Android](https://kb.adguard.com/en/android), [AdGuard for Windows](https://kb.adguard.com/en/windows) (Nightly), [AdGuard for Mac](https://kb.adguard.com/en/macos) (Nightly) and [AdGuard Home](https://kb.adguard.com/en/home) support DNS ad blocking. To learn more about the principle of DNS filtering, read [this KB article](https://kb.adguard.com/general/dns-filtering-android). Compared to the [traditional ad blocking](https://kb.adguard.com/general/how-ad-blocking-works), DNS filtering is more "crude" and allows less customization. On the positive side, it is applied earlier, even before apps and browsers actually make a connection attempt. +[AdGuard for Android](https://kb.adguard.com/android) and [AdGuard Home](https://kb.adguard.com/home) provides a DNS ad blocking feature. To learn more about the principle of DNS filtering, read [this KB article](https://kb.adguard.com/general/dns-filtering-android). Compared to the [traditional ad blocking](https://kb.adguard.com/general/how-ad-blocking-works), DNS filtering is more "crude" and allows less customization. It doesn't support the complex [syntax](https://kb.adguard.com/general/how-to-create-your-own-ad-filters) we use in our filters, but it does support simplified syntax that allows you to block certain domains. -It doesn't support the complex [syntax](https://kb.adguard.com/general/how-to-create-your-own-ad-filters) we use in our filters, but it does support simplified syntax that allows you to block certain domains. DNS filtering supports these types of rules: +DNS filtering supports three types of rules: * Basic filtering rules, which is the same as [AdGuard's basic rules](https://kb.adguard.com/general/how-to-create-your-own-ad-filters#basic-rules), but with a limited set of modifiers supported: * [`$important`](https://kb.adguard.com/general/how-to-create-your-own-ad-filters#important-modifier) + * [`$match-case`](https://kb.adguard.com/general/how-to-create-your-own-ad-filters#match-case-modifier) * [`$badfilter`](https://kb.adguard.com/general/how-to-create-your-own-ad-filters#badfilter-modifier) * Rules with other modifiers will be ignored -AdGuard Home supports more modifiers, you can find more information about AdGuard Home DNS syntax [here](https://github.com/AdguardTeam/AdGuardHome/wiki/Hosts-Blocklists). +* “Hosts” rules, which is basically the same as `/etc/hosts`
+* Domains names -* "Hosts" rules, which is basically the same as `/etc/hosts` +Examples: -#### Examples: +General: +1. `||example.org^` - block access to the example.org domain and all its subdomains +2. `@@||example.org^` - unblock access to the example.org domain and all its subdomains +3. `example.org` - block access to the example.org domain, but not its subdomains +4. `0.0.0.0 example.org` - AdGuard will now return 0.0.0.0 address for the example.org domain (but not its subdomains). Other IP addresses can be specified. +5. `/REGEX/` - block access to the domains matching the specified regular expression +6. `123.45.67.89` - block access to all domains whose CNAME response returns this IP address -1. `||example.org^`- block access to the example.org domain and all it's subdomains -2. `@@||example.org^` - unblock access to the example.org domain and all it's subdomains -3. `0.0.0.0 example.org` - AdGuard will now return 0.0.0.0 address for the example.org domain (but not it's subdomains) -4. `! Here goes a comment` - just a comment -5. `# Also a comment` - just a comment -6. `/REGEX/` - block access to the domains matching the specified regular expression +Wildcarding: +1. `||example.TLD^` - block access to "example" domains across all TLDs and all their subdomains +2. `://example.` - block access to domains that begin with "example." +3. `.example.org` - only block access to the subdomains of example.org (incl. `www.`), not its main domain +4. `||com^` - block access to the .com top-level domain -Use this syntax to create or import rules to DNS filter. If you have any questions, feel free to post them on our [forum](https://forum.adguard.com/index.php?forums/69/). +! Meta: +1. `! Here goes a comment` - just a comment +2. `# Also a comment` - just a comment +3. `! Title:` - the title that'll be used for the filterlist in AdGuard's settings (`# Title:` won't work). + +Based on the examples above, you can create rules for DNS filters. If you have any questions, feel free to post them on our [forum](https://forum.adguard.com/index.php?forums/69/). diff --git a/02.windows/02.installation/docs.ja.md b/02.windows/02.installation/docs.ja.md new file mode 100644 index 00000000..ad43737b --- /dev/null +++ b/02.windows/02.installation/docs.ja.md @@ -0,0 +1,119 @@ +--- +title: インストール/アンインストール +taxonomy: + category: + - docs +--- + +## 動作環境 + +**オペレーティングシステム**: Microsoft Windows 10、8.1、8、7、Vista。 + +**RAM:** 512MB以上 + +**ディスクの空き容量:** 150MB + +**ブラウザ:** Microsoft Edge、Microsoft Internet Explorer (全バージョン)、Opera、Google Chrome、Yandex.Browser、Mozilla Firefox、およびその他のブラウザ。 + + +## AdGuardのインストール方法 + +Microsoft Windowsを搭載したPCやタブレットでAdGuardを使用するには、インストールパッケージをダウンロードして、インストールプログラムを起動する必要があります。 +以下の操作を行ってください: + +1) お使いのブラウザで[adguard.com](http://adguard.com)を開き、「**ダウンロード**」ボタンを押す + + + +2) ダウンロードが完了しましたら、ダウンロードバーにある「実行」ボタンを押すか、「adguardInstaller.exe」ファイルを押してください。 + + + +3) ユーザーアカウント制御のダイアログボックスが表示されてアプリがPCに変更を加えることを許可するよう求められた場合は、「はい]をクリックしてください。 + + + +4) AdGuardのPC上インストール先を選ぶ + + + +デフォルトのインストール先を変更したい場合は、「**参照**」を押して、「**フォルダを参照**」ウィンドウでAdGuardをインストールするフォルダを選択し、**OK**をクリックして選択を確定してください。 +また、**新規フォルダを作成**をクリックしてフォルダ名を入力することで、AdGuardを新しいフォルダにインストールすることもできます。 + +AdGuardのデスクトップのショートカットを作成するには、「**デスクトップにショートカットを作成**」ボックスをチェックします。 + +「**インストール**」を押して、インストールを続行します。 + + + +5) インストールが完了しましたら、「**終了**」を押す + + + +6) インストールが完了すると、AdGuardの主な機能について説明を受けることができます。アプリのチュートリアルを開始し、主要な設定を段階的にカスタマイズするには、「**はじめる**」をクリック。 +このステップをスキップしたい場合は、 「**このままでOK**」 を押します。 + + + +おめでとうございます。お使いのコンピュータにAdGuardが正常にインストールされました。画面には、アプリの設定を変更できるメインウィンドウが表示されます。 + + +## AdGuardのアンインストールと再インストール方法 + +### 通常方法 + +AdGuardをアンインストールまたは再インストールする必要がある場合は、以下の操作を行ってください。 + +【Microsoft Windows 10の場合】 + + **スタート**をクリックして**スタートメニュー**を開き、**設定**を選択します。開いたウィンドウで**アプリ**アイコンをクリックします。**アプリ**ウィンドウの左の一覧から**アプリと機能**を選択します。インストールされているアプリの一覧から「**AdgGuard**」を選択し、「**アンインストール**」をクリックします。開いたダイアログボックスで「**アンインストール**」をクリックして確認します。 + + + +【Microsoft Windows 7の場合】 + +**スタートメニュー**を開きます。検索ボックスに「**コントロールパネル**」と入力します。**プログラム**セクションで**プログラムのアンインストール**をクリックし、インストールされたアプリのリストから**AdGuard**を選択して、リストの真上にある**アンインストール**ボタンを押します。開いたウィンドウで**AdGuardのアンインストール**をクリックして動作を確認します。 + + + +通常のアンインストール方法が何らかの理由で機能しない場合は、下の**アドバンスド方法**を使用してみてください。 + +お使いのPCにAdGuardを再インストールするには、インストールプログラムを再度起動し、上記「AdGuardのインストール方法」項目の手順を繰り返してください。 + +【Microsoft Windows 8の場合】 + +タスクバーの左下にある**空のスペース**を右クリックし、**コントロールパネル**を選択します。**プログラム**セクションで**プログラムのアンインストール**をクリックし、インストールされているアプリのリストから**AdGuard**を選択して、リストの真上にある**アンインストール**ボタンを押します。開いたウィンドウで「AdGuardのアンインストール」をクリックして動作を確認します。 + + + +【Microsoft Windows 8.1の場合】 + +**スタートボタン**を右クリックし、**コントロールパネル**を選択します。**プログラム**セクションで**プログラムのアンインストール**をクリックし、インストールされているアプリのリストから**AdGuard**を選択して、リストの真上にある**アンインストール**ボタンを押します。開いたウィンドウで**AdGuardのアンインストール**をクリックして動作を確認します。 + +### アドバンスド方法 +まず、AdGuardの開発者が作成したアンインストーラーツールをダウンロードする必要があります。方法は以下の通りです: +[このリンク](https://cdn.adguard.com/public/Adguard/tools/Uninstall_Utility.zip")をクリックしてください。 +アーカイブをお使いのPCの任意のフォルダに解凍し、 「**Adguard_Uninstall_Utility.exe**」ファイルを実行してください。 +その後、以下の手順に行なってください。 + +* ’Standard uninstall’ を選択して ’Uninstall’　をクリックしてください + +![](https://cdn.adguard.com/public/Adguard/Ru/Articles/howtodelete/main_menu.png) + +* アンインストールが完了するまで待つと、ウィンドウに文字列が表示されます: + 

"[OK] Uninstall finished"
+ +![](https://cdn.adguard.com/public/Adguard/Ru/Articles/howtodelete/standard_uninstall.png) + +【注意】 最初の2つのステップを実行した後、何らかの理由で十分ではなかった場合にのみ、ステップ3と4を行なってください。通常、AdGuardの再インストールが正しく行われていないことが原因であると考えられますが、アドバンスドアンインストール手順の3と4を行う前に、弊社サポートにお問い合わせいただくことを強くお勧めします。 + +* ’Advanced uninstall’ を選択して ’Uninstall’ をクリック + +![](https://cdn.adguard.com/public/Adguard/Ru/Articles/howtodelete/main_menu_adv.png) + +* アンインストールが完了するまで待つと、ウィンドウに文字列が表示されます: + 
"[OK] Uninstall finished"
+ +![](https://cdn.adguard.com/public/Adguard/Ru/Articles/howtodelete/advanced_uninstall.png) + +AdGuardのアンインストール完了です！ diff --git a/02.windows/02.installation/docs.ko.md b/02.windows/02.installation/docs.ko.md new file mode 100644 index 00000000..eb2a6cf7 --- /dev/null +++ b/02.windows/02.installation/docs.ko.md @@ -0,0 +1,122 @@ +--- +title: 설치 방법/제거 방법 +taxonomy: + category: + - docs +--- + +## 시스템 요구 사항 +**운영 체제:** Microsoft Windows 10, 8.1, 8, 7, Vista. + +**RAM:** 512 MB 이상. + +**디스크 여유 공간:** 150 Mbytes. + +**브라우저:** Microsoft Edge, Microsoft Internet Explorer(모든 버전), Opera, Google Chrome, Yandex.Browser, Mozilla Firefox, 등등. + + +## AdGuard 설치 + +Microsoft Windows의 PC 또는 태블릿에서 AdGuard를 사용하려면 설치 패키지를 다운로드하고 설치하면 됩니다. 다음 단계를 따라와 보세요: + +1) 브라우저를 열고 주소 표시 줄에 adguard.com을 입력하여 [AdGuard 공식 웹 사이트](https://adguard.com/ko/welcome.html)로 이동합니다. 다음 **다운로드**를 클릭합니다. + + + +2) 다운로드가 완료되면 다운로드 표시 줄에 표시된 **실행** 버튼을 누르거나 *adguardInstaller.exe* 파일을 클릭합니다. + + + +3) 프로그램이 PC를 변경할 수 있도록 허용하라는 사용자 계정 컨트롤 대화 상자가 표시될 것입니다. **네** 버튼을 클릭합니다. + +4) 프로그램을 설치할 PC의 폴더를 선택합니다. + + + +기본 설치 경로에 동의하지 않는 경우 **찾아보기**를 누르고 **폴더 찾아보기** 창에서 AdGuard를 설치할 폴더를 선택한 후 **확인**을 클릭합니다. 또한 **새 폴더 만들기**를 클릭하고 이름을 입력하여 AdGuard를 새 폴더에 설치할 수 있습니다. AdGuard 바탕 화면 바로 가기를 만들려면 **바탕 화면 바로 가기 만들기** 확인란을 선택합니다. **설치**를 눌러 설치를 계속합니다. + + + +5) 설치가 완료된 후 **마침**을 클릭합니다. + + + +6) 설치가 완료되면 AdGuard의 주요 기능을 확인할 수 있습니다. 프로그램 기능의 단계별 설정을 조정하려면 **네 알겠습니다**을 클릭합니다. 이 단계를 건너 뛰려면 **아니요 하지않겠습니다**를 누릅니다. + + + +축하드립니다! AdGuard가 컴퓨터에 설치되었습니다. 화면에 프로그램 설정을 변경할 수 있는 메인 창이 표시됩니다. + + +## AdGuard 제거 및 재설치 +### 일반 제거 및 재설치 방법 + +AdGuard 제거 및 재설치 방법은 다음과 같습니다. + +**Microsoft Windows 10** +1. **시작**을 클릭하여 **시작 메뉴**를 엽니다. +2. **설정**을 선택합니다. +3. 열리는 창에서 **앱** 아이콘을 클릭합니다. +4. **앱** 창의 왼쪽 목록에서 **앱 및 기능**을 선택합니다. +5. 설치된 앱 목록 중에 **Adguard**를 선택합니다. +6. **제거**를 클릭합니다. +7. 확인을 위해 열리는 대화 상자에서 **제거**를 클릭합니다. + + + +**Microsoft Windows 7** +1. **시작 메뉴**를 엽니다. +2. 검색 창에 **제어판**을 입력합니다. +3. **프로그램** 섹션에서 **프로그램 제거**를 클릭합니다. +4. 설치된 앱 목록 중에 **AdGuard**를 선택합니다. +5. 목록 바로 위에 있는 **제거** 버튼을 누릅니다. +6. 열리는 창에서 **AdGuard 제거**를 클릭합니다. + + + +일반적인 방법으로 프로그램이 제거되지 않는다면 고급적인 방법을 시도해 보십시오. + +PC에 AdGuard를 재설치하려면 설치 과정을 다시 시작하고 AdGuard 설치 단계를 다시 반복하십시오. + +**Microsoft Windows 8** +1. 작업 표시 줄의 왼쪽 하단에 있는 **빈 공간**을 마우스 우클릭하고 **제어판**을 선택합니다. +2. **프로그램** 섹션에서 **프로그램 제거**를 클릭합니다. +3. 설치된 앱 목록 중에 **AdGuard**를 선택합니다. +4. 목록 바로 위에 있는 **제거** 버튼을 누릅니다. +5. 열리는 창에서 **AdGuard 제거**를 클릭하여 확인합니다. + + + +**Microsoft Windows 8.1** +1. **시작 버튼**을 마우스 우클릭하고 **제어판**을 선택합니다. +2. **프로그램** 섹션에서 **프로그램 제거**를 클릭합니다. +3. 설치된 앱 목록 중에 **AdGuard**를 선택합니다. +4. 목록 바로 위에 있는 **제거** 버튼을 누릅니다. +5. 열리는 창에서 **AdGuard 제거**를 클릭하여 확인합니다. + + +### 고급 방법 + +먼저 개발자들이 만든 제거 도구를 다운로드하십시오. 이 링크를 클릭하면 제거 도구를 다운로드할 수 있습니다. PC의 폴더에 압축을 풀고 Adguard_Uninstall_Utility.exe 파일을 실행합니다. 그런 다음 아래 지침을 따르십시오. + +* 'Standart uninstall'를 선택하고 'uninstall'를 클릭합니다. +![](https://cdn.adguard.com/public/Adguard/Ru/Articles/howtodelete/main_menu.png) + +* 제거가 완료되면 창에 다음과 같은 문자열이 표시됩니다. + +
'[OK] Uninstall finished'
+![](https://cdn.adguard.com/public/Adguard/Ru/Articles/howtodelete/standard_uninstall.png) + +주의! 1 ~ 2 단계를 수행해도 프로그램이 제거되지 않은 경우에만 3 ~ 4 단계를 따르십시오. +AdGuard의 잘못된 재설치로 판단될 수 있지만 고급 제거 지침의 3 ~ 4 단계를 사용하기 전에 지원 팀에 문의하는 것이 좋습니다. + +* 'Advanced uninstall'를 선택하고 'uninstall'를 클릭합니다. +![](https://cdn.adguard.com/public/Adguard/Ru/Articles/howtodelete/main_menu_adv.png) + +* 제거가 완료되면 창에 다음과 같은 문자열이 표시됩니다. + +
'[OK] Uninstall finished'
+ +![](https://cdn.adguard.com/public/Adguard/Ru/Articles/howtodelete/advanced_uninstall.png) + +AdGuard가 제거되었습니다! diff --git a/02.windows/02.installation/docs.zh.md b/02.windows/02.installation/docs.zh.md new file mode 100644 index 00000000..3e1fe564 --- /dev/null +++ b/02.windows/02.installation/docs.zh.md @@ -0,0 +1,99 @@ +--- +title: 安装/卸载 +taxonomy: + category: + - docs +--- + +## 系统需求 + +**操作系统：** Microsoft Windows 10、8.1、8、7、Vista。 + +**RAM：** 至少 512 MB + +**可用磁盘空间：** 170 MB。 + +**浏览器：** Microsoft Edge、Microsoft Internet Explorer（所有版本）、Opera、Google Chrome、Yandex.Browser、Mozilla Firefox、百度和其他浏览器。 + +## AdGuard 安装过程 + +如您想要在 Microsoft Windows 操作系统的电脑或笔记本上使用 AdGuard ，您要下载安装包并启用安装程序。请执行以下步骤： +1) 打开您的浏览器并转到 [AdGuard 网站](https://adguard.com/zh_cn/welcome.html)。您也可以在地址栏输入网址：adguard.com。在官网点击**产品**，选择 AdGuard for Windows。点击**下载**。 + + + +2) 下载完成后，请点击**打开**或直接点击 *adguardInstaller.exe* 的文件名即可。 + + + +3) 下一步，请您选择安装位置。 + + + +如您想更改应用程序默认安装路径，请点击 **[浏览]**，在**浏览文件夹**窗口里选择想要安装 AdGuard 的文件夹位置。选择好后，请您点击**确定**。如您想要将 AdGuard 安装到新建的文件夹位置，请点击**新建文件夹**并输入文件夹名。如果想要创建 AdGuard 桌面快捷键，查看**创建桌面快捷**的复选框。 + +点击**安装**以继续安装过程。 + + + +4) 请稍等，安装完成后，点击**完成**。 + + + +5) 安装完成后，您可以开始了解 AdGuard 的主要功能。以开始了解并一步一步设置应用程序的主要功能，请点击**来试试吧！**。如您不想马上开始设置 AdGuard，点击**先保持这样**即可。 + + + +恭喜您！您已成功安装 AdGuard！您将会看到 AdGuard 的主页。现在，您可以按自己的需求更改设置。 + + +## 卸载及重新安装 AdGuard +### 常规方式 + +如您想卸载 AdGuard，请执行下述操作： + +* Microsoft Windows 10：点击**开始菜单**并选择**设置**。在弹出的视窗里点击**应用**。在左边的选项中选择**应用和功能**。 + +请在已安装的应用程序列表中选择 **Adguard** 并点击**卸载**。在弹出的对话框确认**卸载**。 + + + +* Microsoft Windows 7：打开**开始菜单**。在搜索框键入**控制面板**。请在**程序**选项点击**卸载程序**，然后请您在已安装的程序列表中选择 **AdGuard** 并在应用程序列表的上面点击**卸载**。在弹出的视窗点击**卸载 AdGuard** 以确认卸载。 + + + +* Microsoft Windows 8：在任务栏左下角的空白按右键并选择**控制面板**。在**程序**部分点击**卸载程序**。然后请您在已安装的应用程序列表中选择 **AdGuard** 并在应用程序列表的上面点击**卸载**。 在弹出的视窗再次点击**卸载 AdGuard** 以确认卸载。 + + + +* Microsoft Windows 8.1：右击**开始按钮**并选择**控制面板**。在**程序**部分点击**卸载程序**。然后请您在已安装的应用程序列表中选择 **AdGuard** 并在应用程序列表的上面点击**卸载**。 在弹出的视窗再次点击**卸载 AdGuard** 以确认卸载。 + +如果由于某些原因您无法通过常规的方式卸载应用程序，您可以尝试使用卸载的进阶方法。 + +### 卸载的进阶方法 + +首先，您要通过[该链接](https://cdn.adguard.com/public/Adguard/tools/Uninstall_Utility.zip)下载并安装我们开发人员创建的卸载软件。 + +您可以将压缩包发送到您的电脑上的任何一个文件夹里。解压后，请您开启 **Adguard_Uninstall_Utility.exe** 文件。 + +* 选择一般卸载（Standard uninstall）并点击卸载（Uninstall）。 + +![](https://cdn.adguard.com/public/Adguard/Ru/Articles/howtodelete/main_menu.png) + +* 请等待卸载完成。卸载成功完成后，在视窗里您将会看到 +
"[OK] Uninstall finished"（[好的] 卸载完成）
+ +![](https://cdn.adguard.com/public/Adguard/Ru/Articles/howtodelete/standard_uninstall.png) + +**请注意！** 下述的第三四步，只在由于某些原因上述两个步骤无法卸载 AdGuard 的情况下，才可以执行！即当您执行“一般卸载”后，还是无法重新安装 AdGuard 时。我们强烈推荐执行下述进阶卸载的第三四步前，请您先于技术支持联系。 + +* 选择进阶卸载（Advanced uninstall）并点击卸载（Uninstall ）。 + +![](https://cdn.adguard.com/public/Adguard/Ru/Articles/howtodelete/main_menu_adv.png) + +* 请等待卸载完成。卸载成功完成后，在视窗里您将会看到： +
"[OK] Uninstall finished"（[好的] 卸载完成）。
+ +![](https://cdn.adguard.com/public/Adguard/Ru/Articles/howtodelete/advanced_uninstall.png) + +AdGuard 卸载成功完成！ diff --git a/02.windows/04.solving-problems/03.adguard-logs/docs.en.md b/02.windows/04.solving-problems/03.adguard-logs/docs.en.md index 553759e7..f6be987d 100644 --- a/02.windows/04.solving-problems/03.adguard-logs/docs.en.md +++ b/02.windows/04.solving-problems/03.adguard-logs/docs.en.md @@ -34,10 +34,10 @@ For analysis and diagnostic of different problems support service might need AdG 2. Open the console (type 'cmd' in the start panel). -3. Run the app with the command C:\Program Files (x86)\Adguard\Adguard.exe /trace if you are using 64-bit Windows, and C:\Program Files\Adguard\Adguard.exe /trace in case if you use 32-bit one. +3. Run the app with the command `C:\"Program Files (x86)"\Adguard\Adguard.exe /trace` if you are using 64-bit Windows, and C:\"Program Files"\Adguard\Adguard.exe /trace in case if you use 32-bit one. 4. Select **Debug** logging level. -Don't worry if the log file is large. We need to know as much detail as possible to fix your problem. \ No newline at end of file +Don't worry if the log file is large. We need to know as much detail as possible to fix your problem. diff --git a/02.windows/04.solving-problems/03.adguard-logs/docs.ru.md b/02.windows/04.solving-problems/03.adguard-logs/docs.ru.md index 15a7479b..30e37797 100644 --- a/02.windows/04.solving-problems/03.adguard-logs/docs.ru.md +++ b/02.windows/04.solving-problems/03.adguard-logs/docs.ru.md @@ -34,7 +34,7 @@ visible: true 2. Откройте консоль (введите 'cmd' в стартовой панели). -3. Запустите приложение командой C:\Program Files (x86)\Adguard\Adguard.exe /trace (если вы используете 64-битный Windows) или C:\Program Files\Adguard\Adguard.exe /trace (если вы используете 32-битный). +3. Запустите приложение командой `C:\"Program Files (x86)"\Adguard\Adguard.exe /trace` (если вы используете 64-битный Windows) или C:\"Program Files"\Adguard\Adguard.exe /trace (если вы используете 32-битный). 4. Выберите уровень логирования **Подробный**. diff --git a/02.windows/04.solving-problems/09.common-installer-errors/docs.ru.md b/02.windows/04.solving-problems/09.common-installer-errors/docs.ru.md index 36c2dd57..d3e48a5b 100644 --- a/02.windows/04.solving-problems/09.common-installer-errors/docs.ru.md +++ b/02.windows/04.solving-problems/09.common-installer-errors/docs.ru.md @@ -20,9 +20,7 @@ visible: true ### Ошибка 5: Отказано в доступе -​ Эта ошибка возникает, когда что-то не в порядке с разрешением на доступ. Почему у установщика AdGuard нет разрешения, которое требуется для завершения установки, может объясняться рядом причин. Выполните следующие действия: -​ - Временно отключите антивирусы. Некоторые из них могут мешать установке, это зависит от степени жёсткости ваших настроек. ​ - Выберите другую папку установки – возможно, что у текущей папки есть ограничения доступа. Также удостоверьтесь, что не выбрали внешний или виртуальный жёсткий диск. @@ -32,9 +30,7 @@ visible: true ### Ошибка 112: Недостаточно места на диске, Ошибка 1632: Временная папка переполнена или к ней нет доступа -​ Две разные ошибки с очень похожими решениями. Как видно из названия, в обоих случаях установщик AdGuard не нашёл достаточно места, чтобы завершить процесс. Вот что вы можете попробовать, чтобы устранить проблему: -​ - Удалите некоторые программы или ненужные файлы с вашего диска, на который вы пытались установить AdGuard. - Загрузите, установите и запустите [AdwCleaner](http://www.bleepingcomputer.com/download/adwcleaner/), бесплатный инструмент от Malwarebytes. Помимо прочего, он очистит вашу систему от файлов, оставшихся после неправильно удалённых программ. Это освободит место на диске. @@ -43,9 +39,7 @@ visible: true ​ ### Ошибка 1601: Нет доступа к службе установки Windows -​ Можно сказать, что это частный случай Ошибки 1603. Возможные решения аналогичны: -​ - Запустите и пройдите перерегистрацию службы установщика Microsoft. На это потребуется некоторое время. ​ 1) Нажмите комбинацию клавиш **Win + R** и введите ***services.msc***. @@ -58,9 +52,7 @@ visible: true ### Ошибка 1602: Отменено пользователем -​ Если у вас этот код ошибки, весьма вероятно, что вы тем или иным способом прервали процесс установки вручную. Что вы можете сделать: -​ - Не закрывайте окно установщика. Когда установка будет завершена, оно закроется автоматически. ​ - Если во время установки всплывает диалоговое окно, нажмите «Да», чтобы предоставить установщику необходимое разрешение. Нажатие «Нет» отменит установку. @@ -69,10 +61,8 @@ visible: true ​ ### Ошибка 1603: Во время установки произошла неустранимая ошибка -​ Эта ошибка звучит страшнее, чем она есть на самом деле. На практике это довольно стандартная ошибка, которая может быть обусловлена разными причинами, и некоторые из них легко поправить. Попробуйте следующие решения: -​ -- Нажите кнопку **Win**, найдите поиском приложение **Командная строка** и запустите её. В открывшемся окне вбейте `sfc /scannow` и нажмите **Enter**. +- Нажмите кнопку **Win**, найдите поиском приложение **Командная строка** и запустите её. В открывшемся окне вбейте `sfc /scannow` и нажмите **Enter**. - Выберите другую папку установки. Возможно, что у нынешней папки есть ограничения доступа. Также удостоверьтесь, что не выбрали внешний или виртуальный жёсткий диск. @@ -102,27 +92,21 @@ visible: true ### Ошибка 1618: Уже выполняется другая установка -​ -Эта ошибка возникает, когда установщик AdGuard запущен несколько раз. Что делать: -​ +Эта ошибка возникает, когда установщик AdGuard запущен несколько раз. Что делать:​ - Перезагрузите компьютер и запустите установщик заново. Когда вы сделаете это, все текущие процессы будут остановлены, включая копии установщика. ​ - Не нажимайте на установщик несколько раз, если он не запускается сразу. Иногда отображение интерфейса может занять несколько секунд. ​ ### Ошибка 1638: Другая версия этой программы уже установлена - Очень вероятно, что вы ранее устанавливали AdGuard. -​ - Проверьте, установлен ли AdGuard у вас на компьютере. Вы можете сделать это, нажав клавишу **Win** и введя ***AdGuard***. ​ - Может быть, у вас остались файлы от предыдущей установки AdGuard. Удалите AdGuard, используя наше специальное [средство удаления](https://kb.adguard.com/ru/windows/installation#%D1%83%D0%B4%D0%B0%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8-%D0%BF%D0%B5%D1%80%D0%B5%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-adguard) и повторите установку. ​ ### Другие ошибки -​ Если вы обнаружили ошибку, которая не перечислена выше, возможно, что мы можем её решить. Но чтобы это сделать, нам нужны ваши логи (файлы журналов). Пожалуйста, выполните следующие шаги: -​ - Найдите и архивируйте **файлы журнала установки AdGuard**, как описано в [этой статье](https://kb.adguard.com/ru/windows/solving-problems/installation-logs). - Найдите и сохраните на диск логи «Просмотра событий». [Наша статья](https://kb.adguard.com/ru/windows/solving-problems/system-logs) объясняет, как это сделать. - Пожалуйста, отправьте файлы из двух предыдущих шагов на **[support@adguard.com](mailto:support@adguard.com)** и опишите проблему в тексте сообщения. Наши специалисты технической поддержки ответят вам в кратчайшее время. \ No newline at end of file diff --git a/03.macos/01.overview/01.browser-assistant/docs.en.md b/03.macos/01.overview/01.browser-assistant/docs.en.md new file mode 100644 index 00000000..c1d2957f --- /dev/null +++ b/03.macos/01.overview/01.browser-assistant/docs.en.md @@ -0,0 +1,52 @@ +--- +title: 'AdGuard Browser Assistant' +taxonomy: + category: + - docs +--- + +AdGuard Assistant’s primary function is to manage filtering directly from the browser. It has existed for quite a long time, and its form and content have changed. More precisely, it used to be a mere userscript incorporated into AdGuard for Mac app and became a full-fledged browser extension. Now it definitely yields more benefits. + +
+
+ +
+
+ +
+
+ +## Benefits +### Independence +AdGuard Browser Assistant is a browser extension, it is installed in a browser, so there is no need to wait for the userscript to be injected into the filtered web page, as it was with the preceding one. In other words, it is more autonomous from the main AdGuard app. Still, Browser Assistant needs the installed AdGuard for Mac, because there is no point in using the extension without the app. +### Compatibility with the main app +If you got into the habit of using our previous AdGuard ad blocker extension [in Integration mode](https://kb.adguard.com/en/browser-extensions/integration-mode), you may like the solution that we have developed for the new Browser Assistant. + +Background information: +> In previous versions of the AdGuard Browser Extension (before v3.5), if you had it installed along with a desktop AdGuard for Mac, the extension took over the functions of Assistant, stopped filtering itself and relied on the app to do this. + +> The extension and the app worked in conjunction but sometimes the integration would fail. Some websites would stop being protected by the desktop program and be backed up only by the less powerful extension. + +When using the Browser Assistant, all these problems don’t matter as there can be no conflicts in essence. The role of the Browser Assistant is well-defined and it can’t hinder the functioning of the main app, so there is no need to worry. + +### Smart onboarding +When AdGuard for Mac is installed for the first time, the thing a user encounters in the first place is the onboarding. During this process the user quickly learns about AdGuard's settings and can customize filtering to their liking. At one stage AdGuard will determine the user's default browser and provide them with a download link for the new Assistant. + + + +> On rare occasions, a browser may prove incompatible with the Browser Assistant, and the user will be offered to install the legacy version instead. + +## Separate tab in settings +The new Browser Assistant has its own tab in AdGuard for Mac settings, together with Stealth Mode, Browsing Security, and others. Don’t worry if you missed the opportunity to install Browser Assistant during the onboarding, you'll find this option in the app's settings. Besides, there is a checkbox to enable the legacy Assistant. + + + +## Legacy Assistant +Legacy Assistant is the previous version of Assistant, which is a mere userscript, not a browser extension. Basically, there are two cases when you might want to pick it instead of the new Browser Assistant: 1) the new Assistant is not available for your browser; 2) you are used to the green shield icon and want to leave things as they were. If you recognize yourself in any of these scenarios, then the legacy version will suit you. + +## How to install AdGuard Browser Assistant +Technically, you won’t need to do it on your own: during the onboarding process AdGuard app will determine your default browser and offer to install Browser Assistant for it. Yet, if you missed that step, you can download it yourself. + +AdGuard Browser Assistant is available for all popular browsers: Chrome, Firefox, Safari, Edge, Opera, and Yandex. To install the Browser Assistant for your default browser, you can do it directly from the app settings, but you also have an opportunity to install it for other browsers. + +To install the one you need (or many, it is not prohibited but even encouraged), go to [our website](https://adguard.com/en/adguard-assistant/overview.html), click the browser icon and tap the *Download* button. That’s it! diff --git a/03.macos/01.overview/01.browser-assistant/docs.ru.md b/03.macos/01.overview/01.browser-assistant/docs.ru.md new file mode 100644 index 00000000..f3791cc5 --- /dev/null +++ b/03.macos/01.overview/01.browser-assistant/docs.ru.md @@ -0,0 +1,54 @@ +--- +title: 'Браузерный Помощник AdGuard' +taxonomy: + category: + - docs +--- + +Главная функция Помощника AdGuard – управлять фильтрацией прямо из браузера. Он существовал довольно долго, так что его форма и содержание изменились. Раньше это был просто пользовательский скрипт, включённый в приложение AdGuard для Mac, а теперь он стал полноценным браузерным расширением. Теперь Помощник определённо приносит больше пользы. + +
+
+ +
+
+ +
+
+ +## Преимущества + +### Независимость +Браузерный Помощник AdGuard – это браузерное расширение, он устанавливается в браузер, так что не нужно ждать, пока пользовательский скрипт будет вставлен в код фильтруемой веб-страницы, как это было раньше. Другими словами, он более независим от основного приложения AdGuard. И всё же, Браузерному Помощнику нужен установленный AdGuard для Mac, потому что использовать расширение без приложения бессмысленно. + +### Совместимость с основным приложением +Если вы привыкли к использованию нашего прежнего расширения [в режиме интеграции](https://kb.adguard.com/ru/browser-extensions/integration-mode), вам может понравиться решение, которое мы разработали для нового Браузерного Помощника. + +Справочная информация: +> В предыдущих версиях браузерного расширения AdGuard (до версии 3.5), если оно было установлено у вас вместе с десктопным приложением AdGuard для Mac, расширение брало на себя функции Помощника и переставало фильтровать само, полагаясь в этом на приложение. + +> Расширение и приложение работали в связке, но иногда интеграция ломалась. Некоторые сайты прекращали фильтроваться приложением, вместо этого фильтрацию производило расширение, обладающее заметно меньшими возможностями. + +При использовании Браузерного Помощника все эти проблемы не имеют значения и никаких конфликтов быть не может в принципе. Роль Браузерного Помощника чётко определена, он не может помешать функционированию основного приложения, так что теперь не о чем беспокоиться. + +### Умная установка +Когда AdGuard для Mac устанавливается в первый раз, первое, с чем сталкивается пользователь, – это установка. В ходе этого процесса пользователь быстро узнает о настройках AdGuard и может настроить фильтрацию, как ему нравится. На определённом этапе AdGuard определит браузер пользователя по умолчанию и предоставит ссылку для загрузки нового Помощника. + + + +> В редких случаях браузер может оказаться несовместимым с Браузерным Помощником, и вместо него пользователю предложат установить [легаси-версию](#legacy-assistant). + +## Отдельная вкладка в настройках +У нового Браузерного Помощника есть своя вкладка в настройках AdGuard для Mac, наряду с Антитрекингом, Антифишингом и другими. Не волнуйтесь, если пропустили шаг со скачиванием Браузерного Помощника во время установки, вы найдёте эту опцию в настройках приложения. Кроме того, там можно установить флажок для включения прежней версии Помощника. + + + +## Прежняя версия Помощника +Легаси – это предыдущая версия Помощника, который по сути был пользовательским скриптом, а не браузерным расширением. В основном, есть два случая, когда вы можете предпочесть её новому Браузерному Помощнику: 1) новый Помощник недоступен для вашего браузера; 2) вы привыкли к иконке с зелёным щитом и хотите оставить всё как было. Если вы узнали себя в одном из этих сценариев, тогда легаси-версия вам подходит. + +## Как установить Браузерный Помощник AdGuard +Технически, вам не нужно делать это самостоятельно: во время установки приложение AdGuard определит ваш браузер по умолчанию и предложит установить Браузерный Помощник для него. Но если вы пропустили этот шаг, то можете скачать его самостоятельно. + +Если вы хотите установить Браузерный Помощник для браузера по умолчанию, то можете сделать это напрямую из настроек приложения, но также у вас есть возможность установить Помощник для других браузеров. + +Браузерный Помощник AdGuard доступен для всех популярных браузеров: Chrome, Firefox, Safari, Edge, Opera, и Яндекс.Браузера. Чтобы установить Помощник (или несколько для разных браузеров, это не запрещено, а даже приветствуется), перейдите на [наш сайт](https://adguard.com/ru/adguard-assistant/overview.html), кликните на иконку браузера и нажмите кнопку *«Скачать»*. Вот и всё! \ No newline at end of file diff --git a/03.macos/01.overview/docs.en.md b/03.macos/01.overview/docs.en.md index ae4b0e30..5b6e8f29 100644 --- a/03.macos/01.overview/docs.en.md +++ b/03.macos/01.overview/docs.en.md @@ -1,24 +1,178 @@ --- -title: Overview +title: Features overview taxonomy: category: - docs +visible: true --- -Modern users spend a lot of time on the Internet, and Apple device owners are no exception. The macOS developers did everything to make Mac users comfortable working with their products. However, the operating system still isn’t capable of protecting them from annoying ads, while the blockers currently available on the market can’t filter all types of advertising – for instance, block commercial videos on YouTube or other similar services. +[Home panel](#home-panel) +[General preferences](#general) +[Filters](#filters) +[User rules](#user-rules) +[Stealth Mode](#stealth-mode) +[Browsing Security](#browsing-security) +[Browser Assistant](#browser-assistant) +[Extensions](#extensions) +[Network Filtering](#network-filtering) +[Others](#others) + - [License Management](#license-management) + - [Support](#support) + - [Updates check](#updates-check) -AdGuard for macOS is a unique app made particularly for blocking ads, protecting users from phishing and personal data gathering on the Internet, that takes cue from macOS architecture. AdGuard can work with Safari as well as with any other compatible browser. Apart from video ads and banners, AdGuard for macOS is able to filter other annoying website elements, such as contact forms, online consultation modules, etc. Moreover, AdGuard is able to block ads in various macOS applications without interfering with their work. This app doesn’t need to be specifically adjusted – your Mac will be protected by AdGuard right after you install it. +AdGuard for Mac, as one of our main staples, merits a full how-to guide. We decided to help new users out and to highlight some finer, but less obvious points that even seasoned AdGuard for Mac fans might have been missing. -Content is filtered on the local computer before web pages are loaded onto the browser screen. This allows for significant traffic use decrease, and pages will load much faster without unnecessary elements. This AdGuard version has been specifically developed for Apple computers, and it is fully compatible with all macOS versions starting with macOS X 10.10 x64. It doesn’t matter which browser you use – AdGuard works perfectly with Safari, Google Chrome, Opera, Firefox, or any other page-viewing app compatible with macOS. +AdGuard for Mac is a standalone ad blocker program for macOS computers. While AdGuard for Safari browser extension is [limited in ad blocking capabilities](https://adguard.com/en/blog/youtube-ads-in-safari-explained.html) due to Safari Content Blocking, AdGuard for Mac software is full-fledged and can offer more to its users. Let us walk you through the main features. -AdGuard for macOS utilizes a set of filters to block ads. Flexible adjustment is available to block select elements on certain pages or exclude some sites from filtering lists. The filters are updated automatically, and are always up-to-date. + +## Home panel -Apart from filtering ads, AdGuard for macOS protects its users from potential malware, spyware, and phishing websites. + + +The first thing you see upon startup will be a screen with a big On/Off toggle. Below are shown various stats (ads blocked, trackers blocked, data saved) since the installation or since the last stats reset. + +To start configuring AdGuard for Mac, you need to tap the gear in the upper right corner of the window and select “Preferences”. ->Phishing is a common web fraud aimed at stealing your personal data (passwords, bank account details, etc.). It is carried out using fake web pages mimicking popular websites or real services, such as web stores or social networks. + +## General Preferences -A special module, Browsing Security, protects AdGuard for macOS users from this type of fraud and warns them of attempts at redirection to potentially malicious websites. + -Many websites gather information about their visitors, such as their IP addresses, browser and operating system information, screen resolution, etc. A site can mark your browser with cookies to gather your statistics, save your settings, or automatically identify you upon repeat visit. Spyware Filter by AdGuard for macOS protects your personal data and private information from such statistics gathering systems. Spyware Filter will not allow anyone to track your web activity. +Descriptions under option titles seem self-explanatory, but still: -To learn more about the work, capabilities, and settings of different AdGuard for macOS modules, check out our Database. +**Activate language-specific filters automatically** +Enabling this option, you won't have to manually choose all the filters when visiting a foreign website, saving you some time. + +**Launch AdGuard at login** +A simple and convenient feature with with which you don't have to worry whether or not you have your ad blocker turned on, and just be sure that ads are always blocked. + +**Do not block search ads and websites' self-promotion** +This option might be useful to online shoppers: instead of whitelisting all your favourite e-shops and sites, you can simply exclude [self-promos and search ads](https://kb.adguard.com/en/general/search-ads-and-self-promotion) from filtering. AdGuard will automatically detect those and let them be, while removing everything else ad-like. + +**Hide menu bar icon** +If you don't want to see the menu bar icon, there is an option to hide it. But don't worry: even if you remove it from the menu bar, AdGuard will continue to run in the background. + +From this same window you can access the above mentioned Whitelist, to which you can add websites you do not wish AdGuard to filter. Just tap the corresponding button located at the bottom of the window. + + +## Filters + + + +Filters are the main driving force behind the Ad blocker module. To understand how filtering works, get acquainted with our [comprehensive article](https://adguard.com/en/blog/how-ad-blocking-is-done.html). But in essence, filter lists are sets of rules written in a special language, and your ad blocker is an interpreter of these rules who then implements them. As a result, you stop seeing ads on your webpages and life gets lots better. + +Some filter lists (AdGuard’s Base filter, Annoyances filter, EasyList etc) are pre-installed, while other specific ones, adapted to your preferences, can be downloaded additionally and added to your program. + +Aside from the more general and universally applicable filters (like Base filter), AdGuard provides an extensive quantity of filters for every occasion: +* filters aimed at tracking prevention (like Tracking Protection filter), +* language-specific ad filters that block content in a selected language, +* Social media filter (bye-bye, “Like” and “Share” buttons), +* Annoyances filter for cookie warnings, in-page pop-ups and others of the same ilk; +* and even a filter that unblocks some ads instead of blocking them — Filter for search ads and self-promotions. + +AdGuard filters are automatically updated. Our developers create them all based on user feedback received. You can always help other AdGuard users (and yourself, in perspective) by sending us reports right from the app's Assistant (it's really handy, we'll tell you more about the Assistant further on), or from the [website](https://agrd.io/report). If you wish to know more about AdGuard filters, here is [some info](https://kb.adguard.com/en/general/adguard-ad-filters). + + +## User rules + + + +Another vital part of the Ad Blocker module are its User rules. If you have some coding experience and would like to create your own rules that would be a better custom fit than the standard filters already available, then you can try your hand at this. The syntax AdGuard uses for its filtering rules is based on that of any other ad blocking extension, but with considerable additions, extending its possibilities. The whole process of rule-writing in all its nuances is described in these comprehensive instructions, so if you want to write some custom rules and check how much of a coder you are, just follow the steps we described [in this article](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters). + + +## Stealth Mode + + + +This module is a very useful tool that will help you maintain your privacy from websites that try to retain such info about you as your IP address, computer parameters, browser settings and even the initial page from which you were redirected, not to mention cart contents if we speak of web stores. If this list of info potentially to be shared with shady third parties doesn't make you think twice, then might we add that in most cases they will also get such personal data as your age, yearly income, medical history, physical adress and your kids' names. Eliminating such things as unwanted cookies or clandestine insertion of tracking parameters into your browser is what Stealth Mode does best. + +Stealth Mode contains a wide range of options, which ensure its flexible configuration. They are divided into several categories, and for an unprepared user many of them will seem confusing and maybe even complicated. We provided each option with a hint to make up for the deficiency — hints appear when you hover over the icon with a question mark. If you still wish to know more about the whole concept, we encourage you to proceed to [this article](https://kb.adguard.com/en/general/stealth-mode). + + +## Browsing Security + + + +Next we have the Security panel, where a module also known as Browsing Security is located. What it does is protection from malware and phishing websites. + +> Note that AdGuard is not an antivirus, but an entirely different program. It will show you a warning if you are about to go onto an infected domain, but it cannot stop you from downloading anything suspicious or help you deal with already existing viruses. + +Phishing is a very common web fraud aimed at stealing personal data (passwords, bank account details, etc.). It is carried out using fake web pages mimicking popular websites or real services, such as web stores or social networks. Many phishing websites have URLs that only differ from the real ones in just a few symbols to put you off your guard. If a user enters their details on such a website, they’ll definitely end up in the wrong hands. + +Browsing Security gives strong protection against such incidents. At the same time, the user’s personal information is not transferred anywhere, and AdGuard servers do not know which websites the user is visiting, because the security check is not performed via open web address (URL) but through hash prefixes (hash is a certain data structure that renders each address added to the base unambiguous). + +Some web pages are not malicious themselves, but they may contain elements built into their structure by other websites. Unlike browser plug-ins, Browsing Security module checks each object built into any web page, ensuring maximum protection. + +If you wish to help us in perfecting this module, you can check the lower box on the panel near the "Help us with Browsing Security filters development" phrase. This will enable your computer to send us pertinent info on fraudulent websites you might stumble upon while surfing the web — and our developers will make sure they end up locked at the bottom of your ban list. + + +## Browser Assistant + + + +AdGuard Browser Assistant’s primary function is to manage filtering directly from the browser. It used to be a mere userscript incorporated into AdGuard for Mac app that then became a full-fledged browser extension. Know more about the [benefits it yields](https://kb.adguard.com/en/macos/overview/browser-assistant). + + + +You will be prompted to install the Browser Assistant for your default browser when you first install AdGuard (during the onboarding process). If you missed it, you can [download it for any browser](https://adguard.com/en/adguard-assistant/overview.html) at any time. + + +## Extensions + + + +Extensions are small programs that do exactly what their name implies — they extend functionality. And AdGuard uses several extensions of its own, also called userscripts, to broaden its functions range: + +**1. AdGuard Assistant** (legacy version) +This extension assists the user in changing basic AdGuard settings within the browser, without the need to open the app itself. Like Browser Assistant, legacy Assistant works with all macOS compatible browsers. Thanks to this little tool you can do several things without having to leave the browser: add a certain webpage to the “do not block” list, choose and block an especially annoying element on the page, report the website if it still manages to get ads through to you. + +> Note that this version of Assistant is legacy and there is no point in using it on new systems, since it has been replaced with the full-fledged Browser Assistant. But legacy Assistant might be of help if there is no Browser Assistant extension for your browser. + +**2. AdGuard Extra** +This extension is used to solve the more complicated ad blocking cases you might encounter. We would recommend you to always keep it switched on, unless you have a serious reason not to. + +**3. AdGuard Popup Blocker** +Prevents all these annoying popup windows from opening when you view webpages. Blocks popup ads on web pages. + +One of the important features of AdGuard for Mac is that the application can work as a cross-browser userscript manager. You can easily add any scripts you like and manage existing ones without having to switch browsers every time. + + +## Network Filtering + + + +This last panel is dedicated to Network filtering, and you will find extra functionalities here. We do recommend to enable the first two ones: "Automatically filter applications" and "Filter HTTPS protocol". Those are an important added precaution to better filter your web space. HTTP is the primary protocol for transmitting information over the Internet. Most data including ads is transferred via it, but it has one disadvantage — the connection is unencrypted. Thanks to the HTTPS filtering feature AdGuard has, not only HTTP traffic is filtered, but also HTTPS traffic (S stands for ‘secure’). + +There are also the options of "Do not filter websites with EV certificates" and "Use AdGuard as an HTTP Proxy". Extended Validation (EV) SSL Certificates offer a stronger safety guarantee; owners of such websites have to pass a thorough and globally standardised identity verification process defined by EV guidelines. Which is the reason why some users trust websites with such certificates and prefer not to filter them. + +As for the second option — well, yes, in fact you can use AdGuard as a regular HTTP proxy server. All traffic coming through it will be filtered. This proxy will also be available on your local network, so you may use it for traffic filtering on other devices that are able to reach the proxy directly. To filter traffic on another device connected to proxy you will need to install an AdGuard root certificate there. After you configure proxy, open your browser and go to [this page](http://local.adguard.org/cert). + + +## Others + +There are other useful AdGuard options that shouldn't go unnoticed in this article, since they add much to user experience. + + +### License management + +First, there's the License management tab which you can open from the dropdown main menu (the one that opens once you click on the gear icon on the upper right of the main window). From this tab you can see which license type you are using, check its status and validity period. + + + +In this same tab you can refresh your license status, renew your license or reset the license key using the corresponding buttons. + + +### Support + +Click on the gear in the upper right corner, select "Support", and you will be able to send a Bug Report, Feature request, or any other type of message to our Technical Support team. Be sure to add your real actual email though, because without it the message won't be sent. + + + +To report a missed ad or a broken website, please follow the link above the message window, we use a separate reporting tool for those types of issues. + +It is possible to attach a diagnostic report to your message, you only need to check the box in the lower part of the tab. + + +### Updates check + +Last but not least. You can check for filter and program updates by simply clicking on the corresponding menu options in the dropdown menu (tap on the gear icon, and you'll see it). \ No newline at end of file diff --git a/03.macos/01.overview/docs.ru.md b/03.macos/01.overview/docs.ru.md index 64b8d7c1..771c6f78 100644 --- a/03.macos/01.overview/docs.ru.md +++ b/03.macos/01.overview/docs.ru.md @@ -1,26 +1,175 @@ --- -title: Обзор +title: Обзор функций taxonomy: category: - docs +visible: true --- -Современные пользователи компьютеров и ноутбуков проводят в Интернете много времени, и владельцы устройств Apple — не исключение. Создатели macOS постарались сделать все возможное, чтобы работа в сети стала для пользователей «маков» максимально комфортной, однако операционная система все же не в состоянии защитить их от надоедливой рекламы. Существующие сегодня блокировщики не могут отфильтровать все виды рекламного контента, например, удалить видеовставки, демонстрируемые при просмотре роликов на YouTube и в других аналогичных сервисах. +[Главный экран](#home-panel) +[Общие настройки](#general) +[Фильтры](#filters) +[Пользовательские правила](#user-rules) +[Антитрекинг](#stealth-mode) +[Безопасность](#browsing-security) +[Браузерный Помощник](#browser-assistant) +[Расширения](#extensions) +[Сетевая фильтрация](#network-filtering) +[Другое](#others) + - [Управление лицензией](#license-management) + - [Поддержка](#support) + - [Проверка обновлений](#updates-check) -AdGuard для macOS — это уникальное приложение, предназначенное для блокировки рекламы, защиты пользователей от фишинга и от сбора личных данных в Интернете, которое учитывает все особенности программной архитектуры macOS. AdGuard работает не только с Safari, но и с любыми другими браузерами, совместимыми с этой операционной системой. Помимо видеорекламы и встроенных в веб-страницы баннеров, AdGuard для macOS блокирует всплывающие окна и другие раздражающие элементы сайтов — формы обратной связи, модули он-лайн консультаций, и т.д. Кроме того, AdGuard может удалять рекламу в различных приложениях для macOS, не нарушая их работу. Это приложение практически не требует настройки: сразу после его установки на вашем «маке» начинает действовать надежная защита AdGuard. +AdGuard для Mac, как один из наших флагманских продуктов, заслуживает полноценного практического руководства. Оно поможет новым пользователям разобраться и обратить внимание на другие, менее очевидные особенности, которые могли пропустить даже давние поклонники нашего блокировщика для Mac. -Фильтрация контента осуществляется непосредственно на локальном компьютере, до загрузки веб-страниц в окно браузера. Это позволяет заметно экономить трафик, и кроме того, без лишних элементов веб-страницы будут открываться намного быстрее. Поскольку эта редакция AdGuard была специально разработана для компьютеров Apple, она полностью совместима со всеми версиями операционной системы, начиная с 64-разрядной macOS 10.10. Неважно, какой именно браузер вы используете на своем «маке», AdGuard прекрасно работает с Safari, Google Chrome, Opera, Firefox и любым другим приложением для просмотра веб-страниц, которое можно установить в macOS. +AdGuard для Mac — это независимый блокировщик рекламы для macOS. В отличие от браузерного расширения AdGuard для Safari [с ограниченным Safari Content Blocking функционалом](https://adguard.com/ru/blog/youtube-ads-in-safari-explained.html), десктопная программа полноценная и обладает большими возможностями. Давайте посмотрим, какие в ней есть функции. -AdGuard для macOS блокирует рекламу, используя специальный набор фильтров. Вы можете гибко настраивать правила блокировки, запретив отображение каких-либо отдельных элементов на определенных веб-страницах, или исключив избранные сайты из списков фильтрации. Фильтры обновляются автоматически и потому всегда поддерживаются в актуальном состоянии. + +## Главный экран -Помимо удаления рекламы, AdGuard для macOS защищает своих пользователей от потенциально опасных, вредоносных и мошеннических (фишинговых) сайтов. + + +Первое, что вы увидите после запуска, — это экран с переключателем вкл/выкл. На нём выводится статистика (количество заблокированных рекламных баннеров, трекеров и угроз, сэкономленного трафика), считая с момента установки и запуска последнего сброса статистики. ->Фишинг (Phishing) — технология сетевого мошенничества, целью которого является кража личных данных (паролей доступа, реквизитов банковских карт и т. д.). Для этого используются поддельные веб-страницы, имитирующие оформление популярных сайтов или реально существующих сетевых сервисов (интернет-магазинов, социальных сетей и т.д.). +Чтобы настроить AdGuard для Mac, нажмите на шестерёнку в верхнем правом углу и выберите «Настройки». + + +## Общие настройки + -Специальный модуль — Антифишинг — надежно защищает пользователей AdGuard для macOS от этого вида мошенничества, а также предупреждает их при попытке перейти на потенциально опасный сайт. +Описания опций на скриншоте могут показаться достаточными, но давайте всё же кратко рассмотрим их ниже. -В Интернете существует множество сайтов, собирающих сведения о своих посетителях, включая их IP-адрес и информацию о текущем местоположении, о версии браузера, операционной системы, об установленном экранном разрешении, и многую другую. С помощью специальных файлов cookies сайт может «пометить» ваш браузер с целью сбора статистики, сохранения ваших настроек или автоматической аутентификации при повторном посещении. Специальный модуль AdGuard для macOS — Антитрекинг — защищает ваши личные данные и конфиденциальную информацию от различных систем сбора статистики. Антитрекинг никому не позволит следить за вашими действиями в Интернете. +**Автоматически включать подходящие языковые фильтры** +Если эта опция выбрана, вам не придётся вручную искать и включать языковые фильтры при посещении сайта нв иностранном языке, AdGuard сделает это сам, сэкономив вам немного времени. -Чтобы узнать более подробную информацию о принципах работы, возможностях и настройках различных модулей AdGuard для macOS, обратитесь к соответствующему разделу нашей Базы знаний. +**Запускать AdGuard при старте системы** +Простая и удобная функция, с которой вам не нужно думать о том, включили ли вы блокировщик, и просто быть уверенными, что реклама всегда блокируется. +**Не блокировать поисковую рекламу и саморекламу сайтов** +Эта возможность будет полезна тем, кто делает покупки онлайн: вы можете разблокировать поисковую рекламу и саморекламу любимых сайтов (читайте о ней [здесь](https://kb.adguard.com/ru/general/search-ads-and-self-promotion)). AdGuard автоматически распознает её и оставит, а всё остальное, похожее на рекламу, удалит. + +**Скрыть иконку меню** +Если по какой-то причине вы захотите убрать иконку из панели меню, это можно сделать, поставив галочку в соответствующем поле. Но не волнуйтесь: даже если её спрятать, AdGuard продолжит работать в фоновом режиме. + +Из окна Общих настроек вы можете получить доступ к упомянутому выше белому списку и добавить в него сайты, которые AdGuard не будет фильтровать. Просто нажмите на соответствующую кнопку, расположенную внизу окна. + +## Фильтры + + + +Следующим идёт экран фильтров. Фильтры — основная движущая сила модуля блокировки. Чтобы понять, как работает фильтрация, на которой построена работа большинства блокировщиков, ознакомьтесь с [этой исчерпывающей статьёй](https://adguard.com/ru/blog/how-ad-blocking-is-done.html). Но если коротко, фильтры — это наборы правил, написанных на специальном языке. Блокировщик рекламы интерпретирует эти правила, а затем реализует их. В результате вы перестаёте видеть рекламу на веб-страницах, и жизнь становится намного лучше. + +Некоторые фильтры (Базовый фильтр AdGuard, Фильтр раздражителей, EasyList и т. д.) предустановлены, а другие можно добавить дополнительно. + +Помимо более общих и универсально применимых фильтров (таких как Базовый фильтр), у AdGuard в арсенале огромное количество фильтров для любого случая: +* фильтры, направленные исключительно на борьбу с отслеживанием (например, фильтр счётчиков и систем аналитики), +* языковые рекламные фильтры, блокирующие контент на выбранном языке, +* фильтры социальных сетей, убирающие кнопки «Мне нравится» и «Поделиться»), +* фильтры раздражителей, скрывающие предупреждения о cookies, всплывающие окна и другие подобные элементы; +* и даже фильтр, который разблокирует некоторые объявления, а не блокирует их — фильтр для поисковой рекламы и саморекламы. + +Фильтры автоматически обновляются с серверов AdGuard. Наши разработчики создают и дополняют их на основе полученных отзывов пользователей. Вы всегда можете помочь другим пользователям AdGuard и в конечном счёте себе тоже, отправив отчёт прямо из приложения Помощника (это очень удобно, позже мы расскажем о нём подробнее) или с [сайта](https://agrd.io/report). Если вы хотите разобраться в фильтрах AdGuard, вот [основная информация](https://kb.adguard.com/ru/general/adguard-ad-filters), которую мы рекомендуем изучить. + + +## Пользовательские правила + +Ещё одна жизненно важная часть модуля блокировки рекламы — пользовательские правила. Если вы хотите создать свои собственные правила, которые бы лучше соответствовали вашим потребностям, чем стандартные фильтры, можете попробовать в этом свои силы. AdGuard использует для своих правил фильтрации синтаксис, похожий на синтаксис другого блокировщика рекламы, но с дополнениями, существенно расширяющими его возможности. Весь процесс написания правил можно найти в подробных инструкциях, поэтому, если вы хотите освоить синтаксис и научиться создавать свои правила, начните [с этой статьи](https://kb.adguard.com/ru/general/how-to-create-your-own-ad-filters). + + +## Антитрекинг + + + +Этот модуль – очень полезный инструмент. Он поможет вам сохранить конфиденциальность на сайтах, которые пытаются получить ваши данные: IP-адрес, параметры компьютера, настройки браузера и даже страницу, с которой вы были перенаправлены, не упоминая о содержимом корзины, если говорить об интернет-магазинах. Если этот внушительный перечень информации, которой потенциально могут поделиться с третьими лицами, не заставляет вас подумать дважды, добавим, что многие также узнают о вас такую сугубо личную информацию, как ваш возраст, годовой доход, история болезни, фактический адрес и имена детей. Довольно личные вещи, не правда ли? Устранение нежелательных файлов cookies или тайно добавленных в ваш браузер параметров отслеживания – вот, что Антитрекинг умеет лучше всего. + +Антитрекинг содержит широкий выбор опций, которые обеспечивают его гибкую настройку. Они разделены на несколько категорий, и для неподготовленного пользователя многие покажутся запутанными и, возможно, даже сложными. Мы снабдили каждую опцию подсказкой — под каждой из них вы найдёте небольшое описание серым цветом. Если вы хотите узнать больше об Антитрекинге, рекомендуем почитать о нём [в отдельной статье](https://kb.adguard.com/ru/general/stealth-mode). + + +## Безопасность + + + +Следующим идёт окно «Безопасность». Здесь можно включить защиту от фишинга и вредоносных программ. + +> Но имейте в виду, что AdGuard – это не антивирус, а совершенно другая программа. Он предупредит вас, если вы попадёте на заражённый домен, но не остановит вас от скачивания чего-то подозрительного и не поможет избавиться от уже существующего вируса. + +Фишинг — это очень распространённый вид веб-мошенничества, направленный на кражу персональных данных (паролей, реквизитов банковских счетов и т. д.). В нём используются поддельные веб-страницы, имитирующие популярные вебсайты или сервисы, как, например, интернет-магазины или социальные сети. У многих фишинговых сайтов есть URL-адреса, которые отличаются от реальных всего несколькими символами, чтобы сбить вас с толку. Если пользователь введёт свои данные на таком сайте, они окажутся в чужих руках. + +Модуль безопасности защитит вас от таких инцидентов. При этом персональная информация никуда не передаётся и серверы AdGuard не знают, какие сайты посещает пользователь, поскольку проверка безопасности осуществляется не через открытый веб-адрес (URL), а через префиксы хэшей (хэш — это определенная структура данных, которая проверяет каждый добавленный в базу адрес). + +Некоторые страницы сами по себе не несут вред, но могут содержать элементы, встроенные в их структуру другимисайтами. В отличие от плагинов браузера, модуль безопасности проверяет каждый объект, встроенный в страницу, обеспечивая максимальную защиту. + +Если вы хотите помочь нам в совершенствовании этого модуля, можете поставить галочку рядом с фразой «Помогите нам в развитии фильтров антифишинга». Тогда с вашего компьютера будет отправляться информация о мошеннических сайтах, на которые вы можете наткнуться в интернете, и наши разработчики удостоверятся, что они окажутся заблокированными. + + +## Браузерный Помощник + + + +Основная функция Браузерного Помощника – это управление фильтрацией прямо из браузера. Раньше он был обычным пользовательским скриптом, встроенным в AdGuard for Mac, а потом превратился в полноценное браузерное расширение. + + + +При первой установке AdGuard вам предложат установить Браузерный Помощник для браузера по умолчанию. Если вы пропустили этот шаг, можно [скачать его для любого браузера](https://adguard.com/ru/adguard-assistant/overview.html) в любое время. + + +## Расширения + + + +Расширения — это небольшие программы, которые делают именно то, что подразумевает их название: расширяют функциональность. AdGuard использует несколько собственных расширений, также называемых пользовательскими скриптами, чтобы расширить диапазон своих функций: + +**1. Помощник AdGuard** (старая версия) +Мы дали расширению такое название намеренно: оно помогает пользователю изменить базовые настройки AdGuard внутри браузера без необходимости открывать приложение. Помощник AdGuard работает со всеми браузерами, совместимыми с macOS. Благодаря этому маленькому инструменту вы можете делать в браузере много вещей: добавлять веб-страницу в белый список, убирать раздражающие элементы на страницах, отправлять жалобы на сайт, например, в случае пропущенной рекламы. + +> Обратите внимание, что это устаревшая версия Помощника и нет смысла использовать её на новых системах, потому что её давно заменил Браузерный Помощник. Но старый Помощник может пригодиться, если для вашего браузера нет расширения Браузерного Помощника. + +**2. AdGuard Extra** +Это расширение используется, чтобы решать более сложные случаи блокировки рекламы, с которыми вы могли столкнуться. + +**3. Блокировщик всплывающей рекламы AdGuard** +Не даёт раздражающим всплывающим окнам маячить у вас перед глазами, когда вы открываете веб-страницы. + +Одна из важных особенностей AdGuard для Mac — приложение может работать как менеджер пользовательских скриптов для различных браузеров. Вы можете легко добавлять любые скрипты и управлять существующими без необходимости каждый раз переключать браузер. + + +## Сетевая фильтрация + + + +Фильтрации сети посвящено последнее окно, на нём вы найдёте расширенные функции. Рекомендуем держать включенными первые две опции: «Автоматически фильтровать трафик приложений» и «Фильтровать HTTPS-протокол» — по сути это основная защита для вашего интернета. HTTP и HTTPS — это протоколы передачи информации через интернет. Благодаря функции «Фильтровать HTTPS-протокол», фильтруется не только HTTP-трафик, у которого не зашифровано соединение, но и HTTPS-трафик (где S означает secure, то есть "безопасный"). + +Также есть опции «Не фильтровать сайты с EV-сертификатами» и «Использовать AdGuard как HTTP-прокси». EV-сертификаты (от агнл. Extended Validation – «расширенная валидация») дают более надёжную гарантию; владельцы таких сайтов должны пройти подробный и всемирно стандартизированный процесс проверки личности, определённый руководящими принципами EV. Именно поэтому некоторые пользователи доверяют сайтам с такими сертификатами и предпочитают не фильтровать их. + +Что касается второго варианта — да, фактически вы можете использовать AdGuard в качестве обычного прокси-сервера. Весь трафик, проходящий через него, будет отфильтрован. Этот прокси-сервер также будет доступен в локальной сети, поэтому вы можете использовать его для фильтрации трафика на других устройствах, которые могут напрямую связаться с прокси-сервером. Для фильтрации трафика на другом устройстве, подключенном к прокси, вам потребуется установить корневой сертификат AdGuard. После настройки прокси откройте браузер и перейдите на [эту страницу](http://local.adguard.org/cert). + + +## Другое + +У AdGuard есть другие полезные функции, которые не могут остаться незамеченными, поскольку благодаря им пользоваться программой значительно удобнее. + + +### Управление лицензией + +Вкладку Лицензия можно найти в выпадающем меню (которое открывается, если нажать на иконку шестерёнки в правом верхнем углу главного экрана). Здесь вы можете увидеть, какой тип лицензии используете, проверить её статус и срок действия. + + + +На этой же вкладке вы можете обновить статус лицензии, её саму или сбросить лицензионный ключ. + + +### Поддержка + +Если у вас возник вопрос или вы столкнулись с проблемой, нажмите на шестерёнку в верхнем правом углу и выберите «Поддержка». Вы сможете отправить нашей команде техподдержки отчёт об ошибке, запрос на реализацию функции или другое сообщение. Не забудьте добавить ваш действующий адрес электронной почты, потому что без него сообщение не будет отправлено. + + + +Чтобы сообщить о пропущенной рекламе или сломанном сайте, перейдите по ссылке над окном сообщения, мы используем отдельный инструмент отчётности для этой категории вопросов. + +Если возможно, прикрепите к сообщению отчёт о результатах диагностики. Для этого нужно поставить галочку в нижней части вкладки. + + +### Проверка обновлений + +И последнее, но не менее важное — вы можете проверить обновления фильтров и самой программы, просто нажав на соответствующие пункты в выпадающем меню (кликните на иконку шестерёнки, и вы их увидите). \ No newline at end of file diff --git a/03.macos/02.installation/docs.ja.md b/03.macos/02.installation/docs.ja.md new file mode 100644 index 00000000..6f9d97c3 --- /dev/null +++ b/03.macos/02.installation/docs.ja.md @@ -0,0 +1,101 @@ +--- +title: ‘インストール/アンインストール’ +taxonomy: + category: + - docs +--- +* [動作環境](#system-requirements) +* [インストール方法](#installation) +* [アンインストール方法](#uninstall) + * [アドバンスド・アンインストール](#uninstall-advanced) + + +## 動作環境 + +**OSバージョン:** macOS 10.12 (64 bit) 以上 + +**RAM:** 2 GB以上 + +**対応ブラウザ:** Safari, Google Chrome, Opera, Yandex.Browser, Mozilla Firefox, およびその他のmacOSと互換性のあるブラウザ + +**空きディスク容量:** 120 MB + + +## AdGuard for Macのインストール方法 + +AdGuard for Macをインストールするには、ブラウザで [adguard.com](http://adguard.com) を開き、「**ダウンロード**」ボタンを押してください。 + + + +「**AdguardInstaller.dmg**」がダウンロード完了したら、クリックします。（Finderから開くこともできます。） + + + +表示されたインストールアプリでAdGuardアイコンをダブルクリックしてください。 + + + +AdGuard初インストールの際に、OSからの警告が表示されますので、「**開く**」を押してください。 + + + +次に、「**インストール**」を押してください。 + + + +インストーラが必要なファイルをダウンロード完了するのをお待ちください。 + + + +AdGuardアプリを使用するにはmacOS管理者アカウントのパスワードが必要になります。パスワードを入力して「**OK**」を押してください。 + + + +次に、自分に合わせて設定を簡単にカスタマイズできるチュートリアル画面表示されます。「はじめる」を押して微調整を開始するか、「スキップ」を押して今はスキップすることができます。 + + + +これで、お使いのMacへのAdGuardインストールは完了です！ + + +## アンインストール + +### レギュラー +まず、Finderを開いてください。 + +![](https://cdn.adguard.com/public/Adguard/En/Articles/howtodelete/finder.png) + +「アプリケーション」→「AdGuard」アイコンを右クリック→「こみ箱に入れる」 + + + +レギュラーアンインストール完了です。 + + +### アドバンスド + +**※この手順は、技術的なことが分かる場合、またはAdGuardサポートに「アドバンスドアンインストール」を推奨された場合にのみ使用してください。また、先に「レギュラーアンインストール」の手順をすべて行ってください。** + +その後、以下の手順を行ってください。 + +* 以下のAdGuardファイルを削除してください: + * */Library/Application Support/com.adguard.mac.adguard* (folder) + * *~/Library/Application Support/com.adguard.mac.adguard* (folder) + * *~/Library/Preferences/com.adguard.mac.adguard.plist* (file) + +**これらを削除するには**、Terminalアプリを開き、以下のコマンドを入力して実行してください: + +`sudo rm -R "/Library/Application Support/com.adguard.mac.adguard"` +`rm -R "~/Library/Application Support/com.adguard.mac.adguard"` +`rm ~/Library/Preferences/com.adguard.mac.adguard.plist` + +* 「アクティビティモニタ」アプリを起動する +* 検索ツールを使用して「**cfprefsd**」プロセスを見つける + + + +* ユーザーで実行されているプロセス（ルートで実行されているものではないほう）を停止します。そうするにはプロセスをクリックして、左上の「X」をクリックしてください。表示されたダイアログで確認してください。 + + + +AdGuardアドバンスドアンインストール完了です。 diff --git a/03.macos/02.installation/docs.ko.md b/03.macos/02.installation/docs.ko.md new file mode 100644 index 00000000..cadf2734 --- /dev/null +++ b/03.macos/02.installation/docs.ko.md @@ -0,0 +1,118 @@ +--- +title: '설치 방법/ 제거 방법' +taxonomy: + category: + - docs +--- +* [시스템 요구 사항](#system-requirements) +* [설치 방법](#installation) +* [제거 방법](#uninstall) + * [고급 제거 방법](#uninstall-advanced) + + +## 시스템 요구 사항 + +**운영 체제 버전:** macOS 10.12 (64 비트) 이상 + +**RAM:** 2 GB 이상 + +**브라우저:** Safari, Google Chrome, Opera, Yandex.Browser, Mozilla Firefox 및 기타 macOS 호환 브라우저 + +**디스크 여유 공간:** 120 Mbytes + + + +## 설치 방법 + +컴퓨터에 Mac용 AdGuard를 설치하려면 브라우저를 열고 주소 표시 줄에 _adguard.com_ 을 입력한 후 열리는 페이지에서 **다운로드**를 누릅니다. + + + +_AdguardInstaller.dmg_ 가 다운로드될 때까지 기다렸다가 Dock 패널에 다운로드된 파일 목록에서 해당 아이콘을 두 번 클릭합니다. + + + +바탕 화면에 AdGuard 아이콘이 표시될 것입니다. 설치 앱을 열려면 아이콘을 클릭합니다. 다음 열린 설치 창에서 AdGuard 아이콘을 두 번 클릭합니다. + +AdGuard가 처음 시작되면 운영 체제에서 이 프로그램이 인터넷에서 다운로드되었음을 경고합니다. **열기**를 클릭합니다. + + + + +다음에 **Install**를 클릭합니다. + + + + +설치 프로그램이 필요한 파일을 다운로드할 때까지 기다립니다. + + + + +프로그램을 사용하시려면 macOS 계정의 관리자 암호가 필요합니다. 대화 상자에 암호를 입력하고 **확인**를 누릅니다. + + + +프로그램을 설정하려면 **시스템 환경 설정 열기**를 클릭합니다. + + + +다음에 자물쇠 아이콘을 클릭하고 **App Store 및 확인된 개발자**를 선택합니다. + + + + + +AdGuard가 프록시 구성을 추가하도록 허용할지 여부를 확인하는 창이 표시됩니다. + + + + + +이제 사용자의 필요에 맞게 보호를 설정할 수 있습니다. 프로그램 기능의 단계별 설정을 조정하려면 **네 알겠습니다**을 클릭합니다. 이 단계를 건너 뛰려면 **아니요 하지않겠습니다**를 누릅니다. + + + +맥북에 AdGuard가 설치되었습니다! + + +## 제거 방법 + +### 일반 제거 방법 +Finder 앱을 엽니다. + +![](https://cdn.adguard.com/public/Adguard/En/Articles/howtodelete/finder.png) + + +'응용 프로그램' 섹션으로 이동하여 AdGuard를 우클릭하고 **휴지통으로 이동**을 선택합니다. + + + + +### 고급 제거 방법 + +고객 지원 팀에서 특별히 '고급 제거'를 권장하거나 고급 제거에 익숙한 경우에만 이 지침을 사용하십시오. 먼저 '일반 제거' 지침의 모든 단계를 수행한 후 다음 단계를 수행합니다. + +* 다음과 같은 AdGuard 파일을 삭제합니다. + * */Library/Application Support/com.adguard.mac.adguard* (폴더) + * *~/Library/Application Support/com.adguard.mac.adguard* (폴더) + * *~/Library/Preferences/com.adguard.mac.adguard.plist* (파일) + +* 이 파일을 삭제하시려면 터미널 앱을 열고 다음 명령을 입력하고 실행하십시오. + +`sudo rm -R "/Library/Application Support/com.adguard.mac.adguard"` +`rm -R "~/Library/Application Support/com.adguard.mac.adguard"` +`rm ~/Library/Preferences/com.adguard.mac.adguard.plist` + +* '활동 모니터' 앱을 실행합니다. +* 검색 도구를 사용하여 **cfprefsd** 프로세스를 찾습니다. + + + + +* 사용자로 실행중인 프로세스를 중지합니다 (루트에서 실행되는 프로세스 제외). 프로세스를 중지하려면 프로세스를 클릭한 후 왼쪽 상단의 X를 클릭합니다. 대화 창에서 **종료**를 합니다. + + + +이제 AdGuard가 맥북에서 제거되었습니다. + diff --git a/03.macos/02.installation/docs.zh.md b/03.macos/02.installation/docs.zh.md new file mode 100644 index 00000000..a84b23fb --- /dev/null +++ b/03.macos/02.installation/docs.zh.md @@ -0,0 +1,106 @@ +--- +title: '安装/卸载' +taxonomy: + category: + - docs +--- +* [系统需求](#system-requirements) +* [安装过程](#installation) +* [卸载](#uninstall) + * [进阶卸载](#uninstall-advanced) + + +## 系统需求 + +**操作系统版本：** macOS 10.12（64 位）或更高版本 + +**RAM：** 至少 2 GB + +**浏览器：** Safari、Google Chrome、Opera、Yandex.Browser、Mozilla Firefox 和其他在 macOS 上可用的浏览器 + +**可用磁盘空间：** 120 MB + +## 安装过程 + +为了将 AdGuard macOS 版安装到您的电脑上，请您打开浏览器，在地址栏键入 _adguard.com_ 后，在打开的网页上点击**下载**即可。 + + + +请等待 _AdguardInstaller.dmg_ 下载完成后，在 Dock 栏上已安装的文件列表里双击它的图标。 + + + +您的操作系统将会提示您：该应用程序是从互联网下载的 App。点击**打开**。 + + + +桌面上将会显示 AdGuard 图标。点击**安装** + + + +请等待安装程序完成安装所需要的文件。 + + + +以使用应用程序，需要输入 macOS 账号的用户名和密码。在弹出的对话框上输入用户名和密码后，点击**好**。 + + + +下一步，您会看到视窗确认您是否要安装从互联网下载的 App。请您点击**打开系统首选项** + + + +先**点按锁按钮以进行更改**，然后请您选择 **App Store 和被认可的开发者** + + + +您将会看到视窗确认您是否允许 AdGuard 添加代理配置： + + + +接着您将会看到快速安装向导。这里我们将会建议您按自己的需求来配置保护。您可以马上开始设置（**来试试吧！**）或暂时无设置需求（**先保持这样**）。 + + + +完成啦！AdGuard 已成功安装到您的 Mac！ + +## 卸载 + +### 一般卸载方式 + +首先，请您点击相应的图标以打开 'Finder'： + +![](https://cdn.adguard.com/public/Adguard/En/Articles/howtodelete/finder.png) + +前往**应用程序**。在列表中找到 AdGuard，右键它并选择**移到废纸篓**。 + + + + +### 进阶卸载方式 +**除非您知道如何操作或有我们技术支持专门为您推荐使用进阶方式卸载应用程序，我们不推荐您使用该方式。此外，请您先使用一般卸载方式。** + +如果一般卸载方式无效，再请您执行以下操作： +* 删除以下的 AdGuard 文件： + * */Library/Application Support/com.adguard.mac.adguard*（文件夹） + * *~/Library/Application Support/com.adguard.mac.adguard*（文件夹） + * *~/Library/Preferences/com.adguard.mac.adguard.plist*（文件） + +**为了执行上述步骤**，请您打开 Terminal。然后输入并执行以下的指令： + +`sudo rm -R "/Library/Application Support/com.adguard.mac.adguard"` + +`rm -R "~/Library/Application Support/com.adguard.mac.adguard"` + +`rm ~/Library/Preferences/com.adguard.mac.adguard.plist` + +* 开启 ’活动监视器’。 +* 通过搜索查找 **cfprefsd** 进程。 + + + +* 为了退出在用户态下运行的进程（不是在 root 权限运行的），请点击进程。然后在左上角点击 X。在对话窗确定要退出。 + + + +AdGuard 卸载完成。 diff --git a/03.macos/03.features/docs.en.md b/03.macos/03.features/docs.en.md index b1995708..47f96e79 100644 --- a/03.macos/03.features/docs.en.md +++ b/03.macos/03.features/docs.en.md @@ -3,6 +3,7 @@ title: Features taxonomy: category: - docs +visible: false --- AdGuard for macOS is designed to block ads on web pages and in applications installed on your computer. In addition, AdGuard protects users from fraudulent websites and their information from statistics gathering systems. This section gives a brief overview of the AdGuard for macOS functions. diff --git a/03.macos/03.features/docs.ru.md b/03.macos/03.features/docs.ru.md index 58875723..b65ef9c3 100644 --- a/03.macos/03.features/docs.ru.md +++ b/03.macos/03.features/docs.ru.md @@ -3,6 +3,7 @@ title: Функции taxonomy: category: - docs +visible: false --- AdGuard для macOS предназначен для блокировки рекламы на веб-страницах и в установленных на компьютере приложениях. Кроме того, AdGuard защищает пользователей от распространенных в Интернете мошеннических сайтов, а их личную информацию — от сбора различными системами статистики. В этом разделе представлено краткое описание функций AdGuard для macOS. diff --git a/03.macos/05.solving-problems/01.install-cert/docs.en.md b/03.macos/05.solving-problems/01.install-cert/docs.en.md index 228db1f2..9294f0a3 100644 --- a/03.macos/05.solving-problems/01.install-cert/docs.en.md +++ b/03.macos/05.solving-problems/01.install-cert/docs.en.md @@ -18,6 +18,8 @@ To manually install the certificate into Firefox-like browser: 4. Navigate to "Authorities" tab and click on "Import..." button - 5. Select file `/Library/Application Support/com.adguard.Adguard/NfApiConfiguration/SSL/Adguard Personal CA.cer` + 5. Select file `/Library/Application Support/com.adguard.mac.adguard/AdguardCore/Adguard Personal CA.cer` or just download it from http://local.adguard.org/cert using a Chromium-based browser (e.g Google Chrome or new Edge) and with a HTTPS-filtering running in AdGuard Exact actions required for different Gecko-based browsers may vary, but the general sequence and the path to `AdGuard Personal CA.cer` file will be the same. + +PS: For [Setapp application version](https://setapp.com/apps/adguard) the file path is the following: `/Library/Application Support/com.adguard.mac.adguard-setapp/AdguardCore/Adguard Personal CA.cer` diff --git a/03.macos/05.solving-problems/01.install-cert/docs.ru.md b/03.macos/05.solving-problems/01.install-cert/docs.ru.md index 290f42c7..c10a4961 100644 --- a/03.macos/05.solving-problems/01.install-cert/docs.ru.md +++ b/03.macos/05.solving-problems/01.install-cert/docs.ru.md @@ -18,6 +18,8 @@ visible: true 4. Перйдите во вкладку "Центры сертификации" и кликните по кнопке "Импортировать..." - 5. Выберите файл `/Library/Application Support/com.adguard.Adguard/NfApiConfiguration/SSL/Adguard Perosnal CA.cer` + 5. Выберите файл `/Library/Application Support/com.adguard.mac.adguard/AdguardCore/Adguard Personal CA.cer` или скачайте его через любой браузер на основе Chromium (например, Google Chrome или новый Edge) с запущенной HTTPS-фильтрацией в AdGuard Точные действия могут различаться для разных браузеров, но общая последовательность и путь к файлу `AdGuard Personal CA.cer` остаются теми же. + +P.S: Для [версии приложении в Setapp](https://setapp.com/ru/apps/adguard) путь файла будет такой: `/Library/Application Support/com.adguard.mac.adguard-setapp/AdguardCore/Adguard Personal CA.cer` diff --git a/03.macos/05.solving-problems/04.big-sur-issues/docs.en.md b/03.macos/05.solving-problems/04.big-sur-issues/docs.en.md index d8f3b0b3..fb555a1c 100644 --- a/03.macos/05.solving-problems/04.big-sur-issues/docs.en.md +++ b/03.macos/05.solving-problems/04.big-sur-issues/docs.en.md @@ -34,7 +34,9 @@ These problems aren't fixed by Apple yet, or fixed only partially. ### Compatibility with local proxies ->Note: in Big Sur 11.1 (and newer macOS versions) AdGuard can filter local proxies (mostly) without any problems. If you encounter any issues in OS versions 11.1+, or if you're using Big Sur 11.0, remove the local proxy from System settings and configure an upstream proxy in AdGuard by following the instruction below. +> Note: in Big Sur 11.1 (and newer macOS versions) AdGuard can filter local proxies (mostly) without any problems. If you encounter any issues in OS versions 11.1+, or if you're using Big Sur 11.0, remove the local proxy from System settings and configure an upstream proxy in AdGuard by following the instruction below. + +> After Big Sur 11.3 update, the problems with local proxies came back. Apple will likely roll out a fix soon, and we're also working on a workaround. All required changes are already made to the [Nightly version](http://agrd.io/mac_nightly) of AdGuard for Mac. To configure an upstream proxy in AdGuard for Mac in Big Sur, you need to go to *AdGuard menu -> Advanced -> Advanced Settings...*. Click on the *Value* area of the `upstream.proxy` setting to configure a proxy. diff --git a/03.macos/05.solving-problems/04.big-sur-issues/docs.ru.md b/03.macos/05.solving-problems/04.big-sur-issues/docs.ru.md index e817c4f2..961c7815 100644 --- a/03.macos/05.solving-problems/04.big-sur-issues/docs.ru.md +++ b/03.macos/05.solving-problems/04.big-sur-issues/docs.ru.md @@ -33,7 +33,9 @@ visible: true ### Совместимость с локальными прокси ->Важно: в Big Sur 11.1 (и новее) AdGuard может фильтровать локальные прокси без проблем (в большинстве случаев). Если вы всё же столкнулись с какими-либо трудностями, или если вы используете Big Sur 11.0, уберите локальный прокси из системных настроек и настройте вышестоящий прокси в AdGuard, следуя инструкции ниже. +> Важно: в Big Sur 11.1 (и новее) AdGuard может фильтровать локальные прокси без проблем (в большинстве случаев). Если вы всё же столкнулись с какими-либо трудностями, или если вы используете Big Sur 11.0, уберите локальный прокси из системных настроек и настройте вышестоящий прокси в AdGuard, следуя инструкции ниже. + +> После выхода обновления Big Sur 11.3 вернулись прежние проблемы с локальными прокси. Apple, скорее всего, уже работает над исправлением данного бага, и мы также рассматриваем возможности обойти эту проблему. Необходимые правки уже внесены в [Nightly-версию](http://agrd.io/mac_nightly) AdGuard для Mac. Чтобы настроить вышестоящий прокси в AdGuard для Mac на Big Sur, вам необходимо перейти в *Меню AdGuard -> Дополнительно -> Расширенные настройки...*. Кликните по области *Значение* настройки `upstream.proxy`, чтобы настроить прокси. diff --git a/03.macos/05.solving-problems/05.installation-issues/docs.en.md b/03.macos/05.solving-problems/05.installation-issues/docs.en.md new file mode 100644 index 00000000..d60e5e7b --- /dev/null +++ b/03.macos/05.solving-problems/05.installation-issues/docs.en.md @@ -0,0 +1,24 @@ +--- +title: 'Installation problems solving' +taxonomy: + category: + - docs +--- + +## "Installation failed" error in macOS Catalina + +During the installation you can face an error like this: + + + +Follow this instruction to solve the problem: + +1) Restart your Mac +2) As your Mac restarts, press and hold down the *Command(⌘) + R* keys immediately upon hearing the startup chime. Hold the keys until the Apple logo appears to get the computer into Recovery mode. +3) From the top bar select *Utilities* > *Terminal*, and execute this command: `csrutil disable` +4) Restar the Mac and log into Administrator's profile +5) Open the Finder window and select from the top bar *Go* > *Go to Folder* and type `~/private/` +6) Create a folder named *tmp* and type in your password +7) Launch AdGuard installation + +As the installation is completed, restart your Mac in Recovery mode using the instruction above and execute `csrutil enable` command in Terminal to enable system protection. diff --git a/03.macos/05.solving-problems/05.installation-issues/docs.ru.md b/03.macos/05.solving-problems/05.installation-issues/docs.ru.md new file mode 100644 index 00000000..6c1587be --- /dev/null +++ b/03.macos/05.solving-problems/05.installation-issues/docs.ru.md @@ -0,0 +1,24 @@ +--- +title: 'Решение проблем с установкой' +taxonomy: + category: + - docs +--- + +## Ошибка "Установка не выполнена" на macOS Catalina + +Во время установки может появиться вот такое окно: + + + +Для решения этой проблемы нужно воспользоваться этой инстукцией: + +1) Перезапустите Mac +2) Когда на экране появится логотип Apple, зажмите клавиши *Command(⌘) + R* – откроется меню Recovery +3) На верхней панели выберите *Утилиты* > *Терминал*, а затем введите `csrutil disable` +4) Перезапустите Mac и войдите в профиль администратора +5) Откройте окно Finder, выберите на верхней панели *Переход* > *Переход к папке...* и введите `~/private/` +6) Создайте папку с названием *tmp* и введите пароль пользователя +7) Запустите установщик AdGuard + +Как только установка будет завершена, вновь откройте меню Recovery, следуя инструкции выше, и введите в терминале команду `csrutil enable`, чтобы включить системную защиту. diff --git a/04.android/02.installation/docs.ja.md b/04.android/02.installation/docs.ja.md new file mode 100644 index 00000000..9c646546 --- /dev/null +++ b/04.android/02.installation/docs.ja.md @@ -0,0 +1,109 @@ +--- +title: AdGuard for Android のインストール方法 +taxonomy: + category: + - docs +--- + +## 動作環境 + +**OSバージョン:** Android 5.0以上 + +**RAM:** 2 GB以上 + +**ディスクの空き容量:** 120 Mb + +## インストール方法 +【AdGuardがGoogle Playにない理由】これは、Googleがネットワークレベルの広告ブロッカー（つまり、他のアプリの広告をブロックするアプリ）のGoogle Playでの配布を禁止しているためです。Googleの制限的なポリシーについては、[私たちのブログ](https://blog.adguard.com/en/google-removes-adguard-android-app-google-play/)でご確認いただけます。 + +この理由で、AdGuard for Androidは直接AdGuardウェブサイトから手動でインストールする必要があります。方法は以下の通りです。 + +まず、デバイスのOS設定で提供元不明のアプリケーションのインストールを許可する必要があります: + +* 【Android 8以降の場合】[こちら](https://adguard.com/apk)からダウンロードしたAdGuardのAPKファイルをタップし、[インストール] をタップ。 ブラウザからのインストールが許可されていない場合は通知が表示され、そこで + +[設定]→[この提供元を許可する]→戻る→[インストール] + +で**インストールが完了します**。 + + + + + + +* 【Android 7の場合】お使いのデバイスで「設定」→「セキュリティ」より「提供元不明のアプリ」をタップしてトグルをONにする。 +* 【Android 6の場合】[設定]を開き、[システムとデバイス]から[その他の設定]を選択。[セキュリティ]の[提供元不明のアプリ]をオンにし、システム警告ウィンドウが開きましたらOKをタップ。 +※端末によって少し手順と項目が異なる場合があります。 +* 【Android 5の場合】[設定]を開き、[セキュリティ]を選択。 [提供元不明のアプリ]をオンにし、システムの警告ウィンドウが開きましたら[OK]をタップ。 + +これで、アプリをデバイスにインストールすることができます。ブラウザで[https://adguard.com/apk](https://adguard.com/apk)を開くか、以下のQRコードをスキャンしてください: + +![8a8ed8bad63595189b5c55d184155baa79e71033-androidinstallen03](https://user-images.githubusercontent.com/51786050/116212212-45c83080-a74d-11eb-84de-34260a5a12f8.png) + +ダウンロードしたファイルを保存するリクエストが表示されたら、**OK**を押します。 + + +ダウンロードが完了すると、AdGuardアプリケーションをインストールするかどうかをシステム尋ねられます。 **インストール**を押します。 + + + +アプリを起動しますと、EULAとプライバシーポリシーの同意画面が表示されます。 +また、2つのチェックボックスにチェックを入れることで、AdGuardの開発にご協力いただけます。 +続けるには「**同意する**」を押してください。 + + + +**クイック設定** と **詳細な設定** のどちらかを選びます（詳細な設定も基本的にすぐに終わるので、おすすめです）。 + + + +クイック設定を選ぶと、AdGuardが機能できるよう、ローカルVPNを作成するよう誘導画面が表示されます。 + + +詳細な設定を選ぶと、ニーズに合わせてAdGuardを設定する流れが開始されます。まず、検索広告をブロックするかしないかという設定です: + + + +次に、SNSウィジェット（普通のウェブサイトで出てくるいいね！やシェアボタンなど）をブロックするかしないかという設定です: + + + +迷惑要素（クッキー通知、アシスタントウィンドウなど）をブロックするかしないかという設定です: + + + + +次に、YouTubeアプリから広告なしで動画を再生する方法についての説明があります。ここは方法の説明だけなので、確認いただいて次に進むだけです。 + + + + +プライバシー設定では、ご希望の個人情報追跡からの保護レベルをお選びください: + + + +セキュリティは、危険なサイトにアクセスしようとする時に、警告を表示するかしないかという設定です。 + + + + +最終ステップはローカルVPNを作成することです: + + + +これで、**AdGuard**のインストールは完了です。 + +※広告ブロックが100％の効率で機能するには、アプリ内でHTTPSフィルタリングを有効にしてください（証明書のインストールが必要になります）。 + + +## АdGuardのアンインストールや再インストール + +モバイルデバイスにAdGuardを再インストールする必要がある場合は、 + +まず**設定**を開き、 +**インストールされたアプリ**（Android 6）、**アプリ**（Android 5および7）、**アプリと通知**（Android 8+）、**アプリ**（Android 9+）を選択して、 +インストールされているアプリのリストで**AdGuard**を見つけ、**削除する**を押します。 + + + +AdGuardアプリを再インストールするには、「インストール方法」の手順を繰り返してください。 diff --git a/04.android/02.installation/docs.ko.md b/04.android/02.installation/docs.ko.md new file mode 100644 index 00000000..3d546283 --- /dev/null +++ b/04.android/02.installation/docs.ko.md @@ -0,0 +1,93 @@ +--- +title: 설치 방법 +taxonomy: + category: + - docs +--- + +## 시스템 요구 사항 + +**운영 체제 버전:** Android 5.0 이상 + +**RAM:** 2 GB 이상 + +**디스크 여유 공간:** 120 Mbytes. + +## 설치 방법 +대부분의 Android 기반 앱은 Google Play Market에서 다운로드할 수 있지만 Google은 Google Play를 통한 네트워크 수준 광고 차단기(다른 앱의 광고를 차단하는 앱)를 배포하는 것을 금지하기 때문에 Google Play Market에서 AdGuard 광고 차단 앱이 없습니다. AdGuard 블로그에서 Google 제한 정책에 대한 자세한 내용을 확인하실 수 있습니다. + +그래서 Android용 AdGuard는 수동으로만 설치할 수 있습니다. 휴대폰에서 앱을 사용하려면 다음 단계를 수행해야 합니다. + +먼저 기기의 OS 설정에서 알 수 없는 소스의 앱 설치를 허용해 주세요. 알 수 없는 소스의 앱 설치를 허용하는 방법은 다음과 같습니다. + +* Android 8 이상: +AdGuard apk 다운로드를 시작하면 권한을 허용하라는 메시지가 표시됩니다. 열린 창에서 **설정**을 누르고 **이 출처 허용** 스위치를 활성화합니다. 다음 프로그램 설치를 계속하십시오. + + + + + +* Android 6, 7: **설정**으로 이동한 후 **시스템 및 기기**에서 **추가 설정**을 선택합니다. **알 수 없는 소스**를 켜고 시스템 경고 창에서 **확인**을 누릅니다. + +* Android 5: **설정**으로 이동한 후 **개인** 섹션에서 **보안**을 선택합니다. **알 수 없는 소스**를 켜고 시스템 경고 창에서 **확인**을 누릅니다. + +이제 기기에 앱을 설치할 수 있습니다. 브라우저를 열고 [https://adguard.com/apk](https://adguard.com/apk)를 입력하거나 이 QR 코드를 스캔합니다. + +![8a8ed8bad63595189b5c55d184155baa79e71033-androidinstallen03](https://user-images.githubusercontent.com/51786050/116212212-45c83080-a74d-11eb-84de-34260a5a12f8.png) + +파일을 저장하라는 요청이 표시될 것입니다. **확인**을 누릅니다. + + + +다운로드가 완료되면 시스템에서 AdGuard 앱을 설치할 것인지 묻습니다. **설치**를 누릅니다. + + + +**라이선스 계약** 및 AdGuard의 **개인정보취급방침**을 읽으라는 메시지가 표시됩니다. + +제품 개발에 참여할 수도 있습니다. 제품 개발에 참여하시려면 **자동 충돌 보고서 보내기** 및 **기술 및 상호 작용 데이터 전송** 확인란을 선택하고 **동의**을 탭하세요. + + + +**빠른** 설정과 **상세** 설정 중에서 선택합니다. + + + +빠른 설정을 선택하면 AdGuard가 작동하는 데 로컬 VPN을 활성화하도록 요청합니다. + + + +상세 설정을 선택 시 시작 시퀀스로 사용자의 필요에 맞게 앱을 구성합니다. 첫 번째로 검색 광고를 허용할 것인지 물어볼 것입니다. + + + +'좋아요' 버튼과 같은 소셜 위젯 차단 또는 유지: + + + +방해 요소(쿠키 알림, 지원 창 등): + + + +개인 정보 설정 (원하시는 보호 수준을 선택할 수 있음): + + + +보안 (위험한 웹 사이트에 대한 경고): + + + +마지막 단계는 로컬 VPN을 활성화하는 것입니다. + + + +**AdGuard** 앱 설치가 완료되었습니다. + + +## Аdguard AdGuard 제거 및 재설치 + +휴대폰에 AdGuard를 다시 설치해야 하는 경우, 먼저 앱을 삭제해 주세요. **설정**으로 이동하여 설치된 앱 (Android 6)/ 앱 (Android 5 및 7) / 앱 및 알림 (Android 8 이상)을 선택합니다. 설치된 앱 목록에서 **AdGuard**를 찾아 **삭제**를 누릅니다. + + + +앱을 다시 설치하려면 ‘설치’ 섹션에 설명된 작업을 반복해 주세요. diff --git a/04.android/02.installation/docs.zh.md b/04.android/02.installation/docs.zh.md new file mode 100644 index 00000000..6b7b6199 --- /dev/null +++ b/04.android/02.installation/docs.zh.md @@ -0,0 +1,103 @@ +--- +title: 安装 +taxonomy: + category: + - docs +--- + +## 系统需求 + +**操作系统版本：** 安卓 5.0 以上。 + +**RAM：** 至少 2 GB。 + +**可用磁盘空间：** 120MB。 + +## 安装过程 + +虽然大部分用于安卓系统的应用程序可以通过谷歌商店分发，但是 AdGuard 不在里面。谷歌禁止通过谷歌商店分发网络层的广告拦截程序，即，在其他应用程序里屏蔽商业广告的应用程序。[在我们的博客上](https://blog.adguard.com/en/google-removes-adguard-android-app-google-play/)可以了解更多关于谷歌限制性政策的相关信息。 + +由于上述原因，您只可以手动安装适用于安卓的 AdGuard。为了在移动设备上使用该应用程序，您需要执行以下操作。 + +首先，请在操作系统设置里允许安装未知来源的应用程序。以执行此操作请您： + +* 安卓 8+：开始安装 AdGuard APK 文件（查看下一步）。您将会看到允许安装应用程序的窗口。在打开的窗口点击**设置**并启用**允许此来源**。 + + + +* 安卓 6 和 7：打开**设置**，在**系统和设备**部分选择**其他设置**。启用**未知来源**并在系统警示窗口上点击**OK**。 + +* 安卓 5：打开**设置**，在**个人**设置部分选择**安全**。启用**未知来源**并在系统警示窗口上点击 **OK**。 + +现在您就可以在您的设备上安装应用程序了。打开浏览器并输入以下的网址：[https://adguard.com/apk](https://adguard.com/apk)，或扫 QR 码： + +![8a8ed8bad63595189b5c55d184155baa79e71033-androidinstallen03](https://user-images.githubusercontent.com/51786050/116212212-45c83080-a74d-11eb-84de-34260a5a12f8.png) + +您将会看到确认下载文件的提示。点击**下载**。 + + + +下载完成后，系统将会确认您是否想安装 AdGuard 应用程序。点击**安装**。 + + + +点击安装后，您将会看到阅读**许可协议**和 AdGuard **隐私政策**的页面。您还可以参与应用程序的改进过程。如您想要参加，请您勾选**自动发送崩溃报告**和**发送技术和交互数据**。点击**接受**即可。 + + + +现在您要选择**快速**或**完全**设置方式。 + + + +快速方式将询问您是否下载证书以开启 HTTPS 过滤。 + + + +下载完成以后，会问您是否要启用本地 VPN。 + + + +点击第二个方式后，屏幕上将会出现几个显示设置选项，以让您按自己需求设置 AdGuard。 + +首先，我们会问您是否想要启用搜索广告的过滤器： + + + +下一个是，是否要拦截社交媒体小工具（比如，“赞”按钮）： + + + +下一个是恼人元素，包括 Cookie 通知、支持窗口等等： + + + +接下来，可以多了解如何观看无广告的 YouTube 影片。 + + + +下一个是隐私设置。请选择您所想使用的保护水平： + + + +安全设置（关于危险网站的警告）： + + + +下一步很重要，就是关于 HTTPS 过滤。我们推荐您启用该选项，以让广告拦截更强。 + + + +最后一步是启用本地 VPN： + + + +现在 **AdGuard** 安装成功完成。 + + +## 卸载/重新安装 AdGuard + +如您想要在您的设备上重新安装 AdGuard，请您先删除应用程序，前往**设置** → **已安装的应用程序**（安卓 6）、**应用程序**（安卓 5 和 7）或**应用程序和通知**（安卓 8+）。在已安装的应用程序列表内找到 **AdGuard** 并点击**卸载**。 + + + +为了重新安装应用程序，请执行上述“安装过程”部分讲述的步骤。 diff --git a/04.android/06.solving-problems/07.youtube-ads/docs.ko.md b/04.android/06.solving-problems/07.youtube-ads/docs.ko.md new file mode 100644 index 00000000..5c332241 --- /dev/null +++ b/04.android/06.solving-problems/07.youtube-ads/docs.ko.md @@ -0,0 +1,45 @@ +--- +title: 'YouTube/KakaoTalk/Facebook 광고 차단하는 방법' +taxonomy: + category: + - docs +visible: true +--- + +AdGuard는 Windows, Mac, iOS, Android와 같은 다양한 플랫폼에서 사용이 가능합니다. 이번에는 Android 기기에서 KakaoTalk, YouTube와 Facebook 광고를 차단하는 방법을 살펴보겠습니다. 기술적인 제한 때문에 Android 기기에서 해당 앱의 광고를 차단하는 방법은 다른 플랫폼과 다릅니다. + +## YouTube 광고 차단하는 방법 +Android의 기술적인 제한 때문에 광고를 차단하는 방법은 복잡할 수 있습니다. AdGuard를 사용하여 YouTube 광고 차단하는 방법은 2 가지가 있습니다. + +1. **브라우저에서 YouTube 시청** + +브라우저에서 YouTube를 열면 AdGuard가 완벽하게 모든 광고를 차단합니다. + +2. **YouTube 앱에서 시청** + +YouTube 앱에서 광고를 차단하기 위해 특별한 방법을 찾았습니다. +- ‘공유’ 버튼 클릭 +- ‘AdGuard’ 선택 +- 광고 없이 동영상 보기 + +

+ + +## KakaoTalk 광고 차단하는 방법 + +KakaoTalk 광고 차단하려면 다음과 같은 규칙을 사용해 보세요. + +- ||tg.kakao.com$app=com.kakao.talk,important + +- ||more-api.kakao.com$app=com.kakao.talk + +- ||talkchannel-api.kakao.com/api/home/v1/slots.json$app=com.kakao.talk + +(설정-> 콘텐츠 차단-> 사용자 규칙-> + -> 규칙 입력 -> 저장 ) + +안타깝게도 KakaoTalk이 9.0.5 버전으로 업데이트되었을 경우, Android용 AdGuard는 채팅목록 상단에 광고 배너를 차단할 수 없습니다. + + + +## Facebook 광고 차단하는 방법 +안타깝게도 기술적인 제한으로 인해 Android 기기에서 Facebook 광고를 브라우저에서만 차단합니다. Facebook를 광고 없이 사용하기 위해 브라우저를 여십시오. diff --git a/04.android/06.solving-problems/08.adguard-outbound-proxy/docs.en.md b/04.android/06.solving-problems/08.adguard-outbound-proxy/docs.en.md index 07d51e50..e94a9ef2 100644 --- a/04.android/06.solving-problems/08.adguard-outbound-proxy/docs.en.md +++ b/04.android/06.solving-problems/08.adguard-outbound-proxy/docs.en.md @@ -122,8 +122,5 @@ Proxy port | *1080* ### Limitations -There are several factors that can prevent certain traffic from being routed through the outgoing proxy. +There is a factor that can prevent certain traffic from being routed through the outgoing proxy. AdGuard will only re-route traffic that goes through it. Basically, it means apps that have **Ad blocking** flag enabled in the **Apps Management** tab. -1. AdGuard will only re-route traffic that goes through it. Basically, it means apps that have **Ad blocking** flag enabled in the **Apps Management** tab. - -2. AdGuard does not route UDP through proxy. We plan to add UDP over SOCKS5 support later, but so far only TCP traffic is routed through outgoing proxy. diff --git a/04.android/06.solving-problems/08.adguard-outbound-proxy/docs.ru.md b/04.android/06.solving-problems/08.adguard-outbound-proxy/docs.ru.md index 3d2040e5..9b295299 100644 --- a/04.android/06.solving-problems/08.adguard-outbound-proxy/docs.ru.md +++ b/04.android/06.solving-problems/08.adguard-outbound-proxy/docs.ru.md @@ -122,8 +122,6 @@ visible: true ### Ограничения -Есть несколько факторов, которые могут помешать определенному трафику проходить через исходящий прокси. +Есть фактор, который может помешать определенному трафику проходить через исходящий прокси. +AdGuard будет направлять через прокси только тот трафик, который проходит через сам AdGuard. По сути, это означает трафик приложений, для которых выставлена галочка напротив пункта **Блокировка рекламы** в разделе **Настройки приложений**. -1. AdGuard будет направлять через прокси только тот трафик, который проходит через сам AdGuard. По сути, это означает трафик приложений, для которых выставлена галочка напротив пункта **Блокировка рекламы** в разделе **Настройки приложений**. - -2. AdGuard не направляет UDP через прокси. Мы планируем добавить поддержку UDP через SOCKS5 в будущем, но пока через исходящий прокси пропускается только TCP-трафик. diff --git a/04.android/06.solving-problems/08.adguard-outbound-proxy/docs.zh.md b/04.android/06.solving-problems/08.adguard-outbound-proxy/docs.zh.md new file mode 100644 index 00000000..3305f784 --- /dev/null +++ b/04.android/06.solving-problems/08.adguard-outbound-proxy/docs.zh.md @@ -0,0 +1,101 @@ +--- +title: '如何设置外出代理' +taxonomy: + category: + - docs +visible: true +--- + +* [如何同时使用 AdGuard 和 Tor ](#tor) +* [如何同时使用 AdGuard 与 PIA（Private Internet Access）](#pia) +* [如何同时使用 AdGuard 和 TorGuard](#torguard) +* [如何同时使用 AdGuard 和 NordVPN](#nordvpn) +* [如何同时使用 AdGuard 和 Shadowsocks](#shadowsocks) +* [限制](#limitations) + +这篇文章为用户讲述如何设置一些主流的代理，让它们与 AdGuard 一起运行。 + +### 如何同时使用 AdGuard 和 Tor + + +1. 请您打开 AdGuard 并前往「**设置**」--> 「**网路**」-->「**代理**」。打开[谷歌商店](https://play.google.com/store/apps/details?id=org.torproject.android&noprocess)，或者点击「配置 Tor® 整合」以下载 "Orbot: Proxy with Tor"。 +2. 打开 Orbot 并在应用程序的首页点击「**开启**」按钮。 +3. 返回 AdGuard 的**代理设置**页面。 +4. 点击「配置 Tor® 整合」按钮。 +5. 所有必填的字符串将会被预填写： + +字符串 | 数值 +------- | --------- +代理分类 | *SOCKS4* 或 *SOCKS5* +代理主机 | *127.0.0.1* +代理端口 | *9050* + +或您可以点击「**添加代理**」并手动输入数值。然后设置 Orbot 代理为默认代理。 + +6. 开启 AdGuard 保护。 + +> 请注意，AdGuard 现在会将所有流量通过 Orbot 代理发送。如您禁用 Orbot 代理，那么您在 AdGuard 设置中禁用外出代理设置前，互联网连接将不可用。 + +### 如何同时使用 AdGuard 和 PIA（Private Internet Access） +*假设您已是 PIA VPN 的客户，且已将它安装在您的设备上* +1. 打开 AdGuard 并前往「**设置**」--> 「**网路**」-->「**代理**」。 +2. 点击「**添加代理**」按钮并输入以下的数据 + +字符串 | 数值 +------- | --------- +代理分类 | *SOCKS5* +代理主机 | *proxy-nl.privateinternetaccess.com* +代理端口 | *1080* + +3. 您还需要输入「**用户名/密码**」字符串。以完成操作，请您在 PIA 官网上登录[客户管理面板](https://www.privateinternetaccess.com/pages/client-sign-in)。在**生成 PPTP/L2TP/SOCKS 密码**部分下面点击「**生成密码**」按钮。您将会看到一串开始于 "x" 的用户名和随机密码。将它们输入到 AdGuard「**用户名**」和「**密码**」相应的空白处。 +4. 勾选此代理以设置它为默认代理。然后点击「**保存**」。 +5. 启用 AdGuard 保护。 + +### 如何同时使用 AdGuard 和 TorGuard +*假设您已是 TorGuard 的客户，且已将它安装在您的设备上* +1. 打开 AdGuard 并前往「**设置**」--> 「**网路**」-->「**代理**」。 +2. 点击「**添加代理**」按钮并输入以下数据： + +字符串 | 数值 +------- | --------- +代理分类 | *SOCKS5* +代理主机 | *proxy.torguard.org* 或 *proxy.torguard.io* +代理端口 | *1080* 或 *1085* 或 *1090* + +3. 请在「**用户名**」和「**密码**」的相应空白处输入您的代理名称，以及您在 TorGuard 注册选择的代理密码。 +4. 勾选此代理以设置它为默认代理。然后点击「**保存**」。 +5. 开启 AdGuard 保护。 + +### 如何同时使用 AdGuard 和 NordVPN +1. 打开 AdGuard 并前往「**设置**」--> 「**网路**」-->「**代理**」。 +2. 点击「**添加代理**」按钮并输入以下数据： + +字符串 | 数值 +------- | --------- +代理分类 | *SOCKS5* +代理主机 | *除了“混淆服务器”以外，任何一个[列表内](https://nordvpn.com/servers/)的服务器* +代理端口 | *1080* + +3. 在「**用户名**」和「**密码**」处输入您的 NordVPN 的用户名和密码。 +4. 勾选此代理以设置它为默认代理。然后点击「**保存**」。 +5. 开启 AdGuard 保护。 + +### 如何同时使用 Adguard 和 Shadowsocks +*假设您已是 Shadowsocks 的客户，且已将它安装在您的设备上* + +**请注意：在您开始设置前，请将 Shadowsocks 应用程序从过滤的应用程序列表移除（「AdGuard」--> 「应用管理」--> 「Shadowsocks」--> 「禁用保护」）以避免运行错误。** + +1. 打开 AdGuard 并前往「**设置**」--> 「**网路**」-->「**代理**」。 +2. 点击「**添加代理**」按钮并输入以下数据： + +字符串 | 数值 +------- | --------- +代理分类 | *SOCKS5* +代理主机 | *127.0.0.1* +代理端口 | *1080* + +3. 点击「**选择并保存**」 + +### 限制 + +请注意，有个因素可能会阻止一些特定的流量通过外出代理路由。AdGuard 只重新发送经过它的流量。基本上，也就是在「应用管理」里开启**广告拦截**的应用程序的流量。 diff --git a/04.android/06.solving-problems/09.background-work/docs.en.md b/04.android/06.solving-problems/09.background-work/docs.en.md index 58f57f2e..6c2610ee 100644 --- a/04.android/06.solving-problems/09.background-work/docs.en.md +++ b/04.android/06.solving-problems/09.background-work/docs.en.md @@ -44,6 +44,30 @@ Go to Settings - Power Manager - Mobile Manager - Settings - Battery-saving opti ## Xiaomi +#### MIUI 12 + + + +Go to Settings > Apps > Manage apps > AdGuard. + +- Set Autostart to “On” +- Set Battery saver to “No restrictions” + + + +Now launch the active apps manager by swiping up from the bottom of the screen and look for the AdGuard app. + + + +Tap and hold on it until a special menu pops up. Select a lock icon. + + + +The lock icon should appear above the app window. + + + + #### MIUI 10-11 To let your app run successfully in the background, configure settings as follows: diff --git a/04.android/06.solving-problems/09.background-work/docs.ru.md b/04.android/06.solving-problems/09.background-work/docs.ru.md index 315b2404..96731d31 100644 --- a/04.android/06.solving-problems/09.background-work/docs.ru.md +++ b/04.android/06.solving-problems/09.background-work/docs.ru.md @@ -44,6 +44,30 @@ taxonomy: ## Xiaomi +#### MIUI 12 + + + +Зайдите в Настройки > Приложения > Управление приложениями > AdGuard. + +- Включите Автостарт +- В Разрешениях выберите "Нет ограничений" для Контроля фоновой активности + + + +Теперь запустите Диспетчер запущенных приложений, проведя пальцем вверх от нижней грани экрана. Найдите окно AdGuard. + + + +Нажмите на него и удерживайте, пока не появится специальное меню. Нажмите на значок замка. + + + +Теперь этот значок должен быть над окном AdGuard. + + + + #### MIUI 10-11 diff --git a/04.android/06.solving-problems/13.firefox-certificates/docs.en.md b/04.android/06.solving-problems/13.firefox-certificates/docs.en.md index f6af80b3..41f01974 100644 --- a/04.android/06.solving-problems/13.firefox-certificates/docs.en.md +++ b/04.android/06.solving-problems/13.firefox-certificates/docs.en.md @@ -1,30 +1,34 @@ --- -title: 'Manual installation of the security certificate into the Firefox browser' +title: 'Certificates trust issues in Firefox browser' published: true taxonomy: category: - docs --- -Different versions of Firefox browser require different approaches for AdGuard to perform [HTTPS filtering](https://kb.adguard.com/en/general/https-filtering). Most of the time this happens in Firefox versions older than v81.1.1. To solve this issue, try Method 1 described below (it works with nightly– and beta–versions of the browser). +For AdGuard to [successfully filter HTTPS traffic](https://kb.adguard.com/en/general/https-filtering) in Firefox, the browser needs to trust AdGuard's certificate. It can be achieved differently for different versions of the Firefox. +#### Method 1 -### Enabling access to certificates installed on device +> This method so far only works in [Firefox Nightly](https://www.mozilla.org/firefox/channel/android/) v90.0a1. Once beta- and regular versions of Firefox reach v90, this method will be applicable to them, too. -#### Method 1 (Certificate located in the User store) +To make Firefox Nightly trust AdGuard certificate, follow this instruction: ->This method will only work in [Beta or Nightly](https://www.mozilla.org/firefox/channel/android/) versions of the browser, as regular versions of Firefox don't have `about:config` anymore. +1. Run the browser. +2. Go to *Settings > About Firefox Nightly*. -To make Firefox trust user certificates, you need to toggle the hidden option in the browser itself: + -1. Run the browser; -2. Navigate to **about:config** page; -3. Type **root** in the search field; -4. Locate the option `security.enterprise_roots.enabled` and toggle it, making it **true**. +3. Rapidly tap several times on the Firefox Nightly logo at the top of the screen. +4. Navigate to *Settings > Secret Settings*. -#### Method 2 (Certificate located in the System store) + ->This method will only work on **rooted** devices. +5. Toggle **Use third party CA certificates**. + +#### Method 2 + +> This method will only work on **rooted** devices. 1. [Install and configure](https://www.xda-developers.com/install-adb-windows-macos-linux/) adb; > On the Windows platform, **Samsung** owners may need to install [this utility](https://developer.samsung.com/mobile/android-usb-driver.html). diff --git a/04.android/06.solving-problems/13.firefox-certificates/docs.ru.md b/04.android/06.solving-problems/13.firefox-certificates/docs.ru.md index 976dcb47..c6985d5f 100644 --- a/04.android/06.solving-problems/13.firefox-certificates/docs.ru.md +++ b/04.android/06.solving-problems/13.firefox-certificates/docs.ru.md @@ -1,27 +1,32 @@ --- -title: 'Ручная установка сертификата безопасности в браузер Firefox' +title: 'Проблемы доверия сертификатам безопасности в браузере Firefox' published: true taxonomy: category: - docs --- -Различные версии Firefox требуют разных подходов для осуществления [HTTPS-фильтрации](https://kb.adguard.com/ru/general/https-filtering). Как правило, проблема установки пользовательского сертификата возникает в версиях Firefox до 81.1.1. Для решения воспользуйтесь Методом 1, описанным ниже (он подходит для nightly- и beta-версий браузера). +Чтобы AdGuard мог [успешно фильтровать HTTPS-трафик](https://kb.adguard.com/ru/general/https-filtering) в Firefox, браузер должен доверять сертификату AdGuard. Этого можно добиться по-разному в зависимости от версии Firefox. -### Предоставление доступа к сертификатам +#### Метод 1 -#### Метод 1: Сертификат находится в **пользовательском хранилище** +> Пока что этот метод работает только в [Firefox Nightly](https://www.mozilla.org/firefox/channel/android/) версии 90.0a1. Как только бета- и обычная сборка Firefox достигнут версии 90, данный метод будет также применим к ним. ->Этот метод будет работать только в [Beta- или Nightly-версии](https://www.mozilla.org/firefox/channel/android/) браузера, поскольку обычные версии Firefox более не предоставляют доступа к `about:config`. +Чтобы Firefox Nightly доверял сертификату AdGuard, выполните следующие шаги: -Чтобы начать использовать пользовательские сертификаты, активируйте скрытую опцию в настройках браузера: +1. Запустите браузер. +2. Перейдите в *Настройки > О Firefox Nightly*. -1. Запустите браузер; -2. Перейдите на страницу **about:config**; -3. Введите **root** в поле поиска; -4. Найдите опцию `security.enterprise_roots.enabled` и переключите ее, выбрав значание **true**. + -#### Метод 2: Сертификат находится в **системном хранилище** +3. Несколько раз быстро нажмите на логотип Firefox Nightly в верху экрана. +4. Перейдите в раздел *Настройки > Secret Settings*. + + + +5. Включите настройку **Use third party CA certificates**. + +#### Метод 2 >Этот метод будет работать **только** на устройствах с рут-доступом! diff --git a/04.android/06.solving-problems/13.firefox-certificates/docs.zh.md b/04.android/06.solving-problems/13.firefox-certificates/docs.zh.md new file mode 100644 index 00000000..1a1f6b8d --- /dev/null +++ b/04.android/06.solving-problems/13.firefox-certificates/docs.zh.md @@ -0,0 +1,66 @@ +--- +title: '在火狐浏览器中与信任证书相关的问题' +published: true +taxonomy: + category: + - docs +--- + +为了让 Adguard 在火狐浏览器中[成功过滤 HTTPS 流量](https://kb.adguard.com/en/general/https-filtering)，浏览器需要信任 AdGuard 证书。根据火狐浏览器的版本，您要执行以下操作。 + +#### 第一个方法 + +> 该方法只适用于[火狐浏览器 Nightly](https://www.mozilla.org/firefox/channel/android/) v90.0a1 版本。如果您将 Beta- 和火狐浏览器稳定版升级为 v90，该方法也适用。 + +为了让 AdGuard 证书在火狐浏览器中受信任，请执行以下操作： +1. 打开浏览器 +2. 前往「设置」> 「关于 Firefox Nightly」。 + + + +3. 在屏幕上连续点击若干次火狐浏览器 Nightly 图标。 +4. 前往「设置」>「Secret Settings」。 + + + +5. 开启**使用第三方 CA 证书**（Use third party CA certificates）。 + +#### 第二个方法 + +> 仅在**有 Root 权限**的设备上有效。 + +1. [安装以及配置](https://www.xda-developers.com/install-adb-windows-macos-linux/) ADB； +> 在 Windows 平台上，**三星**用户最可能需要安装[此实用程序](https://developer.samsung.com/mobile/android-usb-driver.html)（Utility）。 + +2. 启用 **「开发者模式」** 以及开启 **「USB 调试」**： +- 在手机上打开 **「设置」**； +- 前往 **「系统」** 部分（设置菜单中最后一个部分）。点击 **「关于手机」**； +- 点击**版本号**七次。然后，您会收到**你现在已经进入开发模式**的通知（如需要的话，请输入设备的解锁密码）； + +- 打开**系统设置** > **开发者选项** > 往下滑并启用 **「USB 调试」** > 仔细阅读提示后，在**允许 USB 调试**的弹窗里确认启用调试。 + +3. 安装[火狐](https://www.mozilla.org/en-US/firefox/releases/)浏览器（发布版本）； +4. 打开 **AdGuard 设置** > **「网络」**>**「HTTPS 过滤」**> **「安装证书至 Firefox 浏览器」** > **「为旧版本安装」**； +5. 使用 `adb shell su` 和`cd data/data/...` 打开 `data/data/org.mozilla.firefox/files/mozilla` 文件夹，找 `xxxxxxx.default` 文件并记住其名称； + +6. 在指定文件夹里我们需要两个文件： +- `cert9.db` +- `key4.db` +7. 请您将这两个文件移动到安全证书发生错误的浏览器的文件夹中： +- `data/data/org.mozilla./files/mozilla/yyyyyy.default`. +8. 完整命令如下： +- `adb shell su` +- `cp -R data/data/org.mozilla.firefox/files/mozilla/xxxxxxxxxx.default/cert9.db data/data/org.mozilla./files/mozilla/yyyyyyyyyy.default`. +- `cp -R data/data/org.mozilla.firefox/files/mozilla/xxxxxxxxxx.default/key4.db data/data/org.mozilla./files/mozilla/yyyyyyyyyy.default`. + +如您收到**权限不足**的系统提示，请您先将指定文件移动至无权限目录。然后再将它们移动至火狐浏览器中特定的文件夹里。 + +完整命令的样式大体如下： + +- `adb shell su`. +- `cp -R data/data/org.mozilla.firefox/files/mozilla/xxxxxxxx.default/cert9.db sdcard/Download ` +- `cp -R data/data/org.mozilla.firefox/files/mozilla/xxxxxxxxx.default/key4.db sdcard/Download ` +- `cp -R sdcard/Download/cert9.db data/data/org.mozilla./files/mozilla/yyyyyyyyyy.default`. +- `cp -R sdcard/Download/key4.db data/data/org.mozilla./files/mozilla/yyyyyyyyyy.default`. + +如果 `adb shell su` 不起作用，请先尝试使用 `adb shell`，然后再使用 `su`。 diff --git a/04.android/06.solving-problems/docs.ko.md b/04.android/06.solving-problems/docs.ko.md new file mode 100644 index 00000000..d3c16a51 --- /dev/null +++ b/04.android/06.solving-problems/docs.ko.md @@ -0,0 +1,23 @@ +--- +title: '문제 해결' +taxonomy: + category: + - docs +--- + +* [배터리 및 트래픽 소비 문제](http://kb.adguard.com/ko/android/solving-problems/battery) +* [Android용 AdGuard에서 로그 수집](http://kb.adguard.com/en/android/solving-problems/log) +* [Android용 AdGuard를 자동화하는 방법](http://kb.adguard.com/en/android/solving-problems/tasker) +* [Logcat log 수집 방법](http://kb.adguard.com/ko/android/solving-problems/logcat) +* [HAR 파일 수집 방법](http://kb.adguard.com/ko/android/solving-problems/har) +* [로우 레벨 설정](http://kb.adguard.com/en/android/solving-problems/low-level-settings) +* [YouTube/KakaoTalk/Facebook 광고 차단하는 방법](http://kb.adguard.com/ko/android/solving-problems/youtube-ads) +* [아웃 바운드 프록시를 설정하는 방법](https://kb.adguard.com/en/android/solving-problems/adguard-outbound-proxy) +* [AdGuard가 시스템에 의해 비활성화되지 않도록 보호하는 방법](https://kb.adguard.com/en/android/solving-problems/background-work) +* [제한 모드 상태에서 프로필 사용으로 인한 문제](https://kb.adguard.com/ko/android/solving-problems/restricted-profile) +* [Firefox 브라우저에 보안 인증서 수동 설치](https://kb.adguard.com/en/android/solving-problems/firefox-certificates) +* [Android 11 기기에 수동 인증서 설치](https://kb.adguard.com/en/android/solving-problems/manual-certificate) + + +이 섹션에는 새로운 정보가 지속적으로 추가되고 있습니다. 지식 창고에서 문제에 대한 해결책을 찾지 못한 경우, [AdGuard 지원 팀](http://kb.adguard.com/en/technical-support)에 문의하십시오. + diff --git a/05.ios/01.overview/docs.en.md b/05.ios/01.overview/docs.en.md index afa5be55..3d057875 100644 --- a/05.ios/01.overview/docs.en.md +++ b/05.ios/01.overview/docs.en.md @@ -1,38 +1,222 @@ --- -title: Overview +title: Features overview taxonomy: category: - docs --- -AdGuard for iOS blocks ads on smartphones and tablets by Apple. AdGuard supports more than 50 filters optimized for Safari mobile browser, including a special filter for Russian websites. +* [Features](#features) + * [Content blockers](#content-blockers) + * [Filters](#filters) + * [User rules](#user-rules) + * [Allowlist](#allowlist) + * [Assistant](#assistant) + * [DNS protection](#dns-protection) + * [DNS implementation](#dns-implementation) + * [DNS servers](#dns-servers) + * [Network settings](#network-settings) + * [DNS filtering](#dns-filtering) + * [DNS filters](#dns-filters) + * [Allowlist and Blocklist](#allowlist-blocklist) + * [Activity](#activity) + * [Statistics](#statistics) + * [Low-level settings](#low-level-settings) + * [Block IPv6](#blockipv6) + * [Bootstrap and Fallback servers](#bootstrap-fallback) +* [Other features](#other-features) -AdGuard allows the user to fine-tune the settings: you can add any website to exceptions and stop blocking ads on it. You can also manually adjust every AdGuard filter, turn them on or off, or even create your own ones. +If you look for AdGuard in the App Store, you'll find two apps — [AdGuard](https://itunes.apple.com/app/id1047223162) and [AdGuard Pro](https://itunes.apple.com/app/id1126386264). These apps are designed to block ads and tracking in Safari, in apps and other browsers, and to manage DNS protection. Don't be misled by their names, both apps block ads on smartphones and tablets by Apple. They used to differ in functionality due to the changing App Store review guidelines, but now these two apps are [basically the same](https://adguard.com/en/blog/updating-adguard-pro-for-ios.html). So if you have purchased AdGuard Pro, there is no need to download AdGuard and buy a license there, and vice versa. -App Store catalogue has two versions of AdGuard for iOS, [free version](https://itunes.apple.com/us/app/id1047223162) and [AdGuard Pro](https://itunes.apple.com/ru/app/id1126386264). The main difference is that AdGuard Pro does not limit its functionality by Safari, but works with all apps and browsers. + +# Features +AdGuard and AdGuard Pro for iOS offer lots of features for blocking ads, trackers and creating user rules, both in Safari and on network level. -Thanks to AdGuard DNS integration, AdGuard Pro can filter traffic in two modes. Default Mode is a basic mode that blocks ads, trackers, phishing websites, etc. Family Mode includes all functions of Default Mode and also blocks all sites with adult content. This mode is perfect if you wish to install AdGuard Pro for iOS on your child’s device. DNS request log will help you track all queries and easily whitelist any website you would like to disable filtering for. + +## Content blockers -Of course, AdGuard Pro has the same functions as the basic version – it can block ads, counters, and malicious websites in Safari, and has a broad selection of filters, both AdGuard proper and the popular third-party filters, such as EasyList. Thanks to AdGuard for iOS, web pages will load much faster, as there will be no banners, excess pictures, and advertising videos. +Content blockers serve as 'containers' for filtering rules that do the actual job of blocking ads and tracking. AdGuard for iOS contains six content blockers: General, Privacy, Social, Security, Custom, and Other. Apple allows each content blocker to contain a maximum of 50K filtering rules, hence, six AdGuard content blockers include 300K filtering rules. -![](iOS-EN.png) +All content blockers, their statuses, which thematic filters they currently include, and a total number of used filtering rules can be found on the respective screen in *Advanced settings*. -**FUNCTIONS** + -* Ad blocking. AdGuard blocks all kinds of ads; more than 50 filters are at your service. With AdGuard, you will forget all about banners, video ads, popup windows, etc. +> Tip: keep all content blockers enabled for the best filtering quality. -* Includes popular Adblock filters: EasyList, EasyPrivacy, Fanboys Annoyances, Malware Domains. AdGuard ensures double protection with the help of both its own and third-party filters. + +## Filters -* Regional and other filters. AdGuard is the first blocker that allows usage of different regional filters. Visist websites in different languages, and they will still be filtered with AdGuard. +Content blockers' work is based on filters, also sometimes referred to as filter lists. Each filter is a list of filtering rules. If you have an enabled ad blocker when browsing, it constantly checks the visited pages and elements on them against these filtering rules, and blocks anything that matches. Rules are developed to block ads, trackers, and more. -* Widget and tracking block. Special filters will block all counters to protect your personal data, and remove all unnecessary social network widgets. +All filters are grouped into thematic categories. To see the full list of these categories (not to be confused with content blockers), go to *AdGuard for iOS Settings > Safari protection > Filters*. -* Surfing acceleration. AdGuard removes everything irrelevant from the web, and clear pages load much faster. + -**These functions are only available in Pro version:** +There are eight of them, each category unites several filters that serve and share a common purpose, i.e. blocking ads, social media widgets, cookie notices, protecting the user from online scams. To decide which filters suit your needs, read their descriptions and navigate by the labels (`ads`, `privacy`, `recommended`, etc.). -* **DNS-filtering in applications.** AdGuard for iOS Pro allows you to control access to the DNS services in applications - this filters the traffic in different applications and browsers, not just in Safari. +> More enabled filters does not guarantee that there will be less ads. A large number of various filters enabled simultaneously reduces the quality of ad blocking. -* **Whitelist / blacklist in the application.** Using this feature you can always enable or disable advertising filtering on certain sites. +> Custom filters category is empty by default for users to add there their filters by URL. You can find filters on the Internet or even try to [create one by yourself](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters). -* **DNS log.** Using DNS log yoy may find the respective request in the log and block the domain in request details. \ No newline at end of file + +## User rules + +Another section of the Safari protection screen that needs to be presented. Here you can add new rules — either by entering them manually, or by using [the AdGuard manual blocking tool in Safari](https://kb.adguard.com/en/ios/overview#assistant). This is needed to customize Safari filtering without adding an entire filter list. + +> Learn [how to create your own ad filters](https://kb.adguard.com/general/how-to-create-your-own-ad-filters). But please note that many of them won't work in Safari on iOS. + + + + +## Allowlist + +The third section of the Safari protection screen. If you want to disable ad blocking on a certain website, Allowlist would be of help. It allows you to add domains and subdomains to exlcusions. AdGuard for iOS has an Import/Export feature, so the allowlist from one device can be easily transferred to another. + + +## Assistant + + + +Assistant is a tool that helps you manage filtering in Safari right from the browser without switching back to the app. To see it, do the following: open Safari, tap on the arrow-in-a-box symbol. Then scroll down to AdGuard/AdGuard Pro (depending on the app you use) and tap it to fetch a window with several options: + +1. **Enable on this page.** Turn the switch off to add the current domain to the Allowlist. +2. **Block an element on this page.** Tap it to enter the 'Element blocking' mode: choose any element on the page, adjust the size by tapping 'plus' or 'minus', preview if necessary and then tap the checkmark icon to confirm. The selected element will be hidden from the page and a corresponding rule will be added to User rules. Remove or disable it there to revert the change. +3. **Report an issue on this page.** Opens a web reporting tool that will help you send a report to our support team in just a few clicks. Use it if you noticed a missed ad or an incorrect blocking on the page. + + +## DNS protection + +[DNS protection module](https://kb.adguard.com/en/general/dns-filtering) enhances your privacy by encrypting your DNS traffic. Unlike with Safari content blocking, DNS protection works system-wide, i.e. beyond Safari, in apps and other browsers. You have to enable this module before you're able to use it. It can be done either from the home screen or from *Settings > DNS protection*. + +> To be able to manage DNS settings, AdGuard apps require establishing a local VPN. It will not route your traffic through any remote servers. Nevertheless, the system will ask you to confirm permission access. + + +### DNS implementation + + + +This section has two options: AdGuard and Native implementation. Basically, these are two methods of setting up DNS. + +In Native implementation, the DNS is handled by the system and not the app. This means that AdGuard doesn't have to create a local VPN. Sadly, this will not help you circumvent system restrictions and use AdGuard alongside other VPN-based applications — if any VPN is enabled, native DNS is ignored. Consequently, you won't be able to filter traffic locally or to use our brand new [DNS-over-QUIC protocol (DoQ)](https://adguard.com/en/blog/dns-over-quic.html). + + +### DNS servers + +The first section you'll see on the DNS Protection screen is DNS server. It shows the currently selected DNS server and encryption type. To change either, tap on the button to enter the DNS server screen. + + + +Servers differ by their speed, employed protocol, trustworthiness, logging policy, etc. By default, AdGuard will suggest several DNS servers from among the most popular ones (including AdGuard DNS). Tap on any to change the encryption type (if such option is provided by the server's owner) or to view the server's homepage. We added labels such as `No logging policy`, `Ad blocking`, `Security` to help you make a choice. + +In addition, at the bottom of the screen there is an option to add a custom DNS server. It supports regular, DNSCrypt, DNS-over-HTTPS and DNS-over-TLS servers. + + +### Network settings + + + +Users can also handle their DNS security on the Network settings screen. *Filter mobile data* and *Filter Wi-Fi* enable or disable DNS protection for respective network types. Further down, at *Wi-Fi exceptions*, you can exclude particular Wi-Fi networks from DNS protection (for example, you might want to exclude your home network if you use [AdGuard Home](https://adguard.com/ru/adguard-home/overview.html)). + + +### DNS filtering + +To get access to this setting, *Advanced mode* has to be enabled from the *General settings* screen. After that, a new section will appear on the DNS protection screen. Tap it to customize your DNS traffic by applying own rules. + + + + +#### DNS filters + +Similar to filters that work in Safari, DNS filters are sets of rules written according to special [syntax](https://kb.adguard.com/ru/general/dns-filtering-syntax). AdGuard will monitor your DNS traffic and block requests that match one or more rules. You can use filters such as [AdGuard DNS filter](https://kb.adguard.com/ru/general/adguard-ad-filters#domains) or add hosts files as filters. Multiple filters can be added simultaneously. To know how to do it, get acquainted with [an exhaustive manual](https://kb.adguard.com/en/ios/solving-problems/how-to-configure-system-wide-blocking). + + +#### Allowlist and Blocklist + +On top of DNS filters, you can have targeted impact on DNS filtering by adding single domains to Blocklist or to Allowlist. Blocklist even supports the same DNS syntax, and both of them can be imported and exported, just like Allowlist in Safari content blocking. + + +## Activity +This is the 'information hub' of AdGuard's DNS protection suite. You can quickswitch to it by tapping the third icon in the row at the screen bottom. N.b. this screen is only seen when DNS protection is enabled. + + + +Here AdGuard displays stats about device's DNS requests, such as total number, number of encrypted requests and average processing time. AdGuard can display the stats for a day, a week, a month, or in total. + +Below is the *Recent activity* feed. AdGuard stores the last 1500 DNS requests that have originated on your device and shows their attributes such as protocol type and target domain. + +> AdGuard does not send this information anywhere. It is 100% local and does not leave your device. + +Tap on any request to view more details. There will also be buttons to add the request to Bloclist/Allowlist in one tap. + + + +Above the activity feed, there are *Most active companies*. Aggregated data on the last 1500 requests are shown here. + + +### Statistics + +Aside from the *Activity* screen, you can find global statistics on the home screen and on widgets. + + +## Low-level settings + + + +To open them, go to *Settings > General > Advanced settings > Low-level settings*. Mind that this section is only visible when Advanced mode is enabled. Some of these settings are better left intact: don't use them unless you know what you are doing or unless it's requested by support. Yet, other settings need further explanation and can be adjusted. + + +### Block IPv6 + +For any DNS query sent to get an IPv6 address, our app returns an empty response (as if this IPv6 address does not exist). Now there is an option not to return IPv6 addresses. At this point the description of this function becomes too technical: configuring or disabling IPv6 is the exclusive domain of advanced users. Presumably, if you are one of them, it will be good to know that we now have this feature, if not – there is no need to dive into it. + + +### Bootstrap and Fallback servers + +Fallback is a backup DNS server. If you chose a DNS server and something happened to it, a fallback is needed to set the backup DNS server until the main server responds. + +With Bootstrap, it’s a little more complicated. For AdGuard for iOS to use a custom secure DNS server, our app needs to get its IP address first. For this purpose, the system DNS is used by default, but sometimes this is not possible for various reasons. In such cases, Bootstrap could be used to get the IP address of the selected secure DNS server. Here are two examples to illustrate when a custom Bootstrap server might help: +1. When a system default DNS server does not return the IP address of a secure DNS server and it is not possible to use a secure one. +2. When our app and third-party VPN are used simultaneously and it is not possible to use System DNS as a Bootstrap. + + +# Other features + +While Safari content blocking and DNS protection are indisputably two major modules of AdGuard/AdGuard Pro, there are some other minor features that don't fall into either of them directly but still can be useful and are worth knowing about. + +- **Dark theme** + +

+
+ +
+
+ +
+
+ +Residing right at the top of **Settings** > **General** screen, this setting allows you to switch between dark and light themes. + +- **Widgets** + + + +AdGuard supports widgets that provide quick access to Safari content blocking and DNS protection switches, and also show global requests stats. + +- **Invert the Allowlist** + +An alternative mode for Safari filtering, it unblocks ads everywhere except for the specified websites from the list. Disabled by default. + +- **Reset statistics** + +Clears all statistical data, such as number of requests, etc. + +- **Advanced mode** + +Aside from unlocking **DNS filtering**, it grants access to **Advanced settings**. We don't recommend messing with those, unless you know what you're doing or you have consulted with technical support first. + +- **Send feedback** + +No matter how hard you try, sometimes things go off the rails. Use this option to contact support, report a missed ad (although we advise to use the Assistant for your own convenience), export logs or to make a feature request. + +- **About** + +Contains the current version of the app and an assortment of rarely needed options and links. \ No newline at end of file diff --git a/05.ios/01.overview/docs.ru.md b/05.ios/01.overview/docs.ru.md index 9ee06171..e697449f 100644 --- a/05.ios/01.overview/docs.ru.md +++ b/05.ios/01.overview/docs.ru.md @@ -1,37 +1,218 @@ --- -title: Обзор +title: Обзор функций taxonomy: category: - docs --- -AdGuard для iOS позволяет блокировать рекламу на смартфонах и планшетах производства компании Apple. AdGuard поддерживает больше 50 разных фильтров, оптимизированных для мобильного браузера Safari, включая специальный фильтр для сайтов на русском языке. +* [Функции](#features) + * [Блокировщики контента](#content-blockers) + * [Фильтры](#filters) + * [Пользовательские правила](#user-rules) + * [Белый список](#allowlist) + * [Помощник](#assistant) + * [DNS-защита](#dns-protection) + * [Реализация DNS](#dns-implementation) + * [DNS-серверы](#dns-servers) + * [Настройки сети](#network-settings) + * [Фильтрация DNS-запросов](#dns-filtering) + * [DNS-фильтры](#dns-filters) + * [Белый и чёрный список](#allowlist-blocklist) + * [Активность](#activity) + * [Статистика](#statistics) + * [Низкоуровневые настройки](#low-level-settings) + * [Блокировать IPv6](#blockipv6) + * [Bootstrap- и Fallback-серверы](#bootstrap-fallback) +* [Другие функции](#other-features) -AdGuard позволяет пользователю гибко менять настройки: вы можете добавить любой сайт в исключения, и реклама на таких сайтах не будет блокироваться. Также вы можете управлять всеми фильтрами AdGuard, при необходимость включать, отключать их, или даже создавать собственные. +Если вы будете искать AdGuard в App Store, то найдёте два приложения — [AdGuard](https://itunes.apple.com/app/id1047223162) и [AdGuard Pro](https://itunes.apple.com/app/id1126386264). Они созданы для блокировки рекламы и трекинга в Safari, в приложениях и других браузерах, а также для управления DNS-фильтрацией. Не дайте разным названиям себя обмануть, оба приложения одинаково блокируют рекламу на айфонах и айпадах. Раньше их функционал отличался из-за меняющихся принципов App Store, но теперь приложения [практически идентичны](https://adguard.com/ru/blog/updating-adguard-pro-for-ios.html). Так что если у вас уже есть AdGuard Pro, не нужно скачивать AdGuard и покупать там лицензию, и наоборот. -В каталоге приложений App Store доступно две версии AdGuard для iOS — [бесплатная](https://itunes.apple.com/us/app/id1047223162) и [AdGuard Pro](https://itunes.apple.com/ru/app/id1126386264). Основное отличие этой версии от базовой заключается в том, что AdGuard Pro не ограничивается одним лишь браузером Safari: он будет работать во всех приложениях и браузерах. + +# Функции +У AdGuard и AdGuard Pro для iOS много функций для блокирования рекламы и трекеров и создания пользовательских правил, как в Safari, так и на уровне сети. + + +## Блокировщики контента + +Блокировщики контента служат «контейнерами» для хранения правил фильтрации, которые и выполняют основную работу: блокируют рекламу и трекинг. В AdGuard для iOS шесть блокировщиков контента: General, Privacy, Social, Security, Custom, и Other. Apple разрешает использовать только 50 000 правил фильтрации на один блокировщик контента, следовательно, в шести блокировщиках контента AdGuard их около 300 000. + +Все блокировщики контента, их статусы, используемые на данный момент фильтры и общее количество правил фильтрации можно найти на соответствующем экране в *Расширенных настройках*. + + + +> Подсказка: для наилучшего качества фильтрации рекомендуем держать все блокировщики контента включёнными. + + +## Фильтры + +Работа блокировщиков рекламы основана на фильтрах. Каждый фильтр – это список правил фильтрации. Когда вы пользуетесь интернетом со включённым блокировщиком рекламы, то последний постоянно проверяет посещаемые страницы и элементы на них. Всё, что соответствует каким-либо правилам фильтрации, он блокирует (или изменяет иным образом, в зависимости от конкретного правила). Правила построены таким образом, чтобы блокировать трекеры, рекламу и многое другое. + +Фильтры сгруппированы в тематические категории. Чтобы увидеть полный список категорий (не путать с блокировщиками контента), откройте *Настройки AdGuard для iOS > Защита Safari > Фильтры*. + + + +Всего категорий восемь, каждая объединяет несколько фильтров, служащих общей цели. Например, они блокируют рекламу, виджеты социальных сетей, уведомления о cookie или защищают пользователя от мошенников. Чтобы вам было легче решить, какие фильтры вам подходят, читайте их описания и ориентируйтесь по меткам (`ads`, `privacy`, `recommended` и т.д.). + +> Имейте в виду, что одновременное включение большого количества фильтров может привести к выходу за лимит по правилам, и в редких случаях — к конфликтам между фильтрами. + +> Категория пользовательских фильтров пуста по умолчанию, чтобы пользователи могли добавлять туда свои фильтры по URL. Их можно найти в интернете или даже попробовать [создать самостоятельно](https://kb.adguard.com/ru/general/how-to-create-your-own-ad-filters). + + +## Пользовательские правила +Ещё один раздел экрана защиты Safari. Здесь вы можете добавить новые правила - либо введя их вручную, либо используя [инструмент ручной блокировки AdGuard в Safari](https://kb.adguard.com/ru/ios/overview#assistant). Пользовательские правила помогают настроить фильтрацию Safari без добавления целого списка фильтров. + +> Узнайте, [как создавать свои фильтры](https://kb.adguard.com/general/how-to-create-your-own-ad-filters). Но обратите внимание, что не все они будут работать в Safari на iOS. + + + + +## Белый список +Третий раздел на экране Защита Safari. Если вы хотите отключить блокировку рекламы на определённом сайте, Белый список поможет это сделать. Он позволяет добавлять домены и поддомены в список исключений. На AdGuard для iOS есть функция экспорта/импорта настроек, чтобы управлять целыми списками (например, чтобы переносить их на другие устройства). + + +## Помощник + + + +Помощник – это инструмент, который помогает вам управлять фильтрацией прямо из Safari, не возвращаясь в приложение. Чтобы увидеть его, откройте браузер, нажмите на иконку коробки со стрелкой, направленной вверх, проскролльте до *AdGuard*/*AdGuard Pro* (в зависимости от того, что у вас установлено) и нажмите на него – откроется окно с несколькими опциями. + +1. **Включить на этом сайте**. Выключите, чтобы добавить текущий домен в **Белый список**. +2. **Заблокировать элемент на этой странице**. Нажмите, чтобы перейти в режим "Блокировка элемента": выберите любой элемент на странице, отрегулируйте размер, нажимая на "+" или "-", воспользуйтесь предварительным просмотром, если необходимо, и нажмите на галочку, чтобы подтвердить. Выбранный элемент будет скрыт со страницы, а соответствующее правило – добавлено в **Пользовательские правила**. Уберите или отключите его, чтобы вернуть блокировку. +3. **Сообщить о проблеме на этой странице**. Открывает инструмент отправки веб-отчёта, с помощью которого вы сможете быстро обратиться к нашей команде поддержки. Используйте его, если заметили пропущенную рекламу или некорректную блокировку на странице. + + +# DNS-защита + +Модуль DNS-защиты усиливает конфиденциальность, шифруя ваш [DNS-трафик](https://kb.adguard.com/ru/general/dns-filtering-android#what-is-dns). В отличие от блокировки контента Safari, DNS-защита распространяется на всё устройство. Включите этот модуль, чтобы шифровать DNS-трафик и блокировать отслеживающие домены. Это можно сделать с главного экрана или отсюда: **Настройки** > **DNS-защита**. + +>Чтобы управлять DNS-настройками, приложения AdGuard требуют установить **локальный** VPN. Он не будет направлять ваш трафик через какие-либо удалённые серверы. Тем не менее, система попросит вас подтвердить разрешение на доступ. + + +## DNS-серверы + +**DNS-сервер** – это первая опция, которую вы увидите на экране **DNS-защиты**. В ней показаны выбранные в данный момент DNS-сервер и тип шифрования. Нажмите на кнопку **DNS-сервер**, если хотите изменить один из этих параметров (или оба). + + + +Серверы отличаются своей скоростью, используемым протоколом, надёжностью, политикой логирования и т.д. По умолчанию AdGuard предложит несколько DNS-серверов из числа наиболее популярных (включая [AdGuard DNS](https://adguard.com/ru/adguard-dns/overview.html)). Нажмите на любой из них, чтобы изменить тип шифрования (если такая опция предусмотрена владельцем сервера) или перейти на домашнюю страницу сервера. Мы добавили такие ярлыки, как `Политика "Без логов"`, `Блокировка рекламы`, `Безопасность`, чтобы помочь вам сделать выбор. + +Помимо этого, в нижней части экрана есть возможность добавить пользовательский DNS-сервер. Он поддерживает обычные серверы, DNSCrypt, DNS-over-HTTPS и DNS-over-TLS. + + +## Настройки сети + +На экране *Настройки сети* вы можете управлять DNS-защитой разными способами. + + + +Опции *Фильтровать мобильные данные* и *Фильтровать Wi-Fi* включают или отключают DNS-защиту для соответствующих типов сети. Ниже, в разделе *Сети-исключения*, вы можете исключить определённые сети Wi-Fi из DNS-защиты (например, вы, возможно, захотите исключить домашнюю сеть, если используете [AdGuard Home](https://adguard.com/ru/adguard-home/overview.html)). + + +## DNS-фильтрация + +Когда вы используете одно из приложений AdGuard, поддерживающее [DNS-фильтрацию](https://kb.adguard.com/ru/general/dns-filtering#dns-filtering), оно работает как буфер между вашим устройством и DNS-сервером. Все DNS-запросы, которые ваши браузеры и приложения собираются отправить, сначала обрабатываются AdGuard. + +Чтобы получить доступ к *DNS-фильтрации*, сначала включите *Расширенный режим* в *Общих настройках*. После этого на экране *DNS-защита* появится новая кнопка. Нажмите на неё, чтобы настроить DNS-трафик, применив собственные правила. + + + + +### DNS-фильтры + +Подобно фильтрам, которые работают в Safari, DNS-фильтры представляют собой наборы правил, написанных в соответствии со специальным [синтаксисом](https://kb.adguard.com/ru/general/dns-filtering-syntax). AdGuard будет отслеживать ваш DNS-трафик и блокировать запросы, подходящие под одно или несколько правил. Вы можете использовать такие фильтры, как [AdGuard DNS](https://kb.adguard.com/ru/general/adguard-ad-filters#domains), или добавлять файлы hosts в качестве фильтров. Также вы можете добавить несколько фильтров одновременно. Исчерпывающее руководство можно найти в нашей [Базе знаний](https://kb.adguard.com/ru/ios/solving-problems/how-to-add-your-own-filter). + +### Белый и чёрный список + +Вы можете точечно влиять на DNS-фильтрацию не только с помощью DNS-фильтров, но и добавляя отдельные домены в списки. Чёрный список даже поддерживает тот же синтаксис для DNS-фильтрации, и оба списка – Белый и Чёрный – можно импортировать и экспортировать, как и Белый список в блокировке контента Safari. -Благодаря интеграции с AdGuard DNS, AdGuard Pro может фильтровать трафик в двух режимах. Режим По умолчанию — это базовый режим для блокирования рекламы, трекеров, фишинговых сайтов и так далее. Семейный режим включает в себя всё, что может режим "По умолчанию", но вдобавок к этому также блокирует все сайты со "взрослым" контентом. Этот режим идеально подойдет, если вы, например, установили AdGuard Pro на iOS-устройство вашего ребенка. Журнал запросов DNS поможет вам отслеживать все запросы и легко занести в белый список любой сайт, для которого вы хотели бы отключить фильтрацию. + +## Активность + +Это "информационный портал" DNS-защиты AdGuard. Вы можете быстро переключиться на него, нажав на третий значок в строке внизу экрана. + + + +Здесь AdGuard отображает статистику DNS-запросов вашего устройства, такую как их общее количество, количество зашифрованных запросов и среднее время обработки. AdGuard может отображать статистику за день, неделю, месяц или за всё время. + +Ниже есть лента *Недавняя активность*. AdGuard хранит последние 1500 DNS-запросов с вашего устройства и показывает информацию о них: например, тип протокола и домен. + +> AdGuard **никуда не посылает** эту информацию. Она на 100% локальна и не покинет ваше устройство. + +Нажмите на любой запрос, чтобы просмотреть подробную информацию о нём. Внизу также будут кнопки, предлагающие добавить запрос в Белый/Чёрный список. + + + +Над лентой активности находятся *Наиболее активные компании*. Здесь собраны сводные данные по последним 1500 запросам, компании расположены в порядке убывания отправленных запросов. + + +### Статистика + +Вы можете найти глобальную статистику на экране **Активность**, на главном экране и в виджетах. + + +## Низкоуровневые настройки + + + +Чтобы открыть их, перейдите в *Настройки > Общие > Расширенные настройки > Низкоуровневые настройки*. Имейте в виду, что этот раздел доступен, только если включен Расширенный режим. Некоторые настройки лучше не трогать: используйте их, только если уверены в том, что делаете, или если об этом попросила команда поддержки. Однако другие настройки можно изменять самостоятельно. + + +### Блокировать IPv6 + +На любой запрос к DNS-серверу на получение IPv6-адреса наше приложение возвращает пустой ответ, как будто этого адреса не существует. Новая функция позволяет не возвращать IPv6-адреса. Боюсь, что её дальнейшее описание получится слишком техническим: всё-таки настройка или отключение IPv6 — это исключительная прерогатива продвинутых пользователей. Если вы один из них, то наверняка и так знаете, что это за функция, если нет – то, честно говоря, и нет необходимости погружаться в эти детали. + + +### Bootstrap- и Fallback-серверы + +Fallback — это резервный DNS-сервер. Если вы выбрали DNS-сервер и с ним что-то случилось, необходим такой запасной вариант, который будет использоваться, пока не отвечает основной. + +С Bootstrap чуть сложнее. Чтобы AdGuard для iOS мог использовать кастомный защищённый DNS-сервер, наше приложение должно сначала получить его IP-адрес. Для этой цели по умолчанию используется системный DNS, но иногда это невозможно по разным причинам. В таких случаях для получения IP-адреса выбранного DNS-сервера можно использовать Bootstrap. Вот два примера случаев, когда кастомный Bootstrap-сервер может помочь: +1. Когда системный DNS-сервер, выбранный по умолчанию, не возвращает IP-адрес защищённого DNS-сервера и последний невозможно использовать. +2. Когда наше приложение и сторонний VPN используются одновременно и невозможно использовать системный DNS в качестве Bootstrap. + + +# Другие функции + +Хотя блокировка контента Safari и DNS-защита – это, несомненно, два основных модуля AdGuard/AdGuard Pro, есть и другие второстепенные функции, которые не подпадают ни под одну из этих категорий напрямую, но всё же могут быть полезны и о них стоит узнать. + +- **Тёмная тема** + +
+
+ +
+
+ +
+
+ +Эта настройка находится наверху экрана **Общих настроек** и позволяет переключаться между тёмной и светлой темой. + +- **Виджеты** + + + +AdGuard поддерживает виджеты, которые дают быстрый доступ к блокировке контента Safari и переключению DNS-защиты, а также показывают глобальную статистику запросов. + +- **Инвертировать белый список** + +Альтернативный режим для фильтрации Safari, который разблокирует рекламу везде, кроме сайтов из списка. Отключен по умолчанию. + +- **Сбросить статистику** + +Очищает все данные статистики, такие как количество запросов и т.д. + +- **Режим разработчика** + +Помимо включения **DNS-фильтрации**, он предоставляет доступ к **Расширенным настройкам**. Не рекомендуем менять эти настройки, только если вы не уверены в том, что делаете, или не проконсультировались с технической поддержкой заранее. + +- **Отправить отзыв** + +Как ни старайся, иногда всё идёт наперекосяк. Используйте эту опцию, чтобы связаться со службой поддержки, чтобы сообщить о пропущенной рекламе (хотя мы советуем использовать Помощник для вашего удобства), экспортировать логи или отправить запрос на добавление новой функции. + +- **О программе** + +Содержит текущую версию приложения и набор некоторых редко используемых опций и ссылок. -Разумеется, AdGuard Pro умеет выполнять те же функции, что и базовая версия — блокировать рекламу, счетчики и вредоносные сайты в Safari, имеет широкий выбор фильтров - как собственных фильтров AdGuard, так и самых популярных "внешних" фильтров типа EasyList. Благодаря AdGuard для iOS веб-страницы загружаются намного быстрее — ведь в них отсутствуют баннеры, лишние картинки и рекламное видео. -![](adguard_dns.png) -## ФУНКЦИИ -* Блокировка рекламы. AdGuard блокирует все виды рекламы; к вашим услугам более 50 различных фильтров. С AdGuard вы забудете, что такое баннеры, видеореклама, всплывающие окна и т.д. - -* Включает в себя популярные фильтры Adblock: EasyList, EasyPrivacy, Fanboys Annoyances, Malware Domains. AdGuard обеспечивает двойную защиту с помощью как сторонних, так и собственных фильтров. - -* Региональные и другие фильтры. AdGuard - первый блокировщик, который позволяет использовать разнообразные региональные фильтры. Посещайте сайты на разных языках - они также будут фильтроваться AdGuard. - -* Блокировка виджетов и систем слежения. Специальные фильтры заблокируют все счетчики, чтобы защитить ваши личные данные, и уберут все лишние кнопки социальных сетей. - -* Ускорение интернета. AdGuard убирает из сети все лишнее, и чистые страницы загружаются гораздо быстрее. - -**Эти функции доступны только в версии Pro:** - -* **DNS-фильтрация в приложениях.** Версия AdGuard для iOS Pro позволяет контролировать обращения к службам DNS в приложениях - это дает возможность фильтровать трафик других приложений и браузеров, а не только в Safari. - -* **Возможность заносить сайты в белый/черный список.** Благодаря этой функции вы всегда сможете включать или отключать фильтрацию рекламы на определенных сайтах. - -* **Журнал DNS-запросов.** Ведение журнала DNS запросов позволяет найти в журнале нужный запрос и заблокировать домен в деталях запроса. \ No newline at end of file diff --git a/05.ios/02.installation/docs.ja.md b/05.ios/02.installation/docs.ja.md new file mode 100644 index 00000000..6ff36216 --- /dev/null +++ b/05.ios/02.installation/docs.ja.md @@ -0,0 +1,65 @@ +--- +title: AdGuard for iOS インストール方法 +published: true +taxonomy: + category: + - docs +--- + +## 動作環境 + +**iPhone:** iOS 11.2以上 + +**iPad:** iOS 11.2以上 + +**iPod touch:** iOS 11.2以上 + +## AdGuard for iOS インストール方法 + +「AdGuard」はApp Storeにある無料アプリ（プレミアム機能を提供するアプリ内課金あり）です。 + +インストールするには、 + +こちらの[App Storeリンク](https://apps.apple.com/app/apple-store/id1047223162)へ進む + +もしくは +App Storeを開く→検索欄をタップ + + + +検索欄に「_adguard_」と入力し、結果で表示される「**AdGuard ー Safariでしっかり広告ブロック**」アプリをタップ + + + +開いたページで「入手する」をタップし、必要に応じてApple IDのパスワードを入力してください。 + + + +## AdGuard Pro for iOSのインストール方法 + +「AdGuard Pro」はApp Store一括購入のアプリであり、プレミアム機能が有効状態の「AdGuard」アプリと完全に同じ機能を提供します。 + +インストールするには、 +こちらの[App Storeリンク](https://apps.apple.com/app/apple-store/id1126386264)を開くか、 + +App Storeで検索を開いてください。 + + + +検索欄に 「_adguard_」と入力し、 +「AdGuard Pro - 本格的な広告ブロック」をタップ + + + +次に、価格表示ボタンを押して、アプリを購入とインストールしてください。 + +必要に応じて、Apple IDのパスワードを入力してください。 + + + +【**ライセンスキーご利用の場合**】 + +ライセンスキーでプレミアム機能を有効にする場合は、無料アプリの「AdGuard」でAdGuardアカウントにログインしてください。 +詳しい手順は[こちら](https://kb.adguard.com/ja/general/license-key#adguard-for-ios%E3%82%92%E6%9C%89%E5%8A%B9%E5%8C%96%E3%81%99%E3%82%8B%E6%96%B9%E6%B3%95)でご確認いただけます。 + +(※「AdGuard Pro」はApp Storeで一括購入されるアプリなので、ライセンスキーの使用は「AdGuard」になります。ライセンスキーでプレミアム機能が有効化された「AdGuard」アプリと「AdGuard Pro」アプリは完全に同機能を提供しますので、どちらか一つあれば十分です。) diff --git a/05.ios/02.installation/docs.ko.md b/05.ios/02.installation/docs.ko.md new file mode 100644 index 00000000..37d85265 --- /dev/null +++ b/05.ios/02.installation/docs.ko.md @@ -0,0 +1,40 @@ +--- +title: 설치 방법 +published: true +taxonomy: + category: + - docs +--- +## 시스템 요구 사항 +* iOS 10.0 이상 +* iPhone 5s, iPhone 6, iPhone 6 Plus, iPhone 6s, iPhone 6s Plus, iPhone 7(64 비트)과 호환 +* iPad Air, iPad Air Wi-Fi + Cellular, iPad mini 2, iPad mini 2 Wi-Fi + Cellular, iPad Air 2, iPad Air 2 Wi-Fi + Cellular, iPad mini 3, iPad mini 3 Wi-Fi + Cellular, iPad mini 4, iPad mini 4 Wi-Fi + Cellular, iPad Pro, 및 iPod touch 6 세대(64 비트)와 호환 + +## iOS용 AdGuard 설치 방법 +iOS용 AdGuard는 App Store에서 다운로드할 수 있는 무료 앱입니다. AdGuard를 설치하려면 App Store 앱을 실행하고 화면 하단의 _Search_ 아이콘을 탭하세요. + + + +검색창에 _adguard_를 입력한 후 표시될 _adGuard_를 탭하세요. + + + +App Store의 열린 페이지에서 AdGuard-adblock privacy 아래에 있는 _GET_ 버튼을 누른 후 _INSTALL 버튼을 클릭합니다. 설치를 완료하려면 Apple ID 로그인 및 암호를 입력하고 설치가 완료될 때까지 기다리십시오. + + + +## iOS용 AdGuard Pro 설치 방법 +AdGuard Pro는 프리미엄 기능을 제공하는 iOS용 AdGuard의 유료 버전입니다. AdGuard Pro를 설치하려면 App Store 앱을 실행하고 화면 하단의 _Search_ 아이콘을 탭하세요. + + + + +검색창에 _adguard_를 입력한 후 표시될 _adGuard pro - adblock_를 탭하세요. + + + +App Store의 열린 페이지에서 AdGuard Pro-block 아래에 라이선스 가격이 있는 버튼을 탭한 후 BUY 버튼을 누릅니다. 설치를 완료하려면 Apple ID 로그인 및 암호를 입력하고 설치가 완료될 때까지 기다리십시오. + + + +라이선스는 개인 AdGuard 계정에서 사용자 자격 증명을 입력하여 활성화 할 수 있습니다. 이를 위해서 사용자는 하나 추가의 예비 라이선스 키가 있어야 합니다. diff --git a/05.ios/02.installation/docs.zh.md b/05.ios/02.installation/docs.zh.md new file mode 100644 index 00000000..d409f347 --- /dev/null +++ b/05.ios/02.installation/docs.zh.md @@ -0,0 +1,51 @@ +--- +title: 安装过程 +published: true +taxonomy: + category: + - docs +--- + +## 系统需求 + +* 要求 iOS 10.0 或更高版本 + +* 可用于 iPhone 5s、iPhone 6、iPhone 6 Plus、iPhone 6s、iPhone 6s Plus、iPhone 7（64 位设备）。 + +* 可用于：iPad Air、iPad Air Wi-Fi + Cellular、iPad mini 2、iPad mini 2 Wi-Fi + Cellular、iPad Air 2、iPad Air 2 Wi-Fi + Cellular、iPad mini 3、iPad mini 3 Wi-Fi + Cellular、iPad mini 4、iPad mini 4 Wi-Fi + Cellular、iPad Pro、iPad Pro Wi-Fi + Cellular 和 iPod touch 第 6 代（64位设备）。 + +> **请注意：目前 AdGuard 广告拦截程序无法在中国大陆的 App Store 里下载。为了下载适用于 iOS 的 AdGuard 广告拦截程序，请您们更改 Apple ID 的地区（比如，香港、美国等等）** + +## AdGuard iOS 版的安装过程 + +AdGuard iOS 版是 App Store 里可免费下载的应用程序。如您想要在您的设备上安装 AdGuard iOS 版，请您打开 App Store 并在下面点击 “Search”（搜索）图标。 + + + +先在搜索栏输入 _adguard_，然后在搜索结果找到并按 _AdGuard_ 选项。 + + + +在 App Store 打开的页面上 _AdGuard - adblock&privacy_ 选项下点击 _GET_（获取）按钮，然后点击 _INSTALL_(安装)。 + +为了完成安装过程，您可能会看到要求输入您的苹果 ID 和密码的弹窗。输入您的 ID 和密码后，请等待安装成功完成。 + + + +## AdGuard Pro iOS 版的安装过程 + +AdGuard Pro 是 AdGuard iOS 版的付费版本。AdGuard Pro 为用户提供更多功能。为了安装 AdGuard Pro 请您打开 App Store 并在下面按 _Search_（搜索）图标。 + + + +先在搜索栏输入 _adguard_，然后在搜索结果找到并按 _AdGuard Pro_ 选项。 + + + +在打开的 App Store 页面上 _AdGuard Pro - adblock_ 选项下点击显示许可价格的按钮。点击价格后，请您点击 _BUY_（购买）。 + +为了完成安装流程，您可能会看到要求输入您的苹果 ID 和密码的弹窗。输入您的 ID 和密码后，请等待安装成功完成。 + + + +*您要输入 AdGuard 个人账号的用户身份信息以激活许可。为执行此操作，用户至少要有一个许可。* diff --git a/05.ios/03.features/docs.en.md b/05.ios/03.features/docs.en.md index 01a47ada..1d2a2b59 100644 --- a/05.ios/03.features/docs.en.md +++ b/05.ios/03.features/docs.en.md @@ -1,6 +1,7 @@ --- title: Features published: true +visible: false taxonomy: category: - docs diff --git a/05.ios/03.features/docs.ru.md b/05.ios/03.features/docs.ru.md index 1102d384..8449c619 100644 --- a/05.ios/03.features/docs.ru.md +++ b/05.ios/03.features/docs.ru.md @@ -1,6 +1,7 @@ --- title: Функции published: true +visible: false taxonomy: category: - docs diff --git a/05.ios/05.solving-problems/08.how-to-configure-system-wide-blocking/docs.en.md b/05.ios/05.solving-problems/08.how-to-configure-system-wide-blocking/docs.en.md new file mode 100644 index 00000000..2ce8ed46 --- /dev/null +++ b/05.ios/05.solving-problems/08.how-to-configure-system-wide-blocking/docs.en.md @@ -0,0 +1,56 @@ +--- +title: 'How to configure system-wide blocking with AdGuard for iOS?' +taxonomy: + category: + - docs +--- + + * [About system-wide blocking](#system-wide) + * [How to add a DNS filter/hosts file](#filters) + + +System-wide blocking means blocking ads and trackers beyond the Safari browser, i.e. in other apps and browsers. This article will tell you how to set it up on your iOS device. + +On iOS, the only way to block ads and trackers system-wide is to use [DNS filtering](https://kb.adguard.com/en/general/dns-filtering). First, you have to enable DNS protection. To do so, open *AdGuard for iOS settings* —> *DNS protection* and switch it on. + + + +Now, if your purpose is to block ads and trackers system-wide, you have two options: + +1. Enable AdGuard DNS server (*Settings* —> *DNS protection* —> *DNS server* —> *AdGuard DNS*). +2. Add a DNS filter/hosts file that will block ad and tracking domains, e.g. AdGuard DNS filter. + +The second option takes a bit more time to set up but has several advantages: + +* You can use any DNS server at your discretion and you are not tied up to a specific blocking server. +* You can add multiple DNS filters and/or hosts files at the same time, but you can't use multiple DNS servers at once. + + +

How DNS filtering works

+ + +### How to add a DNS filter/hosts file + +You can add any DNS filter or hosts file, the instruction will be the same for all of them. For the sake of the example, let's add [AdGuard DNS filter](https://github.com/AdguardTeam/AdguardSDNSFilter). It is composed of several other filters (AdGuard Base filter, Social Media filter, Tracking Protection filter, Mobile Ads filter, EasyList, EasyPrivacy, etc.) and it's simplified specifically to be better compatible with DNS-level ad blocking. + +1. Open *AdGuard for iOS settings* —> *General*. +2. Enable *Advanced mode*. The 'Advanced settings' tab will appear. Open it. + +
+
+ +
+
+ +
+
+ +> Note: We don't recommend touching other settings you'll find inside the *Advanced settings* tab, especially when it comes to *Low-level settings*. Some of them might break the Internet connection or compromise your privacy and security, so it's better to be careful. The text below describes the exact actions required to add AdGuard DNS filter. + +3. Copy this link: `https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt`. +4. Open *AdGuard for iOS settings* —> *DNS protection* —> *DNS filtering* (available while *Advanced mode* is enabled) —> *DNS filters*. +5. *Click *Add a filter* button, paste the link into the filter URL field, and click 'Next'. + + + +> Add any number of other DNS filters the same way by pasting a different URL at step 3. You can find various filters and links to them [here](https://filterlists.com). diff --git a/05.ios/05.solving-problems/08.how-to-configure-system-wide-blocking/docs.ru.md b/05.ios/05.solving-problems/08.how-to-configure-system-wide-blocking/docs.ru.md new file mode 100644 index 00000000..f8f24047 --- /dev/null +++ b/05.ios/05.solving-problems/08.how-to-configure-system-wide-blocking/docs.ru.md @@ -0,0 +1,56 @@ +--- +title: 'Как настроить системную фильтрацию в AdGuard для iOS?' +taxonomy: + category: + - docs +--- + + * [О системной фильтрации](#system-wide) + * [Как добавить DNS-фильтр/hosts-файл](#filters) + + +Под системной блокировкой понимается блокировка рекламы и трекеров за пределами браузера Safari, то есть в других приложениях и браузерах. + +На iOS единственный способ заблокировать рекламу и трекинг на системном уровне — это [DNS-фильтрация](https://kb.adguard.com/ru/general/dns-filtering). Для начала вам понадобится включить DNS-защиту. Сделать это можно, открыв раздел *настройки AdGuard для iOS* —> *DNS-защита*. Передвиньте ползунок переключателя в положение «вкл». + + + +Теперь, если ваша цель — заблокировать рекламу и трекинг везде, а не только в Safari, то у вас две опции: + +1. Включить сервер AdGuard DNS (*Настройки* —> *DNS-защита* —> *DNS-сервер* —> *AdGuard DNS*). +2. Добавить DNS-фильтр или hosts-файл, который будет блокировать рекламные и трекинговые домены, например, фильтр AdGuard DNS. + +Настройка второго варианта займёт немного больше времени, зато он обладает несколькими преимуществами: + +* Можно использовать любой DNS-сервер по своему предпочтению, а не только конкретный блокирующий сервер. +* Вы можете добавлять сразу несколько DNS-фильтров и/или hosts-файлов, но вы не можете одновременно использовать несколько DNS-серверов. + + +

Схематичное объяснение DNS-фильтрации

+ + +### Как добавить DNS-фильтр/hosts-файл + +Вы можете добавлять любые DNS-фильтры или hosts-файлы, инструкция будет одинаковой для всех. Для примера давайте возьмём [фильтр AdGuard DNS](https://github.com/AdguardTeam/AdguardSDNSFilter). Он составлен из нескольких других фильтров (Базовый фильтр AdGuard, Фильтр счётчиков и системы аналитики, Фильтр виджетов, Фильтр социальных сетей, Фильтр мобильной рекламы, EasyList, EasyPrivacy и т. д.) и упрощён специально, чтобы лучше блокировать рекламу на уровне DNS-запросов. + +1. Откройте *настройки AdGuard для iOS* —> *Общие*. +2. Включите *Расширенный режим*. Появится вкладка «Расширенные настройки». Откройте её. + +
+
+ +
+
+ +
+
+ +> Важно: мы не рекомендуем менять другие настройки в этом разделе, особенно *Низкоуровневые настройки*. Изменение некоторых из них может привести к проблемам с интернетом или скомпрометировать вашу онлайн-конфиденциальность. Не меняйте их, если не знаете, что делаете. Далее описаны точные шаги, необходимые для добавления фильтра AdGuard DNS. + +3. Скопируйте эту ссылку: `https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_15_DnsFilter/filter.txt`. +4. Откройте настройки AdGuard для iOS —> *DNS-защита* —> *DNS-фильтрация* (доступна, когда *Расширенный режим* включен) —> *DNS-фильтры*. +5. Нажмите кнопку «Добавить фильтр», вставьте ссылку в поле URL фильтра и нажмите кнопку «Далее». + + + +> Вы можете добавлять любое количество других фильтров аналогичным образом, подставляя их URL на шаге 3. Огромный выбор различных фильтров и ссылки на них доступны [здесь](https://filterlists.com). diff --git a/05.ios/05.solving-problems/08.how-to-add-your-own-filter/docs.zh.md b/05.ios/05.solving-problems/08.how-to-configure-system-wide-blocking/docs.zh.md similarity index 100% rename from 05.ios/05.solving-problems/08.how-to-add-your-own-filter/docs.zh.md rename to 05.ios/05.solving-problems/08.how-to-configure-system-wide-blocking/docs.zh.md diff --git a/05.ios/05.solving-problems/10.how-to-block-ads-on-YouTube/docs.en.md b/05.ios/05.solving-problems/10.how-to-block-ads-on-YouTube/docs.en.md new file mode 100644 index 00000000..a19c2c61 --- /dev/null +++ b/05.ios/05.solving-problems/10.how-to-block-ads-on-YouTube/docs.en.md @@ -0,0 +1,30 @@ +--- +title: 'How to block ads on YouTube in Safari' +taxonomy: + category: + - docs + +--- +## How to block ads on YouTube in Safari + +Unfortunately, ad blocking in the YouTube app is technically impossible, but if you watch YouTube in Safari, there is a way. We developed an action extension (available since AdGuard v4.2 for iOS) designed specifically to block ads there. After you update your app to v4.2, this extension will be installed automatically, you don't have to follow any complicated instructions. Other than ads, the extension removes the placeholder remaining after blocking on iPads. Plus, YouTube videos are played automatically again and you don't have to make an extra tap. + +
+
+ +
+
+ +
+
+ +To activate the extension and block ads on YouTube, do the following: + +1. Open youtube.com in Safari. +2. Tap the Share button. +3. Tap "Block YouTube Ads (by AdGuard)". + +YouTube is now ad-free! Please note that you need to run this extension again if you reload the page. + +> In some cases the AdGuard extension may be not displayed. If you don't see it, try to follow the instruction again or restart your device + diff --git a/05.ios/05.solving-problems/10.how-to-block-ads-on-YouTube/docs.ru.md b/05.ios/05.solving-problems/10.how-to-block-ads-on-YouTube/docs.ru.md new file mode 100644 index 00000000..65bbe00f --- /dev/null +++ b/05.ios/05.solving-problems/10.how-to-block-ads-on-YouTube/docs.ru.md @@ -0,0 +1,31 @@ +--- +title: 'Как заблокировать рекламу на YouTube в Safari' +taxonomy: + category: + - docs + +--- +## Как заблокировать рекламу на YouTube в Safari + +К сожалению, блокировать рекламу в приложении YouTube технически невозможно, но если вы смотрите YouTube в браузере, выход есть. Специально для этой цели мы разработали расширение (доступно начиная с версии 4.2 AdGuard для iOS). + +Расширение устанавливается само с обновлением приложения AdGuard, его не нужно добавлять по инструкции. Помимо рекламы, расширение убирает белое поле, остающееся после блокировки на айпадах. Кроме того, видео теперь снова воспроизводятся автоматически и вам не нужно делать лишнее нажатие. + +
+
+ +
+
+ +
+
+ +Чтобы активировать расширение и блокировать рекламу на YouTube, сделайте следующее: + + 1. Откройте youtube.com в Safari. + 2. Нажмите на кнопку «Поделиться». + 3. Нажмите «Блокировать рекламу на YouTube (от AdGuard)». + +Теперь YouTube без рекламы! Обратите внимание, что вам нужно будет заново включить расширение, если вы перезагрузите страницу. + +> N.B. В редких случаях расширение AdGuard может не отображаться. Если вы его не видите, попробуйте заново проделать действия выше или перезагрузить устройство.* \ No newline at end of file diff --git a/05.ios/05.solving-problems/08.how-to-add-your-own-filter/docs.en.md b/05.ios/05.solving-problems/OLD-how-to-add-your-own-filter/docs.en.md similarity index 100% rename from 05.ios/05.solving-problems/08.how-to-add-your-own-filter/docs.en.md rename to 05.ios/05.solving-problems/OLD-how-to-add-your-own-filter/docs.en.md diff --git a/05.ios/05.solving-problems/08.how-to-add-your-own-filter/docs.ru.md b/05.ios/05.solving-problems/OLD-how-to-add-your-own-filter/docs.ru.md similarity index 100% rename from 05.ios/05.solving-problems/08.how-to-add-your-own-filter/docs.ru.md rename to 05.ios/05.solving-problems/OLD-how-to-add-your-own-filter/docs.ru.md diff --git a/05.ios/05.solving-problems/OLD-how-to-add-your-own-filter/docs.zh.md b/05.ios/05.solving-problems/OLD-how-to-add-your-own-filter/docs.zh.md new file mode 100644 index 00000000..131b7ab1 --- /dev/null +++ b/05.ios/05.solving-problems/OLD-how-to-add-your-own-filter/docs.zh.md @@ -0,0 +1,32 @@ +--- +title: '如何添加您的 DNS 过滤器' +taxonomy: + category: + - docs + +--- +如您想在 iOS 拦截 Safari 中之外的广告和跟踪器，那么您需要使用 DNS。在一般情况下，需要使用 DNS 服务阻止器（比如，[AdGuard DNS](https://adguard.com/zh_cn/adguard-dns/overview.html)）。但 iOS 版的 AdGuard 应用有其他方式能够让用户拦截广告：您可以添加您的 DNS 过滤器或 hosts 文件。 + +此方式有以下几种优势： +1) 您可亲自选择任何 DNS 服务器，不会绑定到特定的阻止服务器。 +2) 您可以同时添加几个 DNS 过滤器和/或 hosts 文件，但您不能同时使用几个 DNS 服务器。 + +为了在 iOS 版的 AdGuard 应用程序中添加用户的 DNS 过滤器*，请您根据以下步骤来操作： + +**⠀不要与 “将自定义过滤器添加到 Safari 中”混淆。* + +1. 前往 AdGuard Pro 设置 —> 通用—> 开启*高级模式*。 + + +2. 前往 DNS 保护 —> DNS 过滤 —> DNS 过滤器 —> 点击添加过滤器。 + + +我们以[AdGuard DNS 过滤器](https://kb.adguard.com/en/general/adguard-ad-filters#domains)作为例子，来展示如何添加自己的 DNS 过滤器。 + +> DNS 过滤器是由几个过滤器，包括英文、社交媒体、间谍软件、移动广告、EasyList、EasyPrivacy 等过滤器组成，以更好地通过 DNS 拦截广告的过滤方式与之兼容。 + +3. 粘贴该链接： [https://adguardteam.github.io/AdGuardSDNSFilter/Filters/filter.txt](https://adguardteam.github.io/AdGuardSDNSFilter/Filters/filter.txt) 以添加 AdGuard DNS 过滤器（或使用其他您所想添加的过滤器链接）。 + + + +就是这样！您已成功添加自定义过滤器。 diff --git a/05.ios/05.solving-problems/docs.en.md b/05.ios/05.solving-problems/docs.en.md index 0512d05e..3d6fedd4 100644 --- a/05.ios/05.solving-problems/docs.en.md +++ b/05.ios/05.solving-problems/docs.en.md @@ -5,8 +5,10 @@ taxonomy: - docs --- -* [How to collect DNS requests log on AdGuard Pro?](http://kb.adguard.com/en/ios/solving-problems/dns-requests-log) -* [How to activate license](http://kb.adguard.com/en/ios/solving-problems/premium-activation) -* [How to add your own DNS filter](https://kb.adguard.com/en/ios/solving-problems/how-to-add-your-own-filter) +* [How to collect DNS requests log on AdGuard Pro](http://kb.adguard.com/en/ios/solving-problems/dns-requests-log) +* [How to activate premium features](http://kb.adguard.com/en/ios/solving-problems/premium-activation) +* [How to configure system-wide blocking](https://kb.adguard.com/en/ios/solving-problems/how-to-configure-system-wide-blocking) +* [How to avoid compatibility issues with FaceTime](https://kb.adguard.com/en/ios/solving-problems/how-to-avoid-compatibility-issues-with-facetime) +* [How to block ads on YouTube in Safari](https://kb.adguard.com/en/ios/solving-problems/how-to-block-ads-on-youtube) -This section is regularly updated. If you haven't found a solution to your problem in our knowledge base, [AdGuard Support Team](http://kb.adguard.com/en/technical-support) will be happy to help. +This section is regularly updated. If you haven't found a solution to your problem in our knowledge base, [AdGuard Support Team](http://kb.adguard.com/en/technical-support) will be of help. diff --git a/05.ios/05.solving-problems/docs.ru.md b/05.ios/05.solving-problems/docs.ru.md index e6fd9420..f876ca88 100644 --- a/05.ios/05.solving-problems/docs.ru.md +++ b/05.ios/05.solving-problems/docs.ru.md @@ -6,7 +6,9 @@ taxonomy: --- * [Как собрать лог DNS запросов в AdGuard Pro](http://kb.adguard.com/ru/ios/solving-problems/dns-requests-log) -* [Как активировать лицензию](http://kb.adguard.com/ru/ios/solving-problems/premium-activation) -* [Как добавить собственный DNS-фильтр](https://kb.adguard.com/ru/ios/solving-problems/how-to-add-your-own-filter) +* [Как активировать премиум-функции](http://kb.adguard.com/ru/ios/solving-problems/premium-activation) +* [Как настроить системную блокировку](https://kb.adguard.com/ru/ios/solving-problems/how-to-configure-system-wide-blocking) +* [Как избежать проблем с совместимостью с FaceTime](https://kb.adguard.com/ru/ios/solving-problems/how-to-avoid-compatibility-issues-with-facetime) +* [Как заблокировать рекламу на YouTube в Safari](https://kb.adguard.com/ru/ios/solving-problems/how-to-block-ads-on-youtube) Этот раздел регулярно обновляется. Если вы не нашли решения своей проблемы в приведенных в этом разделе статьях, обратитесь в [техническую поддержку AdGuard](http://kb.adguard.com/ru/technical-support). diff --git a/06.safari/01.overview/docs.en.md b/06.safari/01.overview/docs.en.md index 785f560f..5bd1e43c 100644 --- a/06.safari/01.overview/docs.en.md +++ b/06.safari/01.overview/docs.en.md @@ -27,18 +27,30 @@ It’s free and it will protect you from ads, trackers, phishing, and malicious ## General - -

The General tab

+
+
+ +
+
+ +
+
The first tab is the General screen where you can set up basic things like notifications, update intervals, and launching AdGuard at system startup. You can also choose to display the AG icon in the menu bar. And most importantly, you can choose which content blockers you’re going to use, but more on that later. ## Filters - -

The Filters tab

+
+
+ +
+
+ +
+
-A filter is a set of rules that can filter web traffic and, in particular, block advertising content (banners, pop-ups and such) and stop tracking. For the convenience of users we have combined them into thematic categories. Seven categories of filters are at your disposal: *Ad Blocking, Privacy, Social widgets, Annoyances, Security, Language-specific, Custom and Other filters*. If you’re curious to know more about them, here is [an extensive article](https://kb.adguard.com/en/general/adguard-ad-filters) describing them. +A filter is a list of rules written in a special syntax. Following these rules, content blockers can filter web traffic, in particular, block advertising content (banners, pop-ups and such) and stop tracking. For the convenience of users we have combined them into thematic categories. Eight categories of filters are at your disposal: *Ad Blocking, Privacy, Social widgets, Annoyances, Security, Language-specific, Custom and Other filters*. If you’re curious to know more, here are extensive articles [about AdGuard filters](https://kb.adguard.com/en/general/adguard-ad-filters) and about [ad filtering in general](https://kb.adguard.com/en/general/how-ad-blocking-works). In the Filters tab you can enable/disable the whole category, or fine-tune separate filters inside it. If you make changes, this would be reflected in the Content Blockers section (located in the General tab). In other words, you can adjust things in the Filters tab and see what has changed in the Content Blockers section. @@ -46,7 +58,6 @@ In the Filters tab you can enable/disable the whole category, or fine-tune separ ## Content Blockers -

Content Blockers

A сontent blocker is a thematic cluster of filters. For instance, all filters that come within the topic of privacy will be included in the content blocker with the corresponding name — *AdGuard Privacy*. There were two reasons to make content blockers: it’s much more convenient to manage structured filters and there still exists Apple’s restriction. @@ -62,7 +73,7 @@ Here is a list of 6 content blockers grouped thematically. The good thing about ### AdGuard General *AdGuard General* is a category for filters of overall orientation – basically, that’s all you need to know. We recommend that you keep the AdGuard Base filter from here always enabled. -> Please note: to enable any filters, blocking and tracking lists attributed to any given content blocker, you should go to the Filters tab. Here, in the Content blockers section, you can only see what is already enabled and working. +> Note that to enable any filters, blocking and tracking lists attributed to any given content blocker, you should go to the Filters tab. Here, in the Content blockers section, you can only see what is already enabled and working. @@ -90,31 +101,9 @@ This content blocker unites several security-related filters. *Malware Domains B ### AdGuard Custom -

Adding a custom filter is easy

*AdGuard Custom* is extra space left for supplementary filters you may want to add. Adding a filter is not rocket science. There is no need to know how to create user rules, you can use the ready-made filters. Just enter a valid URL of the filter subscription in the field. -How is AdGuard for Safari different from other popular ad blockers for this browser? Here is a comparison table updated April, 2020. - - -

Ad blockers' comparison chart

- -*⠀300K filtering rules vs. 50K - - - -## Whitelist - -

Whitelist

- -To put it simply, Whitelist is a list of exceptions — websites that AdGuard won’t block. If you want to see some ads for a reason (say, you want to support your favorite website), there is a solution. - -How does it work? Add a website to Whitelist and ad blocking will be disabled for it. You can add as many websites as needed. - -There is an option to import/export a list of exclusions. If you’ve already created one and want to apply it to another device, just press the corresponding button. - -> Note: Whitelist can be inverted — this means AdGuard will not block ads and tracking anywhere except for the websites you’ve put on this list. - ## User Rules @@ -133,4 +122,4 @@ Last but not least important tab. Here you can see what version you have, read E Finally, there is a link to our repository on GitHub. If you are even a little bit of a geek, it might be of interest to you. You can monitor the product development, create feature requests and report bugs there, for instance. -> Reminder: AdGuard for Safari can be downloaded for free [from the App Store](https://apps.apple.com/en/app/adguard-for-safari/id1440147259?l=en&mt=12). A detailed setup instruction is available [here](https://www.kb.adguard.com/en/safari/installation). +> Reminder: AdGuard for Safari can be downloaded for free [from the App Store](https://apps.apple.com/en/app/adguard-for-safari/id1440147259). A detailed setup instruction is available [here](https://www.kb.adguard.com/en/safari/installation). diff --git a/06.safari/01.overview/docs.ru.md b/06.safari/01.overview/docs.ru.md index ee856943..5488423d 100644 --- a/06.safari/01.overview/docs.ru.md +++ b/06.safari/01.overview/docs.ru.md @@ -1,5 +1,5 @@ --- -title: Обзор +title: Обзор функций taxonomy: category: - docs @@ -16,7 +16,6 @@ visible: true * [AdGuard Безопасность](#agsecurity) * [AdGuard Другие](#agother) * [AdGuard Пользовательские](#agcustom) -* [Белый список](#whitelist) * [Пользовательские правила](#userrules) * [О программе](#about) @@ -27,32 +26,44 @@ AdGuard для Safari был выпущен в ноябре 2018 года и б ## Общие - -

Общие настройки

-Первая вкладка – это экран «Общие», где вы можете настроить базовые вещи, такие как уведомления, интервалы, через которые расширение обновляется, и автоматический запуск AdGuard при старте системы. Вы также можете решать, отображать ли значок AG в строке меню. И самое главное, здесь вы можете увидеть, какие блокировщики контента используются в данный момент, но об этом позже. +
+
+ +
+
+ +
+
+ +Первая вкладка – это экран «Общие», где вы можете настроить базовые вещи, такие как уведомления, периоды обновления расширения, и автозапуск AdGuard при входе в систему. Вы также можете решать, отображать ли значок AdGuard в строке меню, включить ли подробное логирование или аппаратное ускорение. С этого экрана можно экспортировать и импортировать настройки и экспортировать логи. И самое главное, здесь вы можете увидеть, какие блокировщики контента используются в данный момент, но об этом позже. ## Фильтры - -

Вкладка «Фильтры»

+
+
+ +
+
+ +
+
-Фильтр – это набор правил, которые фильтруют веб-трафик, в частности, блокируют рекламный контент (баннеры, всплывающие уведомления и всё такое) и борются с трекингом. Для удобства пользователей мы объединили их в тематические категории. В вашем распоряжении семь категорий фильтров: *Блокировка рекламы, Антитрекинг, Виджеты социальных сетей, Раздражители, Безопасность, Языковые, Пользовательские и Другие фильтры*. Если вам интересно узнать о них больше, рекомендуем прочитать эту [обширную статью](https://kb.adguard.com/ru/general/adguard-ad-filters), описывающую их. +Фильтр – это набор правил, следуя которым блокировщики фильтруют веб-трафик, в частности, блокируют рекламный контент (баннеры, всплывающие уведомления и другие раздражающие элементы) и борются с трекингом. Для удобства пользователей мы объединили их в тематические категории. В вашем распоряжении восемь категорий фильтров: *Блокировка рекламы, Антитрекинг, Виджеты социальных сетей, Раздражители, Безопасность, Другие, Языковые и Собственные фильтры*. Если вам интересно узнать больше, рекомендуем прочитать статьи [о фильтрах AdGuard](https://kb.adguard.com/ru/general/adguard-ad-filters) и о том, [как работает фильтрация](https://kb.adguard.com/ru/general/how-ad-blocking-works). -Во вкладке «Фильтры» вы можете как включить/отключить целую категорию, так и настроить отдельные фильтры внутри неё. Если вы внесёте изменения, это отразится в разделе «Блокировщики контента», который расположен во вкладке «Общие». Другими словами, во вкладке «Фильтры» вы можете менять вещи, в разделе «Блокировщики контента» – видеть, что изменилось. +Во вкладке «Фильтры» вы можете как включить/отключить целую категорию, так и настроить отдельные фильтры внутри неё. Если вы внесёте изменения, это отразится в разделе «Блокировщики контента», который расположен во вкладке «Общие». Другими словами, во вкладке «Фильтры» вы можете менять вещи, а в разделе «Блокировщики контента» – видеть, что изменилось. ## Блокировщики контента -

Блокировщики контента

-Блокировщик контента – это тематическая группа фильтров. Например, все фильтры, объединённые темой конфиденциальности, включены в блокировщик с соответствующим названием — AdGuard Безопасность. «Зачем так всё усложнять?», – можете спросить вы. По сути, на это есть две причины: действующее ограничение Apple и тот факт, что управлять сгруппированными фильтрами гораздо удобнее. +Блокировщик контента – это тематическая группа фильтров. Например, все фильтры, объединённые темой конфиденциальности, включены в блокировщик с соответствующим названием — *AdGuard Безопасность*. Мы пользуемся таким делением по двум причинам: из-за действующего ограничения Apple и просто потому, что управлять сгруппированными фильтрами гораздо удобнее. Как вы можете [помнить](https://adguard.com/ru/blog/adguard-safari-1-5.html), Apple наложил ограничения на блокировщики рекламы для Safari, разрешив им использовать только 50 000 правил фильтрации одновременно. Не обманывайтесь этим на первый взгляд большим числом – на самом деле, для правил фильтрации это совсем немного. Например, некоторые наши фильтры сами по себе содержат больше 50 000 правил, и нам даже пришлось оптимизировать часть из них специально для AdGuard для Safari. -К счастью, есть способ обойти это ограничение. Один блокировщик можно разделить на несколько, в каждом из которых будет содержаться до 50 тысяч правил. Эта мера позволяет нам усилить защиту пользователей. +К счастью, есть способ обойти это ограничение. Один блокировщик можно разделить на несколько, в каждом из которых будет содержаться до 50 тысяч правил. Эта мера позволяет нам усилить защиту пользователей. Вот список блокировщиков контента, которые доступны в расширении AdGuard для Safari. Что особенно удобно, вся информация о включённых фильтрах и количестве использующихся правил находится прямо перед глазами. Например: > AdGuard Основные @@ -91,38 +102,14 @@ AdGuard для Safari был выпущен в ноябре 2018 года и б ### AdGuard Пользовательские - -

Добавить пользовательский фильтр легко

+ -*AdGuard Пользовательские* – это дополнительное пространство, которое мы оставили для фильтров, которые вы, возможно, захотите добавить. Добавить фильтр самому – это не высшая математика. Вам не нужно уметь создавать свои пользовательские правила, можно взять готовый фильтр. Просто введите действительный URL фильтра в поле ниже. К счастью, фильтров существует огромное количество, и их без труда можно найти в интернете, например, на тематических форумах. - -Чем AdGuard для Safari отличается от других блокировщиков рекламы для этого браузера? Вот сравнительная таблица на апрель 2020. - - -

Сравнительная таблица браузерных блокировщиков

- - -*⠀300 тыс. правил фильтрации vs. 50 тыс. - - - -## Белый список - -

Белый список

- -Говоря по-простому, Белый список – это список исключений, то есть сайтов, которые AdGuard не будет блокировать. Если вы по какой-то причине хотите видеть рекламу на некоторых сайтах (скажем, хотите поддержать любимый проект), есть решение. - -Как это работает? Добавьте сайт в Белый список, и блокировка рекламы для него будет отключена. Вы можете добавить столько сайтов, сколько потребуется. - -Также есть возможность импортировать/экспортировать свой список исключений. Если вы уже создали его и хотите применить его на другом устройстве, просто нажмите соответствующую кнопку. - -> Важно: Белый список можно инвертировать — это значит, что AdGuard не будет блокировать рекламу и трекинг нигде кроме сайтов, которые вы добавили в этот список. +*AdGuard Пользовательские* – это дополнительное пространство, которое мы оставили для фильтров, которые вы, возможно, захотите добавить. Добавить фильтр самому не так сложно, как может показаться. Вам не нужно уметь создавать свои пользовательские правила, можно взять готовый фильтр. Просто введите действительный URL фильтра в поле ниже. К счастью, фильтров существует огромное количество, и их без труда можно найти в интернете, например, на тематических форумах. ## Пользовательские правила -

Пользовательские правила

Пользовательские правила – это отличная возможность для тех, кто хочет кастомизировать процесс фильтрации. Конечно, чтобы написать и применить своё правило, потребуются определённые навыки: в частности, нужно овладеть синтаксисом правил. Если вы хотите изучить что-то новое, у нас есть для вас [исчерпывающее руководство](https://kb.adguard.com/ru/general/how-to-create-your-own-ad-filters) на эту тему. @@ -136,4 +123,4 @@ AdGuard для Safari был выпущен в ноябре 2018 года и б Наконец, в этой вкладке лежит ссылка на наш репозиторий на GitHub. Если вы хотя бы чуточку технарь, этот ресурс может оказаться для вас интересным. На GitHub можно отслеживать развитие продукта, оставлять запросы о добавлении функций и, к примеру, сообщать об ошибках. -> Напоминание: AdGuard для Safari можно скачать бесплатно [из App Store](https://apps.apple.com/ru/app/adguard-for-safari/id1440147259?l=en&mt=12). Подробная инструкция по установке доступна [по этой ссылке](https://www.kb.adguard.com/ru/safari/installation). +> Напоминание: AdGuard для Safari можно скачать бесплатно [из App Store](https://apps.apple.com/ru/app/adguard-for-safari/id1440147259). Подробная инструкция по установке доступна [по этой ссылке](https://www.kb.adguard.com/ru/safari/installation). \ No newline at end of file diff --git a/07.content-blocker/02.installation/docs.ru.md b/07.content-blocker/02.installation/docs.ru.md index 15990b30..d6e65cad 100644 --- a/07.content-blocker/02.installation/docs.ru.md +++ b/07.content-blocker/02.installation/docs.ru.md @@ -6,7 +6,7 @@ taxonomy: - docs --- -Приложение доступно в пяти магазинах: [Google Play](https://play.google.com/store/apps/details?id=com.adguard.android.contentblocker),Samsung Galaxy Store](https://galaxystore.samsung.com/detail/com.adguard.android.contentblocker), [Huawei Store](https://appstore.huawei.com/app/C100440597), [Aptoide](https://adguard-content-blocker.ru.aptoide.com/) и [F-Droid](https://f-droid.org/ru/packages/com.adguard.android.contentblocker/). Для установки AdGuard Content Blocker из Google Play запустите приложение Play Маркет. В форме поиска введите строку _AdGuard content blocker_. +Приложение доступно в пяти магазинах: [Google Play](https://play.google.com/store/apps/details?id=com.adguard.android.contentblocker), [Samsung Galaxy Store](https://galaxystore.samsung.com/detail/com.adguard.android.contentblocker), [Huawei Store](https://appstore.huawei.com/app/C100440597), [Aptoide](https://adguard-content-blocker.ru.aptoide.com/) и [F-Droid](https://f-droid.org/ru/packages/com.adguard.android.contentblocker/). Для установки AdGuard Content Blocker из Google Play запустите приложение Play Маркет. В форме поиска введите строку _AdGuard content blocker_. Важно: AdGuard Content Blocker работает в двух браузерах – [Яндекс.Браузере](https://browser.yandex.ru/) и [Samsung Internet Browser](https://play.google.com/store/apps/details?id=com.sec.android.app.sbrowser&hl=ru). Если они у вас не установлены, вам нужно будет скачать один из них, чтобы пользоваться AG Content Blocker. @@ -46,4 +46,4 @@ taxonomy:

-Вот и всё! Приложение успешно установлено на вашем устройстве. \ No newline at end of file +Вот и всё! Приложение успешно установлено на вашем устройстве. diff --git a/09.browser-extensions/01.overview/docs.en.md b/09.browser-extensions/01.overview/docs.en.md index a86be908..bc0fe788 100644 --- a/09.browser-extensions/01.overview/docs.en.md +++ b/09.browser-extensions/01.overview/docs.en.md @@ -1,58 +1,169 @@ --- -title: Overview +title: Features overview taxonomy: category: - docs --- -## Ad Blocker +AdGuard provides a range of software products that block ads and trackers on different platforms. One of the most popular AdGuard products is a free extension that is accessible for five popular browsers: Chrome, Firefox, Edge, Opera, and Yandex.Browser. Browser extensions include basic ad blocking features but cannot be compared with full-featured desktop programs such as [*AdGuard for Windows*](https://kb.adguard.com/en/windows/overview) and [*AdGuard for Mac*](https://kb.adguard.com/en/mac/overview). -This extension blocks ads in social networks, such as VK.com and Facebook, on YouTube, and other sites. AdGuard Ad Blocker efficiently blocks all kinds of ads on all web pages. Ad Blocker speeds up loading and saves traffic by not wasting it on ads and popups. This extension also blocks spyware and adware installers, protects your personal data and you from malware and phishing sites. AdGuard Ad Blocker is free for use. +In this article we’ll reveal to you all its useful options. If you're looking for some specific information, navigate directly to the appropriate item or read the entire article to learn more about the product. -![](chrome_block_en.png?cropResize=600,400) + -### Functions +- [Availability](#br-extension) +- [Ad blocking](#adblocker) + - [Filters](#filters) + - [Custom filters](#custom) + - [User rules](#user-rules) + - [Allowlist](#allowlist) +- [Stealth Mode](#stealth-mode) +- [Other features and options](#other) + - [General](#general) + - [Miscellaneous](#misc) + - [About](#about) +- [Extension’s main menu](#main-menu) +- [AdGuard browser extension vs. AdGuard application](#comparison) -* Blocks all ads including video ads (including Youtube video ads), rich media advertising like video ads, interstitial ads and floating ads, unwanted pop-ups, banners and text ads (including Facebook advertisements). + +## Availability -* Speeds up page loading and saves bandwidth, thanks to the missing ads and pop up windows. +The [AdGuard Browser extension](https://adguard.com/en/adguard-browser-extension/overview.html) is accessible for most major browsers. You can easily find it in your browser’s online store or on our official website. + + -* Blocks many spyware, adware and dialer installers (optional). +> We have a standalone extension for Safari because since the release of [Safari 13](https://adguard.com/en/blog/adguard-safari-1-5.html) most of the ad blocking extensions have experienced huge issues and many of them simply stopped working. We had to develop a [separate extension for Safari](https://kb.adguard.com/en/safari/overview) that has some differences in comparison with the extension described in this article. -* Protects your privacy by blocking common third-party tracking systems (optional). +**Do not forget that the functionality of each extension is strictly limited by browser’s capabilities.** So if you want to get a full-fledged protection, you'd better turn your gaze towards a standalone program for your computer. And we’ll [explain why](https://kb.adguard.com/en/browser-extensions/overview.html#comparison). -* Protects you from malware and phishing (optional). + +## Ad blocking -### Supported Operating Systems +Blocking ads is clearly the key functionality of any ad blocker, and AdGuard is not an exception. The extension will successfully block ads on any page in your browser. At the base of ad blocking lie so-called filter lists, or simply [filters](https://adguard.com/en/blog/how-ad-blocking-is-done.html), that can be enabled or disabled in the AdGuard settings. You can adjust ad blocking according to your needs by activating specific filters. -* Windows; + +### Filters -* macOS/OS X; +In essence, filter lists are sets of rules written in a special language, and your ad blocker is an interpreter of these rules who then implements them. As a result, you stop seeing ads on your webpages and life gets a lot better. -* GNU/Linux; + -* Android (for browsers that support browser extensions). +All filters are grouped according to their role. For example, there are categories for ad blocking filters, privacy protection filters, social media-related filters, etc. You can enable either individual filters or the entire group at once. -### Supported browsers + -* Chrome + +#### Custom filters -* Microsoft Edge +While the features of other filter groups are more or less predictable, there is a group called *Custom* that may raise additional questions. -* Safari + -* Firefox +In this tab you can add filters that are not present in the extension by default. There are plenty of [publicly available filters on the Internet](https://filterlists.com). Moreover, you can create and add your own filters. In fact, you can build any set of filters and customize ad blocking the way you like. -* Opera +To add a filter, just click the **Add custom filter** button and then enter the URL or the file path of the filter you want to be added, and then click the **Next** button. -* Yandex Browser + + + +### User rules -* Palemoon +*User rules* is another tool that helps you personalize protection by adjusting it in a preferable way. -### Why AdGuard AdBlocker is better than Adblock or AdBlock Plus + -* AdGuard AdBlocker is really fast and lightweight. It uses half as much memory as other popular solutions: Adblock, Adblock Plus. +In this tab it is possible to create your own filtering rules. There are several ways to add new rules. The most straightforward is to just type a rule in, but it requires some knowledge of the [rule syntax](https://kb.adguard.com/en/general/how-to-create-your-own-ad-filters). + +Then, it's possible to import a ready-to-use filter list from a text file. *Make sure that different rules are separated by line breaks.* Besides, you can export filtering rules created by you. But first and foremost, this option is for transferring your list of rules between browsers or devices, while for importing ready-to-use filters it is better to use [Custom filters](https://kb.adguard.com/en/browser-extensions/overview.html#custom). -* AdGuard AdBlocker can handle Anti-AdBlock scripts. You won't have to turn off the AdBlocker anymore to be able to visit the websites that are using such scripts. Just send a complaint to our tech support and we'll handle it. +When you add a website to allowlist (more about it [below](#allowlist)) or use [the Assistant tool](https://kb.adguard.com/en/browser-extensions/overview.html#assistant) for hiding an element on the page, a corresponding rule goes to *User rules*. + + +### Allowlist -* AdGuard AdBlocker is simply better looking and modern. \ No newline at end of file +If you want to exclude certain websites from filtering, the *Allowlist* option will be of help. Here you can add particular websites to the list of exceptions, it will disable blocking for those trusted domains. Just put the websites you want to exclude into the Allowlist and the ad blocking rules won’t be applied to them. + + + +The *Allowlist* can be inverted, too — you can unblock ads everywhere except the sites that you added to this list. Just activate the **Invert Allowlist** option. + + + +Also, you can either import or export already existing lists of exclusions if needed. It is especially useful when you want to apply the same list of sites on other devices and you don’t want to spend time on its creation. The *Allowlist* can be configured just in a couple of clicks. + + +## Stealth Mode + +The *Stealth Mode* module aims to ensure the protection of sensitive personal information from online trackers and other fraudsters. + + + +Stealth Mode can be flexibly adjusted — you can prohibit a website to receive the search requests you used to find it on the Internet, automatically delete both third-party and website’s own cookies, and so on. [A separate article](https://kb.adguard.com/en/general/stealth-mode) is devoted to all these features. + +> Note that some of the *Stealth Mode* options available in full-fledged apps are not present in the browser extensions due to technical restrictions. + + +## Other features and options + +Apart from the large key modules of AdGuard Browser extension there are several more specific but no less useful features that can be configured in the *General* and *Miscellaneous* sections of the extension settings. They'll help you customize the extension according to your individual needs. + + +### General + +In the *General* settings you can allow [search ads and the self-promotion of websites](https://kb.adguard.com/en/general/search-ads-and-self-promotion), enable/disable the automatic activation of the most appropriate filters and indicate the filters update interval, etc. + + + +Besides, here you can enable *Phishing and malware protection* (read more about [how it works](https://kb.adguard.com/en/general/how-malware-protection-works#phishing)). + +In case you want to keep your settings configuration, you can use the **Export settings** option to save it as a file. And vice versa, use the **Import settings** button to upload settings from a previously stored settings file. You can even use it to quickly switch between different settings profiles or even to transfer settings configurations between different browsers. + + +### Miscellaneous + +The *Miscellaneous* settings section contains a range of various settings that are related to the ad blocking process and application usability. + + + +From this settings tab you can activate optimized filters, enable notifications about extension updates, open the *Filtering log*, see the most recent *Сhangelog*, and reset blocked ads statistics by clicking the **Reset statistics** button. + +Besides, you can opt to help us in the development of filters by sending some anonymized information. Naturally, all data is sent strictly anonymously, and it is crucial for us to obtain statistics on rules — which ones are triggered, on which websites and how often — because we use this data to optimize our filters. By agreeing to share this data, you will help us improve filtering, and eventually you will also help yourself, because the filters in the extension will become better. But don't worry, no data will be sent without your consent, this option is disabled by default. + + +### About + +Among the rest of AdGuard settings tabs there is the *About* section where you can get some additional information (for example, what extension version you’re using). Here you will also find the links to the legal documents such as EULA (End User License Agreement) and Privacy policy, and to the repository of the Browser extension on GitHub. + + + + +## Extension’s main menu + +Now let's get back to the very beginning and have a look at the interface of the extension itself. You can summon it at any time by clicking on the extension's icon on any web page. + + + + +It provides several options. You can hide any element on any page manually (corresponding rule will be added to *User rules*), open *Filtering log* to view the comlete information about your browser's traffic, or look at a website’s security report. Besides, you can submit a complaint about any website (for example, if there are missed ads on the page — our filter engineers will review the report and fix the problem) and see the statistics on blocked ads. + +All web requests made by the browser are displayed in the *Filtering log*, along with detailed information about each request. The *Filtering log* makes it easy, for example, to monitor requests blocked by the AdGuard Browser extension. Besides, it allows you to block any request or add a previously blocked request to allowlist in two clicks. The *Filtering log* also offers you a wide variety of options for sorting web requests, which can be extremely helpful when creating your own filtering rules. +You can open the *Filtering log* by selecting the corresponding item in the main menu, or from the settings page (in the "Miscellaneous" tab). + +By clicking the icons in the top right corner of the screen you can open extension settings or stop protection by clicking the respective button. + + +## AdGuard Browser extension vs. AdGuard standalone apps + +The main advantage of AdGuard standalone programs over browser extensions is that they can block ads in every browser and in almost all apps. You may use different browsers at the same time, the app will filter ads and online threats in all of them equally well. + +The second significant difference is that the possibilities of extension-based ad blockers are strictly limited by what browsers allow and don't allow them to do. They are also intrinsically less powerful as they, for example, don't support some types of filtering rules that are available to standalone apps. Some browsers have policies that restriсt ad blocking, and AdGuard for Windows or Mac couldn't care less about that. The apps are not limited by anything — when you choose the app, you choose the better filtering quality. + +AdGuard Browser extension has its advantages: it's absolutely free, you don’t have to spend time and money on its installation, and once installed, it will filter ads and fight online threats as effectively as possible in your browser. Yet, compared to full-fledged apps for Mac and Windows, the extension has its disadvantages. We gathered them all together in the comparative table below to demonstrate the differences between AdGuard Browser extension and our standalone program. + + + +`1 – within browser restrictions and only in the browser where it is installed;` + +`2 – the extension is unable to detect requests from other extensions. So if some other, malicious or tracking extension wants to send a request to its server to show you ads or track your activity, AdGuard Browser extension will not be able to block that request;` + +`3 – not all types of ads and threats can be blocked by browser extensions because of certain browser restrictions. It means that some elements may get to the page and slow down the loading process. Besides, unlike browser ad blockers, AdGuard app blocks ads before they are loaded to the browser. This saves traffic and speeds up page loading.` \ No newline at end of file diff --git a/09.browser-extensions/01.overview/docs.ru.md b/09.browser-extensions/01.overview/docs.ru.md index 72517838..f250a078 100644 --- a/09.browser-extensions/01.overview/docs.ru.md +++ b/09.browser-extensions/01.overview/docs.ru.md @@ -1,60 +1,173 @@ --- -title: Обзор +title: Обзор функций taxonomy: category: - docs --- -## Антибаннер +AdGuard выпускает целый ряд продуктов для блокировки рекламы и трекеров на различных платформах. Одним из первых появилось браузерное расширение AdGuard, которое доступно для пяти популярных браузеров: Chrome, Firefox, Edge, Opera и Яндекс.Браузера. Браузерные расширения включают базовые функции по блокировке рекламы, но уступают полноценным приложениям, таким как [*AdGuard для Windows*](https://kb.adguard.com/ru/windows/overview) или [*AdGuard для Mac*](https://kb.adguard.com/ru/mac/overview). -Это расширение блокирует рекламу в социальных сетях Вконтакте и Одноклассники, на портале Youtube и на других сайтах. Антибаннер AdGuard эффективно блокирует все виды рекламы на всех веб-страницах, ускоряет отображение страниц и экономит трафик, поскольку он не тратится на загрузку рекламы и всплывающих окон. Также это расширение блокирует инсталляторы программ-шпионов и программного обеспечения, содержащего рекламу (adware), защищает ваши личные данные и оберегает вас от вредоносных и фишинговых сайтов. +В этой статье мы расскажем о его возможностях. Ознакомьтесь с интересующими вас функциями или прочитайте статью целиком, чтобы узнать о продукте как можно больше. -Антибаннер можно установить на вашем компьютере и использовать совершенно бесплатно. + -![](chrome_block_ru.png?cropResize=600,400) +- [Особенности](#br-extension) +- [Блокировка рекламы](#ad-blocker) + - [Фильтры](#filters) + - [Собственные](#custom) + - [Пользовательские правила](#user-rules) + - [Белый список](#allowlist) +- [Антитрекинг](#stealth-mode) +- [Другие функции и опции](#other) + - [Основные](#general) + - [Разное](#misc) + - [О нас](#about) +- [Главное меню расширения](#main-screen) +- [Сравнение расширений с десктопными приложениями](#comparison) -### Функции AdGuard Антибаннер + +## Особенности -* Блокирует всю рекламу, включая видеорекламу (в том числе на YouTube), rich media (анимированную рекламу), нежелательные всплывающие окна, баннеры и текстовые объявления. +[Браузерное расширение AdGuard](https://adguard.com/ru/adguard-browser-extension/overview.html) доступно почти для всех популярных браузеров. Вы можете легко найти расширение в интернет-магазине вашего браузера или на нашем официальном сайте. -* Ускоряет загрузку страниц и экономит трафик, так как он не тратится на загрузку рекламы и всплывающих окон. + -* Блокирует инсталляторы программ-шпионов и программного обеспечения, содержащего рекламу (adware). +> Для браузера Safari у нас есть отдельное расширение, так как с момента выхода [Safari 13](https://adguard.com/ru/blog/adguard-safari-1-5.html) большинство расширений столкнулись с проблемами, и многие из них перестали работать. В этих условиях мы разработали [новое расширение](https://kb.adguard.com/ru/safari/overview), отличающееся от описанного в этой статье. -* Защищает ваши личные данные, блокируя все известные системы слежения за действиями пользователя в интернете. +**Однако не стоит забывать, что функциональность любого расширения строго ограничена возможностями самого браузера.** Поэтому, если вы заинтересованы в полноценной и всесторонней защите, обратите внимание на отдельную программу для вашего компьютера. Ниже мы [опишем её преимущества](https://kb.adguard.com/ru/browser-extensions/overview.html#comparison). -* Защищает от вредоносных и фишинговых сайтов. + +## Блокировка рекламы -### Какие операционные системы поддерживает AdGuard Антибаннер? +Блокировка рекламы — ключевая функция AdGuard. Расширение успешно блокирует большинство рекламы на страницах браузера. В основе процесса блокировки лежат [фильтры](https://adguard.com/ru/blog/how-ad-blocking-is-done.html), которые можно включать в настройках. С их помощью вы легко подстроите процесс блокировки под себя. -* Windows; + +### Фильтры -* macOS/OS X; +Фильтры — основная движущая сила блокировки рекламы. Чтобы понять, как работает фильтрация, на которой построена работа большинства блокировщиков, ознакомьтесь с [этой исчерпывающей статьёй](https://adguard.com/ru/blog/how-ad-blocking-is-done.html). Но если коротко, фильтры — это наборы правил, написанных на специальном языке. Блокировщик рекламы интерпретирует эти правила, а затем реализует их. В результате вы перестаёте видеть рекламу на веб-страницах, и жизнь становится намного лучше. -* GNU/Linux; + -* Android (для браузеров, поддерживающих браузерные расширения). +Фильтры сгруппированы в соответствии с их ролью. Например, существуют категории фильтров, блокирующих рекламу или удаляющих виджеты социальных сетей, фильтры для защиты конфиденциальности и другие. -### С какими браузерами совместим AdGuard Антибаннер? +Вы можете включать/отключать как отдельные фильтры, так и группы целиком. -* Chrome + -* Firefox + +#### Собственные фильтры -* Safari +Функционал большинства групп фильтров очевиден из названия, но группу *Собственные* хочется рассмотреть подробнее. -* Opera + -* Яндекс Браузер +В данном разделе вы можете добавить любые фильтры, которые отсутствуют в расширении по умолчанию. В интернете можно найти много фильтров [в открытом доступе](https://filterlists.com)). Кроме того, вы можете создать и добавить свой собственный фильтр. Фактически, вы можете создать любой набор фильтров и настроить блокировку так, как вам нравится. + +Чтобы добавить фильтр, просто нажмите на кнопку **Добавить фильтр**, введите его URL-адрес или путь к файлу, в котором он хранится. Затем нажмите кнопку **Далее**. -* Microsoft Edge + -* Palemoon + +### Пользовательские правила -### Почему AdGuard лучше, чем AdBlock? +*Пользовательские правила* — ещё один инструмент, позволяющий настраивать блокировку в соответствии с потребностями пользователя. -* AdGuard Антибаннер - быстрая и интуитивно понятная программа. Потребляет вдвое меньше памяти по сравнению с другими популярными решениями: Adblock, Adblock Plus. + -* AdGuard Антибаннер может справиться с Anti-Adblock скриптами. Вам больше не придется отключать Антибаннер, чтобы просматривать вебсайты, которые используют данные скрипты. Просто обратитесь в нашу техподдержку, и мы решим данную проблему. +В этом разделе можно создавать собственные правила фильтрации. Существует несколько способов добавления новых правил. Самый простой — ввести их в поле данного раздела, однако для этого потребуется некоторое знание [синтаксиса правил](https://kb.adguard.com/ru/general/how-to-create-your-own-ad-filters). -* AdGuard Антибаннер попросту симпатичнее и современнее. \ No newline at end of file +Кроме того, можно импортировать готовые наборы правил из текстового файла с помощью кнопки **Импорт**. *Перед этим убедитесь, что каждое правило начинается с новой строки.* Вы также можете экспортировать созданные вами правила. Но в первую очередь эта функция для переноса списка своих правил между браузерами или устройствами, а для импорта готовых фильтров лучше использовать раздел [«Собственные правила»](https://kb.adguard.com/ru/browser-extensions/overview.html#custom). + +Когда вы используете [белый список](#allowlist) или [инструмент для ручной блокировки](https://kb.adguard.com/ru/browser-extensions/overview.html#assistant), соответствующее правило также автоматически появляется и сохраняется в *Пользовательских правилах*. + + +### Белый список + +Если вы вы хотите отключить работу AdGuard на определённом сайте, вам пригодится опция *Белый список*. Здесь вы можете оставлять адреса сайтов, на которых не хотите блокировать рекламу. + + + +*Белый список* также можно инвертировать. Сделав это, вы разблокируете рекламу везде, кроме сайтов, которые вы добавили в этот список. Для этого просто активируйте опцию **Инвертировать белый список**. + + + +При необходимости можно экспортировать и импортировать уже существующие списки исключений. Это особенно полезно, когда вы хотите применить тот же список сайтов на другом устройстве (или в другом браузере) и не хотите тратить время на его переписывание. *Белый список* будет настроен всего за пару кликов. + + +## Антитрекинг + +Модуль *Антитрекинг* обеспечивает конфиденциальность пользователя, то есть защиту его личной информации от онлайн-трекеров и мошенников. + + + +Режим *Антитрекинг* поддаётся гибкой настройке. Вы можете запретить сайтам получать поисковые запросы, которые вы использовали для их поиска в интернете, автоматически удалять как сторонние, так и основные файлы cookie, и многое другое. Всем функциям этого режима посвящена [отдельная статья](https://kb.adguard.com/ru/general/stealth-mode). + +> Обратите внимание, что некоторые из опций *Антитрекинга*, которые есть в самостоятельных приложениях, недоступны в браузерном расширении из-за технических ограничений. + + +## Другие функции и опции + +Кроме ключевых модулей блокировки рекламы AdGuard предлагает несколько более специфических, но не менее полезных функций, которые доступны в разделах настроек *Основные* и *Разное*. Они помогут вам настроить расширение в соответствии с вашими индивидуальными потребностями. + + +### Основные + +В *Основных* настройках вы можете разрешить [поисковую рекламу и саморекламу веб-сайтов](https://kb.adguard.com/ru/general/search-ads-and-self-promotion), включить/отключить автоматическую активацию наиболее подходящих фильтров, а также указать интервал обновления фильтров. + + + +Кроме того, здесь можно включить *Защиту от фишинговых и вредоносных сайтов* (подробнее о том, как работает антифишинг, читайте [здесь](https://kb.adguard.com/ru/general/how-malware-protection-works#phishing)). + +Если вы хотите сохранить настройки и восстановить их в будущем, воспользуйтесь опцией **Экспорт настроек**. Чтобы загрузить предыдущие настройки, нажмите кнопку **Импорт настроек**. + + +### Разное + +В разделе *Разное* собраны всевозможные настройки, связанные с процессом блокировки рекламы и удобством использования самого приложения. + + + +Здесь можно активировать оптимизированные фильтры, включить уведомления об обновлениях расширения, открыть *Журнал фильтрации*, посмотреть *Список изменений* и сбросить статистику заблокированной рекламы, которая отображается на главном экране. + +Также вы можете помочь в разработке фильтров, согласившись отправлять некоторые анонимизированные данные. Разумеется, все данные отправляются строго анонимно, и нам крайне важно получать статистику о том, какие правила срабатывают на каких сайтах и как часто, потому что на основе этих данных мы оптимизируем фильтры. Согласившись на отправку данных, вы помогаете нам улучшить фильтрацию, а в перспективе помогаете и себе, ведь фильтры в расширении становятся лучше. Но не беспокойтесь, без вашего согласия никакие данные отправляться не будут — эта опция отключена по умолчанию. + + +### О программе + +В основном списке настроек AdGuard есть раздел *О программе*, где вы можете посмотреть, какую версию расширения вы используете. Здесь же вы найдёте ссылки на юридические документы, такие как Лицензионное соглашение и Политика конфиденциальности, а также на репозиторий Браузерного расширения на GitHub. + + + + +## Главное меню расширения + +Вернёмся к самому началу и посмотрим на интерфейс самого расширения. Вы можете вызвать его в любое время, нажав на иконку расширения на любой веб-странице. + + + + +Здесь вы можете скрыть элемент на текущей странице браузера вручную (соответствующее правило будет добавлено в *Пользовательские правила*), открыть *Журнал фильтрации* для просмотра информации о трафике вашего браузера или просмотреть отчёт о безопасности сайта. Кроме того, вы можете пожаловаться на любой сайт (например, если на странице пропущена реклама — наши специалисты просмотрят отчёт и исправят проблему) и посмотреть статистику заблокированных объявлений. + +В *Журнале фильтрации* отображаются все веб-запросы, совершаемые браузером, а также подробная информация о каждом из них. С его помощью, например, легко отслеживать запросы, заблокированные браузерным расширением AdGuard. Через Журнал фильтрации можно в два клика заблокировать любой запрос, либо наоборот добавить в белый список заблокированный ранее. Журнал также предоставляет широкие возможности для сортировки веб-запросов, что может быть крайне полезно при составлении собственных правил фильтрации. +Журнал фильтрации можно открыть, выбрав соответствующий пункт в главном меню расширения, либо через страницу настроек (во вкладке "Разное"). + +В правом верхнем углу экрана вы можете открыть настройки расширения, а также приостановить защиту, если это потребуется. + + +## Сравнение расширений с полноценными приложениями + +Самым главным преимуществом приложений AdGuard перед браузерными расширениями является то, что они могут блокировать рекламу в каждом браузере и почти во всех приложениях. Вы можете использовать разные браузеры одновременно, приложение будет фильтровать рекламу и онлайн-угрозы в каждом из них. + +Вторая существенная разница, как уже сказано выше, заключается в ограничении возможностей блокировки браузером. Расширения, блокирующие рекламу, всегда строго ограничены тем, что разрешено и не разрешено браузерами. Кроме того, они не поддерживают часть правил фильтрации, доступных полноценным программам, а политика некоторых браузеров ограничивает или попросту запрещает блокировку рекламы. + +Конечно же, приложения-блокировщики не сталкиваются с такими проблемами. Их функциональность, напротив, ничем не ограничена. Выбирая приложение, вы выбираете более качественную и надёжную фильтрацию. + +У Браузерного расширения AdGuard есть свои преимущества: оно абсолютно бесплатно, вам не придётся тратить время на скачивание файлов и их установку, а после установки оно будет фильтровать рекламу и бороться с онлайн-угрозами в вашем браузере. Но по сравнению с полноценными приложениями [для Mac](https://kb.adguard.com/ru/macos/overview) и [Windows](https://kb.adguard.com/ru/windows/overview), у расширения есть и недостатки. Мы собрали их все в сравнительной таблице ниже, чтобы более наглядно продемонстрировать разницу между блокировкой браузерным расширением и приложением AdGuard. + + + +`*1 – в рамках возможностей браузера; действует только в браузере, в котором установлено расширение;` + +`*2 – расширение не может обнаруживать запросы от других расширений. Поэтому, если какое-либо другое, вредоносное или отслеживающее расширение захочет отправить запрос на свой сервер с целью показать вам рекламу или отследить вашу активность, то наше расширение не сможет заблокировать этот запрос;` + +`*3 – не все типы рекламы и онлайн-угроз могут быть заблокированы расширениями браузера из-за определенных ограничений. Это означает, что некоторые элементы могут попасть на страницу и замедлить процесс загрузки. Кроме того, в отличие от браузерных блокировщиков рекламы, приложение AdGuard блокирует рекламу до того, как она загружается в браузер. Это экономит трафик и ускоряет загрузку страницы.` \ No newline at end of file diff --git a/09.browser-extensions/03.features/docs.en.md b/09.browser-extensions/03.features/docs.en.md index 1d419b98..277fbca9 100644 --- a/09.browser-extensions/03.features/docs.en.md +++ b/09.browser-extensions/03.features/docs.en.md @@ -4,6 +4,7 @@ published: true taxonomy: category: - docs +visible: false --- AdGuard AdBlocker is the browser extension performs a number of functions, each of which can be customized according to your preferences. This section gives a brief overview of the AdGuard AdBlocker functions and features. diff --git a/09.browser-extensions/03.features/docs.ru.md b/09.browser-extensions/03.features/docs.ru.md index d91a4138..4de2dc57 100644 --- a/09.browser-extensions/03.features/docs.ru.md +++ b/09.browser-extensions/03.features/docs.ru.md @@ -4,6 +4,7 @@ published: true taxonomy: category: - docs +visible: false --- Расширение AdGuard Антибаннер выполняет целый ряд функций, каждую из которых пользователь может настроить в соответствии со своими предпочтениями. В этом разделе представлено краткое описание функциональных возможностей AdGuard Антибаннер. diff --git a/11.vpn/02.installation/docs.en.md b/11.vpn/02.installation/docs.en.md index bb68b8ad..c7af9ff4 100644 --- a/11.vpn/02.installation/docs.en.md +++ b/11.vpn/02.installation/docs.en.md @@ -56,7 +56,7 @@ AdGuad VPN for Firefox is successfully installed! To install AdGuard VPN for Android: -1) Follow [this link](https://agrd.io/vpn_android_beta) or open navigate to AdGuard VPN's page in Google Play Store. +1) Follow [this link](https://agrd.io/adguard_vpn_android) or navigate to AdGuard VPN's page in Google Play Store. 2) Tap **Install**. @@ -70,19 +70,50 @@ AdGuard VPN for Android is successfully installed! ## AdGuard VPN for iOS +To install AdGuard VPN for iOS: -AdGuard VPN for iOS is coming soon! +1) Follow [this link](https://agrd.io/ios_vpn) or open App Store and type in "AdGuard VPN" in the search bar. + +2) Click the **GET** button next to the string AdGuard VPN — Unlimited & Fast, and then confirm installation by double-clicking the side button of your iOS device. + +3) Wait until the downloading process is complete and then tap **Open**. + + + +AdGuard VPN for iOS is successfully installed! ## AdGuard VPN for Mac -AdGuard VPN for Mac is coming soon! +To install AdGuard VPN for Mac beta: + +1) Follow [this link](https://agrd.io/mac_vpn_beta). A DMG file will appear in the downloads list of your browser. + +2) Open it. You'll see the screen 'Install AdGuard VPN'. Double-click the icon. + + + +3) The AdGuard VPN installer will do the rest, just click **Continue** and **Install**. Or you can change the install location, if needed. + +4) When you see the screen saying 'The installaion was successful', tap **Close**. + +That's it, AdGuard VPN for Mac beta is installed to your device! ## AdGuard VPN for Windows -AdGuard VPN for Windows is coming soon! \ No newline at end of file +To install AdGuard VPN for Windows beta: + +1) Follow [this link](https://agrd.io/windows_vpn_beta). `installer.exe` file will appear in the downloads list of your browser. + +2) Open it. The AdGuard VPN installer will do the rest, just click **Install**. + +4) When you see the screen saying 'Installaion completed successfully', tap **Finish**. + + + +That's it, AdGuard VPN for Windows beta is installed to your device! diff --git a/11.vpn/02.installation/docs.ru.md b/11.vpn/02.installation/docs.ru.md index 9409c398..f50bd079 100644 --- a/11.vpn/02.installation/docs.ru.md +++ b/11.vpn/02.installation/docs.ru.md @@ -56,7 +56,7 @@ AdGuad VPN для Firefox успешно установлен! Чтобы установить AdGuard VPN для Android: -1) Перейдите по [этой ссылке](https://agrd.io/vpn_android_beta) или откройте страницу AdGuard VPN в магазине приложений Google Play. +1) Перейдите по [этой ссылке](https://agrd.io/adguard_vpn_android) или откройте страницу AdGuard VPN в магазине приложений Google Play. 2) Нажмите **Установить**. @@ -64,25 +64,57 @@ AdGuad VPN для Firefox успешно установлен! 3) Подождите, пока закончится процесс загрузки, и нажмите **Открыть**. -AdGuard VPN для Android упешно установлен! +AdGuard VPN для Android успешно установлен! ## AdGuard VPN для iOS -AdGuard VPN для iOS пока находится в разработке. Ожидайте его выход в ближайшем будущем! +Чтобы установить AdGuard VPN для iOS: + +1) Перейдите по [этой ссылке](https://agrd.io/ios_vpn) или откройте App Store и введите "AdGuard VPN" в поле для поиска. + +2) Нажмите **ЗАГРУЗИТЬ** рядом с AdGuard VPN — Unlimited & Fast и подтвердите установку двойным нажатием на боковую кнопку устройства iOS. + +3) Подождите, пока закончится процесс загрузки, и нажмите **Открыть**. + + + +AdGuard VPN для iOS успешно установлен! ## AdGuard VPN для Mac -AdGuard VPN для Mac пока находится в разработке. Ожидайте его выход в ближайшем будущем! +Чтобы установить AdGuard VPN для Mac beta: +1) Перейдите по [этой ссылке](https://agrd.io/mac_vpn_beta). DMG-файл появится в списке загрузок вашего браузера. + +2) Откройте его. Вы увидите экран "Установить AdGuard VPN". Дважды нажмите на иконку. + +3) Установщик AdGuard VPN сделает всё сам, просто нажмите **Продолжить** и **Установить**. Или можете изменить размещение установки, если потребуется. + +4) Когда вы увидите экран "Установка прошла успешно", нажмите **Закрыть**. + + + +Вот и всё, AdGuard VPN для Mac beta установлен на ваше устройство! + ## AdGuard VPN for Windows -AdGuard VPN для Windows пока находится в разработке. Ожидайте его выход в ближайшем будущем! \ No newline at end of file +Чтобы установить AdGuard VPN для Windows beta: + +1) Перейдите по [этой ссылке](https://agrd.io/windows_vpn_beta). Файл `installer.exe` появится в списке загрузок вашего браузера. + +2) Откройте его. Установщик AdGuard VPN сделает всё сам, просто нажмите **Установить**. + +3) Когда вы увидите экран "Установка успешно завершена", нажмите **Завершить**. + + + +Вот и всё, AdGuard VPN для Windows beta установлен на ваше устройство! diff --git a/11.vpn/03.features/docs.en.md b/11.vpn/03.features/docs.en.md index 323a6659..267e8410 100644 --- a/11.vpn/03.features/docs.en.md +++ b/11.vpn/03.features/docs.en.md @@ -105,7 +105,7 @@ Turn off the switch next to any app to tell AdGuard VPN to ignore this app's tra ### Kill Switch -If anonymity is absolutely essential for you, enable **Kill Switch** from the **Settings** tab. If connection drops for any reason, Kill Switch will block access to the Internet, thus preventing your anonyymity from becoming compromised. +If anonymity is absolutely essential for you, enable **Kill Switch** from the **Settings** tab. If connection drops for any reason, Kill Switch will block access to the Internet, thus preventing your anonymity from becoming compromised. ### VPN mode @@ -115,6 +115,18 @@ We don't recommend using *SOCKS5* mode unless you know what you're doing. >*NOTE*: *SOCKS5* mode can be used as a [temporary solution](https://adguard.com/en/blog/introducing-adguard-vpn-for-android.html#compatibilitywiththeadguardmainapp) to run AdGuard VPN alongside [AdGuard for Android](https://adguard.com/adguard-android/overview.html) ad blocker until we implement a proper solution. +### Compatibility with AdGuard ad blocker + +Normally, two VPN-based apps can't work simultaneously on Android. But we made it possible for AdGuard VPN and [AdGuard ad blocker](https://adguard.com/en/adguard-android/overview.html). All you have to do is to install both applications on your device, AdGuard will do the rest automatically. + +Compatibility mode comes with a few limiations: + +* Application tunneling and other app settings are now available only via the AdGuard ad blocker app +* Switching to a custom DNS server can be performed only via AdGuard ad blocker +* Kill Switch option becomes unavailable + +If you want to disable Compatibility mode, go to *Settings > App settings > Advanced settings > Operating mode* and select a different mode. This will unlink AdGuard VPN from the ad blocker app, and AdGuard ad blocker will stop protecting your device. + ### Custom DNS and low level settings Normally, we strongly discourage from messing with **Low level settings** (located at **Settings > Advanced settings > Low level settings**) without consulting tech support. However, **DNS servers** option can prove useful to many users. It allows to indicate any custom DNS server that will be forced for all traffic coming through AdGuard VPN. diff --git a/11.vpn/03.features/docs.ru.md b/11.vpn/03.features/docs.ru.md index ffdde76f..885619e7 100644 --- a/11.vpn/03.features/docs.ru.md +++ b/11.vpn/03.features/docs.ru.md @@ -115,8 +115,20 @@ AdGuard VPN для Android использует тот же продвинуты >*ВНИМАНИЕ*: режим *SOCKS5* можно использовать как [временное решение](https://adguard.com/ru/blog/introducing-adguard-vpn-for-android.html), чтобы запустить AdGuard VPN вместе с блокировщиком [AdGuard для Android](https://adguard.com/adguard-android/overview.html), пока мы не добавим более простое решение. +### Совместимость с блокировщиком AdGuard + +Обычно, два приложения, в основе которых — VPN, не могут работать одновременно на Android. Но мы сделали это возможным для AdGuard VPN и [блокировщика рекламы AdGuard](https://adguard.com/ru/adguard-android/overview.html). Всё, что нужно сделать, это установить оба приложения на своё устройство, и всё остальное AdGuard сделает автоматически. + +Режим совместимости имеет несколько ограничений: + +* “Туннелирование” приложений и их другие настройки теперь доступны только через приложение блокировщика рекламы AdGuard +* Переключение на собственный DNS-сервер возможно только через блокировщик рекламы AdGuard +* Опция Kill Switch (блокировка доступа к интернету при обрыве соединения) становится недоступной + +Если вы хотите отключить режим совместимости, перейдите в *Настройки > Настройки приложения > Расширенные настройки > Режим работы* и выберите другой режим. Это отключит AdGuard VPN от блокировщика рекламы AdGuard, а блокировщик перестанет защищать ваше устройство. + ### Собственный DNS и настройки низкого уровня Обычно мы не рекомендуем изменять **Настройки низкого уровня** (расположенные в разделе **Настройки > Расширенные настройки > Настройки низкого уровня**) без предварительной консультации с технической поддержкой. Однако, опция **DNS-сервер** может оказаться полезной для многих пользователей. Она позволяет указать любой DNS-сервер, и в этом случае он будет использоваться для всего трафика, проходящего через AdGuard VPN. -Разные DNS-серверы могут служить для различных целей: более безопасные, более быстрые, блокирующие рекламу, блокирующие "взрослый" контент и т.д. Некоторые из наиболее популярных DNS-провайдеров, включая [AdGuard DNS](https://adguard.com/adguard-dns/overview.html), можно найти в [этой](https://kb.adguard.com/ru/general/dns-providers) статье нашей Базы знаний. \ No newline at end of file +Разные DNS-серверы могут служить для различных целей: более безопасные, более быстрые, блокирующие рекламу, блокирующие "взрослый" контент и т.д. Некоторые из наиболее популярных DNS-провайдеров, включая [AdGuard DNS](https://adguard.com/adguard-dns/overview.html), можно найти в [этой](https://kb.adguard.com/ru/general/dns-providers) статье нашей Базы знаний. diff --git a/11.vpn/04.FAQ/docs.en.md b/11.vpn/04.FAQ/docs.en.md index 6a547243..cc2e88bd 100644 --- a/11.vpn/04.FAQ/docs.en.md +++ b/11.vpn/04.FAQ/docs.en.md @@ -20,7 +20,7 @@ A VPN is a multi-purpose digital survival tool. You can use your VPN to: * Get discounts when you shop online (local prices and special offers are sometimes more favorable). ### What makes AdGuard VPN better than other VPNs? -Over the years we proved that we can be trusted, and 20M+ users agree. We have a strict no logging policy and we even developed our own safe protocol specifically for AdGuard VPN. Our VPN service has several advantages over its competitors. We provide unique features like domain exclusions and custom DNS servers (more [here](LINK NEEDED)). +Over the years we proved that we can be trusted, and 20M+ users agree. We have a strict no logging policy and we even developed our own safe protocol specifically for AdGuard VPN. Our VPN service has several advantages over its competitors. We provide unique features like domain exclusions and custom DNS servers (more [here](https://kb.adguard.com/en/vpn/features)). ### What are the advantages of AdGuard VPN protocol? While there are other tested and proven solutions, AdGuard offers an unparalleled level of security compared to other popular communication protocols. Combined with high speed and reliability, it's a perfect choice for a multipurpose VPN service like AdGuard. @@ -54,10 +54,16 @@ In the paid version there is unlimited speed and no traffic limit (as opposed to ### How to buy AdGuard VPN? Proceed to [the payment page](https://adguard-vpn.com/en/license.html) and choose the plan that suits you best. We have 1-month or 1-year subscription options. -### What do I get with the paid subscription? -* Unlimited speed -* Unlimited traffic (as opposed to the free version with only 3GB of monthly traffic). -* Subscription will be valid for 5 devices at once (whether it be the extension or Android app or future products that are yet to come). +### What restrictions do users of the free version have? +* VPN can be used only on two devices simultaneously +* Speed cap is 20 Mbit/s +* Traffic limit is 3 GB per month +* Some locations are not available +* Streaming services are not supported +* Torrents are not supported +* Email clients can’t be used for sending messages (for AdGuard VPN for iOS and Android) + +> The last point should be addressed separately: users of the free version of AdGuard VPN for iOS and Android cannot send emails in email clients. It’s impossible because we block port 25, which is used for outgoing emails, and thus reinsure against spam. However, sending emails in the browser version of email services works perfectly, and on AdGuard VPN for Android you can add apps to exclusions so that email apps will function as well. ### How many devices can be connected to AdGuard VPN simultaneously? Most likely you are reading this because you’ve seen the “Maximum number of connections reached” warning. diff --git a/11.vpn/04.FAQ/docs.ru.md b/11.vpn/04.FAQ/docs.ru.md index fdf3f806..a18ed497 100644 --- a/11.vpn/04.FAQ/docs.ru.md +++ b/11.vpn/04.FAQ/docs.ru.md @@ -19,10 +19,10 @@ VPN — это многофункциональный цифровой инст * Получать скидки, когда вы делаете покупки онлайн (местные цены и специальные предложения иногда более выгодны). ### Чем AdGuard VPN лучше других VPN? -За много лет мы доказали, что нам можно доверять, и более 20 миллионов пользователей тому подтверждение. Мы придерживаемся строгой политики без записи логов и даже разработали свой безопасный протокол специально для AdGuard VPN. Кроме того, наш VPN-сервис предоставляет уникальные возможности, такие, как исключения доменов и выбор DNS-сервера (узнать больше можно [здесь](ССЫЛКА)). +За много лет мы доказали, что нам можно доверять, и более 20 миллионов пользователей тому подтверждение. Мы придерживаемся строгой политики без записи логов и даже разработали свой безопасный протокол специально для AdGuard VPN. Кроме того, наш VPN-сервис предоставляет уникальные возможности, такие, как исключения доменов и выбор DNS-сервера (узнать больше можно [здесь](https://kb.adguard.com/ru/vpn/features)). ### Каковы преимущества протокола AdGuard? -Хотя существуют и другие проверенные и популярные решения, AdGuard предлагает беспрецедентный уровень безопасности в сравнении с прочими протоколами взаимодействия. В комбинации с высокой скоростью и надёжностью, протокол AdGuard является идеальным выбором для такого многоцелевого VPN-сервиса, как AdGuard VPN. +Хотя существуют и другие проверенные и популярные решения, AdGuard предлагает беспрецедентный уровень безопасности в сравнении с прочими протоколами взаимодействия. В комбинации с высокой скоростью и надежностью, протокол AdGuard является идеальным выбором для такого многоцелевого VPN-сервиса, как AdGuard VPN. ### Как установить AdGuard VPN? Подробную инструкцию по установке для всех платформ можно найти [в этой статье](https://kb.adguard.com/ru/vpn/installation). @@ -58,15 +58,21 @@ AdGuard — это компания, специализирующаяся на Одна подписка AdGuard VPN распространяется на **5 одновременных подключений** (к любым устройствам). Если вы достигли лимита и хотите подключить другое устройство, пожалуйста, отключите любое из устройств, которое не используете. Для этого кликните или нажмите кнопку “Отключить” на соответствующем устройстве. Кроме того, если вам нужно подключить более 5 устройств, вы можете приобрести дополнительную подписку (с ней VPN будет работать на еще 5 устройствах). -### Что я получу с платной подпиской? -- Неограниченную скорость; -- Неограниченный трафик (в отличие от бесплатной версии с только 3 Гб ежемесячного трафика); -- Подписка будет действительна для 5 устройств сразу (будь то расширение, приложение для Android или продукты, которые появятся в будущем). +### Какие ограничения есть у бесплатных пользователей? +* Можно пользоваться VPN только на двух устройствах одновременно +* Максимальная скорость — 20 Мбит/сек. +* Лимит трафика — 3 Гб в месяц +* Для подключения доступны не все локации +* Нельзя пользоваться стриминговыми сервисами +* Нельзя пользоваться торрент-приложениями +* Нельзя использовать почтовые клиенты для отправки сообщений + +> Обратите внимание на последний пункт: пользователи бесплатной версии AdGuard VPN для iOS и Android не могут отправлять письма в почтовых клиентах — мы блокируем порт 25, который отвечает за исходящие электронные письма, и таким образом перестраховываемся от спама. При этом отправка писем в браузерной версии почтовых служб прекрасно работает, а на AdGuard VPN для Android можно добавить приложения с почтой в исключения, чтобы работали и почтовые приложения. ### Какие варианты подписки у вас есть? -У нас 2 тарифных плана: **Ежемесячная** (оплачивается раз в месяц) и **Годовая** (оплачивается раз в год) подписки. [Выбирайте ту, что подходит вам больше](https://adguard-vpn.com/license.html). +У нас 2 тарифных плана подписки: **Ежемесячная** и **Годовая**, оплачиваются они раз в месяц и раз в год соответственно. [Выбирайте ту, что подходит вам больше](https://adguard-vpn.com/license.html). ### Как работает 30-дневная гарантия возврата денег? -Мы предоставляем нашим клиентам возможность вернуть 100% средств, потраченных ими на Годовые подписки AdGuard, приобретенные с сайта https://adguard-vpn.com/ (для подписок, приобретенных в другом месте, ознакомьтесь с порядком возврата средств этого конкретного посредника). Для Годовых подписок у нас есть 30-дневная гарантия возврата денег. Все запросы на возврат средств за Годовую подписку, сделанные в течение 30 дней с момента покупки, удовлетворяются независимо от причины. +Мы предоставляем нашим клиентам возможность вернуть 100% средств, потраченных ими на Годовые подписки AdGuard, приобретенные с сайта [https://adguard-vpn.com/](https://adguard-vpn.com/) (для подписок, приобретенных в другом месте, ознакомьтесь с порядком возврата средств этого конкретного посредника). Для Годовых подписок у нас есть 30-дневная гарантия возврата денег. Все запросы на возврат средств за Годовую подписку, сделанные в течение 30 дней с момента покупки, удовлетворяются независимо от причины. Чтобы вернуть деньги за Годовую подписку, приобретенную [на официальном сайте](https://adguard-vpn.com/), вам необходимо связаться со службой поддержки: support@adguard-vpn.com. Время обработки зависит от выбранного вами способа оплаты и обычно занимает до 5-10 рабочих дней. diff --git a/11.vpn/05.solving-problems/020.debug-logs/docs.en.md b/11.vpn/05.solving-problems/020.debug-logs/docs.en.md new file mode 100644 index 00000000..544b9de4 --- /dev/null +++ b/11.vpn/05.solving-problems/020.debug-logs/docs.en.md @@ -0,0 +1,25 @@ +--- +title: 'How to collect debug logs' +published: true +taxonomy: + category: + - docs +--- + +Debug logs are required whenever there's an atypical technical issue that calls for a close look from the developers. If you've run into such an issue and want to record relevant logs, or if you were asked by the support team to collect debug logs, here's what you need to do, depending on your OS. + +## Android + +1. Swipe away all background applications that are irrelevant to the problem. + +2. Open *AdGuard VPN settings > App settings > Advanced settings > Logging level* and select **Extended** logging level. + +3. Reproduce the problem and mark the exact time when it happened. + +4. Go back to *AdGuard VPN settings > Support* and tap **Export logs and system info**. On the opened screen confirm saving the archive to your local storage. + +5. Return to *AdGuard VPN settings > App settings > Advanced settings > Logging level* and select **Default** again. + +6. Send us an email at support@adguard.com, attach the archive with logs, and mention the time when the problem was reproduced. **This is very important!** Without it, we might not be able to find the relevant information. + +> Sometimes, the support team may ask you to record and send over the Extreme logs. The instruction would be the same, except for step 2, where you'd need to select **Extreme** instead of Extended. **Never switch to Extreme logging level unless you were told to by the support team!** This will lead to severe problems with app's performance if left enabled for long. diff --git a/11.vpn/05.solving-problems/020.debug-logs/docs.ru.md b/11.vpn/05.solving-problems/020.debug-logs/docs.ru.md new file mode 100644 index 00000000..1dab55c2 --- /dev/null +++ b/11.vpn/05.solving-problems/020.debug-logs/docs.ru.md @@ -0,0 +1,27 @@ +--- +title: 'Как собрать отладочные логи' +published: true +taxonomy: + category: + - docs +--- + +Отладочные логи требуются, когда у пользователя возникает нетипичная техническая проблема, требующая пристального внимания со стороны разработчиков. Если вы столкнулись с такой проблемой и хотите направить отладочные логи в службу поддержки для её решения, или если служба поддержки сама попросила вас собрать их, то вот что вам нужно сделать в зависимости от вашей операционной системы. + + +## Android + +1. Смахните/закройте все фоновые приложения, которые не имеют отношения к проблеме. + +2. Откройте *Настройки AdGuard VPN > Настройки приложения > Расширенные настройки > Уровень логирования* и выберите **Расширенный** уровень логирования. + +3. Воспроизведите проблему и отметьте точное время, когда она возникла. + +4. Вернитесь в *Настройки AdGuard VPN > Поддержка* и нажмите **Экспортировать логи и информацию о системе**. В открывшемся окошке подтвердите сохранение архива в локальное хранилище. + +5. Вернитесь в *Настройки AdGuard VPN > Настройки приложения > Расширенные настройки > Уровень логирования* и выберите **Стандартный**. + +6. Отправьте нам сообщение на почту support@adguard.ru, прикрепив архив с логами, и укажите время, когда проблема была воспроизведена. **Это очень важно!** Без точного времени мы не сможем найти нужную информацию. + + +> Иногда служба поддержки может попросить вас записать и отправить логи экстремального уровня. Инструкция будет такой же, за исключением шага 2, где вам нужно выбрать опцию **Экстремальный** вместо Расширенный. **Никогда не переключайтесь на экстремальный уровень логирования, если только вы не получили такую инструкцию от нашей службы поддержки!** Если оставить его включенным на долгое время, это может привести к серьезным проблемам с производительностью приложения. diff --git a/12.miscellaneous/01.acknowledgments/docs.en.md b/12.miscellaneous/01.acknowledgments/docs.en.md index e1777147..79dabcb9 100644 --- a/12.miscellaneous/01.acknowledgments/docs.en.md +++ b/12.miscellaneous/01.acknowledgments/docs.en.md @@ -209,34 +209,55 @@ This is the list of libraries and other resources that really helped us with AdG # Special thanks -Also a huge thanks and gratitude to all beta testers and other engaged users, whose help in finding and eliminating all the bugs was priceless. Special thanks to: +Also a huge thanks and gratitude to all beta testers and other engaged users, whose help in finding/eliminating all the bugs, translating AdGuard and moderating our communities was priceless. Special thanks to: -* [ag_bug_finder](http://forum.adguard.com/member.php?3639) -* [Blaz](http://forum.adguard.com/member.php?4656-Blaz) -* [Boo Berry](http://forum.adguard.com/member.php?1905-Boo-Berry) -* [buuuuuuu190](http://forum.adguard.com/member.php?3571-buuuuuuu190) -* [clarke](http://forum.adguard.com/member.php?3985-clarke) -* [dartrax](https://github.com/dartrax) -* [dja2k](http://forum.adguard.com/member.php?3933-dja2k) -* [hanschke](http://forum.adguard.com/member.php?3946-hanschke) -* [itabmedia](http://forum.adguard.com/member.php?4711-itabmedia) -* [Lord Ami](http://forum.adguard.com/member.php?5374-Lord-Ami) -* [milder](http://forum.adguard.com/member.php?4519-milder) -* [Nicos18](http://forum.adguard.com/member.php?5726-Nicos18) -* [rickyoh](http://forum.adguard.com/member.php?1507-rickyoh) -* [Ronin427](http://forum.adguard.com/member.php?4116-Ronin427) -* [saturnotaku](http://forum.adguard.com/member.php?4782-saturnotaku) -* [steve1209](http://forum.adguard.com/member.php?3437-steve1209) -* [streetwolf](http://forum.adguard.com/member.php?3482-streetwolf) -* [TPS](https://github.com/TPS) -* fabjazz -* kirasam -* malware1 -* ouzbed -* Sanjay Nand -* TayTayTheKiller +* ag_bug_finder - beta tester of AdGuard for Windows +* Aikatsui – active contributor to AdGuard Home +* Andy Kleinert (AndyKl) – translator and proofreader to German in Crowdin +* BigDargon – contributed the hostsVN project as a source to the list of AdGuard DNS +* Blaz - started as a filter contributor and now working at AdGuard +* Boo Berry - forum and Telegram group moderator +* buuuuuuu190 - beta tester, active AdGuard Forum member +* clarke - beta tester, active AdGuard Forum member +* [dartrax](https://github.com/dartrax) - beta tester, active AdGuard Forum member +* dja2k - beta tester, active AdGuard Forum member +* Eduardo Addad de Oliveira (eduardoaddad) – translator and proofreader to Portuguese and Portuguese, Brazilian in Crowdin +* fabjazz - beta tester, active AdGuard Forum member +* Görkem Emrah Güler (gork7777) – translator and proofreader to Turkish in Crowdin +* hanschke - beta tester, active AdGuard Forum member +* iDjay – outstanding beta tester of AdGuard for iOS +* Imre Kristoffer Eilertsen (DandelionSprout) – maintainer of “Dandelion Sprout’s Nordic Filters” that are included in all AdGuard tools +* IONIL – translator and proofreader to Hebrew in Crowdin +* itabmedia - beta tester, active AdGuard Forum member +* kirasam - beta tester, active AdGuard Forum member +* krystian3w – very active filter contributor +* lancelot.moon – translator and proofreader to Chinese Traditional in Crowdin, beta tester +* Lord Ami - beta tester, active AdGuard Forum member +* malware1 - beta tester, active AdGuard Forum member +* milder - beta tester, active AdGuard Forum member +* Nicos18 - beta tester, active AdGuard Forum member +* Oizaro – translator and proofreader to Italian in Crowdin +* Oleg Chashko — very active beta tester of AdGuard for Safari +* Oskari Lavinto (olavinto) – translator and proofreader to Finnish in Crowdin +* ouzbed - beta tester, active AdGuard Forum member +* PentagramTr – filter contributor, namely, he has brought a lot of new things to the Turkish filter +* Peter Hubinsky (hubak) – translator and proofreader to Slovak in Crowdin +* PiQuark6046 – filter contributor +* rickyoh - beta tester, active AdGuard Forum member +* Ronin427 - beta tester, active AdGuard Forum member +* Sanjay Nand - beta tester, active AdGuard Forum member +* saturnotaku - beta tester, active AdGuard Forum member +* steve1209 - beta tester, active AdGuard Forum member +* streetwolf - beta tester, active AdGuard Forum member +* superlex – helps us with scriptlets, filters, and AdGuard for Safari +* TayTayTheKiller - beta tester, active AdGuard Forum member +* [TPS](https://github.com/TPS) - bug finder, filter contributor +* Yuki2718 – actively contributes to AdGuard filters +* zznosar — active beta tester focused on AdGuard for iOS +* Сергей Зозуля (sviperz) — active member of our Telegram group, beta tester --- + We also want to thank the [xda-developers users](https://adguard.com/en/forum.xda-developers.com/android/apps-games/adguard-ad-blocker-doesnt-require-root-t2958895). Thank you for your much helpful feedback! We always appreciate comments from our users, especially constructive ones :) You can always contact us to share your thoughts about AdGuard, request new features, and submit bugs. Join our [AdGuard Forum](http://forum.adguard.com/forumdisplay.php?25-English-Forums), [Subreddit](https://reddit.com/r/adguard), [Xda-developers Forum](https://adguard.com/en/forum.xda-developers.com/android/apps-games/adguard-ad-blocker-doesnt-require-root-t2958895) or visit our page on [GitHub](https://github.com/AdguardTeam). diff --git a/12.miscellaneous/01.acknowledgments/docs.ru.md b/12.miscellaneous/01.acknowledgments/docs.ru.md index 595d9569..87ba4ea3 100644 --- a/12.miscellaneous/01.acknowledgments/docs.ru.md +++ b/12.miscellaneous/01.acknowledgments/docs.ru.md @@ -208,70 +208,90 @@ visible: true # Благодарности -Огромное спасибо всем бета-тестерам и другим пользователям, чья помощь в поиске и устранении ошибок была поистине бесценной. Особая благодарность: +Также огромное спасибо всем бета-тестерам и другим неравнодушным пользователям, чья помощь в поиске и устранении ошибок, переводе AdGuard и модерации наших сообществ была бесценной. Особая благодарность: -* [dartrax](https://github.com/dartrax) -* [Petrovic](http://forum.adguard.com/member.php?3037-Petrovic) -* [leh-stav](http://forum.adguard.com/member.php?2624-leh-stav) -* [Анатолий1978](http://forum.adguard.com/member.php?3153-%D0%90%D0%BD%D0%B0%D1%82%D0%BE%D0%BB%D0%B8%D0%B91978) -* [toby_43](http://forum.adguard.com/member.php?371-toby_43) -* [N3m0s](http://forum.adguard.com/member.php?4159-N3m0s) -* [Иван Кузенков](http://forum.adguard.com/member.php?2801-%D0%98%D0%B2%D0%B0%D0%BD-%D0%9A%D1%83%D0%B7%D0%B5%D0%BD%D0%BA%D0%BE%D0%B2) -* [ZP](http://forum.adguard.com/member.php?4531-ZP) -* [vampir900](http://forum.adguard.com/member.php?809-vampir900) -* [4pokMEN](http://forum.adguard.com/member.php?5932-4pokMEN) -* [jesus_c31](http://forum.adguard.com/member.php?2286-jesus_c31) -* [Хых](http://forum.adguard.com/member.php?1846-%D0%A5%D1%8B%D1%85) -* [KiLlArMy_Juni](http://forum.adguard.com/member.php?107-KiLlArMy_Juni) -* [dr_max](http://forum.adguard.com/member.php?3114-dr_max) -* [iluhin](http://forum.adguard.com/member.php?1764-iluhin) -* [MisterMyth](http://forum.adguard.com/member.php?6006-MisterMyth) -* [BigStone](http://forum.adguard.com/member.php?3284-BigStone) -* [sasanau](http://forum.adguard.com/member.php?3705-rasanau) -* [focus](http://forum.adguard.com/member.php?5323-focus) -* Sanjay Nand -* [fix](http://forum.adguard.com/member.php?4077-fix) -* [Domovou](http://forum.adguard.com/member.php?2695-Domovou) -* [D1MSON](http://forum.adguard.com/member.php?6057-D1MSON) -* [RicuOne](http://forum.adguard.com/member.php?5182-RicuOne) -* [Fantom](http://forum.adguard.com/member.php?65-Fantom) -* [WSK](http://forum.adguard.com/member.php?1746-WSK) -* [Martin_Devil](http://forum.adguard.com/member.php?2148-Martin_Devil) -* [Gumbo](http://forum.adguard.com/member.php?791-Gumbo) -* [maxvelamx](http://forum.adguard.com/member.php?506-maxvelamx) -* [Talisman](http://forum.adguard.com/member.php?80-Talisman) -* [ArgoS](http://forum.adguard.com/member.php?4023-ArgoS) -* [re1ko](http://forum.adguard.com/member.php?6171-re1ko) -* [Maxim PRO](http://forum.adguard.com/member.php?440-Maxim-PRO) -* [Malahiya](http://forum.adguard.com/member.php?2549-Malahiya) -* [biomednet](http://forum.adguard.com/member.php?6196-biomednet) -* [RybakOFF](http://forum.adguard.com/member.php?4260-RybakOFF) -* [Wusa](http://forum.adguard.com/member.php?4345-Wusa) -* [Ligre](http://forum.adguard.com/member.php?3681-Ligre) -* [Hercules](http://forum.adguard.com/member.php?5881-Hercules) -* [ag_bug_finder](http://forum.adguard.com/member.php?3639) -* [milder](http://forum.adguard.com/member.php?4519-milder) -* [Ronin427](http://forum.adguard.com/member.php?4116-Ronin427) -* [itabmedia](http://forum.adguard.com/member.php?4711-itabmedia) -* [saturnotaku](http://forum.adguard.com/member.php?4782-saturnotaku) -* [Ариша](http://forum.adguard.com/member.php?5173-%D0%90%D1%80%D0%B8%D1%88%D0%B0) -* [Blaz](http://forum.adguard.com/member.php?4656-Blaz) -* [Boo Berry](http://forum.adguard.com/member.php?1905-Boo-Berry) -* [buuuuuuu190](http://forum.adguard.com/member.php?3571-buuuuuuu190) -* [clarke](http://forum.adguard.com/member.php?3985-clarke) -* [dja2k](http://forum.adguard.com/member.php?3933-dja2k) -* [hanschke](http://forum.adguard.com/member.php?3946-hanschke) -* [Lord Ami](http://forum.adguard.com/member.php?5374-Lord-Ami) -* [Nicos18](http://forum.adguard.com/member.php?5726-Nicos18) -* [rickyoh](http://forum.adguard.com/member.php?1507-rickyoh) -* [steve1209](http://forum.adguard.com/member.php?3437-steve1209) -* [streetwolf](http://forum.adguard.com/member.php?3482-streetwolf) -* [TPS](https://github.com/TPS) -* fabjazz -* kirasam -* malware1 -* ouzbed -* TayTayTheKiller +* ag_bug_finder – бета-тестер AdGuard для Windows +* Aikatsui – активный контрибьютор AdGuard Home +* Andy Kleinert (AndyKl) – переводчик и редактор немецкого языка в Crowdin +* ArgoS – бета-тестер AdGuard для Windows +* BigDargon – добавил проект hostsVN в качестве источника в список AdGuard DNS +* BigStone – бета-тестер, активный участник форума AdGuard +* biomednet – бета-тестер, активный участник форума AdGuard +* Blaz – начинал как контрибьютор, пополняя наши фильтры (а теперь работает в AdGuard) +* Boo Berry – модератор нашего форума и группы Telegram +* buuuuuuu190 – бета-тестер, активный участник форума AdGuard +* clarke – бета-тестер, активный участник форума AdGuard +* D1MSON – бета-тестер, активный участник форума AdGuard +* [dartrax](https://github.com/dartrax) – бета-тестер, активный участник форума AdGuard +* dja2k – бета-тестер, активный учаcтник форума AdGuard +* Domovou – бета-тестер, активный учаcтник форума AdGuard +* dr_max – бета-тестер, активный учаcтник форума AdGuard +* Eduardo Addad de Oliveira (eduardoaddad) – переводчик и редактор португальского и португальского бразильского языков в Crowdin +* Fantom – бета-тестер, активный участник форума AdGuard +* fabjazz – бета-тестер, активный участник форума AdGuard +* fix – бета-тестер, активный участник форума AdGuard +* focus – бета-тестер, активный участник форума AdGuard +* Görkem Emrah Güler (gork7777) – переводчик и редактор турецкого языка в Crowdin +* Gumbo – бета-тестер, активный участник форума AdGuard +* hanschke – бета-тестер, активный участник форума AdGuard +* Hercules – бета-тестер, активный участник форума AdGuard +* iDjay – выдающийся бета-тестер AdGuard для iOS +* iluhin – бета-тестер, активный участник форума AdGuard +* Imre Kristoffer Eilertsen (DandelionSprout) – разработчик "Nordic Filters" от Dandelion Sprout, которые включены во все инструменты AdGuard +* IONIL – переводчик и редактор иврита в Crowdin +* itabmedia – бета-тестер, активный участник форума AdGuard +* jesus_c31 – бета-тестер, активный участник форума AdGuard +* KiLlArMy_Juni – бета-тестер, активный участник форума AdGuard +* kirasam – бета-тестер, активный участник форума AdGuard +* krystian3w – очень активный разработчик фильтров +* lancelot.moon – переводчик и редактор традиционного китайского языка в Crowdin, бета-тестер +* leh-stav – бета-тестер, активный участник форума AdGuard +* Ligre – бета-тестер, активный участник форума AdGuard +* Lord Ami – бета-тестер, активный участник форума AdGuard +* Malahiya – бета-тестер, активный участник форума AdGuard +* malware1 – бета-тестер, активный участник форума AdGuard +* Maxim PRO – бета-тестер, активный участник форума AdGuard +* maxvelamx – бета-тестер, активный участник форума AdGuard +* Martin_Devil – бета-тестер, активный участник форума AdGuard +* milder – бета-тестер, активный участник форума AdGuard +* MisterMyth – бета-тестер, активный участник форума AdGuard +* N3m0s – бета-тестер, активный участник форума AdGuard +* Nicos18 – бета-тестер, активный участник форума AdGuard +* Oizaro – переводчик и редактор итальянского языка в Crowdin +* Oleg Chashko – очень активный бета-тестер AdGuard для Safari +* Oskari Lavinto (olavinto) – переводчик и редактор финского языка в Crowdin +* ouzbed – бета-тестер, активный участник форума AdGuard +* PentagramTr – разработчик фильтров, очень многое добавил в турецкий рекламный фильтр +* Peter Hubinsky (hubak) – переводчик и редактор словацкого языка в Crowdin +* Petrovic – бета-тестер, активный участник форума AdGuard +* PiQuark6046 – разработчик фильтров +* rickyoh – бета-тестер, активный участник форума AdGuard +* re1ko – бета-тестер, активный участник форума AdGuard +* RicuOne – бета-тестер, активный участник форума AdGuard +* Ronin427 – бета-тестер, активный участник форума AdGuard +* RybakOFF – бета-тестер, активный участник форума AdGuard +* Sanjay Nand – бета-тестер, активный участник форума AdGuard +* sasanau – бета-тестер, активный участник форума AdGuard +* saturnotaku – бета-тестер, активный участник форума AdGuard +* steve1209 – бета-тестер, активный участник форума AdGuard +* streetwolf – бета-тестер, активный участник форума AdGuard +* superlex – помогает нам со скриптлетами, фильтрами и AdGuard для Safari +* Talisman – бета-тестер, активный участник форума AdGuard +* TayTayTheKiller – бета-тестер, активный участник форума AdGuard +* toby_43 – бета-тестер, активный участник форума AdGuard +* [TPS](https://github.com/TPS) – бета-тестер, разработчик фильтров +* Yuki2718 – активный контрибьютор, помогает с фильтрами AdGuard +* vampir900 – бета-тестер, активный участник форума AdGuard +* WSK – бета-тестер, активный участник форума AdGuard +* Wusa – бета-тестер, активный участник форума AdGuard +* ZP – бета-тестер, активный участник форума AdGuard +* zznosar – активный бета-тестер, особенно помогает с AdGuard для iOS +* 4pokMEN – бета-тестер, активный участник форума AdGuard +* Анатолий1978 – бета-тестер, активный участник форума AdGuard +* Ариша – бета-тестер, активный участник форума AdGuard +* Иван Кузенков – бета-тестер, активный участник форума AdGuard +* Сергей Зозуля (sviperz) – активный участник нашей группы в Telegram, бета-тестер +* Хых – бета-тестер, активный участник форума AdGuard --- diff --git a/12.miscellaneous/02.updating-kb/docs.en.md b/12.miscellaneous/02.updating-kb/docs.en.md index 02d781dc..7049ec87 100644 --- a/12.miscellaneous/02.updating-kb/docs.en.md +++ b/12.miscellaneous/02.updating-kb/docs.en.md @@ -35,7 +35,7 @@ So, what is pull request (or PR)? To put it simply, it is kind of a message to t ## Writing new articles -To write a completely new article is a much more laborious task. But if you are determined to go down this path, do the following. First, make sure your article has a place in AdGuard Knowledgebase. It should be either related to one of the AdGuard products in some way, or be "Meta" (examples of such "meta-articles" are any of the [General questions](https://kb.adguard.com/en)) articles, or this one. Now, when you have found an appropriate topic, go to the [repository](https://github.com/AdguardTeam/AdguardKnowledgeBase) and then to the most suitable category (for example, let's say it is [Android — Solving Problems](https://github.com/AdguardTeam/AdguardKnowledgeBase/tree/master/04.android/06.solving-problems)). Press the "Create new file" button in the top-right part of the screen and name your file. Take into account that you need to create a new folder (by analogy with all the other folders in this category). The file itself should always be named `docs.en.md` for articles in English. +To write a completely new article is a much more laborious task. But if you are determined to go down this path, do the following. First, make sure your article has a place in AdGuard Knowledgebase. It should be either related to one of the AdGuard products in some way, or be "Meta" (examples of such "meta-articles" are any of the [General questions](https://kb.adguard.com/en)) articles, or this one. Now, when you have found an appropriate topic, go to the [repository](https://github.com/AdguardTeam/AdguardKnowledgeBase) and then to the most suitable category (for example, let's say it is [Android — Solving Problems](https://github.com/AdguardTeam/AdguardKnowledgeBase/tree/master/04.android/06.solving-problems)). Press the "Create new file" button in the top-right part of the screen and name your file depending on the language of your article: `docs.zh.md` for Chinese, `docs.en.md` for English, `docs.ja.md` for Japanese, `docs.ko.md` for Korean and `docs.ru.md` for Russian (**at the moment, we accept articles only in these languages**). Take into account that you need to create a new folder (by analogy with all the other folders in this category). The new folder's name will be then a part of your article's URL so please choose the name of it carefully. Notice that at the top of every file there should be a certain header: @@ -54,7 +54,7 @@ Type the rest of the text below (use [Markdown](https://github.com/LewisVo/Markd ## Translating an article -This part is tricky. Currently, our Knowledgebase only supports the English and Russian languages, but we can envision a future where we have many more to choose from. You can help us lay the foundation of this future by suggesting translations to existing articles. Everything that was said about [writing new articles](#new-article) applies here too, the main difference is that you should always create the new file in the same folder as the original one, and name it accordingly (e.g. `docs.es.md` for Spanish). Use the English original's raw text to copy the structure of the article, it will eliminate a lot of possible misunderstandings and inconsistencies. +This part is tricky. Currently, our Knowledgebase supports the Chinese, English, Japanese, Korean and Russian languages. You can help us by suggesting translations to existing articles in these languages. Everything that was said about [writing new articles](#new-article) applies here too, the main difference is that you should always create the new file in the same folder as the original one, and name it accordingly (e.g. `docs.ko.md` for Korean). Use the English original's raw text to copy the structure of the article, it will eliminate a lot of possible misunderstandings and inconsistencies. diff --git a/12.miscellaneous/02.updating-kb/docs.ru.md b/12.miscellaneous/02.updating-kb/docs.ru.md index 3d78603c..4cb1d54a 100644 --- a/12.miscellaneous/02.updating-kb/docs.ru.md +++ b/12.miscellaneous/02.updating-kb/docs.ru.md @@ -40,9 +40,7 @@ visible: true ## Создание новой статьи -Написать и предложить совершенно новую статью для Базы знаний — процесс, требующий огромных усилий. Но если вы все-таки решились на это, не забудьте учесть следующие моменты. Прежде всего, вам необходимо убедиться в том, что ваша статья найдет свое место -в нашей Базе знаний. Она должна либо относиться непосредственно к продуктам AdGuard, либо содержать в себе метаинформацию (среди примеров можно отметить некоторые статьи Базы знаний раздела [Общие вопросы](https://kb.adguard.com/ru) или данную статью). Теперь, когда вы определились с тематикой, отправляйтесь в [репозиторий](https://github.com/AdguardTeam/AdguardKnowledgeBase) -и выбирайте наиболее подходящую категорию (например: [Android — Solving Problems](https://github.com/AdguardTeam/AdguardKnowledgeBase/tree/master/05.android/06.solving-problems)). Пожалуйста, помните: для написания статьи вам потребуется создать новую папку (по аналогии с другими папками в этой же категории). Далее нажмите на кнопку "Create new file" в правой верхней части экрана и назовите данный файл `docs.ru.md` (для статей на русском языке). +Написать и предложить совершенно новую статью для Базы знаний — процесс, требующий огромных усилий. Но если вы все-таки решились на это, не забудьте учесть следующие моменты. Прежде всего, вам необходимо убедиться в том, что ваша статья найдет свое место в нашей Базе знаний. Она должна либо относиться непосредственно к продуктам AdGuard, либо содержать в себе метаинформацию (среди примеров можно отметить некоторые статьи Базы знаний раздела [Общие вопросы](https://kb.adguard.com/ru) или данную статью). Теперь, когда вы определились с тематикой, отправляйтесь в [репозиторий](https://github.com/AdguardTeam/AdguardKnowledgeBase) и выбирайте наиболее подходящую категорию (например: [Android — Solving Problems](https://github.com/AdguardTeam/AdguardKnowledgeBase/tree/master/05.android/06.solving-problems)). Пожалуйста, помните: для написания статьи вам потребуется создать новую папку (по аналогии с другими папками в этой же категории). Имя новой папки станет частью URL-адреса вашей статьи, поэтому, пожалуйста, тщательно выбирайте ее название. Далее нажмите на кнопку "Create new file" в правой верхней части экрана и назовите данный файл в зависимости от выбранного языка: `docs.zh.md` для статьи на китайском, `docs.en.md` - на английском, `docs.ja.md` - на японском, `docs.ko.md` - на корейском и `docs.ru.md` - на русском (**в данный момент, мы принимаем статьи только на этих языках**). Обратите внимание на заголовок, который должен присутствовать в верхней части каждой статьи: @@ -63,9 +61,7 @@ visible: true ## Перевод статьи -Перевод статьи — задача не из простых. В настоящее время наша База знаний содержит информацию только на английском и русском языках. -Вы можете заложить фундамент для будущего, в котором появится возможность выбирать переводы статей Базы знаний AdGuard и на другие -языки. Для того, чтобы предложить свой перевод, вам необходимо действовать по тому же принципу, который описан в разделе [Создание новой статьи](#new-article). Главное различие заключается лишь в том, что вам потребуется создать новый файл в той же самой папке, где располагается оригинальный текст, и назвать его соответствующим образом (например, `docs.es.md` для испанского языка). При переводе мы советуем вам использовать структуру оригинальной версии статьи как образец во избежание возможных недоразумений и несоответствий. +Перевод статьи — задача не из простых. В настоящее время наша База знаний содержит информацию на английском, китайском, корейском, русском и японском языках. Вы можете помочь нам с переводом статей на эти языки. Для того, чтобы предложить свой перевод, вам необходимо действовать по тому же принципу, который описан в разделе [Создание новой статьи](#new-article). Главное различие заключается лишь в том, что вам потребуется создать новый файл в той же самой папке, где располагается оригинальный текст, и назвать его соответствующим образом (например, `docs.ko.md` для корейского языка). При переводе мы советуем вам использовать структуру оригинальной версии статьи как образец во избежание возможных недоразумений и несоответствий.