diff --git a/docs/adguard-for-windows/adguard-for-windows.md b/docs/adguard-for-windows/adguard-for-windows.md index 0ce724cb401..9653f5f24eb 100644 --- a/docs/adguard-for-windows/adguard-for-windows.md +++ b/docs/adguard-for-windows/adguard-for-windows.md @@ -14,7 +14,7 @@ AdGuard for Windows is an easy-to-use tool that blocks annoying banners, popups, --- -![Home screen](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/main_screen.png) +![Home screen *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/main_screen.png) On the Home screen, you’ll find a toggle to enable or disable AdGuard protection, as well as icons for *Ad blocking*, *Tracking protection*, *DNS protection*, and *Annoyance blocking*. Main settings can be accessed through the left-side menu. @@ -36,4 +36,4 @@ Options to select language and theme, view legal documents, check license inform Click *Check for updates* to see whether your app version, filters, and extensions are up to date. -![Check for updates](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/checking_for_updates.png) +![Check for updates *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/checking_for_updates.png) diff --git a/docs/adguard-for-windows/app-management/app-management.md b/docs/adguard-for-windows/app-management/app-management.md index 386a898ccad..41b638ee1dc 100644 --- a/docs/adguard-for-windows/app-management/app-management.md +++ b/docs/adguard-for-windows/app-management/app-management.md @@ -15,7 +15,7 @@ When routing and filtering are enabled for an app, the icons below each app will You can leave the settings as they are, disable both filtering and routing, or fine-tune them manually for each app. You can also access the app’s stats. -![App stats](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/app_management/stats_app.png) +![App stats *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/app_management/stats_app.png) ## How app filtering and routing work in AdGuard for Windows v8.0 diff --git a/docs/adguard-for-windows/protection/ad-blocking.md b/docs/adguard-for-windows/protection/ad-blocking.md index 2d20c9798fb..6580f94ae66 100644 --- a/docs/adguard-for-windows/protection/ad-blocking.md +++ b/docs/adguard-for-windows/protection/ad-blocking.md @@ -5,7 +5,7 @@ sidebar_position: 1 The *Ad blocking* section is responsible for removing ads from the websites you visit and from the apps installed on your device. To filter banners, popups, trackers, and other intrusive elements, AdGuard relies on filters — sets of rules written in a [special syntax](/general/ad-filtering/create-own-filters). If you’d like to learn more about how they work, read our [article about filters](/general/ad-filtering/how-ad-blocking-works). -![Ad blocking](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/ad_blocking.png) +![Ad blocking *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/ad_blocking.png) Here you can: diff --git a/docs/adguard-for-windows/protection/annoyance-blocking.md b/docs/adguard-for-windows/protection/annoyance-blocking.md index 65521025ea5..935dc0ddb7e 100644 --- a/docs/adguard-for-windows/protection/annoyance-blocking.md +++ b/docs/adguard-for-windows/protection/annoyance-blocking.md @@ -7,7 +7,7 @@ Annoyance filters are designed to improve website usability by blocking non-adve These filters may contain rules that are not suitable for all users. Sometimes it is recommended to disable them. The decisions to add rules to this filter are made by filter developers on a rule-by-rule basis. -![Annoyance filters](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/annoyance_blocking.png) +![Annoyance filters *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/annoyance_blocking.png) **Block cookie notices** removes cookie consent banners on webpages. diff --git a/docs/adguard-for-windows/protection/browsing-security.md b/docs/adguard-for-windows/protection/browsing-security.md index 293ba5861bc..76ee1bbb97b 100644 --- a/docs/adguard-for-windows/protection/browsing-security.md +++ b/docs/adguard-for-windows/protection/browsing-security.md @@ -11,7 +11,7 @@ It won’t stop a virus that is already being downloaded, and it won’t remove For more details about how this protection works, see our article [Phishing and malware protection](/general/browsing-security). -![Browsing security](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/browsing.png) +![Browsing security *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/browsing.png) In the *Browsing security* section, you can: diff --git a/docs/adguard-for-windows/protection/dns-protection.md b/docs/adguard-for-windows/protection/dns-protection.md index 506f1d167a7..6f95239c184 100644 --- a/docs/adguard-for-windows/protection/dns-protection.md +++ b/docs/adguard-for-windows/protection/dns-protection.md @@ -17,13 +17,13 @@ Modern protocols like DNS-over-TLS and DNS-over-HTTPS ensure that your DNS reque DNS protection can filter out ads, trackers, phishing websites, and other harmful or annoying content before it even loads in your browser or apps. [Learn more about DNS filtering](https://adguard-dns.io/kb/general/dns-filtering/) -![DNS protection](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/dns.png) +![DNS protection *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/dns.png) Here’s what you can configure in DNS protection: ## Choose a DNS server -![DNS servers](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/dns_server.png) +![DNS servers *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/dns_server.png) You can select from multiple trusted DNS providers. AdGuard itself offers several options for different needs: diff --git a/docs/adguard-for-windows/protection/extensions.md b/docs/adguard-for-windows/protection/extensions.md index bed024c2e8e..f2e94e5df8c 100644 --- a/docs/adguard-for-windows/protection/extensions.md +++ b/docs/adguard-for-windows/protection/extensions.md @@ -5,7 +5,7 @@ sidebar_position: 7 AdGuard can extend website functionality by acting as a [userscript manager](/general/extensions.md). This allows you to add your own scripts as well as manage existing ones. -![Extensions](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/extensions.png) +![Extensions *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/extensions.png) ## Automatically detect userscripts diff --git a/docs/adguard-for-windows/protection/parental-control.md b/docs/adguard-for-windows/protection/parental-control.md index 0928fcf0585..5516ac3dc6d 100644 --- a/docs/adguard-for-windows/protection/parental-control.md +++ b/docs/adguard-for-windows/protection/parental-control.md @@ -5,7 +5,7 @@ sidebar_position: 6 There are several websites that children shouldn’t be able to access. *Parental control* helps you solve this problem. -![Parental control](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/parental.png) +![Parental control *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/parental.png) When *Parental control* is enabled, AdGuard scans the content of webpages and blocks those that may be harmful or inappropriate for children. This includes adult images and text, crude language, violence, and drug-related content. diff --git a/docs/adguard-for-windows/protection/protection.md b/docs/adguard-for-windows/protection/protection.md index ca13e8c11d7..d37775aee4b 100644 --- a/docs/adguard-for-windows/protection/protection.md +++ b/docs/adguard-for-windows/protection/protection.md @@ -3,7 +3,7 @@ title: Protection sidebar_position: 1 --- -![Protection tab](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/protection_section.png) +![Protection tab *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/protection_section.png) The *Protection* tab contains all key security and filtering settings. Here you can control *Ad blocking*, *Tracking protection*, *Annoyance blocking*, *DNS protection*, *Browsing security*, *Parental control*, and *Extensions*. You can also manage AdGuard Assistant here — a tool that lets you control its functionality without opening the app. Each of these features is described in a separate article. diff --git a/docs/adguard-for-windows/protection/tracking-protection.md b/docs/adguard-for-windows/protection/tracking-protection.md index 189681a7295..b44f7402d4e 100644 --- a/docs/adguard-for-windows/protection/tracking-protection.md +++ b/docs/adguard-for-windows/protection/tracking-protection.md @@ -1,178 +1,195 @@ ---- -title: Tracking protection -sidebar_position: 2 ---- - -Many websites collect data about their visitors, including IP addresses, browser and OS information, screen resolution, and even the page you came from. Cookies can be used to identify your browser, remember your preferences, or recognize you when you return. Tracking protection prevents such systems from collecting your personal data. Learn more in our [article about Tracking protection in AdGuard](https://adguard.com/kb/general/stealth-mode/) - -![Tracking protection](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/tracking_protection.png) - -If you don’t want to spend time adjusting filters manually, you can simply pick one of the ready-made protection levels: - -- *Standard*: enabled by default and provides reliable protection for everyday browsing. -- *High*: removes tracking parameters from page URLs and blocks third-party cookies. You may have to re-log in to some websites or face other cookie-related issues. -- *Extreme*: limits cookie lifetime of third-party cookies and blocks certain browser APIs. Some websites may not work correctly. - -For maximum flexibility, select *Custom* and adjust everything manually. The settings there are divided into five categories: - -- [General settings](#general-settings) - -- [Tracking methods](#tracking-methods) - -- [Browser API](#browser-api) - -- [Windows tracking](#windows-tracking) - -- [Miscellaneous](#miscellaneous) - -## General settings - -![General settings](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_general.png) - -### Block trackers - -Blocks trackers and web analytics using *AdGuard Tracking Protection filter*. - -### Remove tracking parameters from URLs - -Strips tracking parameters such as `utm_*` and `fb_ref` from pages’ URLs using *AdGuard URL Tracking filter*. - -### Hide your search queries - -Hides queries for websites visited from a search engine. When you get directed to a website from Google, Yahoo, or any other search engine, this option hides the search query that you used to find that website. - -### Ask websites not to track you - -Sends the [Global Privacy Control](https://globalprivacycontrol.org/#gpc-spec) and [Do Not Track](https://en.wikipedia.org/wiki/Do_Not_Track) signals to the websites you visit. - -## Tracking methods - -![Tracking methods](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_tracking_methods.png) - -### Delete third-party cookies - -Websites use cookies to store your preferences — for example, the language you chose, your location, or the items in your shopping cart. When you return, the browser sends these cookies back so the site can recognize you. - -Third-party cookies work the same way, but they are created by domains other than the one you’re visiting. For instance, cnn.com may include a Facebook *Like* widget that sets a cookie later read by Facebook. Advertisers often use such cookies to track which other sites you visit. - -With this option, you can set a time limit (in minutes) after which all third-party cookies will be deleted. If you set the timer to 0, such cookies will be blocked completely. - -![Time-to-live](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/delete_third_party.png) - -:::caution - -Keep in mind that this setting removes all third-party cookies, including those used for logins via social networks or other external services. This means you may need to log in again from time to time or deal with other cookie-related issues. If you only want to block tracking cookies, use [*AdGuard Tracking Protection filter*](/general/ad-filtering/filter-policy/#tracking-protection-filter). - -::: - -### Delete first-party cookies (not recommended) - -This option deletes cookies set by the website you are currently visiting after a selected period of time (in minutes). When the timer runs out, all such cookies are removed. Set the timer to 0 to block them completely. - -:::caution - -We do not recommend enabling this option as it may severely interfere with the work of certain websites. - -::: - -### Block ETag and If-None-Match headers - -Removes the ETag and If-None-Match headers from requests and responses to prevent websites from using them for tracking. - -When a browser addresses a page, the server assigns it an ETag — a unique identifier used to cache the page’s contents. On subsequent visits, the browser sends the same ETag back to the server. This allows the server to recognize the visitor. As long as the cached files remain, the ETag is transmitted with every request. If the page also contains embedded elements from other servers, such as images or iframes, those servers can use ETags to track your activity without your knowledge. - -### Block third-party Authorization header - -Disables cached authorization data that can be used for tracking purposes. May interfere with the functionality of some browser extensions and websites. - -The Authorization header value is cached by the browser and automatically sent with every request to the same domain. Since it accompanies each request, it can be used to identify and track you similarly to how cookies do. - -## Browser API - -![Browser API](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_browser_api.png) - -### Block WebRTC - -Blocks WebRTC, a known vulnerability that can leak your real IP address even if you use a proxy or VPN. - -WebRTC (Web Real-Time Communication) is a technology that allows direct data streaming between browsers and apps. It can reveal your true IP address, even if you use a proxy or VPN. Enabling this option may disrupt certain browser applications, such as messengers, chats, cinemas, or games. - -### Block Push API - -The Push API allows servers to send messages to web applications regardless of the activity status of your browser. This is why you may receive notifications from websites even if your browser is hidden in the tray or not launched. Enabling this option completely blocks the Push API. - -### Block Location API - -When this option is enabled, the browser will no longer send GPS data to websites. This prevents them from determining your location, altering search results, or tailoring content based on where you are. - -### Block Flash - -The Flash Player plugin is outdated and highly vulnerable to viruses and exploits. It can also slow down website loading. Enabling this option prevents browsers from detecting Flash components (such as plugins or ActiveXObject objects), which effectively disables Flash support. - -## Windows tracking - -![Windows tracking](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_windows_tracking.png) - -### Disable Windows telemetry - -Disables sending technical data about your system and app usage. - -### Turn off Advertising ID - -Disables Advertising ID to block tracking of your app usage. - -### Disable automatic reporting by Microsoft Defender - -Blocks automatic reporting and sampling of suspected malware. - -### Disable WAP Push message routing service - -Disables data collection about Windows component problems - -## Miscellaneous - -![Miscellaneous](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_misc.png) - -### Hide Referer from third parties - -Referer is an HTTP header included in browser-to-server requests. It contains the URL of the request source. When you navigate from one page to another, Referer saves the URL of the initial page. The server that hosts the destination web page often has software that parses Referer and extracts various pieces of information from it. - -Enabling the *Hide Referer from third-parties* option prevents third-party websites from seeing this information by altering or removing the header. - -You can also enter a custom value in the *Custom Referer* field. To use default Referer, leave the field blank. - -Note that to be able to filter traffic, AdGuard applications intercept browser-to-server requests. Requests to ad, tracking, and phishing servers may be altered before sending them to the server or blocked completely. - -Same goes for the *Hide Referer from third parties* option: To filter traffic, AdGuard intercepts HTTP(S) requests and may alter or block them before they reach the server. The change happens only after the request leaves your browser. For this reason, if you check headers inside the browser (for example with Chrome Developer Tools), you will still see the original Referer. To confirm that it has been modified, you can use external tools such as Fiddler. - -### Hide your User-Agent - -When you visit a website, your browser sends a header called User-Agent as part of the HTTP request. It looks like a text line that begins with “User-Agent:”. This line usually contains details such as the browser name and version, operating system, and language settings. - -By enabling this option, AdGuard removes identifying information from the User-Agent so advertisers and trackers cannot use it to profile you. If you prefer, you can enter a custom value in the *Custom User-Agent* field. To keep the default value, simply leave the field blank. - -### Mask your IP address - -AdGuard cannot completely hide your real IP address, but it can replace it with a different one so that websites interpret your connection as coming through a proxy. In some cases this helps to obscure your true IP. - -You can enter any IP address you want to use in the corresponding field. To use the default IP address, leave the field blank. - -### Remove X-Client-Data header - -Prevents Google Chrome from sending information about its version and modifications in requests to Google domains, including services like DoubleClick and Google Analytics. - -### Protect against DPI - -The Deep Packet Inspection is a system of deep analysis and filtering of traffic by packet content, as well as the accumulation of statistical data. Using this technology, ISPs have the ability to control the passing traffic and limit access to content for their clients. - -Deep Packet Inspection (DPI) is a technology used by some ISPs to analyze and filter traffic based on packet content. It allows them to monitor connections, restrict access to certain resources, and collect statistics about users. - -When this option is enabled, AdGuard modifies outgoing packet data so that it no longer matches the DPI blocking criteria. This can help you bypass restrictions and access the content you need. However, not all DPI systems can be circumvented yet — improvements are still in progress. - -The *Protect from DPI* feature is already implemented in AdGuard for Windows, AdGuard for Mac, and AdGuard for Android. - -:::caution - -If this feature is enabled in AdGuard for Windows, it may interfere with the ESET antivirus. In this case, ESET will not be able to filter traffic, leaving some malicious or blocked websites accessible. - -::: +--- +title: Tracking protection +sidebar_position: 2 +--- + +Many websites collect data about their visitors, including IP addresses, browser and OS information, screen resolution, and even the page you came from. Cookies can be used to identify your browser, remember your preferences, or recognize you when you return. Tracking protection prevents such systems from collecting your personal data. Learn more in our [article about Tracking protection in AdGuard](https://adguard.com/kb/general/stealth-mode/) + +![Tracking protection *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/tracking_protection.png) + +If you don’t want to spend time adjusting filters manually, you can simply pick one of the ready-made protection levels: + +- *Standard*: enabled by default and provides reliable protection for everyday browsing. +- *High*: removes tracking parameters from page URLs and blocks third-party cookies. You may have to re-log in to some websites or face other cookie-related issues. +- *Extreme*: limits cookie lifetime of third-party cookies and blocks certain browser APIs. Some websites may not work correctly. + +For maximum flexibility, select *Custom* and adjust everything manually. The settings there are divided into five categories: + +- [General settings](#general-settings) + +- [Tracking methods](#tracking-methods) + +- [Browser API](#browser-api) + +- [Windows tracking](#windows-tracking) + +- [Miscellaneous](#miscellaneous) + +## General settings + +![General settings *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_general_settings.png) + +### Block trackers + +Blocks trackers and web analytics using *AdGuard Tracking Protection filter*. + +### Remove tracking parameters from URLs + +Strips tracking parameters such as `utm_*` and `fb_ref` from pages’ URLs using *AdGuard URL Tracking filter*. + +### Hide search queries + +Hides queries for websites visited from a search engine. When you get directed to a website from Google, Yahoo, or any other search engine, this option hides the search query that you used to find that website. + +### Ask websites not to track me + +Sends the [Global Privacy Control](https://globalprivacycontrol.org/#gpc-spec) and [Do Not Track](https://en.wikipedia.org/wiki/Do_Not_Track) signals to the websites you visit. + +### Other privacy filters + +Applies a set of additional privacy protection filters. The number next to *Enabled in Filters* shows how many filters are currently active. + +## Tracking methods + +![Tracking methods *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_settings_tracking_methods.png) + +### Delete third-party cookies + +Websites use cookies to store your preferences — for example, the language you chose, your location, or the items in your shopping cart. When you return, the browser sends these cookies back so the site can recognize you. + +Third-party cookies work the same way, but they are created by domains other than the one you’re visiting. For instance, cnn.com may include a Facebook *Like* widget that sets a cookie later read by Facebook. Advertisers often use such cookies to track which other sites you visit. + +With this option, you can set a time limit (in minutes) after which all third-party cookies will be deleted. If you set the timer to 0, such cookies will be blocked completely. + +![Time-to-live *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/delete_third_party.png) + +:::caution + +Keep in mind that this setting removes all third-party cookies, including those used for logins via social networks or other external services. This means you may need to log in again from time to time or deal with other cookie-related issues. If you only want to block tracking cookies, use [*AdGuard Tracking Protection filter*](/general/ad-filtering/filter-policy/#tracking-protection-filter). + +::: + +### Delete first-party cookies (not recommended) + +This option deletes cookies set by the website you are currently visiting after a selected period of time (in minutes). When the timer runs out, all such cookies are removed. Set the timer to 0 to block them completely. + +:::caution + +We do not recommend enabling this option as it may severely interfere with the work of certain websites. + +::: + +### Block ETag and If-None-Match headers + +Removes the ETag and If-None-Match headers from requests and responses to prevent websites from using them for tracking. + +When a browser addresses a page, the server assigns it an ETag — a unique identifier used to cache the page’s contents. On subsequent visits, the browser sends the same ETag back to the server. This allows the server to recognize the visitor. As long as the cached files remain, the ETag is transmitted with every request. If the page also contains embedded elements from other servers, such as images or iframes, those servers can use ETags to track your activity without your knowledge. + +### Block third-party Authorization header + +Disables cached authorization data that can be used for tracking purposes. May interfere with the functionality of some browser extensions and websites. + +The Authorization header value is cached by the browser and automatically sent with every request to the same domain. Since it accompanies each request, it can be used to identify and track you similarly to how cookies do. + +## Browser API + +![Browser API *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_settings_browser_api.png) + +### Prevent IP address leaks through WebRTC + +Makes WebRTC use a stricter IP address policy to prevent your real IP address from being exposed, even if you use a proxy or VPN. + +WebRTC (Web Real-Time Communication) is a technology that allows direct data streaming between browsers and apps. By default, it can reveal your true IP address even when a proxy or VPN is active. This option enforces a stricter IP address policy instead of blocking WebRTC entirely, so browser applications such as messengers, chats, and games are less likely to be affected. + +### Block Push API + +The Push API allows servers to send messages to web applications regardless of the activity status of your browser. This is why you may receive notifications from websites even if your browser is hidden in the tray or not launched. Enabling this option completely blocks the Push API. + +### Block Location API + +When this option is enabled, the browser will no longer send GPS data to websites. This prevents them from determining your location, altering search results, or tailoring content based on where you are. + +## Windows tracking + +![Windows tracking *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_settings_windows_tracking.png) + +### Disable Windows telemetry + +Disables sending technical data about your system and app usage. + +### Disable Windows Recall + +Disables the Windows Recall feature, which periodically takes snapshots of your screen and stores them locally. This prevents sensitive information visible on your screen from being captured and saved. + +### Turn off Advertising ID + +Disables Advertising ID to block tracking of your app usage. + +### Disable automatic reporting by Microsoft Defender + +Blocks automatic reporting and sampling of suspected malware. + +### Disable WAP Push message routing service + +Disables data collection about Windows component problems. + +## Miscellaneous + +![Miscellaneous *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/custom_settings_miscellaneous.png) + +### Hide Referer from third parties + +Referer is an HTTP header included in browser-to-server requests. It contains the URL of the request source. When you navigate from one page to another, Referer saves the URL of the initial page. The server that hosts the destination web page often has software that parses Referer and extracts various pieces of information from it. + +Enabling the *Hide Referer from third parties* option prevents third-party websites from seeing this information by altering or removing the header. + +You can also enter a custom value in the *Custom Referer* field. To use default Referer, leave the field blank. + +Note that to be able to filter traffic, AdGuard applications intercept browser-to-server requests. Requests to ad, tracking, and phishing servers may be altered before sending them to the server or blocked completely. + +Same goes for the *Hide Referer from third parties* option: To filter traffic, AdGuard intercepts HTTP(S) requests and may alter or block them before they reach the server. The change happens only after the request leaves your browser. For this reason, if you check headers inside the browser (for example with Chrome Developer Tools), you will still see the original Referer. To confirm that it has been modified, you can use external tools such as Fiddler. + +### Hide User-Agent + +When you visit a website, your browser sends a header called User-Agent as part of the HTTP request. It looks like a text line that begins with “User-Agent:”. This line usually contains details such as the browser name and version, operating system, and language settings. + +By enabling this option, AdGuard removes identifying information from the User-Agent so advertisers and trackers cannot use it to profile you. If you prefer, you can enter a custom value in the *Custom User-Agent* field. To keep the default value, simply leave the field blank. + +### Mask IP address + +AdGuard cannot completely hide your real IP address, but it can replace it with a different one so that websites interpret your connection as coming through a proxy. In some cases this helps to obscure your true IP. + +You can enter any IP address you want to use in the corresponding field. To use the default IP address, leave the field blank. + +### Remove X-Client-Data header + +Prevents Google Chrome from sending information about its version and modifications in requests to Google domains, including services like DoubleClick and Google Analytics. + +### Protect against DPI + +![Protect against DPI *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/protect_against_dpi.png) + +Deep Packet Inspection (DPI) is a technology that allows ISPs to analyze and filter traffic based on packet content. With this option enabled, AdGuard modifies outgoing packet data to make it harder for DPI systems to identify and analyze your traffic, helping protect your connection privacy. + +When you click on *Protect against DPI*, a separate screen opens with three groups of settings: + +**ClientHello split** — modifies the TLS ClientHello message to make it harder for DPI systems to detect and block encrypted connections. The following strategies are available: + +- *Split TCP packet at fixed position* — splits the ClientHello TCP packet at a specified byte position. +- *Split TLS record at fixed position* — splits the TLS record containing the ClientHello at a specified byte position. +- *Split TLS before SNI* — splits the ClientHello before the Server Name Indication field. +- *Split TLS after SNI* — splits the ClientHello after the Server Name Indication field. +- *Split TLS in the middle of SNI* — splits the ClientHello in the middle of the Server Name Indication field. +- *Split TLS randomly within SNI* — splits the ClientHello at a random position within the Server Name Indication field. + +When using a fixed-position strategy, set the *Split byte position* (1–1500) to specify where the split occurs. + +**HTTP request split** — splits HTTP requests into multiple TCP packets to bypass DPI systems that rely on inspecting complete HTTP requests. + +**HTTP space juggling** — manipulates whitespace in HTTP requests to confuse DPI systems that parse HTTP headers, making it harder for them to identify and block specific traffic. + +:::caution + +This feature can break access to some unencrypted websites. If this feature is enabled in AdGuard for Windows, it may also interfere with the ESET antivirus — ESET will not be able to filter traffic, leaving some malicious or blocked websites accessible. + +::: diff --git a/docs/adguard-for-windows/settings/about.md b/docs/adguard-for-windows/settings/about.md index bc3cf2077dc..64849b9744b 100644 --- a/docs/adguard-for-windows/settings/about.md +++ b/docs/adguard-for-windows/settings/about.md @@ -3,6 +3,6 @@ title: About sidebar_position: 4 --- -![About](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/about.png) +![About *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/about.png) In addition to information about the current version of the program and used libraries, this screen provides some useful links to License agreement, Privacy policy, acknowledgements, version history, and the main page of our website. diff --git a/docs/adguard-for-windows/settings/app-settings/app-settings.md b/docs/adguard-for-windows/settings/app-settings/app-settings.md index 60612753a77..d8eea48b5db 100644 --- a/docs/adguard-for-windows/settings/app-settings/app-settings.md +++ b/docs/adguard-for-windows/settings/app-settings/app-settings.md @@ -3,13 +3,11 @@ title: App settings sidebar_position: 1 --- -![App settings](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/1_app_settings.png) +![App settings *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/main_settings_1.png) Here you can adjust the main app settings: choose between light and dark themes, set the app language, enable AdGuard to launch at system startup, and allow silent automatic updates. It’s also possible to select the update channel and specify how often AdGuard checks for filter updates. -If you wish, you can agree to send anonymized app usage data to help us improve the product. - -In case of issues, you can change the logging level to create detailed logs for the support team. +You can opt in to send us two types of data: anonymized app usage data to help us improve the product and crash reports if the app unexpectedly closes. In [*Filter editor*](/adguard-for-windows/settings/app-settings/filter-editor.md), you can add your own filtering rules or import ready-to-use filters. @@ -17,4 +15,4 @@ In [*Filter editor*](/adguard-for-windows/settings/app-settings/filter-editor.md [*Advanced*](/adguard-for-windows/settings/app-settings/advanced-settings.md) settings are intended for experienced users. They are rarely needed in everyday use and should only be changed if you know what you’re doing or if our support team asks you to. -![App settings](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/2_app_settings.png) +![App settings *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/main_settings_2.png) diff --git a/docs/adguard-for-windows/settings/app-settings/filter-editor.md b/docs/adguard-for-windows/settings/app-settings/filter-editor.md index 8dbb5a1bbd3..fcabf4215d7 100644 --- a/docs/adguard-for-windows/settings/app-settings/filter-editor.md +++ b/docs/adguard-for-windows/settings/app-settings/filter-editor.md @@ -3,7 +3,7 @@ title: Filter editor sidebar_position: 2 --- -![Filter editor](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/editor.png) +![Filter editor *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/editor.png) The Filter editor is a tool that allows you to view and manage filters at the level of individual rules. Filters are combined into thematic categories: *Ad Blocking*, *Privacy*, *Language-specific* filters, *Custom*, and *Other*. diff --git a/docs/adguard-for-windows/settings/app-settings/network-settings.md b/docs/adguard-for-windows/settings/app-settings/network-settings.md index c2f01d628f5..444cf0ef27b 100644 --- a/docs/adguard-for-windows/settings/app-settings/network-settings.md +++ b/docs/adguard-for-windows/settings/app-settings/network-settings.md @@ -5,7 +5,7 @@ sidebar_position: 3 This section lets you manage how AdGuard filters your Internet traffic and provides additional tools to control network-related features. -![Network settings](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/network_settings.png) +![Network settings *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/network_settings.png) ## Use AdGuard as an HTTP proxy @@ -33,7 +33,7 @@ With this option, you can: Here you can choose which proxy AdGuard should use to download filter updates or new app versions — the system proxy, a custom proxy, or no proxy at all. -![Proxy settings](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/proxy_apps.png) +![Proxy settings *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/proxy_apps.png) ## Use SockFilter driver diff --git a/docs/adguard-for-windows/settings/license.md b/docs/adguard-for-windows/settings/license.md index 821aef7b8a3..01361c14742 100644 --- a/docs/adguard-for-windows/settings/license.md +++ b/docs/adguard-for-windows/settings/license.md @@ -3,7 +3,7 @@ title: License sidebar_position: 2 --- -![License](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/licenses.png) +![License *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/licenses.png) The *License* tab provides details about your current license. Here you can: diff --git a/docs/adguard-for-windows/settings/settings.md b/docs/adguard-for-windows/settings/settings.md index 30a21ac00c1..2b4ebbd4ca7 100644 --- a/docs/adguard-for-windows/settings/settings.md +++ b/docs/adguard-for-windows/settings/settings.md @@ -5,7 +5,7 @@ sidebar_position: 1 There are other useful AdGuard options that shouldn’t go unnoticed in this article, since they add much to user experience. -![Settings](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/setting.png) +![Settings *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/setting.png) ## [App settings](/adguard-for-windows/settings/app-settings) diff --git a/docs/adguard-for-windows/settings/support.md b/docs/adguard-for-windows/settings/support.md index a755413ce40..14150530cd1 100644 --- a/docs/adguard-for-windows/settings/support.md +++ b/docs/adguard-for-windows/settings/support.md @@ -1,12 +1,16 @@ ---- -title: Support -sidebar_position: 3 ---- - -![Support](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/support.png) - -Use this section if you have any questions or suggestions about AdGuard for Windows v8.0. We recommend checking the [FAQ](https://adguard.com/support/faq.html) and this Knowledge base before contacting support. - -If you notice a missed ad, please let us know using *Report incorrect blocking*. - -You can also join our social channels to discuss AdGuard with other users, or reach out to us on GitHub to suggest new features or report bugs. +--- +title: Support +sidebar_position: 3 +--- + +![Support *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/support_main_screen.png) + +Use this section if you have any questions or suggestions about AdGuard for Windows. We recommend checking the [FAQ](https://adguard.com/support/faq.html) and this Knowledge base before contacting support. + +If you notice a missed ad, please let us know using *Report incorrect blocking*. + +You can also join our social channels to discuss AdGuard with other users, or reach out to us on GitHub to suggest new features or report bugs. + +If you reach out to support and our team asks you for logs or technical data from the app, you can export it here. For step-by-step instructions, see [How to collect AdGuard logs](/adguard-for-windows/solving-problems/adguard-logs). + +![Logs *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/support_logs.png) diff --git a/docs/adguard-for-windows/solving-problems/adguard-logs.md b/docs/adguard-for-windows/solving-problems/adguard-logs.md new file mode 100644 index 00000000000..8d0d65f6918 --- /dev/null +++ b/docs/adguard-for-windows/solving-problems/adguard-logs.md @@ -0,0 +1,103 @@ +--- +title: How to collect AdGuard logs +sidebar_position: 3 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock). + +::: + +:::note + +Data and files provided in logs are processed in accordance with the [AdGuard Privacy Policy](https://adguard.com/en/privacy.html). + +::: + +To diagnose problems you may encounter while using AdGuard, our support team may need AdGuard log files. These files record errors and other events that occur in the application. This article explains how to change the logging level, collect the logs, and send them to support. + +AdGuard for Windows offers two logging levels: *Default* and *Debug*. For most troubleshooting, *Debug* is sufficient, but it may slow down the app. + +## How to change the logging level {#change-level} + +You can change the logging level in either of two ways: + +### Option 1: In the app + +Go to AdGuard settings → *Support* → *Logs*, and in the *Logging level* dropdown select *Debug*. + +![Logging level dropdown on Support page *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/support_logs.png) + +### Option 2: From the tray menu + +Right-click the AdGuard icon in the system tray, select *Advanced* → *Logging level*, and choose *Debug*. + +![Logging level in tray menu *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/tray_menu_debug.png) + +## Debug logs {#debug-logs} + +For most issues, debug logs give the support team enough information to identify and fix the problem. + +1. Set the logging level to *Debug* using one of the methods described [above](#change-level). + +1. Reproduce the issue. Note the exact time — it will help our support team find the relevant log entries and solve the problem faster. + +1. Go to AdGuard settings → *Support* → *Logs*, and click *Export logs and system info*. + + Once the export is complete, you’ll see a confirmation message. You can click *Show in folder* to open the folder where the exported archive with logs and system information was saved. + + :::note + + Set the logging level back to *Default* after exporting the logs. The *Debug* level slows down the application. + + ::: + +1. Send the archive to **support@adguard.com**, describe the problem, and mention the time you reproduced the issue. + +## Trace logs {#trace-logs} + +Sometimes the support team may ask you for *trace* logs. Trace logging captures more detail than debug logging and is only available via command line. + +1. Exit AdGuard by right-clicking the AdGuard icon in the tray menu and choosing *Exit AdGuard*. + + ![Exit AdGuard *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/exit_adguard.png) + + If prompted to keep the service running in the background, make sure to stop it — the service must not be running when you start AdGuard with trace logging. + +1. Open the command prompt (type `cmd` in the Start menu search). + +1. Run AdGuard with trace logging enabled: + + ```text + C:\"Program Files"\Adguard\Adguard.exe /trace + ``` + +1. Reproduce the issue. Note the exact time — it will help our support team find the relevant log entries and solve the problem faster. + +1. Export the collected logs: go to Settings → *Support* → *Logs* → *Export logs and system info*. + + Don’t worry if the log file is large — we need as much detail as possible to fix your problem. + +1. After exporting the trace logs, close AdGuard and restart it normally to return to the default logging level. + +## Diagnostic report {#diagnostic-report} + +When contacting support through the form in Settings → *Support*, you can include a diagnostic report that automatically attaches application logs together with other system information. + +The diagnostic report includes: + +- Information about the system +- A list of running processes +- Details about AdGuard settings, including enabled filters and installed extensions +- Application logs + +To use this option, check the *Add diagnostic report* checkbox before sending your message. + +![Diagnostic report option *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/add_report.png) + +:::note + +AdGuard is committed to protecting your privacy. We strictly follow our [Privacy Policy](https://adguard.com/privacy/windows.html) and do not collect any private information about users. Before sending your logs to the support team, please review the file as it may contain additional information that you don’t want to share. If it contains such personal information, we recommend that you delete it first. + +::: diff --git a/docs/adguard-for-windows/solving-problems/dump-file.md b/docs/adguard-for-windows/solving-problems/dump-file.md index cd46d5d9e5d..954cd504324 100644 --- a/docs/adguard-for-windows/solving-problems/dump-file.md +++ b/docs/adguard-for-windows/solving-problems/dump-file.md @@ -38,8 +38,7 @@ AdGuard for Windows runs two processes: `Adguard.exe` and `AdguardSvc.exe`. You ![Two processes *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/dump_file/new/two_processes_en.png) -Since dump files can be large, please compress them into an archive before sending them to support. Also, include the AdGuard logs to help us diagnose the issue more effectively. -[Instructions for collecting logs](/archive/adguard-for-windows/solving-problems/adguard-logs). +Since dump files can be large, please compress them into an archive before sending them to support. Also, include the AdGuard logs to help us diagnose the issue more effectively. See [Instructions for collecting logs](/adguard-for-windows/solving-problems/adguard-logs). ## Collecting `wfpdiag.cab` file @@ -62,3 +61,5 @@ Our support team may request a wfpdiag.cab file, along with a minidump file, to 1. Visit any website to route traffic through AdGuard and log the filtering process 1. To stop logging, enter `netsh wfp capture stop` + +1. Compress the `wfpdiag.cab` file and send it to our support team at **support@adguard.com**. diff --git a/docs/adguard-for-windows/solving-problems/minidump.md b/docs/adguard-for-windows/solving-problems/minidump.md index cafcbdf3425..6c5f22db8df 100644 --- a/docs/adguard-for-windows/solving-problems/minidump.md +++ b/docs/adguard-for-windows/solving-problems/minidump.md @@ -21,7 +21,7 @@ Blue Screen of Death (BSOD) errors may occasionally occur while using AdGuard. W To collect minidump files, you’ll need administrator access on your computer. By default, Windows stores these files in the `C:\Windows\Minidump\` folder. The files you’re looking for will be named either `MEMORY.DMP` or follow the pattern `Mini(ddmmmyy-xxx).dmp` where the letters and numbers represent dates and sequence numbers. -![Minidump file](https://cdn.adtidy.org/content/kb/ad_blocker/windows/solving-problems/minidump.png) +![Minidump file *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/solving-problems/minidump.png) If you can’t find these files, your system may not be configured to create minidumps automatically. diff --git a/docs/adguard-for-windows/solving-problems/network-dump.md b/docs/adguard-for-windows/solving-problems/network-dump.md index e7084efb3e3..45626e71e3a 100644 --- a/docs/adguard-for-windows/solving-problems/network-dump.md +++ b/docs/adguard-for-windows/solving-problems/network-dump.md @@ -31,7 +31,7 @@ Open Wireshark, and you will see a list of network interfaces. Select the one yo If you’re not sure which interface to choose, pick the one with the most activity in the graph — the higher the graph, the more traffic goes through it. -![Main screen](https://cdn.adtidy.org/content/kb/ad_blocker/windows/solving-problems/main_screen.png) +![Main screen *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/solving-problems/main_screen.png) Double-click the selected interface to start the capture. Now, reproduce the issue you are experiencing, making sure to perform only the necessary actions to trigger the problem and avoid any other processes. This helps isolate the issue and ensures relevant traffic is recorded. diff --git a/docs/adguard-for-windows/statistics/statistics.md b/docs/adguard-for-windows/statistics/statistics.md index 096e63631d1..0a8ef306fc2 100644 --- a/docs/adguard-for-windows/statistics/statistics.md +++ b/docs/adguard-for-windows/statistics/statistics.md @@ -5,7 +5,7 @@ sidebar_position: 1 In *Statistics*, you see a complete picture of what is happening with the traffic on your computer: how many requests are being sent and to which companies, how much data is being uploaded and downloaded, what requests are being blocked. You can check statistics for various time frames: all time, the last 14 days, the last 7 days, the last 24 hours, and broken down by ads, trackers, or requests. -![Customize stats](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/statistics/stats.png) +![Customize stats *border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/statistics/stats.png) :::note