diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 2d9c4320c1a..8a69d19a031 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/be/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/be/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/be/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/be/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/be/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 2d9c4320c1a..8a69d19a031 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/bn/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/bn/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/bn/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index a7c205f7cd3..f59734c48fc 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Zde můžete vybrat, jaký proxy server má AdGuard používat ke stahování ak ## Použít ovladač SockFilter -Tuto možnost zapněte, chcete-li používat ovladač SockFilter, který pomáhá blokovat reklamy a slídiče v aplikacích ve Windows 8 a novějších verzích. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -Pokud je tato možnost deaktivována, AdGuard místo toho přepne na starší ovladač WFP. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +Po dokončení testování a implementace má SockFilter potenciál přinést oproti jiným ovladačům několik výhod: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 4c3f123921d..e6d0381f9ea 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Z tohoto důvodu se viditelnost provozu založená na TDI stává stále nestabi AdGuard již považuje ovladač TDI za zastaralý a v rámci vývoje produktu se plánuje jeho úplné odstranění. +## Trvalé řešení + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Dočasné řešení Určité změny v registru systému Windows mohou přimět prohlížeč, aby přestal používat AppContainer, což způsobí, že jeho procesy budou opět spuštěny v režimu bez sandboxu. Síťová služba přestane používat stack WSK a přejde na síťovou cestu, kterou může vidět ovladač TDI. AdGuard poté znovu získá schopnost filtrovat provoz prohlížeče. @@ -123,7 +131,3 @@ Měly by být aktivní následující zásady: Pokud jsou k dispozici, klikněte na _Znovu načíst zásadu_. Hotovo! - -## Trvalé řešení - -Plánujeme přidat podporu pro ovladač SockFilter v nadcházejících verzích. Problém vyřeší odstraněním konfliktů ve stacku WFP. [Další informace](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index fef3fc4951e..3352a7d5260 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,35 +17,47 @@ V tomto modulu můžete vybrat _Použít AdGuard jako HTTP proxy_, chcete-li pou Nakonec je zde část s nastavením proxy. Zde můžete určit, který proxy má AdGuard používat k aktualizaci filtrů, získávání nových verzí atd. -### SockFilter a další síťové ovladače +### Enable traffic filtering -V sekci _Síť_ můžete také povolit filtrování provozu a zvolit, který ovladač chcete použít: SockFilter, WFP nebo TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) je výkonný ovladač, u některých uživatelů však může představovat riziko pro stabilitu, například [občasné selhání systému (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792). +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -K dispozici je také ovladač **TDI**, ten je však zastaralý a v některých verzích prohlížeče Google Chrome může způsobovat [problémy s filtrováním](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [Existuje dočasné provizorní řešení](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), ale nejde o spolehlivé dlouhodobé řešení. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. -**SockFilter** je _experimentální_, odlehčený síťový ovladač v režimu jádra, který pracuje na úrovni soketů (TCP/UDP). Místo toho, aby filtrování soketů kontrolovalo nebo upravovalo pakety při jejich průchodu celým síťovým zásobníkem systému Windows, zachycuje volání soketů (např. connect, send, receive, bind) na vyšší a stabilnější abstrakční úrovni. Díky tomu je ideální pro aplikace, které vyžadují monitorování nebo řízení síťové aktivity bez hloubkové analýzy paketů. +#### SockFilter -V současné době je SockFilter Right stále nestabilní a mohou se vyskytnout chyby. Po dokončení testování a implementace má SockFilter potenciál přinést oproti jiným ovladačům několik výhod: +**SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -- **Pracuje na vyšší úrovni, na úrovni soketů**: SockFilter pracuje se soketovými operacemi namísto surových paketů, díky čemuž je méně složitý a stabilnější než nízkoúrovňové filtrování paketů v rámci WFP. -- **Žádné rušení ostatních síťových ovladačů**: Jelikož je umístěn nad filtry VPN, brány firewall a antivirového softwaru WFP, nedochází k problémům s pořadím filtrů ani ke konfliktům kompatibility, které jsou v zásobníku WFP běžné. -- **Výrazně snížené riziko BSOD souvisejících s NETIO**: SockFilter neběží uvnitř paketu NETIO, čímž se vyhýbá typickým situacím vedoucím k selhání, které jsou způsobeny nesprávným zpracováním vyrovnávacích pamětí, výsledků klasifikace nebo paměti paketů při voláních WFP. +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -Co se týče nevýhod, ovladač SockFilter vidí pouze operace na úrovni soketů a nezachytává provoz generovaný jinými ovladači jádra nebo komponentami, které obcházejí standardní rozhraní Winsock API. Z pohledu síťových mechanismů na nízké úrovni lze toto považovat za omezení, protože ovladač nemá přístup k surovým paketům ani nemůže kontrolovat provoz mimo sokety. Pro aplikaci blokující reklamy je však toto chování nejen přijatelné, ale přímo optimální. Veškerý relevantní provoz z prohlížečů a aplikací v uživatelském režimu prochází standardními sokety, a právě to potřebujeme mít pod kontrolou. Zároveň ignorování provozu na nízké úrovni ovladačů odstraňuje zbytečnou složitost, předchází problémům s kompatibilitou a zajišťuje stabilitu systému. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. + +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN -Poslední část je věnována AdGuard VPN — ideálnímu nástroji, který poskytuje bezpečnost a anonymitu při každém procházení internetu. Můžete si ji stáhnout kliknutím na tlačítko _Stáhnout_ nebo přejít na webové stránky AdGuard VPN kliknutím na tlačítko _Domovská stránka_. +The last section is dedicated to AdGuard VPN — an ideal tool that provides security and anonymity each time you browse the Internet. You can download it by clicking the _Download_ button or go to the AdGuard VPN website by clicking the _Homepage_ button. -Jak funguje AdGuard VPN? Aniž bychom zacházeli do technických podrobností, můžeme říci, že VPN vytváří bezpečný šifrovaný tunel mezi počítačem nebo mobilním zařízením uživatele a vzdáleným serverem VPN. Tímto způsobem je zachována důvěrnost dat i anonymita uživatele, protože pozorovatel třetí strany vidí IP adresu serveru VPN, a nikoli skutečnou IP adresu uživatele. +How does AdGuard VPN work? Without going into technical details, we can say that VPN creates a secure encrypted tunnel between the user's computer or mobile device and a remote VPN server. In this way, data privacy is preserved, as well as the anonymity of the user, because a third-party observer sees the IP address of the VPN server and not the actual user's IP. -**Co dělá AdGuard VPN:** +**What AdGuard VPN does:** -- skrývá vaše skutečné místo pobytu a pomáhá vám zůstat v anonymitě -- změní vaši IP adresu a ochrání vaše data před sledováním -- šifruje váš provoz, aby byl nečitelný pro třetí strany -- umožňuje nastavit, kde se má VPN používat a kde ne (funkce výjimek) +- hides your real whereabouts and helps you stay anonymous +- changes your IP address to protect your data from tracking +- encrypts your traffic to make it unreadable to third parties +- lets you configure where to use VPN and where not to (exclusions feature) -Chcete-li získat více informací o AdGuard VPN, ponořte se do [Databáze znalostí AdGuard VPN](https://adguard-vpn.com/kb/). +To get more information about AdGuard VPN, dive into the [AdGuard VPN Knowledge Base](https://adguard-vpn.com/kb/). diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index 90b6442c62e..9d18a4575a2 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Než začnete ručně psát vlastní pravidla, přečtěte si našeho podrobnéh Mnoho webových stránek shromažďuje informace o svých návštěvnících, například jejich IP adresy, informace o nainstalovaném prohlížeči a operačním systému, rozlišení obrazovky, a dokonce i o tom, na jakou stránku uživatel přišel nebo z jaké stránky byl přesměrován. Některé webové stránky používají soubory cookies k označení prohlížeče a uložení vašich osobních nastavení, uživatelských preferencí nebo k vašemu “rozpoznání“ při příští návštěvě. To jim umožní vás při příští návštěvě “rozpoznat“. Ochrana před sledováním chrání vaše osobní údaje před takovými systémy shromažďujícími data a statistiky. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - Nastavení _ochrany před sledováním_ můžete upravit podle potřeby. Můžete například zabránit webovým stránkám v přijímání vyhledávacích dotazů, které jste použili k jejich vyhledání na internetu, automaticky mazat soubory cookies třetích stran a vlastní a deaktivovat sdílení polohy ve svém prohlížeči, abyste zabránili sledování vaší polohy. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - Chcete-li se dozvědět vše o _Ochraně před sledováním_ a mnoha možnostech, přečtěte si [tento článek](/general/stealth-mode). ### Bezpečné prohlížení diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index b6be40664be..913e65dc1fe 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` bude převeden na -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` Tato možnost se použije pouze v případě, že je povolena možnost *Ochrana před DPI* v Režimu utajení. diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index a198fd5e7a5..43cc8bf072b 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Z tohoto důvodu se viditelnost provozu založená na TDI stává stále nestabi AdGuard již považuje ovladač TDI za zastaralý a v rámci vývoje produktu se plánuje jeho úplné odstranění. +## Trvalé řešení + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Dočasné řešení Určité změny v registru systému Windows mohou přimět prohlížeč, aby přestal používat AppContainer, což způsobí, že jeho procesy budou opět spuštěny v režimu bez sandboxu. Síťová služba přestane používat stack WSK a přejde na síťovou cestu, kterou může vidět ovladač TDI. AdGuard poté znovu získá schopnost filtrovat provoz prohlížeče. @@ -136,7 +144,3 @@ Měly by být aktivní následující zásady: Pokud jsou k dispozici, klikněte na _Znovu načíst zásadu_. Hotovo! - -## Trvalé řešení - -Plánujeme přidat podporu pro ovladač SockFilter v nadcházejících verzích. Problém vyřeší odstraněním konfliktů ve stacku WFP. [Další informace](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/cs/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/cs/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/cs/docusaurus-plugin-content-docs/current/general/how-to-install.md index b1f8617e0bd..d2d3c51ec06 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: Jak nainstalovat AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Podle toho, kterou aplikaci AdGuard nebo rozšíření prohlížeče chcete nainstalovat, vyhledejte příslušný článek pomocí jednoho z těchto odkazů: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 2d9c4320c1a..8a69d19a031 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/da/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/da/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/da/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/da/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md index 819e673435f..9c42731d3c9 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md @@ -11,7 +11,7 @@ In diesem Artikel geht es um die AdGuard Browsereweiterung, die nur Ihren Browse - [Funktionen](/adguard-browser-extension/features) - Main features and settings available in AdGuard Browser Extension + Die wichtigsten Funktionen und Einstellungen der AdGuard Browsererweiterung - [Verfügbarkeit](/adguard-browser-extension/availability) @@ -23,7 +23,7 @@ In diesem Artikel geht es um die AdGuard Browsereweiterung, die nur Ihren Browse - [Kompatibilität mit der eigenständigen App](adguard-browser-extension/compatibility) - Compatibility of AdGuard Browser Extension with the AdGuard desktop apps + Kompatibilität der AdGuard Browsererweiterung mit den AdGuard-Desktop-Apps - [AdGuard Browsererweiterung für Chrome MV3](/adguard-browser-extension/mv3-version/) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md index c772527f1ae..40e7f776b2b 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md @@ -9,18 +9,18 @@ In diesem Artikel geht es um die AdGuard Browsereweiterung, die nur Ihren Browse ::: -- [Main menu](/adguard-browser-extension/features/main-menu.md) +- [Hauptmenü](/adguard-browser-extension/features/main-menu.md) - The main popup from which you can access settings, filtering log and statistics, and report problems + Das Pop-up, von dem aus Sie auf Einstellungen, das Filterungsprotokoll und Statistiken zugreifen und Probleme melden können -- [Filters](/adguard-browser-extension/features/filters.md) +- [Filter](/adguard-browser-extension/features/filters.md) Filter und Benutzerregeln zur Feinabstimmung der Werbeblockierung -- [Tracking protection (Stealth Mode)](/adguard-browser-extension/features/stealth-mode.md) +- [Tracking-Schutz (Privatsphäre)](/adguard-browser-extension/features/stealth-mode.md) - Settings to block cookies, UTM tags, and online analytics that collect user information + Einstellungen zum Blockieren von Cookies, UTM-Tags und Analyse-Tools, die Nutzerdaten sammeln -- [Other features and options](/adguard-browser-extension/features/other-features.md) +- [Weitere Funktionen und Optionen](/adguard-browser-extension/features/other-features.md) - General and additional settings, links to privacy documents and GitHub repository + Allgemeine und zusätzliche Einstellungen, Links zu Datenschutzdokumenten und zum GitHub-Repository diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md index d1e6bdd8101..15cabb3b1e3 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md @@ -1,13 +1,13 @@ --- -title: Ad blocking issues on search websites in Opera +title: Probleme mit der Werbeblockierung auf Suchmaschinen in Opera sidebar_position: 3 --- If AdGuard Browser Extension fails to block ads on search websites in Opera, either automatically or manually, it means that the extension does not have permission to access search page results. -To grant the required permission: +Um die erforderliche Berechtigung zu erteilen: -![Allow access to search page results](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/allow-access.png) +![Zugriff auf Suchergebnisseiten zulassen](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/allow-access.png) 1. Click the cube icon next to the address bar → _Manage extensions..._. 2. Find AdGuard AdBlocker in the list of installed extensions and tick the box next to _Allow access to search page results_. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md index fa905bcd89b..c4ab1716ebb 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md @@ -3,7 +3,7 @@ title: Probleme lösen sidebar_position: 1 --- -Here are some guides you may need to solve problems with AdGuard Browser Extension. +Hier finden Sie einige Anleitungen, die Sie benötigen, um Probleme mit der AdGuard Browsererweiterung zu lösen. - [So exportieren Sie Protokolle von der Hintergrundseite](/adguard-browser-extension/solving-problems/logs.md) - [So erfolgt die Fehlersuche bei Regeln in AdGuard für Chrome MV3](/adguard-browser-extension/solving-problems/debug-rules.md) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-android/features/protection/tracking-protection.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-android/features/protection/tracking-protection.md index 1fa55da43bc..ecacdc86bf3 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-android/features/protection/tracking-protection.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-android/features/protection/tracking-protection.md @@ -77,4 +77,4 @@ Hier sind die aktiven Funktionen der vorkonfigurierten Ebenen: k. _X-Client-Data-Header entfernen_. Diese Funktion verhindert, dass Google Chrome seine Versions- und Änderungsinformationen an Google-Domains (einschließlich DoubleClick und Google Analytics) sendet -You can tweak individual settings in _Tracking protection_ to create a custom configuration. Each setting has a description to help you understand its purpose. [Read more about various _Tracking protection_ settings](/general/stealth-mode) and use them cautiously, as some may interfere with the functionality of websites and browser extensions. +You can tweak individual settings in _Tracking protection_ to create a custom configuration. Each setting has a description to help you understand its purpose. [Lesen Sie mehr darüber, was die verschiedenen _Tracking-Schutz_-Einstellungen bewirken](/general/stealth-mode) und verwenden Sie sie mit Bedacht, da einige die Funktionalität von Websites und Browsererweiterungen beeinträchtigen können. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-android/features/settings.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-android/features/settings.md index b8a2c5a9e2f..23282c7641e 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-android/features/settings.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-android/features/settings.md @@ -31,7 +31,7 @@ Die _Protokollierungsebene_ legt fest, welche Daten über die Funktion der App p ![Erweitert \*mobile_border](https://cdn.adtidy.org/blog/new/vshfnadvanced.png) -Der Abschnitt _Low-Level-Einstellungen_ ist für erfahrene Benutzer:innen gedacht. [Read more about low-level settings](/adguard-for-android/features/low-level-settings/) +Der Abschnitt _Low-Level-Einstellungen_ ist für erfahrene Benutzer:innen gedacht. [Weitere Informationen über Low-Level-Einstellungen](/adguard-for-android/solving-problems/low-level-settings/) ![Low-Level-Einstellungen \*mobile_border](https://cdn.adtidy.org/blog/new/n9ztplow_level.png) @@ -83,7 +83,7 @@ Disable AMP is a userscript that disables [Accelerated mobile pages](https://en. #### HTTPS-Filterung -To block ads and trackers on most websites and in most apps, AdGuard needs to filter their HTTPS traffic. [Read more about HTTPS filtering](/general/https-filtering/what-is-https-filtering) +To block ads and trackers on most websites and in most apps, AdGuard needs to filter their HTTPS traffic. [Lesen Sie mehr über HTTPS-Filterung](/general/https-filtering/what-is-https-filtering) ##### Security certificates @@ -112,7 +112,7 @@ By default, we also do not filter websites with Extended Validation (EV) certifi #### Proxy -You can set up AdGuard to route all your device's traffic through your proxy server. [How to set up an outbound proxy](/adguard-for-android/solving-problems/outbound-proxy) +You can set up AdGuard to route all your device's traffic through your proxy server. [So richten Sie einen Outbound-Proxy ein](/adguard-for-android/solving-problems/outbound-proxy) In this section, you can also set up a third-party VPN to work with AdGuard, if your VPN provider allows it. @@ -126,7 +126,7 @@ This section allows you to select the traffic filtering method. :::note -The _Local VPN_ mode doesn't allow AdGuard to be used simultaneously with other VPNs. To use another VPN with AdGuard, you need to reconfigure it to work in proxy mode and set up an outbound proxy in AdGuard. For AdGuard VPN, this is done automatically with the help of the [_Integrated mode_](/adguard-for-android/features/integration-with-vpn). +The _Local VPN_ mode doesn't allow AdGuard to be used simultaneously with other VPNs. To use another VPN with AdGuard, you need to reconfigure it to work in proxy mode and set up an outbound proxy in AdGuard. Bei AdGuard VPN geschieht dies automatisch mit Hilfe des [_Integrierten Modus_](/adguard-for-android/features/integration-with-vpn). ::: @@ -161,12 +161,12 @@ Use this section if you have any questions or suggestions regarding AdGuard for If you notice a missed ad, please report it via _Report incorrect blocking_. -For unexpected app behavior, select _Report a bug_. If possible, describe your problem in detail and add app logs. [How to describe an issue](/guides/report-bugs/#how-to-describe-a-problem) +For unexpected app behavior, select _Report a bug_. If possible, describe your problem in detail and add app logs. [So beschreiben Sie ein Problem](/guides/report-bugs/#how-to-describe-a-problem) For your suggestions, use _Request a feature_. :::note -GitHub is an alternative way to report bugs and suggest new features. [Instructions and repository links](/guides/report-bugs/#adguard-for-android) +GitHub is an alternative way to report bugs and suggest new features. [Anleitungen und Repository-Links](/guides/report-bugs/#adguard-for-android) ::: diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md index 5b4c576aa2b..88e00a6a378 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md @@ -35,7 +35,7 @@ Dieser Artikel behandelt AdGuard für iOS, einem multifunktionalen Werbeblocker, - [Weitere Funktionen](/adguard-for-ios/features/other-features.md) - General settings: theme, settings and statistics reset, auto-update, inverting the allowlist, and advanced mode. + Allgemeine Einstellungen: Design, Zurücksetzen von Einstellungen und Statistiken, Auto-Updates, Invertieren der Zulassungsliste und erweiterter Modus. - [Kompatibilität mit AdGuard VPN](/adguard-for-ios/features/compatibility-with-adguard-vpn.md) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md index c3ff375e470..1e235e4eeeb 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md @@ -27,7 +27,7 @@ Dieser Artikel behandelt AdGuard für Mac, einem multifunktionalen Werbeblocker, - [Privatsphäre](/adguard-for-mac/features/stealth.md) - Settings to block cookies, UTM tags, and online analytics that collect user information + Einstellungen zum Blockieren von Cookies, UTM-Tags und Analyse-Tools, die Nutzerdaten sammeln - [Sicherheit](/adguard-for-mac/features/security.md) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-mac/features/stealth.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-mac/features/stealth.md index e61ca2b0992..961e880adc4 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-mac/features/stealth.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-mac/features/stealth.md @@ -13,4 +13,4 @@ Dieser Artikel behandelt AdGuard für Mac, einem multifunktionalen Werbeblocker, ![Stealth Mode](https://cdn.adtidy.org/content/kb/ad_blocker/mac/tracking_protection.png) -_Tracking protection_ (formerly Stealth Mode) safeguards your privacy by deleting cookies, UTM tags, online counters, and analytics systems. Es verhindert, dass Websites Ihre IP-Adresse, Geräte- und Browserparameter, Suchanfragen und persönliche Informationen sammeln. [Learn more about Tracking protection settings](/general/stealth-mode) +_Tracking protection_ (formerly Stealth Mode) safeguards your privacy by deleting cookies, UTM tags, online counters, and analytics systems. Es verhindert, dass Websites Ihre IP-Adresse, Geräte- und Browserparameter, Suchanfragen und persönliche Informationen sammeln. [Mehr über die Einstellungen zum Tracking-Schutz](/general/stealth-mode) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index d3215d76b9c..55d08930787 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Hier können Sie festlegen, welchen Proxy AdGuard zum Herunterladen von Filter-U ## SockFilter-Treiber verwenden -Aktivieren Sie diese Option, um den SockFilter-Treiber zu verwenden, der dabei hilft, Werbung und Tracker in Apps unter Windows 8 und höher zu blockieren. +Aktivieren Sie diese Option, um den SockFilter-Treiber zu verwenden, der dabei hilft, Werbung und Tracker in Apps unter Windows 8 und höher zu blockieren. Wenn diese Option deaktiviert ist, wechselt AdGuard stattdessen zum älteren WFP-Treiber. -Wenn diese Option deaktiviert ist, wechselt AdGuard stattdessen zum älteren WFP-Treiber. +SockFilter wurde erstmals in Version 8.0 RC eingeführt. Der SockFilter ist ein _experimenteller_, schlanker Kernel-Modus-Netzwerktreiber, der auf Socket-Ebene (TCP/UDP) arbeitet. Anstatt Pakete zu überprüfen oder zu modifizieren, während sie den gesamten Windows-Netzwerkstack durchlaufen, fängt ein Sock-Filter Socket-Aufrufe (z. B. connect, send, receive, bind) auf einer höheren, stabileren Abstraktionsebene ab. Dies eignet sich ideal für Apps, die Netzwerkaktivitäten ohne Deep Packet Processing überwachen oder steuern müssen. + +Nach vollständiger Erprobung und Implementierung bietet SockFilter gegenüber anderen Treibern mehrere entscheidende Vorteile: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **Keine Beeinträchtigung anderer Netzwerktreiber**: Da es über den VPN-, Firewall- und Antivirus-WFP-Filtern angesiedelt ist, vermeidet es Probleme mit der Filterreihenfolge und Kompatibilitätskonflikte, die im WFP-Stack häufig auftreten. +- **Deutlich geringeres Risiko von NETIO-bedingten BSODs**: SockFilter läuft nicht innerhalb der NETIO-Paketpipeline, wodurch die typischen Absturzszenarien vermieden werden, die durch WFP-Callouts verursacht werden, bei denen Puffer, Klassifizierungsergebnisse oder der Paketspeicher falsch verarbeitet werden. + +Was die Nachteile betrifft, so sieht der SockFilter-Treiber nur Vorgänge auf Socket-Ebene und erfasst keinen Datenverkehr, der von anderen Kernel-Treibern oder Komponenten erzeugt wird, welche die Standard-Winsock-API umgehen. Aus Sicht der Low-Level-Vernetzung kann dies als Einschränkung angesehen werden, da der Treiber nicht auf Rohpakete zugreifen oder Nicht-Socket-Datenverkehr überprüfen kann. Für eine Werbeblocker-App ist dieses Verhalten jedoch nicht nur akzeptabel, sondern optimal. Der gesamte relevante Datenverkehr von Browsern und Apps im Benutzermodus wird über Standard-Sockets geleitet, und genau das muss durch AdGuard geregelt werden. Gleichzeitig wird durch das Ignorieren von Low-Level-Treiberdatenverkehr unnötige Komplexität vermieden, Kompatibilitätsprobleme werden umgangen und die Stabilität des Systems bleibt gewahrt. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 3f1a0399dae..cb9c86e534e 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Deshalb wird die TDI-basierte Verkehrssichtbarkeit zunehmend instabil. In einige AdGuard behandelt den TDI-Treiber bereits als veraltet, und seine vollständige Entfernung ist im Zuge der Weiterentwicklung des Produkts geplant. +## Dauerhafte Lösung + +Ab Version 8.0 RC wurde eine experimentelle Unterstützung für den SockFilter-Treiber hinzugefügt. It fixes the issue by solving conflicts in the WFP stack. [Weitere Informationen](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Da es sich um eine experimentelle Funktion handelt, kann es zu Fehlern kommen. Sollten Sie etwas Ungewöhnliches, Unerwartetes oder einfach nur eine Fehlfunktion bemerken, **können Sie jederzeit im selben Abschnitt wieder zu TDI oder WFP zurückwechseln**. + ## Vorübergehende Lösung Bestimmte Änderungen in der Windows-Registry können den Browser dazu zwingen, die Verwendung von AppContainer zu stoppen, wodurch dessen Prozesse wieder im nicht sandboxed Modus ausgeführt werden. Der Netzwerkdienst verwendet nicht mehr den WSK-Stack, sondern greift auf einen Netzwerkpfad zurück, den der TDI-Treiber sehen kann. AdGuard ist dann wieder in der Lage, den Browserverkehr zu filtern. @@ -123,7 +131,3 @@ Folgende Richtlinien sollten aktiv sein: Falls verfügbar, klicken Sie auf _Richtlinien neu laden_. Fertig! - -## Dauerhafte Lösung - -Wir planen, in den kommenden Versionen Unterstützung für den SockFilter-Treiber hinzuzufügen. Dadurch werden Konflikte im WFP-Stack behoben und das Problem gelöst. [Weitere Informationen](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 8ccccb19d65..5ea7fe9ad60 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,35 +17,47 @@ In diesem Modul können Sie das Kontrollkästchen _AdGuard als HTTP-Proxy verwen Schließlich gibt es noch einen Abschnitt mit Proxy-Einstellungen. Dort können Sie angeben, welchen Proxyserver AdGuard verwenden soll, um Filter zu aktualisieren, neue Versionen zu erhalten usw. -### SockFilter und andere Netzwerktreiber +### Enable traffic filtering -In _Netzwerk_ können Sie auch die Datenverkehrsfilterung aktivieren und auswählen, welcher Treiber verwendet werden soll: SockFilter, WFP oder TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) ist ein leistungsstarker Treiber, kann jedoch für einige Benutzer Stabilitätsrisiken mit sich bringen, wie beispielsweise [gelegentliche Systemabstürze (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792). +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -Der **TDI**-Treiber ist ebenfalls verfügbar, jedoch veraltet und kann [in einigen Versionen von Google Chrome zu Filterproblemen führen](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. -Der **SockFilter** ist ein _experimenteller_, schlanker Kernel-Modus-Netzwerktreiber, der auf Socket-Ebene (TCP/UDP) arbeitet. Anstatt Pakete zu überprüfen oder zu modifizieren, während sie den gesamten Windows-Netzwerkstack durchlaufen, fängt ein Sock-Filter Socket-Aufrufe (z. B. connect, send, receive, bind) auf einer höheren, stabileren Abstraktionsebene ab. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. +#### SockFilter -Derzeit ist SockFilter Right noch instabil, und es können Probleme auftreten. Nach vollständiger Erprobung und Implementierung bietet SockFilter gegenüber anderen Treibern mehrere entscheidende Vorteile: +**SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Anstatt Pakete zu überprüfen oder zu modifizieren, während sie den gesamten Windows-Netzwerkstack durchlaufen, fängt ein Sock-Filter Socket-Aufrufe (z. B. connect, send, receive, bind) auf einer höheren, stabileren Abstraktionsebene ab. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -- **Es wird auf einer höheren Ebene ausgeführt**: SockFilter arbeitet mit Socket-Operationen statt mit Rohpaketen, wodurch es weniger komplex und stabiler ist als die Low-Level-Paketfilterung von WFP. +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **Keine Beeinträchtigung anderer Netzwerktreiber**: Da es über den VPN-, Firewall- und Antivirus-WFP-Filtern angesiedelt ist, vermeidet es Probleme mit der Filterreihenfolge und Kompatibilitätskonflikte, die im WFP-Stack häufig auftreten. -- **Deutlich reduziertes Risiko von NETIO-bedingten BSODs**: SockFilter wird nicht innerhalb der NETIO-Paketpipeline ausgeführt, sodass die typischen Absturzszenarien vermieden werden, die durch WFP-Callouts verursacht werden, die Puffer, Klassifizierungsergebnisse oder Paketspeicher fehlerhaft verarbeiten. +- **Deutlich geringeres Risiko von NETIO-bedingten BSODs**: SockFilter läuft nicht innerhalb der NETIO-Paketpipeline, wodurch die typischen Absturzszenarien vermieden werden, die durch WFP-Callouts verursacht werden, bei denen Puffer, Klassifizierungsergebnisse oder der Paketspeicher falsch verarbeitet werden. + +Was die Nachteile betrifft, so sieht der SockFilter-Treiber nur Vorgänge auf Socket-Ebene und erfasst keinen Datenverkehr, der von anderen Kernel-Treibern oder Komponenten erzeugt wird, welche die Standard-Winsock-API umgehen. Aus Sicht der Low-Level-Vernetzung kann dies als Einschränkung angesehen werden, da der Treiber nicht auf Rohpakete zugreifen oder Nicht-Socket-Datenverkehr überprüfen kann. However, for an ad-blocking application, this behavior is not just acceptable but optimal. Der gesamte relevante Datenverkehr von Browsern und Apps im Benutzermodus wird über Standard-Sockets geleitet, und genau das muss durch AdGuard geregelt werden. Gleichzeitig wird durch das Ignorieren von Low-Level-Treiberdatenverkehr unnötige Komplexität vermieden, Kompatibilitätsprobleme werden umgangen und die Stabilität des Systems bleibt gewahrt. + +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI -Was die Nachteile betrifft, so sieht der SockFilter-Treiber nur Vorgänge auf Socket-Ebene und erfasst keinen Datenverkehr, der von anderen Kernel-Treibern oder Komponenten erzeugt wird, welche die Standard-Winsock-API umgehen. Aus Sicht der Low-Level-Vernetzung kann dies als Einschränkung angesehen werden, da der Treiber nicht auf Rohpakete zugreifen oder Nicht-Socket-Datenverkehr überprüfen kann. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN The last section is dedicated to AdGuard VPN — an ideal tool that provides security and anonymity each time you browse the Internet. You can download it by clicking the _Download_ button or go to the AdGuard VPN website by clicking the _Homepage_ button. -Wie funktioniert AdGuard VPN? Ohne auf technische Details einzugehen, kann gesagt werden, dass VPN einen sicheren verschlüsselten Tunnel zwischen einem Gerät und einem entfernten VPN-Server herstellt. Auf diese Weise bleibt der Datenschutz gewahrt und damit auch die Anonymität, denn ein fremder Beobachter sieht die IP-Adresse des VPN-Servers und nicht die tatsächliche IP-Adresse. +How does AdGuard VPN work? Without going into technical details, we can say that VPN creates a secure encrypted tunnel between the user's computer or mobile device and a remote VPN server. In this way, data privacy is preserved, as well as the anonymity of the user, because a third-party observer sees the IP address of the VPN server and not the actual user's IP. -**Was AdGuard VPN leistet:** +**What AdGuard VPN does:** -- verbirgt Ihren tatsächlichen Aufenthaltsort und hilft Ihnen, anonym zu bleiben -- ändert Ihre IP-Adresse, um Ihre Daten vor Verfolgung zu schützen -- verschlüsselt Ihren Datenverkehr, um ihn für Dritte unlesbar zu machen -- lässt Sie konfigurieren, wo VPN verwendet werden soll und wo nicht (Ausschlussfunktion) +- hides your real whereabouts and helps you stay anonymous +- changes your IP address to protect your data from tracking +- encrypts your traffic to make it unreadable to third parties +- lets you configure where to use VPN and where not to (exclusions feature) -Weitere Informationen über AdGuard VPN finden Sie in der [AdGuard VPN Wissensdatenbank](https://adguard-vpn.com/kb/). +To get more information about AdGuard VPN, dive into the [AdGuard VPN Knowledge Base](https://adguard-vpn.com/kb/). diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index 750e144c51e..eef866033ea 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Bevor Sie mit dem manuellen Schreiben eigener Regeln beginnen, lesen Sie unsere Viele Websites sammeln Informationen über Personen, die sie besuchen, z. B. ihre IP-Adressen, Informationen über den Browser und das installierte Betriebssystem, die Bildschirmauflösung und sogar darüber, von welcher Seite die Benutzer:innen kamen oder weitergeleitet wurden. Einige Webseiten verwenden Cookies, um den Browser zu kennzeichnen und Ihre persönlichen Einstellungen und Vorlieben zu speichern oder Sie bei Ihrem nächsten Besuch wiederzuerkennen. Dadurch können sie Sie bei Ihrem nächsten Besuch „wiedererkennen“. Tracking-Schutz bewahrt Ihre persönlichen Informationen vor solchen Daten- und Statistiksammelsystemen. -![Tracking-Schutzstufen \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - Sie können die Einstellungen für den _Tracking-Schutz_ nach Bedarf anpassen. Beispielsweise können Sie verhindern, dass Websites die Suchanfrage erfahren, mit der Sie sie im Internet gefunden haben, automatisch Cookies von Drittanbietern und Erstanbietern löschen und die Standortfreigabe in Ihrem Browser deaktivieren, um die Verfolgung Ihres Aufenthaltsorts zu unterbinden. -![Benutzerdefinierte Funktionen für den Tracking-Schutz \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - Um alles über den _Tracking-Schutz_ und seine Optionen zu erfahren, [lesen Sie diesen Artikel](/general/stealth-mode). ### Internetsicherheit diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 1772bf3a189..2471f9b66a3 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` umgewandelt in -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` Diese Option wird nur angewendet, wenn die Option *Schutz vor DPI* im Privatsphärenmodus aktiviert ist. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 778ad6e8794..25846b360b8 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Deshalb wird die TDI-basierte Verkehrssichtbarkeit zunehmend instabil. In einige AdGuard behandelt den TDI-Treiber bereits als veraltet, und seine vollständige Entfernung ist im Zuge der Weiterentwicklung des Produkts geplant. +## Dauerhafte Lösung + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [Weitere Informationen](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Da es sich um eine experimentelle Funktion handelt, kann es zu Fehlern kommen. Sollten Sie etwas Ungewöhnliches, Unerwartetes oder einfach nur eine Fehlfunktion bemerken, **können Sie jederzeit im selben Abschnitt wieder zu TDI oder WFP zurückwechseln**. + ## Vorübergehende Lösung Bestimmte Änderungen in der Windows-Registry können den Browser dazu zwingen, die Verwendung von AppContainer zu stoppen, wodurch dessen Prozesse wieder im nicht sandboxed Modus ausgeführt werden. Der Netzwerkdienst verwendet nicht mehr den WSK-Stack, sondern greift auf einen Netzwerkpfad zurück, den der TDI-Treiber sehen kann. AdGuard ist dann wieder in der Lage, den Browserverkehr zu filtern. @@ -136,7 +144,3 @@ Folgende Richtlinien sollten aktiv sein: Falls verfügbar, klicken Sie auf _Richtlinien neu laden_. Fertig! - -## Dauerhafte Lösung - -Wir planen, in den kommenden Versionen Unterstützung für den SockFilter-Treiber hinzuzufügen. Dadurch werden Konflikte im WFP-Stack behoben und das Problem gelöst. [Weitere Informationen](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/filter-policy.md b/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/filter-policy.md index b30fc7bf41b..52cf27e05f0 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/filter-policy.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/filter-policy.md @@ -205,7 +205,7 @@ This is a filter that blocks various widgets that are not essential for the func - Widgets for content recommendations — related articles, similar websites, various personalized recommendations - Chat widgets that are not integrated with the content and are not the main content of the page -- Marketing widgets: +- Marketing-Widgets: - Chats for communication with assistants or bots - Widgets with product recommendations that are shown to the user - Call-back forms @@ -213,7 +213,7 @@ This is a filter that blocks various widgets that are not essential for the func **Beschränkungen und Ausnahmen** -This filter doesn’t block: +Was wird nicht blockiert? - Widgets closely related to the content of the page, such as comments sections, live chat streams, with an exception of unmoderated chats on sites with unofficial streams, which are often filled with spam and similar content - Widgets for self-promotion and site-specific promotional activities diff --git a/i18n/de/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/de/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/de/docusaurus-plugin-content-docs/current/general/how-to-install.md index b79b038324a..7049fb48ac4 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: So installieren Sie AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Je nachdem, welche AdGuard-App oder Browsererweiterung Sie installieren möchten, folgen Sie einem dieser Links, um den entsprechenden Artikel zu finden: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md index d65148a8a22..352f1c63861 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md @@ -11,7 +11,7 @@ Este artículo trata sobre la extensión de navegador AdGuard, que protege solo - [Funciones](/adguard-browser-extension/features) - Main features and settings available in AdGuard Browser Extension + Principales funciones y configuraciones disponibles en la extensión de navegador AdGuard - [Disponibilidad](/adguard-browser-extension/availability) @@ -23,7 +23,7 @@ Este artículo trata sobre la extensión de navegador AdGuard, que protege solo - [Compatibilidad con la app independiente](/adguard-browser-extension/compatibility) - Compatibility of AdGuard Browser Extension with the AdGuard desktop apps + Compatibilidad de la extensión de navegador AdGuard con las aplicaciones de escritorio de AdGuard - [Extensión de navegador de AdGuard para Chrome MV3](/adguard-browser-extension/mv3-version/) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/comparison-standalone.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/comparison-standalone.md index 8ae599cbd6e..1978b43207f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/comparison-standalone.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/comparison-standalone.md @@ -5,7 +5,7 @@ sidebar_position: 7 :::info -Este artículo trata sobre la extensión de navegador AdGuard, que protege solo tu navegador. Para proteger todo su dispositivo, [descarca la aplicación AdGuard](https://agrd.io/download-kb-adblock) +Este artículo trata sobre la extensión del navegador de AdGuard, que protege solo tu navegador. Para proteger todo su dispositivo, [descarca la aplicación AdGuard](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md index 89f7e80f47e..b1b4126a9cb 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md @@ -9,18 +9,18 @@ Este artículo trata sobre la extensión de navegador AdGuard, que protege solo ::: -- [Main menu](/adguard-browser-extension/features/main-menu.md) +- [Menú principal](/adguard-browser-extension/features/main-menu.md) - The main popup from which you can access settings, filtering log and statistics, and report problems + La ventana emergente principal desde la que se puede acceder a la configuración, el registro de filtrado, las estadísticas e informes de problemas -- [Filters](/adguard-browser-extension/features/filters.md) +- [Filtros](/adguard-browser-extension/features/filters.md) Filtros y reglas de usuario para mejorar el bloqueo de anuncios -- [Tracking protection (Stealth Mode)](/adguard-browser-extension/features/stealth-mode.md) +- [Protección de rastreo (Modo sigiloso)](/adguard-browser-extension/features/stealth-mode.md) - Settings to block cookies, UTM tags, and online analytics that collect user information + Configuración para bloquear cookies, etiquetas UTM y análisis en línea que recopilan información del usuario -- [Other features and options](/adguard-browser-extension/features/other-features.md) +- [Otras funciones y opciones](/adguard-browser-extension/features/other-features.md) - General and additional settings, links to privacy documents and GitHub repository + Configuración de Modo general y adicional, enlaces a documentos de privacidad y al repositorio de GitHub diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/main-menu.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/main-menu.md index 1d381fba366..f5d1d29f1df 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/main-menu.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/main-menu.md @@ -5,7 +5,7 @@ sidebar_position: 1 :::info -Este artículo trata sobre la extensión de navegador AdGuard, que protege solo tu navegador. Para proteger todo su dispositivo, [descarca la aplicación AdGuard](https://agrd.io/download-kb-adblock) +Este artículo trata sobre la extensión del navegador de AdGuard, que protege solo tu navegador. Para proteger todo su dispositivo, [descarca la aplicación AdGuard](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/other-features.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/other-features.md index 52944245237..c7973c76f0a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/other-features.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/other-features.md @@ -5,7 +5,7 @@ sidebar_position: 4 :::info -Este artículo trata sobre la extensión de navegador AdGuard, que protege solo tu navegador. Para proteger todo su dispositivo, [descarca la aplicación AdGuard](https://agrd.io/download-kb-adblock) +Este artículo trata sobre la extensión del navegador de AdGuard, que protege solo tu navegador. Para proteger todo su dispositivo, [descarca la aplicación AdGuard](https://agrd.io/download-kb-adblock) ::: @@ -25,22 +25,22 @@ Puedes guardar tu configuración haciendo clic en el botón _Exportar configurac La sección _Configuraciones adicionales_ contiene una variedad de configuraciones relacionadas con el proceso de bloqueo de anuncios y la usabilidad de la aplicación. -![Additional settings \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/additional-settings.png) +![Configuración adicional \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_additional_settings.png) -From this tab, you can invert the allowlist and add the AdGuard item to the browser’s context menu. You can also enable the display of the number of blocked ads on the AdGuard icon and notifications about extension updates. Additionally, this section lets you enable notifications about the AdGuard app, open the _Filtering log_, clear the statistics of blocked ads and trackers, or reset the settings. +Desde esta pestaña, puedes invertir la lista de permitido y añadir el artículo de AdGuard al menú contextual del navegador. También puedes habilitar la visualización del número de anuncios bloqueados en el icono de AdGuard y las notificaciones sobre actualizaciones de la extensión. Además, esta sección te permite activar notificaciones sobre la app AdGuard, abrir el _Registro de filtrado_, borrar las estadísticas de anuncios y rastreadores bloqueados o reiniciar la configuración. Además, puedes optar por ayudarnos con el desarrollo de filtros enviándonos estadísticas sobre las reglas aplicadas: cuáles se activan, en qué sitios web y con qué frecuencia. Esta opción está deshabilitada de forma predeterminada ya que no recopilamos datos del usuario sin su consentimiento. Sin embargo, si lo habilitas, todos los datos serán estrictamente anónimos. -You can also choose to help us improve the extension by sending us anonymized usage data. This includes the names of the screens you interact with, the names of the buttons you click, and session identifiers. These insights help us understand where users run into friction, refine the experience, and make the extension faster and easier to use. The _Send anonymized usage data_ option is disabled by default. If you enable it, all data will be strictly anonymized and used only internally. It will never be shared with third parties. +También puedes ayudarnos a mejorar la extensión enviándonos datos de uso anonimizados. Esto incluye los nombres de las pantallas con las que interactúas, los nombres de los botones en los que haces clic y los identificadores de sesión. Estos datos nos ayudan a comprender dónde encuentran dificultades los usuarios, a perfeccionar la experiencia y a hacer que la extensión sea más rápida y fácil de usar. La opción de _Enviar datos de uso anonimizados_ está deshabilitada de forma predeterminada. Si lo habilitas, todos los datos serán anonimizados de forma estricta y se utilizarán únicamente de forma interna. Nunca se compartirá con terceros. :::note -The _Send anonymized usage data_ option can also be enabled on the post-installation page in Chromium-based browsers. +La opción _Enviar datos de uso anonimizados_ también se puede habilitar en la página de postinstalación en navegadores basados en Chromium. ::: -## About {#about} +## Acerca de {#about} -In the _About_ section, you can find info about the current version, links to the EULA and Privacy policy, and to the repository of the Browser extension on GitHub. +En la sección _Acerca de_, puedes encontrar información sobre la versión actual, enlaces al EULA y la política de privacidad, y al repositorio de la extensión del navegador en GitHub. -![About \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_about.png) +![Acerca de \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_about.png) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/stealth-mode.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/stealth-mode.md index dafef7c4120..0bb41c9dde5 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/stealth-mode.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/stealth-mode.md @@ -1,5 +1,5 @@ --- -title: Tracking protection (formerly Stealth Mode) +title: Protección de seguimiento (anteriormente Modo sigiloso) sidebar_position: 3 --- @@ -9,20 +9,20 @@ Este artículo trata sobre la extensión de navegador AdGuard, que protege solo ::: -The purpose of _Tracking protection_ is to safeguard your sensitive personal data from online trackers and fraudsters. There are slight differences in the tracking protection features between Chromium-based browsers, which support MV3, and non-Chromium browsers, which support MV2. +El propósito de la _Protección de rastreo_ es salvaguardar sus datos personales sensibles de los rastreadores y estafadores en línea. Existen pequeñas diferencias en las características de protección contra el seguimiento entre los navegadores basados en Chromium, que soportan MV3, y los navegadores no basados en Chromium, que soportan MV2. -![Tracking protection in Chromium-based browsers \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_mv3_trackingProtection.png) +![Modo sigiloso \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_stealth_mode.png) -_Tracking protection_ in Chromium-based browsers +_Protección de rastreo_ en navegadores basados en Chromium -![Tracking protection in non-Chromium browsers \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_mv2_trackingProtection.png) +![Protección de rastreo en navegadores no basados en Chromium \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_mv2_trackingProtection.png) -_Tracking protection_ in non-Chromium browsers +_Protección contra el rastreo_ en navegadores que no utilizan Chromium -_Tracking protection_ features prevent websites from seeing the search query you used to find them on the Internet, automatically delete third-party and website cookies, and more. A [separate article](/general/stealth-mode) is devoted to all these features. +Las características de _Protección de rastreo_ evitan que los sitios web vean la consulta de búsqueda que usaste para encontrarlos en Internet, eliminan automáticamente las cookies de terceros y del propio sitio web, y más. Un [artículo separado](/general/stealth-mode) fue dedicado a todas estas funciones. :::note -Browser extensions are limited to a specific browser and are subject to its technical restrictions. Therefore, they cannot offer all the tracking protection features available in full-fledged ad-blocking apps. +Las extensiones de navegador están limitadas a un navegador específico y están sujetas a sus restricciones técnicas. Por lo tanto, no pueden ofrecer todas las características de protección contra el seguimiento disponibles en apps completas de bloqueo de anuncios. ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md index bbb0b25a663..a342e46f003 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md @@ -55,7 +55,7 @@ El número máximo de filtros habilitados simultáneamente es **50**. **Reglas dinámicas:** se impone un límite estricto de **5 000** reglas, que incluye un máximo de 1 000 reglas de expresiones regulares. -If this limit is exceeded, only **5,000 converted rules** will be applied in the following order: first Allowlist, then User rules and finally Custom filters. +Si se supera este límite, sólo se aplicarán **5 000 reglas convertidas** en el siguiente orden: primero lista de permitido, luego reglas de usuario y, por último, filtros personalizados. > **Las reglas convertidas** son reglas que se han transformado > a \[formato DNR] usando el [convertidor declarativo][github-declarative-converter]. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md index d1e6bdd8101..64d15baed66 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md @@ -1,15 +1,15 @@ --- -title: Ad blocking issues on search websites in Opera +title: Problemas de bloqueo de anuncios en sitios web de búsqueda en Opera sidebar_position: 3 --- -If AdGuard Browser Extension fails to block ads on search websites in Opera, either automatically or manually, it means that the extension does not have permission to access search page results. +Si la extensión AdGuard Browser no logra bloquear los anuncios en los sitios web de búsqueda en Opera, ya sea de forma automática o manual, significa que la extensión no tiene permiso para acceder a los resultados de la página de búsqueda. -To grant the required permission: +Para otorgar el permiso requerido: -![Allow access to search page results](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/allow-access.png) +![Permitir el acceso a los resultados de la página de búsqueda](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/allow-access.png) -1. Click the cube icon next to the address bar → _Manage extensions..._. -2. Find AdGuard AdBlocker in the list of installed extensions and tick the box next to _Allow access to search page results_. +1. Haz clic en el icono del cubo junto a la barra de direcciones → _Administrar extensiones..._. +2. Encuentra el bloqueador de anuncios AdGuard en la lista de extensiones instaladas y marca la casilla junto a _Permitir acceso a los resultados de la página de búsqueda_. -Once this is done, ads on search websites will be blocked as expected. +Una vez que esto se haya hecho, los anuncios en sitios web de búsqueda serán bloqueados como se espera. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md index 02fea104d60..d030282fb67 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md @@ -3,7 +3,7 @@ title: Resolución de problemas sidebar_position: 1 --- -Here are some guides you may need to solve problems with AdGuard Browser Extension. +Aquí hay algunas guías que puede necesitar para resolver problemas con la extensión de navegador AdGuard. - [Cómo exportar registros desde la página de fondo](/adguard-browser-extension/solving-problems/logs.md) - [Cómo depurar reglas en AdGuard para Chrome MV3](/adguard-browser-extension/solving-problems/debug-rules.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/user-scripts-api.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/user-scripts-api.md index 175d4cb2667..f20e93d2e21 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/user-scripts-api.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-browser-extension/user-scripts-api.md @@ -1,40 +1,40 @@ --- -title: User Scripts API +title: API de scripts de usuario sidebar_position: 8 --- :::info -Este artículo trata sobre la extensión de navegador AdGuard, que protege solo tu navegador. To protect your entire device, [download the AdGuard app](https://adguard.com/download.html?auto=true). +Este artículo trata sobre la extensión de navegador AdGuard, que protege solo tu navegador. Para proteger todo tu dispositivo, [descarga la aplicación AdGuard](https://adguard.com/download.html?auto=true). ::: -When adding a custom filter or user rule, a notification will appear asking you to enable the Developer mode to use these features in the extension. +Al agregar un filtro personalizado o una regla de usuario, aparecerá una notificación solicitándole que habilite el modo de desarrollador para usar estas características en la extensión. -![Notification \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/notification-allow-user-scripts.jpg) +![Notificación \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/notification-allow-user-scripts.jpg) -Starting with version 5.2, AdGuard Browser Extension uses the User Scripts API. Chrome requires this new API to follow best practices for user safety. +A partir de la versión 5.2, la extensión de navegador AdGuard utiliza la API de scripts de usuario. Chrome requiere esta nueva API para cumplir con las mejores prácticas de seguridad del usuario. -## What is the User Scripts API? +## ¿Qué es la API de scripts de usuario? -The User Scripts API is a tool that allows extensions to run customized JavaScript scripts on webpages. These are often used to modify or enhance websites in ways that aren’t originally provided by the website itself. +La API de User Scripts es una herramienta que permite a las extensiones ejecutar scripts de JavaScript personalizados en páginas web. Estas herramientas se utilizan a menudo para modificar o mejorar sitios web de maneras que no están contempladas originalmente en el propio sitio web. -With the shift to Chrome’s Manifest V3, many older methods of injecting scripts are limited or delayed. However, there is an exception for the User Scripts API. +Con el cambio al manifiesto V3 de Chrome, muchos métodos antiguos para inyectar scripts se ven limitados o retrasados. Sin embargo, existe una excepción para la API de scripts de usuario. -Learn more about the impacts of the MV3 policies in our [blog post](https://adguard.com/en/blog/review-issues-in-chrome-web-store.html). +Obtén más información sobre los impactos de las políticas MV3 en nuestra [publicación de blog](https://adguard.com/en/blog/review-issues-in-chrome-web-store.html). -## How to enable the Developer mode +## Cómo habilitar el modo de desarrollador -To use custom filters and JavaScript rules in the _User Rules_ tab, you must set up your browser first. This will give the extension a reliable and secure method of injecting scripts into webpages at the optimal time. Follow the instructions below depending on your Chrome version. +Para utilizar filtros personalizados y reglas de JavaScript en la pestaña _Reglas de usuario_, primero debes configurar tu navegador. Esto proporcionará a la extensión un método fiable y seguro para inyectar scripts en las páginas web en el momento óptimo. Sigue las instrucciones que aparecen a continuación, según tu versión de Chrome. -### For Chrome versions prior to 138 +### Para versiones de Chrome anteriores a 138 -You must enable Developer mode for extensions. To do so, open the Chrome menu by clicking the three dots in the upper-right corner, go to _Extensions_ ⭢ _Manage extensions_, and toggle the _Developer mode_ switch. +Debe habilitar el modo de desarrollador para las extensiones. Para ello, abre el menú de Chrome haciendo clic en los tres puntos de la esquina superior derecha, ve a _Extensiones_ ⭢ _Administrar extensiones_ y activa el interruptor _Modo desarrollador_. -![Manage Extensions \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/developer-mode-enable1.jpg) +![Administrar extensiones \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/developer-mode-enable1.jpg) -### For Chrome version 138 and later +### Para Chrome versión 138 y posteriores -You must enable the _Allow user scripts_ toggle. To do so, open the Chrome menu by clicking the three dots in the upper-right corner, go to _Extensions_ ⭢ _Manage extensions_, go to AdGuard Browser Extension’s _Details_, and toggle the _Allow user scripts_ switch. +Debes habilitar la opción _Permitir scripts de usuario_. Para ello, abre el menú de Chrome haciendo clic en los tres puntos de la esquina superior derecha, ve a _Extensiones_ ⭢ _Administrar extensiones_, accede a _Detalles_ de la extensión de navegador AdGuard y activa el interruptor _Permitir scripts de usuario_. -![Manage Extensions \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/allow-user-scripts1.jpg) +![Administrar extensiones \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/allow-user-scripts1.jpg) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-android/features/low-level-settings.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-android/features/low-level-settings.md index ae8657bc941..9f5f665f82c 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-android/features/low-level-settings.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-android/features/low-level-settings.md @@ -245,4 +245,4 @@ If this setting is enabled, AdGuard will display the **Developer tools** icon in #### Detect Samsung Pay -If this setting is enabled, AdGuard protection will be paused when you open the Samsung Pay app. Korean users require this feature as they experience [issues with Samsung Pay](/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea) when AdGuard is enabled. +If this setting is enabled, AdGuard protection will be paused when you open the Samsung Pay app. Los usuarios coreanos requieren esta característica ya que experimentan [asuntos con Samsung Pay](/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea) cuando AdGuard está habilitado. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-android/features/protection/tracking-protection.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-android/features/protection/tracking-protection.md index f75500f3b11..1579f4f6022 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-android/features/protection/tracking-protection.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-android/features/protection/tracking-protection.md @@ -77,4 +77,4 @@ Estas son las características activas de los niveles preconfigurados: k. _Eliminar encabezado X-Client-Data_. Esta función evita que Google Chrome envíe información sobre su versión y modificaciones a los dominios de Google (incluidos DoubleClick y Google Analytics) -You can tweak individual settings in _Tracking protection_ to create a custom configuration. Each setting has a description to help you understand its purpose. [Read more about various _Tracking protection_ settings](/general/stealth-mode) and use them cautiously, as some may interfere with the functionality of websites and browser extensions. +You can tweak individual settings in _Tracking protection_ to create a custom configuration. Each setting has a description to help you understand its purpose. [Obtén más información sobre lo que hacen las distintas configuraciones de _Protección contra el rastreo_](/general/stealth-mode) y utilízalas con precaución, ya que algunas pueden interferir con la funcionalidad de los sitios web y las extensiones del navegador. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-android/features/settings.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-android/features/settings.md index fb6f708f53c..2c4803a2ddb 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-android/features/settings.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-android/features/settings.md @@ -83,15 +83,15 @@ Disable AMP is a userscript that disables [Accelerated mobile pages](https://en. #### Filtrado HTTPS -To block ads and trackers on most websites and in most apps, AdGuard needs to filter their HTTPS traffic. [Read more about HTTPS filtering](/general/https-filtering/what-is-https-filtering) +To block ads and trackers on most websites and in most apps, AdGuard needs to filter their HTTPS traffic. [Más información sobre el filtrado HTTPS](/general/https-filtering/what-is-https-filtering) ##### Security certificates To manage encrypted traffic, AdGuard installs its CA certificate on your device. It's safe: the traffic is filtered locally and AdGuard verifies the security of the connection. -On older versions of Android, the certificate is installed automatically. On Android 11 and later, you need to install it manually. [Installation instructions](/adguard-for-android/solving-problems/manual-certificate/) +On older versions of Android, the certificate is installed automatically. On Android 11 and later, you need to install it manually. [Instrucciones de instalación](/adguard-for-android/solving-problems/manual-certificate/) -The CA certificate in the user store is enough to filter HTTPS traffic in browsers and some apps. However, there are apps that only trust certificates from the system store. To filter HTTPS traffic there, you need to install AdGuard's CA certificate into the system store. [Instructions](/adguard-for-android/solving-problems/https-certificate-for-rooted/) +The CA certificate in the user store is enough to filter HTTPS traffic in browsers and some apps. However, there are apps that only trust certificates from the system store. To filter HTTPS traffic there, you need to install AdGuard's CA certificate into the system store. [Instrucciones](/adguard-for-android/solving-problems/https-certificate-for-rooted/) ##### HTTPS-filtered apps @@ -101,7 +101,7 @@ This section contains the list of apps for which AdGuard filters HTTPS traffic. This setting allows you to manage websites for which AdGuard should filter HTTPS traffic. -HTTPS filtering allows AdGuard to filter the content of requests and responses, but we never collect or store this data. However, to increase security, we [exclude websites that contain potentially sensitive information from HTTPS filtering](/general/https-filtering/what-is-https-filtering/#financial-websites-and-websites-with-sensitive-personal-data). +HTTPS filtering allows AdGuard to filter the content of requests and responses, but we never collect or store this data. Sin embargo, para aumentar la seguridad, [excluimos del filtrado HTTPS los sitios web que contienen información potencialmente confidencial](/general/https-filtering/what-is-https-filtering/#financial-websites-and-websites-with-sensitive-personal-data). You can also add websites that you consider necessary to exclusions by selecting one of the modes: @@ -112,7 +112,7 @@ By default, we also do not filter websites with Extended Validation (EV) certifi #### Proxy -You can set up AdGuard to route all your device's traffic through your proxy server. [How to set up an outbound proxy](/adguard-for-android/solving-problems/outbound-proxy) +You can set up AdGuard to route all your device's traffic through your proxy server. [Cómo configurar un proxy saliente](/adguard-for-android/solving-problems/outbound-proxy) In this section, you can also set up a third-party VPN to work with AdGuard, if your VPN provider allows it. @@ -126,7 +126,7 @@ This section allows you to select the traffic filtering method. :::note -The _Local VPN_ mode doesn't allow AdGuard to be used simultaneously with other VPNs. To use another VPN with AdGuard, you need to reconfigure it to work in proxy mode and set up an outbound proxy in AdGuard. For AdGuard VPN, this is done automatically with the help of the [_Integrated mode_](/adguard-for-android/features/integration-with-vpn). +The _Local VPN_ mode doesn't allow AdGuard to be used simultaneously with other VPNs. To use another VPN with AdGuard, you need to reconfigure it to work in proxy mode and set up an outbound proxy in AdGuard. Para AdGuard VPN, esto se hace automáticamente con la ayuda del [_modo integrado_](/adguard-for-android/features/integration-with-vpn). ::: @@ -144,7 +144,7 @@ Please note that DNS filtering will still be active in _Automatic proxy_ routing In this section, you can find information about your license and manage it: -- Buy an AdGuard license to activate [the full version's features](/adguard-for-android/features/free-vs-full) +- Compra una licencia de AdGuard para activar [las funciones de la versión completa](/adguard-for-android/features/free-vs-full) - Log in to your AdGuard account or enter the activation code to activate your license - Sign up to activate your 14-day trial period. The activation code can be used on different devices and platforms - Refresh the license status from the three-dots menu (⋮) @@ -161,12 +161,12 @@ Use this section if you have any questions or suggestions regarding AdGuard for If you notice a missed ad, please report it via _Report incorrect blocking_. -For unexpected app behavior, select _Report a bug_. If possible, describe your problem in detail and add app logs. [How to describe an issue](/guides/report-bugs/#how-to-describe-a-problem) +For unexpected app behavior, select _Report a bug_. If possible, describe your problem in detail and add app logs. [Cómo describir un problema](/guides/report-bugs/#how-to-describe-a-problem) For your suggestions, use _Request a feature_. :::note -GitHub is an alternative way to report bugs and suggest new features. [Instructions and repository links](/guides/report-bugs/#adguard-for-android) +GitHub is an alternative way to report bugs and suggest new features. [Instrucciones y enlaces al repositorio](/guides/report-bugs/#adguard-for-android) ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md index 571987f883f..cd06b728026 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md @@ -35,7 +35,7 @@ Este artículo trata sobre AdGuard para iOS, un bloqueador de anuncios multifunc - [Otras funciones](/adguard-for-ios/features/other-features.md) - General settings: theme, settings and statistics reset, auto-update, inverting the allowlist, and advanced mode. + Configuración general: tema, restablecimiento de ajustes y estadísticas, actualización automática, inversión de la lista de permitidos y modo avanzado. - [Compatibilidad con AdGuard VPN](/adguard-for-ios/features/compatibility-with-adguard-vpn.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md index 4ab7ab788e5..3c887351dc3 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md @@ -27,7 +27,7 @@ Este artículo trata sobre AdGuard para Mac, un bloqueador de anuncios multifunc - [Modo sigiloso](/adguard-for-mac/features/stealth.md) - Settings to block cookies, UTM tags, and online analytics that collect user information + Configuración para bloquear cookies, etiquetas UTM y análisis en línea que recopilan información del usuario - [Seguridad](/adguard-for-mac/features/security.md) @@ -35,7 +35,7 @@ Este artículo trata sobre AdGuard para Mac, un bloqueador de anuncios multifunc - [Asistente de navegador](/adguard-for-mac/features/browser-assistant.md) - An extension that complements the desktop app and allows you to manage filtering from your browser + Una extensión que complementa la aplicación de escritorio y te permite gestionar el filtrado desde tu navegador - [Extensiones](/adguard-for-mac/features/extensions.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-mac/features/stealth.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-mac/features/stealth.md index c7de3c104ed..b80198e11c2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-mac/features/stealth.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-mac/features/stealth.md @@ -13,4 +13,4 @@ Este artículo trata sobre AdGuard para Mac, un bloqueador de anuncios multifunc ![Stealth Mode](https://cdn.adtidy.org/content/kb/ad_blocker/mac/tracking_protection.png) -_Tracking protection_ (formerly Stealth Mode) safeguards your privacy by deleting cookies, UTM tags, online counters, and analytics systems. It prevents websites from collecting your IP address, device and browser parameters, search queries, and personal information. [Learn more about Tracking protection settings](/general/stealth-mode) +_Tracking protection_ (formerly Stealth Mode) safeguards your privacy by deleting cookies, UTM tags, online counters, and analytics systems. It prevents websites from collecting your IP address, device and browser parameters, search queries, and personal information. [Más información sobre Protección contra el rastreo](/general/stealth-mode) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/adguard-for-windows-8.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/adguard-for-windows-8.md index 1e3318b3cb4..cec36abad7d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/adguard-for-windows-8.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/adguard-for-windows-8.md @@ -15,19 +15,19 @@ AdGuard para Windows es una herramienta fácil de usar que bloquea molestos bann 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. -## [Protection](/adguard-for-windows-8/protection/) +## [Protección DNS](/adguard-for-windows-8/protection/) Settings to configure _Ad blocking_, _Tracking protection_, _DNS protection_, _Annoyances blocking_, _Browsing security_, _Parental control_, and _Extensions_. -## [Statistics](/adguard-for-windows-8/statistics/) +## [Estadísticas](/adguard-for-windows-8/statistics/) Detailed information about blocked ads, trackers, and data usage. -## [App management](/adguard-for-windows-8/app-management/) +## [Administración de la app](/adguard-for-windows-8/app-management/) Settings to customize traffic filtering and routing for each app and browser. -## [Settings](/adguard-for-windows-8/settings/) +## [Ajustes](/adguard-for-windows-8/settings/) Options to select language and theme, view legal documents, check license information, and contact support. Advanced settings and network settings also live there. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/ad-blocking.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/ad-blocking.md index d86f46d5420..be70196d166 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/ad-blocking.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/ad-blocking.md @@ -9,14 +9,14 @@ This article describes AdGuard for Windows v8.0, a comprehensive ad blocker that ::: -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). +The _Ad blocking_ section is responsible for removing ads from the websites you visit and from the apps installed on your device. Para filtrar banners, ventanas emergentes, rastreadores y otros elementos intrusivos, AdGuard se basa en filtros: conjuntos de reglas escritas en una [sintaxis especial](/general/ad-filtering/create-own-filters). Si quieres saber más sobre cómo funcionan, lee nuestro [artículo sobre filtros](/general/ad-filtering/how-ad-blocking-works). ![Ad blocking](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/ad_blocking.png) Aquí puedes: - enable basic protection, -- block [search ads and self-promotion](/general/ad-filtering/search-ads), +- bloquear [anuncios de búsqueda y autopromoción](/general/ad-filtering/search-ads), - desactivar los anuncios en el menú Inicio en Windows 11, - enable automatic activation of language-specific filters - manage user rules. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/browsing-security.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/browsing-security.md index e757af4a506..96d6579e288 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/browsing-security.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/browsing-security.md @@ -15,7 +15,7 @@ While AdGuard for Windows is not an antivirus, it does provide essential securit It won’t stop a virus that is already being downloaded, and it won’t remove existing malware. But it will block access to websites that are marked as unsafe, helping you avoid threats in the first place. -For more details about how this protection works, see our article [Phishing and malware protection](/general/browsing-security). +Para obtener más detalles sobre cómo funciona esta protección, consulte nuestro artículo [Protección contra phishing y malware](/general/browsing-security). ![Browsing security](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/browsing.png) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/extensions.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/extensions.md index ef6bc4e1e29..6e2411ac4ce 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/extensions.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/extensions.md @@ -9,7 +9,7 @@ This article describes AdGuard for Windows v8.0, a comprehensive ad blocker that ::: -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. +AdGuard puede ampliar la funcionalidad del sitio web actuando como un [director de scripts de usuario](/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) @@ -28,7 +28,7 @@ AdGuard comes with four pre-installed userscripts: ### AdGuard Assistant (Beta) -AdGuard Assistant is the legacy version of Assistant, which you can use if the [new Assistant](/adguard-for-windows/browser-assistant.md) is not available for your browser. As the name suggests, it helps you manage basic AdGuard settings directly from your browser without opening the app. +AdGuard Assistant es la versión heredada de Asistente, que puedes usar si el [nuevo Asistente](/adguard-for-windows/browser-assistant.md) no está disponible para tu navegador. As the name suggests, it helps you manage basic AdGuard settings directly from your browser without opening the app. AdGuard Assistant works with all browsers compatible with Microsoft Windows. It will not appear on websites excluded from filtering or on certain pages where it could cause display issues. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/protection.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/protection.md index 458d8ccd546..9009842923f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/protection.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/protection.md @@ -13,16 +13,16 @@ This article describes AdGuard for Windows v8.0, a comprehensive ad blocker that 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. -[Ad blocking](/adguard-for-windows-8/protection/ad-blocking) +[Bloqueo de anuncios](/adguard-for-windows-8/protection/ad-blocking) -[Tracking protection](/adguard-for-windows-8/protection/tracking-protection) +[Protección contra el rastreo](/adguard-for-windows-8/protection/tracking-protection) -[Annoyance blocking](/adguard-for-windows-8/protection/annoyance-blocking) +[Bloqueo de elementos molestos](/adguard-for-windows-8/protection/annoyance-blocking) -[DNS protection](/adguard-for-windows-8/protection/dns-protection) +[Protección DNS](/adguard-for-windows-8/protection/dns-protection) -[Browsing security](/adguard-for-windows-8/protection/browsing-security) +[Seguridad de navegación](/adguard-for-windows-8/protection/browsing-security) -[Parental control](/adguard-for-windows-8/protection/parental-control) +[Control parental](/adguard-for-windows-8/protection/parental-control) -[Extensions](/adguard-for-windows-8/protection/extensions) +[Extensiones](/adguard-for-windows-8/protection/extensions) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/tracking-protection.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/tracking-protection.md index b911d99b83f..8b414d051df 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/tracking-protection.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/tracking-protection.md @@ -67,7 +67,7 @@ With this option, you can set a time limit (in minutes) after which all third-pa :::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). +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. Si solo desea bloquear las cookies de seguimiento, utilice el filtro [_AdGuard Tracking Protection_](/general/ad-filtering/filter-policy/#tracking-protection-filter). ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/app-settings.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/app-settings.md index 63cf8114bf1..adb3fd91915 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/app-settings.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/app-settings.md @@ -17,10 +17,10 @@ If you wish, you can agree to send anonymized app usage data to help us improve In case of issues, you can change the logging level to create detailed logs for the support team. -In [_Filter editor_](/adguard-for-windows-8/settings/app-settings/filter-editor.md), you can add your own filtering rules or import ready-to-use filters. +En [_Editor de filtrado_](/adguard-for-windows-8/settings/app-settings/filter-editor.md), puedes añadir tus propias reglas de filtrado o importar filtros listos para usar. -[_Network_ settings](/adguard-for-windows-8/settings/app-settings/network-settings.md) include all options related to network filtering and how AdGuard interacts with your system’s network. +[_Configuración de red_](/adguard-for-windows-8/settings/app-settings/network-settings.md) incluyen todas las opciones relacionadas con el filtrado de red y cómo AdGuard interactúa con la red de tu sistema. -[_Advanced_](/adguard-for-windows-8/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. +La configuración [_Avanzado_](/adguard-for-windows-8/settings/app-settings/advanced-settings.md) está destinada a usuarios experimentados. 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) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 2db6ca8ffaf..31d54587f21 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/settings.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/settings.md index 12798c2f7a3..b0152a8d156 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/settings.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/settings.md @@ -13,18 +13,18 @@ There are other useful AdGuard options that shouldn’t go unnoticed in this art ![Settings](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/setting.png) -## [App settings](/adguard-for-windows-8/settings/app-settings) +## [Ajustes de la aplicación](/adguard-for-windows-8/settings/app-settings) Language and theme, update channel and interval, advanced options for experienced users, and a filter editor to quickly create custom rules. -## [License](/adguard-for-windows-8/settings/license) +## [Licencia](/adguard-for-windows-8/settings/license) Information about license type, number of available devices, and activation code, with options to refresh or reset license and bind it to your AdGuard account. -## [Support](/adguard-for-windows-8/settings/support) +## [Soporte](/adguard-for-windows-8/settings/support) FAQ and support form, tools to report missed ads and request new features, possibility to rate the app, share feedback, and access AdGuard social networks. -## [About](/adguard-for-windows-8/settings/about) +## [Acerca de](/adguard-for-windows-8/settings/about) Details about app version and libraries, as well as links to legal documents. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index da54018bac5..5e4b6df9414 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [Más información](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. ¡Listo! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/adguard-for-windows.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/adguard-for-windows.md index 80b89a98457..8d39b546d0f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/adguard-for-windows.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/adguard-for-windows.md @@ -19,7 +19,7 @@ Este artículo trata sobre AdGuard para Windows, un bloqueador de anuncios multi - [Asistente de navegador](/adguard-for-windows/browser-assistant.md) - An extension that complements the desktop app and allows you to manage filtering from your browser + Una extensión que complementa la aplicación de escritorio y te permite gestionar el filtrado desde tu navegador - [Resolviendo problemas](/adguard-for-windows/solving-problems/solving-problems.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/features/features.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/features/features.md index 689781c6a57..c343b9893b7 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/features/features.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/features/features.md @@ -27,4 +27,4 @@ Este artículo trata sobre AdGuard para Windows, un bloqueador de anuncios multi - [Otras funciones](/adguard-for-windows/features/others/) - Support, license management, tray menu options, app version and updates + Soporte, gestión de licencias, opciones del menú de la bandeja, versión de la app y actualizaciones diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 9a652fb1281..1dccb378291 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ En este módulo, puedes marcar la casilla de verificación _Usar AdGuard como pr Por fin, hay una sección con configuración de proxy. Allí puedes especificar qué servidor proxy AdGuard debe utilizar para actualizar los filtros, obtener nuevas versiones, etc. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index 7507dbd2c99..4b8a651a3aa 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -13,11 +13,11 @@ _Configuración_ es la sección que requiere mayor atención. Aquí es donde pod ### General settings -Here you can set the language and theme (Dark or Light), enable AdGuard launching at system start-up and silent automatic updates, choose the update channel and filter update check interval. Also Settings is the place to go if AdGuard for Windows is not working properly and the support team asked you to [collect _Debug logs_](/adguard-for-windows/solving-problems/adguard-logs.md). +Here you can set the language and theme (Dark or Light), enable AdGuard launching at system start-up and silent automatic updates, choose the update channel and filter update check interval. Además, configuración es el lugar al que acudir si AdGuard para Windows no funciona correctamente y el equipo de soporte te pidió que [recopiles _Logs de depuración_](/adguard-for-windows/solving-problems/adguard-logs.md). ![Settings \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/general_settings.png) -At the very bottom of the screen you will find _Advanced Settings_. Changing some of them mindlessly may potentially cause problems with AdGuard’s performance, break the Internet connection or compromise your security and privacy. That’s why we suggest you open this section only if you are sure of what you are doing or our support team has asked you about it. If you want to know what can be set up in _Advanced Settings_, read the [dedicated article](/adguard-for-windows/solving-problems/low-level-settings.md). +At the very bottom of the screen you will find _Advanced Settings_. Changing some of them mindlessly may potentially cause problems with AdGuard’s performance, break the Internet connection or compromise your security and privacy. That’s why we suggest you open this section only if you are sure of what you are doing or our support team has asked you about it. Si deseas saber qué se puede configurar en _Configuración avanzada_, lee el [artículo dedicado](/adguard-for-windows/solving-problems/low-level-settings.md). ![Advanced Settings \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/advanced_settings.png) @@ -44,17 +44,13 @@ Antes de empezar a escribir manualmente tus propias reglas, lee nuestra detallad Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - -To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). +Para aprender todo sobre el modo sigiloso y sus muchas opciones, [lee este artículo](/general/stealth-mode). ### Seguridad de navegación -Browsing security gives strong protection against malicious and phishing websites. No, AdGuard for Windows is not an antivirus. It will neither stop the download of a virus when it’s already started, nor delete the already existing ones. But it will warn you if you’re about to proceed to a website whose domain has been added to our “untrusted sites” database, or to download a file from such website. You can find more information about how this module works in the [dedicated article](/general/browsing-security). +Browsing security gives strong protection against malicious and phishing websites. No, AdGuard for Windows is not an antivirus. It will neither stop the download of a virus when it’s already started, nor delete the already existing ones. But it will warn you if you’re about to proceed to a website whose domain has been added to our “untrusted sites” database, or to download a file from such website. Puedes encontrar más información sobre el funcionamiento de este módulo en el [artículo dedicado](/general/browsing-security). In this module, you can: @@ -64,7 +60,7 @@ In this module, you can: ![Browsing security \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/browsing_security.png) -In case you want to learn more about Browsing security, read [this article](/general/browsing-security). +En caso de que desees obtener más información sobre la Seguridad de navegación, lee [este artículo](/general/browsing-security). ### DNS Protection @@ -97,4 +93,4 @@ In the _Parental control_ module you can enable the _Safe search_ and manage the ![Browser Assistant \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/browser_assistant.png) -From this tab you can easily proceed to install AdGuard Browser Assistant, which primary function is to manage filtering directly from the browser. We explained more about how to work with it and what to do if there is no Browser Assistant for your browser in the [separate article](/adguard-for-windows/browser-assistant.md). +From this tab you can easily proceed to install AdGuard Browser Assistant, which primary function is to manage filtering directly from the browser. Explicamos más sobre cómo trabajar con él y qué hacer si no hay un Asistente de navegador disponible para tu navegador en el [artículo separado](/adguard-for-windows/browser-assistant.md). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 35e04a43dd3..1def5d47e2f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: ejemplo.org` se convertirá en -`GET /foo/bar/ HTTP/1.1 -Host: ejemplo.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` Esta opción solo se aplica cuando la opción *Proteger de DPI* en Modo Stealh está habilitada. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 12f1c37e2ea..ffe6fe5901c 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [Más información](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. ¡Listo! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/adguard-mini-for-mac.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/adguard-mini-for-mac.md index eb2a236a572..e7b3c8d8314 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/adguard-mini-for-mac.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/adguard-mini-for-mac.md @@ -9,20 +9,20 @@ This page is about AdGuard Mini for Mac, which safeguards only your Safari brows ::: -AdGuard Mini for Mac (formerly AdGuard for Safari) was designed to conform to Apple’s restrictions for ad blocking browser extensions. Although it can’t be compared to our desktop ad blocking apps, it’s free and can protect you from ads, trackers, phishing, and malicious websites. +AdGuard Mini for Mac (formerly AdGuard for Safari) was designed to conform to Apple’s restrictions for ad blocking browser extensions. Aunque no se puede comparar con nuestras apps de bloqueo de anuncios para desktop, es gratis y puede protegerte de anuncios, rastreadores, phishing y sitios web maliciosos. -- [Features](/adguard-mini-for-mac/features/features.md) +- [Funciones](/adguard-mini-for-mac/features/features.md) Main features and settings available in AdGuard Mini for Mac -- [Installation](/adguard-mini-for-mac/installation.md) +- [Instalación](/adguard-mini-for-mac/installation.md) Installation, removal, and system requirements for AdGuard Mini for Mac -- [Safari extensions](/adguard-mini-for-mac/extensions.md) +- [Extensiones de Safari](/adguard-mini-for-mac/extensions.md) Mechanisms that enable content blocking and add functionality to the Safari web browser -- [Solving problems](/adguard-mini-for-mac/solving-problems/solving-problems.md) +- [Resolviendo problemas](/adguard-mini-for-mac/solving-problems/solving-problems.md) Problemas conocidos y posibles soluciones diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/extensions.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/extensions.md index 0311344e7af..9e6eaee5ddd 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/extensions.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/extensions.md @@ -52,7 +52,7 @@ User rules and allowlist rules are included in every extension. _AdGuard for Safari_ activates the AdGuard icon next to the search bar. It’s useful if you want to quickly set up protection for a specific website or block ads manually. -_AdGuard for Safari_ extension also contains advanced rules that aren’t converted to the format supported by Safari. These include [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [extended CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets), which allow AdGuard to block complex ads, such as those on YouTube. +_AdGuard for Safari_ extension also contains advanced rules that aren’t converted to the format supported by Safari. Estos incluyen [reglas CSS](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [selectores CSS extendidos](/general/ad-filtering/create-own-filters#extended-css-selectors) y [scriptlets](/general/ad-filtering/create-own-filters#scriptlets), que permiten a AdGuard bloquear anuncios complejos, como los que aparecen en YouTube. ## Cómo gestionar las extensiones de Safari diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/about.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/about.md index f3c118199ab..ac3a8339c3c 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/about.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/about.md @@ -19,6 +19,6 @@ You can also find the links to: :::note Importante -AdGuard Mini for Mac can be downloaded for free [from the App Store](https://agrd.io/mini_mac). A detailed setup instruction is available in [this Knowledge Base article](/adguard-mini-for-mac/installation/). +AdGuard Mini for Mac can be downloaded for free [from the App Store](https://agrd.io/mini_mac). En [este artículo de la base de conocimientos](/adguard-mini-for-mac/installation/ encontrará instrucciones detalladas de configuración. ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/advanced-blocking.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/advanced-blocking.md index bbf9454367c..87f4e7e579a 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/advanced-blocking.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/advanced-blocking.md @@ -11,6 +11,6 @@ Here you can turn on the _AdGuard Extra_ userscript — if there’s a website w :::note -_AdGuard Extra_ is a feature of the [full version](/adguard-mini-for-mac/features/full-version.md). +_AdGuard Extra_ es una característica de la [versión completa](/adguard-mini-for-mac/features/full-version.md). ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index 9b1681e01fe..4e5c0d24cc2 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -3,34 +3,34 @@ title: Features sidebar_position: 1 --- -- [Safari protection](/adguard-mini-for-mac/features/safari-protection.md) +- [Protección de Safari](/adguard-mini-for-mac/features/safari-protection.md) Core filtering feature with customizable options -- [Advanced blocking](/adguard-mini-for-mac/features/advanced-blocking.md) +- [Bloqueo avanzado](/adguard-mini-for-mac/features/advanced-blocking.md) Unlocks stronger filtering capabilities -- [User rules](/adguard-mini-for-mac/features/rules.md) +- [Reglas del usuario](/adguard-mini-for-mac/features/rules.md) Reglas de filtrado personalizadas para mejorar el bloqueo de anuncios -- [Settings](/adguard-mini-for-mac/features/settings/settings.md) +- [Ajustes](/adguard-mini-for-mac/features/settings/settings.md) Various options that help you configure the app and filtering -- [Support](/adguard-mini-for-mac/features/support.md) +- [Soporte](/adguard-mini-for-mac/features/support.md) Helpful options for when you have a question or encountered a problem -- [About](/adguard-mini-for-mac/features/about.md) +- [Acerca de](/adguard-mini-for-mac/features/about.md) Info about the app’s current version and a list of helpful links -- [Safari toolbar menu](/adguard-mini-for-mac/features/toolbar-menu.md) +- [Menú de la barra de herramientas de Safari](/adguard-mini-for-mac/features/toolbar-menu.md) A handy menu in the Safari toolbar -- [Full version](/adguard-mini-for-mac/features/full-version.md) +- [Versión completa](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/safari-extensions.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/safari-extensions.md index 4846a086661..f2b22aec4a7 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/safari-extensions.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/safari-extensions.md @@ -47,7 +47,7 @@ _AdGuard Otros_ contiene filtros con varias funciones. Por ejemplo, tiene un fil :::note Importante -We don’t have any “acceptable ads” paid by advertisers. Instead, we provide users with an option to see [search ads and websites’ self-promotion](/general/ad-filtering/search-ads). +We don’t have any “acceptable ads” paid by advertisers. En su lugar, ofrecemos a los usuarios la opción de ver [anuncios de búsqueda y autopromoción de sitios web](/general/ad-filtering/search-ads). ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/settings.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/settings.md index 1e44dae97a2..feb68fa0883 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/settings.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/settings.md @@ -9,11 +9,11 @@ In _Settings_, you can set up basic things like filters, filter updates, launchi The main two sections are: -- [Filters](/adguard-mini-for-mac/features/settings/filters.md) +- [Filtros](/adguard-mini-for-mac/features/settings/filters.md) Different filters that allow you to customize your ad blocking experience -- [Safari extensions](/adguard-mini-for-mac/features/settings/safari-extensions.md) +- [Extensiones de Safari](/adguard-mini-for-mac/features/settings/safari-extensions.md) Info on the current state of content blockers — how many rules and filters are enabled for each of them diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/solving-problems.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/solving-problems.md index 2e64b8debe0..5da8472267e 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/solving-problems.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/solving-problems.md @@ -11,8 +11,8 @@ Este artículo trata sobre AdGuard Mini para Mac, que protege solo tu navegador Here are some problems you may encounter and workarounds, as well as guides and instructions you may need: -- [Rule limit issues](/adguard-mini-for-mac/solving-problems/rule-limit.md) -- [Filtering doesn’t work and ads aren’t blocked](/adguard-mini-for-mac/solving-problems/ads-not-blocked.md) -- [Filtering doesn’t stop when AdGuard Mini is disabled](/adguard-mini-for-mac/solving-problems/filters-after-disable.md) -- [How to collect logs in AdGuard Mini for Mac](/adguard-mini-for-mac/solving-problems/logs.md) -- [AdGuard Mini doesn’t work in private tabs on macOS Sonoma](/adguard-mini-for-mac/solving-problems/private-sonoma.md) +- [Problemas de reglas](/adguard-mini-for-mac/solving-problems/rule-limit.md) +- [El filtrado no funciona y los anuncios no están bloqueados](/adguard-mini-for-mac/solving-problems/ads-not-blocked.md) +- [El filtrado no se detiene cuando AdGuard Mini está desactivado](/adguard-mini-for-mac/solving-problems/filters-after-disable.md) +- [Cómo recopilar registros en AdGuard Mini para Mac](/adguard-mini-for-mac/solving-problems/logs.md) +- [AdGuard Mini no funciona en pestañas privadas en macOS Sonoma](/adguard-mini-for-mac/solving-problems/private-sonoma.md) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/es/docusaurus-plugin-content-docs/current/general/extensions.md index 7514d1c7ef7..eb31d1c347f 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/general/extensions.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/general/extensions.md @@ -61,7 +61,7 @@ SponsorBlock skips sponsored segments in YouTube videos. It saves time by jumpin :::info -This userscript runs exclusively on our desktop applications, AdGuard for Windows and AdGuard for Mac. +Este script de usuario se ejecuta exclusivamente en nuestras aplicaciones de escritorio, AdGuard para Windows y AdGuard para Mac. ::: diff --git a/i18n/es/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/es/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/es/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/es/docusaurus-plugin-content-docs/current/general/how-to-install.md index e21f85dc187..f30bf40ddf0 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: Cómo instalar AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Dependiendo de la aplicación AdGuard o de la extensión del navegador que desee instalar, siga uno de estos enlaces para encontrar el artículo correspondiente: diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 2d9c4320c1a..8a69d19a031 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/fa/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/fa/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/fa/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 2d9c4320c1a..8a69d19a031 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/fi/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/fi/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/fi/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index c2e1c164ed7..bcd31f2462c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Ici, vous pouvez choisir quel proxy AdGuard doit utiliser pour télécharger les ## Utiliser le pilote SockFilter -Activez cette option pour utiliser le pilote SockFilter, qui aide à bloquer les publicités et les traqueurs dans les apps sur Windows 8 et versions ultérieures. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -Si cette option est désactivée, AdGuard passera au pilote WFP plus ancien. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 7552be1dbd5..ab9712a3e4c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ De ce fait, la visibilité du trafic basée sur le TDI devient de plus en plus i AdGuard considère déjà le pilote TDI comme obsolète, et sa suppression complète est prévue à mesure que le produit évolue. +## Solution permanente + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Solution temporaire Certaines modifications du registre Windows peuvent forcer le navigateur à cesser d'utiliser AppContainer, ce qui aura pour conséquence que ses processus s'exécutent à nouveau en mode non isolé. Le service réseau cesse d'utiliser la pile WSK et se rabat sur un chemin réseau que le pilote TDI peut voir. AdGuard retrouve alors la capacité de filtrer le trafic du navigateur. @@ -123,7 +131,3 @@ Vous devriez voir les politiques actives suivantes : Si disponible, cliquez sur _Recharger les politiques_. C'est fait ! - -## Solution permanente - -Nous prévoyons d'ajouter la prise en charge du pilote SockFilter dans les prochaines versions. Cela résoudra le problème en éliminant les conflits dans la pile WFP. [Plus d'informations](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 1c048943a42..a4bde3af9fc 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ Dans ce module, vous pouvez cocher la case _Utiliser AdGuard comme proxy HTTP_ p Enfin, il y a une section avec les paramètres de proxy. Vous pouvez y spécifier quel serveur proxy AdGuard doit utiliser pour mettre à jour les filtres, obtenir de nouvelles versions, et ainsi de suite. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index 64bb6b0aeae..a26a655bb3c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Avant de commencer à écrire vos propres règles manuellement, lisez notre [gui Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Navigation sécurisée diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 134ffc6fae2..fcb9a2e6696 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` sera convertie en -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` Cette option n'est appliquée que lorsque l'option *Protection contre l'inspection approfondie des paquets* du mode furtif est activée. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index c4800373c6c..07ffb3d9673 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. C'est fait ! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/fr/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/fr/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/fr/docusaurus-plugin-content-docs/current/general/how-to-install.md index 6a3eca6e7e5..67d55ec4ca5 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: Comment installer AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Selon l'application AdGuard ou l'extension de navigateur que vous souhaitez installer, suivez l'un de ces liens pour trouver l'article correspondant : diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 2d9c4320c1a..8a69d19a031 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/hr/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/hr/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/hr/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 16168d18402..0d80225d9e1 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 4b0b4fa6fdf..cc7bfeb8fe1 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/hu/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/hu/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/hu/docusaurus-plugin-content-docs/current/general/how-to-install.md index cc0f757af24..5e298f37419 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index ce6fd2fc56e..d382d325035 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Qui puoi scegliere quale proxy AdGuard deve usare per scaricare gli aggiornament ## Usa il driver SockFilter -Abilita questa opzione per usare il driver SockFilter, che aiuta a bloccare inserzioni e tracciatori nelle app su Windows 8 e versioni successive. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -Se questa opzione viene disabilitata, AdGuard passerà al vecchio driver WFP. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index fc7da814787..993ea39c9b0 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Per questo motivo, la visibilità del traffico basata su TDI diventa sempre più AdGuard già considera il driver TDI obsoleto e la sua completa rimozione è pianificata con l'evoluzione del prodotto. +## Soluzione permanente + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Soluzione temporanea Certi cambiamenti del registro di Windows possono forzare il browser a fermare l'uso di AppContainer, causando nuovamente l'esecuzione dei suoi processi in una modalità non isolata. Il servizio della rete dedica ferma l'uso dello stack WSK e torna a un percorso di rete che il driver TDI può vedere. AdGuard quindi riacquista la capacità di filtrare il traffico del browser. @@ -123,7 +131,3 @@ Dovresti vedere le seguenti politiche attive: Se disponibile, clicca _Ricarica le politiche_. Fatto! - -## Soluzione permanente - -Abbiamo in programma di aggiungere il supporto per il driver SockFilter nelle prossime versioni. Risolverà l'inghippo sistemando i conflitti nello stack WFP. [Ulteriori informazioni](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 51e3136a1d8..75e50399e38 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In questo modulo puoi selezionare la casella di controllo _Usa AdGuard come prox Infine, esiste una sezione con le impostazioni proxy. Lì, puoi specificare quale server proxy dovrebbe essere usato da AdGuard per aggiornare i filtri, ottenere le nuove versioni e così via. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index 987e3a6d677..af598b8e016 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Prima d'iniziare a scrivere manualmente le tue regole, leggi la nostra dettaglia Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Sicurezza di navigazione diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index dfd3802572e..8eabf258697 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` sarà convertito in -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` Questa opzione viene applicata solo quando l'opzione Modalità Stealth di *Protezione da DPI* è attivata. diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index e22f031fd7f..34bcf271f16 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Per questo motivo, la visibilità del traffico basata su TDI diventa sempre più AdGuard già considera il driver TDI obsoleto e la sua completa rimozione è pianificata con l'evoluzione del prodotto. +## Soluzione permanente + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Soluzione temporanea Certi cambiamenti del registro di Windows possono forzare il browser a fermare l'uso di AppContainer, causando nuovamente l'esecuzione dei suoi processi in una modalità non isolata. Il servizio della rete dedica ferma l'uso dello stack WSK e torna a un percorso di rete che il driver TDI può vedere. AdGuard quindi riacquista la capacità di filtrare il traffico del browser. @@ -136,7 +144,3 @@ Dovresti vedere le seguenti politiche attive: Se disponibile, clicca _Ricarica le politiche_. Fatto! - -## Soluzione permanente - -Abbiamo in programma di aggiungere il supporto per il driver SockFilter nelle prossime versioni. Risolverà l'inghippo sistemando i conflitti nello stack WFP. [Ulteriori informazioni](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/it/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/it/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/it/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/it/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/it/docusaurus-plugin-content-docs/current/general/how-to-install.md index 297fff52c61..1db612762c5 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: Come installare AdGuard -sidebar_position: 9 +sidebar_position: 10 --- A seconda di quale app o estensione del browser di AdGuard desideri installare, segui uno di questi link per trovare l'articolo rilevante: diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index ba1793f91b0..821189049fb 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index f407442c719..660b91ebc2d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. 完了です! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 78c85113b99..d9333ec0b0a 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ sidebar_position: 4 最後に、プロキシ設定のセクションがあります。 そこで、AdGuard がフィルタの更新や新バージョンの取得などに使用するプロキシサーバーを指定できます。 -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index 5e644d0f76a..d3548e2c448 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ In the Ad blocking module you can: Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### ブラウジング・セキュリティ diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 9a649a875e6..4e749e62d08 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` は、以下に変換されます: -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` このオプションは、「*DPIから保護する*」というステルスモード機能が有効になっている場合にのみ適用されます。 diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 77680059563..496b7ffd006 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. 完了です! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/ja/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/ja/docusaurus-plugin-content-docs/current/general/how-to-install.md index 32a20cc559a..50d8271f273 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: AdGuard のインストール方法 -sidebar_position: 9 +sidebar_position: 10 --- インストールしたいAdGuardアプリ・ブラウザ拡張機能に応じて、以下のリンクから関連記事をご覧ください。 diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 518fe07b7f0..f79107801cd 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 81199a20c11..a85deb60e68 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. 끝! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 776a2a38c0e..28d7243095b 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ sidebar_position: 4 마지막으로 프록시 설정 섹션이 있습니다. 여기에서 필터 업데이트, 새 버전 가져오기 등에 AdGuard가 사용할 프록시 서버를 지정할 수 있습니다. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index 5ee26428549..fb07af417be 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ In the Ad blocking module you can: Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### 브라우징 보안 diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index ab7614e0f8d..44b2e28ddf2 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org 요청은` 다음과 같이 변환됩니다. -`GET /foo/bar/ HTTP/1.1 -Host: example.org 요청은` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` 이 설정은 스텔스 모드에서 *DP로부터 보호* 옵션이 활성화된 경우에만 적용됩니다. diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index d8199f58dac..ce56f6acbf2 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. 끝! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/ko/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/ko/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/ko/docusaurus-plugin-content-docs/current/general/how-to-install.md index b4472bdfa94..e907a80ddeb 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: AdGuard를 설치하는 방법 -sidebar_position: 9 +sidebar_position: 10 --- 설치하려는 AdGuard 앱 또는 확장 프로그램에 따라 다음 링크 중 하나를 클릭하여 관련 지침을 따르세요. diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 2d9c4320c1a..8a69d19a031 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/nl/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/nl/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/nl/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 2d9c4320c1a..8a69d19a031 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/no/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/no/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/no/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/no/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/no/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 2d9c4320c1a..8a69d19a031 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/pl/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/pl/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/pl/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md index 423cf02e7bb..6cf55f836da 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md @@ -11,7 +11,7 @@ Este artigo é sobre a extensão de navegador AdGuard, que protege apenas o seu - [Recursos](/adguard-browser-extension/features) - Main features and settings available in AdGuard Browser Extension + Principais recursos e configurações disponíveis na extensão do navegador AdGuard - [Disponibilidade](/adguard-browser-extension/availability) @@ -23,7 +23,7 @@ Este artigo é sobre a extensão de navegador AdGuard, que protege apenas o seu - [Compatibilidade com o aplicativo independente](/adguard-browser-extension/compatibility) - Compatibility of AdGuard Browser Extension with the AdGuard desktop apps + Compatibilidade da extensão do navegador AdGuard com os aplicativos de desktop do AdGuard - [Extensão de navegador AdGuard para Chrome MV3](/adguard-browser-extension/mv3-version/) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md index ec2c6f022ce..dfc762c9e63 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md @@ -9,18 +9,18 @@ Este artigo é sobre a extensão de navegador AdGuard, que protege apenas o seu ::: -- [Main menu](/adguard-browser-extension/features/main-menu.md) +- [Menu principal](/adguard-browser-extension/features/main-menu.md) - The main popup from which you can access settings, filtering log and statistics, and report problems + A janela principal a partir da qual você pode acessar as configurações, filtrar registros e estatísticas e relatar problemas -- [Filters](/adguard-browser-extension/features/filters.md) +- [Filtros](/adguard-browser-extension/features/filters.md) Filtros e regras de usuário para ajustar o bloqueio de anúncios -- [Tracking protection (Stealth Mode)](/adguard-browser-extension/features/stealth-mode.md) +- [Proteção contra rastreamento (Modo invisível)](/adguard-browser-extension/features/stealth-mode.md) - Settings to block cookies, UTM tags, and online analytics that collect user information + Configurações de bloqueio cookies, tags UTM e análises online que coletam informações do usuário -- [Other features and options](/adguard-browser-extension/features/other-features.md) +- [Outros recursos e opções](/adguard-browser-extension/features/other-features.md) - General and additional settings, links to privacy documents and GitHub repository + Configurações gerais e adicionais, links para documentos de privacidade e repositório do GitHub diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/other-features.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/other-features.md index 3aae4e2cdad..0b5b0489956 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/other-features.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/other-features.md @@ -25,22 +25,22 @@ Você pode salvar suas configurações clicando no botão _Exportar configuraç A seção _Configurações adicionais_ contém uma variedade de configurações relacionadas ao processo de bloqueio de anúncios e à usabilidade do aplicativo. -![Additional settings \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/additional-settings.png) +![Configurações adicionais \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_additional_settings.png) -From this tab, you can invert the allowlist and add the AdGuard item to the browser’s context menu. You can also enable the display of the number of blocked ads on the AdGuard icon and notifications about extension updates. Additionally, this section lets you enable notifications about the AdGuard app, open the _Filtering log_, clear the statistics of blocked ads and trackers, or reset the settings. +Nesta aba, você pode inverter a lista de permissões e adicionar o item do AdGuard ao menu de contexto do navegador. Você também pode ativar a exibição do número de anúncios bloqueados no ícone do AdGuard e notificações sobre atualizações da extensão. Além disso, esta seção permite ativar notificações sobre o aplicativo AdGuard, Abrir o _Registro de filtragem_, limpar as estatísticas de anúncios e rastreadores bloqueados ou redefinir as configurações. Além disso, você pode optar por nos ajudar no desenvolvimento de filtros enviando estatísticas sobre as regras aplicadas: quais são acionadas, em quais sites e com que frequência. Esta opção está desativada por padrão, pois não coletamos dados do usuário sem consentimento. Mesmo que você a ative, todos os dados serão estritamente anônimos. -You can also choose to help us improve the extension by sending us anonymized usage data. This includes the names of the screens you interact with, the names of the buttons you click, and session identifiers. These insights help us understand where users run into friction, refine the experience, and make the extension faster and easier to use. The _Send anonymized usage data_ option is disabled by default. If you enable it, all data will be strictly anonymized and used only internally. It will never be shared with third parties. +Você também pode optar por nos ajudar a melhorar a extensão enviando-nos dados de uso anonimizados. Isso inclui os nomes das telas com as quais você interage, os nomes dos botões em que você clica e os identificadores de sessão. Essas informações nos ajudam a entender onde os usuários encontram dificuldades, aprimorar a experiência e tornar a extensão mais rápida e fácil de usar. A opção _Enviar dados de uso anonimizados_ está desativada por padrão. Ao ativar essa opção, todos os dados serão estritamente anonimizados e usados apenas internamente. Nunca será compartilhado com terceiros. :::note -The _Send anonymized usage data_ option can also be enabled on the post-installation page in Chromium-based browsers. +A opção _Enviar dados de uso anonimizados_ também pode ser ativada na página pós-instalação em navegadores baseados em Chromium. ::: -## About {#about} +## Sobre {#about} -In the _About_ section, you can find info about the current version, links to the EULA and Privacy policy, and to the repository of the Browser extension on GitHub. +Na seção _Sobre_, você pode encontrar informações sobre a versão atual, links para o EULA e a política de privacidade e para o repositório da extensão do navegador no GitHub. -![About \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_about.png) +![Sobre \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_about.png) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/stealth-mode.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/stealth-mode.md index 21ae61dde8a..af5331e907f 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/stealth-mode.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/stealth-mode.md @@ -1,5 +1,5 @@ --- -title: Tracking protection (formerly Stealth Mode) +title: Proteção contra rastreamento (Modo invisível) sidebar_position: 3 --- @@ -9,20 +9,20 @@ Este artigo é sobre a extensão de navegador AdGuard, que protege apenas o seu ::: -The purpose of _Tracking protection_ is to safeguard your sensitive personal data from online trackers and fraudsters. There are slight differences in the tracking protection features between Chromium-based browsers, which support MV3, and non-Chromium browsers, which support MV2. +O objetivo da _Proteção contra rastreamento_ é proteger seus dados pessoais sensíveis contra rastreadores online e fraudadores. Existem pequenas diferenças nos recursos de proteção contra rastreamento entre navegadores baseados em Chromium, que suportam MV3, e navegadores não baseados em Chromium, que suportam MV2. -![Tracking protection in Chromium-based browsers \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_mv3_trackingProtection.png) +![Stealth Mode \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_stealth_mode.png) -_Tracking protection_ in Chromium-based browsers +_Proteção contra rastreamento_ em navegadores baseados no Chromium -![Tracking protection in non-Chromium browsers \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_mv2_trackingProtection.png) +![Proteção contra rastreamento em navegadores que não sejam Chromium \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_mv2_trackingProtection.png) -_Tracking protection_ in non-Chromium browsers +Algumas das opções do _Modo Invisível_ disponíveis em aplicativos completos não estão presentes nas extensões do navegador devido a restrições técnicas. -_Tracking protection_ features prevent websites from seeing the search query you used to find them on the Internet, automatically delete third-party and website cookies, and more. A [separate article](/general/stealth-mode) is devoted to all these features. +Os recursos de _Proteção contra rastreamento_ impedem que os sites vejam a consulta de pesquisa que você usou para encontrá-los na Internet, excluem automaticamente cookies de terceiros e de sites, e muito mais. Um [artigo separado](/general/stealth-mode) é dedicado a todos esses recursos. :::note -Browser extensions are limited to a specific browser and are subject to its technical restrictions. Therefore, they cannot offer all the tracking protection features available in full-fledged ad-blocking apps. +As extensões de navegador são limitadas a um navegador específico e estão sujeitas às suas restrições técnicas. Portanto, não podem oferecer todos os recursos de proteção contra rastreamento disponíveis em aplicativos completos de bloqueio de anúncios. ::: diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md index 13ed454738f..d8c7d56ee6d 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md @@ -55,7 +55,7 @@ O número máximo de filtros ativados simultaneamente é **50**. **Regras dinâmicas:** é imposto um limite estrito de **5.000** regras, que inclui um máximo de 1.000 regras regex. -If this limit is exceeded, only **5,000 converted rules** will be applied in the following order: first Allowlist, then User rules and finally Custom filters. +Se esse limite for excedido, apenas **5.000 regras convertidas** serão aplicadas na seguinte ordem: primeiro a lista de permissões, depois as Regras de usuário, filtros personalizados e, finalmente, o filtro Quick Fixes. > **Regras convertidas** são regras que foram transformadas > para o \[formato DNR] usando o [conversor declarativo][github-declarative-converter]. diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md index d1e6bdd8101..b2af0d63f4a 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md @@ -1,15 +1,15 @@ --- -title: Ad blocking issues on search websites in Opera +title: Problemas com o bloqueio de anúncios em sites de busca no Opera sidebar_position: 3 --- -If AdGuard Browser Extension fails to block ads on search websites in Opera, either automatically or manually, it means that the extension does not have permission to access search page results. +Se a extensão AdGuard para navegadores não conseguir bloquear anúncios em sites de busca no Opera, seja automaticamente ou manualmente, significa que a extensão não tem permissão para acessar os resultados da página de busca. -To grant the required permission: +Para conceder a permissão necessária: -![Allow access to search page results](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/allow-access.png) +![Permitir acesso aos resultados da página de pesquisa](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/allow-access.png) -1. Click the cube icon next to the address bar → _Manage extensions..._. -2. Find AdGuard AdBlocker in the list of installed extensions and tick the box next to _Allow access to search page results_. +1. Clique no ícone de cubo ao lado da barra de endereço → _Gerenciar extensões..._. +2. Encontre o bloqueador de anúncios AdGuard na lista de extensões instaladas e marque a caixa ao lado de _Permitir acesso aos resultados da página de pesquisa_. -Once this is done, ads on search websites will be blocked as expected. +Feito isso, os anúncios em sites de busca serão bloqueados conforme o esperado. diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md index 40d5e0bdcf0..a7a305c9f1e 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md @@ -3,7 +3,7 @@ title: Resolvendo problemas sidebar_position: 1 --- -Here are some guides you may need to solve problems with AdGuard Browser Extension. +Aqui estão alguns guias que você pode precisar para resolver problemas com a extensão de navegador AdGuard. - [Como exportar registros da página de segundo plano](/adguard-browser-extension/solving-problems/logs.md) - [Como depurar regras no AdGuard para Chrome MV3](/adguard-browser-extension/solving-problems/debug-rules.md) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/user-scripts-api.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/user-scripts-api.md index 91ccdf14f2b..ac033b86e52 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/user-scripts-api.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-browser-extension/user-scripts-api.md @@ -1,40 +1,40 @@ --- -title: User Scripts API +title: API de Scripts de Usuário sidebar_position: 8 --- :::info -Este artigo é sobre a extensão de navegador AdGuard, que protege apenas o seu navegador. To protect your entire device, [download the AdGuard app](https://adguard.com/download.html?auto=true). +Este artigo é sobre a extensão de navegador AdGuard, que protege apenas o seu navegador. Para proteger todo o seu dispositivo, [baixe o aplicativo AdGuard](https://adguard.com/download.html?auto=true). ::: -When adding a custom filter or user rule, a notification will appear asking you to enable the Developer mode to use these features in the extension. +Ao adicionar um filtro personalizado ou uma regra de usuário, uma notificação aparecerá solicitando que você ative o modo do Desenvolvedor para usar esses recursos na extensão. -![Notification \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/notification-allow-user-scripts.jpg) +![Notificação \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/notification-allow-user-scripts.jpg) -Starting with version 5.2, AdGuard Browser Extension uses the User Scripts API. Chrome requires this new API to follow best practices for user safety. +A partir da versão 5.2, a Extensão do AdGuard para navegador usa a API de User Scripts. O Chrome exige essa nova API para seguir melhores práticas de segurança do usuário. -## What is the User Scripts API? +## O que é a API de Scripts de Usuário? -The User Scripts API is a tool that allows extensions to run customized JavaScript scripts on webpages. These are often used to modify or enhance websites in ways that aren’t originally provided by the website itself. +A API de Scripts de Usuário é uma ferramenta que permite que extensões executem scripts JavaScript personalizados em páginas da web. Essas ferramentas são frequentemente usadas para modificar ou aprimorar sites de maneiras que não são originalmente oferecidas pelo próprio site. -With the shift to Chrome’s Manifest V3, many older methods of injecting scripts are limited or delayed. However, there is an exception for the User Scripts API. +Com a mudança para o Manifest V3 do Chrome, muitos métodos antigos de injeção de scripts ficaram limitados ou sofreram atrasos. No entanto, há uma exceção para a API de Scripts de Usuário. -Learn more about the impacts of the MV3 policies in our [blog post](https://adguard.com/en/blog/review-issues-in-chrome-web-store.html). +Saiba mais sobre os impactos das políticas MV3 em nosso [post de blog](https://adguard.com/en/blog/review-issues-in-chrome-web-store.html). -## How to enable the Developer mode +## Como ativar o modo de desenvolvedor -To use custom filters and JavaScript rules in the _User Rules_ tab, you must set up your browser first. This will give the extension a reliable and secure method of injecting scripts into webpages at the optimal time. Follow the instructions below depending on your Chrome version. +Para usar filtros personalizados e regras JavaScript na guia _Regras do Usuário_, você precisa configurar seu navegador primeiro. Isso proporcionará à extensão um método confiável e seguro de injetar scripts em páginas da web no momento ideal. Siga as instruções abaixo, dependendo da sua versão do Chrome. -### For Chrome versions prior to 138 +### Para versões do Chrome anteriores à 138 -You must enable Developer mode for extensions. To do so, open the Chrome menu by clicking the three dots in the upper-right corner, go to _Extensions_ ⭢ _Manage extensions_, and toggle the _Developer mode_ switch. +Você precisa ativar o modo de desenvolvedor para as extensões. Para isso, abra o menu do Chrome clicando nos três pontos no canto superior direito, vá para _Extensões_ ⭢ _Gerenciar extensões_ e ative a opção _Modo de desenvolvedor_. -![Manage Extensions \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/developer-mode-enable1.jpg) +![Gerenciar extensões \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/developer-mode-enable1.jpg) -### For Chrome version 138 and later +### Para o Chrome versão 138 e posterior -You must enable the _Allow user scripts_ toggle. To do so, open the Chrome menu by clicking the three dots in the upper-right corner, go to _Extensions_ ⭢ _Manage extensions_, go to AdGuard Browser Extension’s _Details_, and toggle the _Allow user scripts_ switch. +Você precisa ativar a opção _Permitir scripts de usuário_. Para isso, abra o menu do Chrome clicando nos três pontos no canto superior direito, vá para _Extensões_ ⭢ _Gerenciar extensões_, acesse os _Detalhes_ da extensão AdGuard Browser Extension e ative a opção _Permitir scripts de usuário_. -![Manage Extensions \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/allow-user-scripts1.jpg) +![Gerenciar extensões \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/allow-user-scripts1.jpg) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-android/features/protection/tracking-protection.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-android/features/protection/tracking-protection.md index b531a8fcbc2..c1a674889c6 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-android/features/protection/tracking-protection.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-android/features/protection/tracking-protection.md @@ -77,4 +77,4 @@ Aqui estão os recursos ativos dos níveis pré-configurados: k. _Remover cabeçalho X-Client-Data_. Este recurso impede que o Google Chrome envie informações sobre sua versão e modificações para domínios do Google (incluindo DoubleClick e Google Analytics) -You can tweak individual settings in _Tracking protection_ to create a custom configuration. Each setting has a description to help you understand its purpose. [Read more about various _Tracking protection_ settings](/general/stealth-mode) and use them cautiously, as some may interfere with the functionality of websites and browser extensions. +You can tweak individual settings in _Tracking protection_ to create a custom configuration. Each setting has a description to help you understand its purpose. [Saiba mais sobre o papel de várias configurações de _Proteção contra rastreamento_](/general/stealth-mode) e aborde-as com cautela, pois algumas podem interferir na funcionalidade de sites e extensões de navegador. diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-android/features/settings.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-android/features/settings.md index 8ccc2ca23fb..841e9ccf86d 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-android/features/settings.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-android/features/settings.md @@ -83,15 +83,15 @@ Disable AMP is a userscript that disables [Accelerated mobile pages](https://en. #### Filtragem HTTPS -To block ads and trackers on most websites and in most apps, AdGuard needs to filter their HTTPS traffic. [Read more about HTTPS filtering](/general/https-filtering/what-is-https-filtering) +To block ads and trackers on most websites and in most apps, AdGuard needs to filter their HTTPS traffic. [Leia mais sobre filtragem HTTPS](/general/https-filtering/what-is-https-filtering) ##### Security certificates To manage encrypted traffic, AdGuard installs its CA certificate on your device. It's safe: the traffic is filtered locally and AdGuard verifies the security of the connection. -On older versions of Android, the certificate is installed automatically. On Android 11 and later, you need to install it manually. [Installation instructions](/adguard-for-android/solving-problems/manual-certificate/) +On older versions of Android, the certificate is installed automatically. On Android 11 and later, you need to install it manually. [Instruções de instalação](/adguard-for-android/solving-problems/manual-certificate/) -The CA certificate in the user store is enough to filter HTTPS traffic in browsers and some apps. However, there are apps that only trust certificates from the system store. To filter HTTPS traffic there, you need to install AdGuard's CA certificate into the system store. [Instructions](/adguard-for-android/solving-problems/https-certificate-for-rooted/) +The CA certificate in the user store is enough to filter HTTPS traffic in browsers and some apps. However, there are apps that only trust certificates from the system store. To filter HTTPS traffic there, you need to install AdGuard's CA certificate into the system store. [Instruções](/adguard-for-android/solving-problems/https-certificate-for-rooted/) ##### HTTPS-filtered apps @@ -101,7 +101,7 @@ This section contains the list of apps for which AdGuard filters HTTPS traffic. This setting allows you to manage websites for which AdGuard should filter HTTPS traffic. -HTTPS filtering allows AdGuard to filter the content of requests and responses, but we never collect or store this data. However, to increase security, we [exclude websites that contain potentially sensitive information from HTTPS filtering](/general/https-filtering/what-is-https-filtering/#financial-websites-and-websites-with-sensitive-personal-data). +HTTPS filtering allows AdGuard to filter the content of requests and responses, but we never collect or store this data. No entanto, para aumentar a segurança, [excluímos sites que contêm informações potencialmente confidenciais da filtragem HTTPS](/general/https-filtering/what-is-https-filtering/#financial-websites-and-websites-with-sensitive-personal-data). You can also add websites that you consider necessary to exclusions by selecting one of the modes: @@ -112,7 +112,7 @@ By default, we also do not filter websites with Extended Validation (EV) certifi #### Proxy -You can set up AdGuard to route all your device's traffic through your proxy server. [How to set up an outbound proxy](/adguard-for-android/solving-problems/outbound-proxy) +You can set up AdGuard to route all your device's traffic through your proxy server. [Como configurar um proxy de saída](/adguard-for-android/solving-problems/outbound-proxy) In this section, you can also set up a third-party VPN to work with AdGuard, if your VPN provider allows it. @@ -126,7 +126,7 @@ This section allows you to select the traffic filtering method. :::note -The _Local VPN_ mode doesn't allow AdGuard to be used simultaneously with other VPNs. To use another VPN with AdGuard, you need to reconfigure it to work in proxy mode and set up an outbound proxy in AdGuard. For AdGuard VPN, this is done automatically with the help of the [_Integrated mode_](/adguard-for-android/features/integration-with-vpn). +The _Local VPN_ mode doesn't allow AdGuard to be used simultaneously with other VPNs. To use another VPN with AdGuard, you need to reconfigure it to work in proxy mode and set up an outbound proxy in AdGuard. Para AdGuard VPN, isso é feito automaticamente com a ajuda do [_modo integrado_](/adguard-for-android/features/integration-with-vpn). ::: @@ -144,7 +144,7 @@ Please note that DNS filtering will still be active in _Automatic proxy_ routing In this section, you can find information about your license and manage it: -- Buy an AdGuard license to activate [the full version's features](/adguard-for-android/features/free-vs-full) +- Compre uma licença do AdGuard para ativar [os recursos da versão completa](/adguard-for-android/features/free-vs-full) - Log in to your AdGuard account or enter the activation code to activate your license - Sign up to activate your 14-day trial period. The activation code can be used on different devices and platforms - Refresh the license status from the three-dots menu (⋮) @@ -161,12 +161,12 @@ Use this section if you have any questions or suggestions regarding AdGuard for If you notice a missed ad, please report it via _Report incorrect blocking_. -For unexpected app behavior, select _Report a bug_. If possible, describe your problem in detail and add app logs. [How to describe an issue](/guides/report-bugs/#how-to-describe-a-problem) +For unexpected app behavior, select _Report a bug_. If possible, describe your problem in detail and add app logs. [Como descrever um problema](/guides/report-bugs/#how-to-describe-a-problem) For your suggestions, use _Request a feature_. :::note -GitHub is an alternative way to report bugs and suggest new features. [Instructions and repository links](/guides/report-bugs/#adguard-for-android) +GitHub is an alternative way to report bugs and suggest new features. [Instruções e links de repositório](/guides/report-bugs/#adguard-for-android) ::: diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md index 580579a1fc4..5447ef5262e 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md @@ -35,7 +35,7 @@ Este artigo é sobre o AdGuard para iOS, um bloqueador de anúncios multifuncion - [Outros recursos](/adguard-for-ios/features/other-features.md) - General settings: theme, settings and statistics reset, auto-update, inverting the allowlist, and advanced mode. + Modo geral: tema, configurações e estatísticas, atualização automática, inversão da lista de permissões e modo avançado. - [Compatibilidade com AdGuard VPN](/adguard-for-ios/features/compatibility-with-adguard-vpn.md) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md index 2d278b13005..8cf5cb31d48 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md @@ -27,7 +27,7 @@ Este artigo é sobre o AdGuard para Mac, um bloqueador de anúncios multifuncion - [Modo invisível](/adguard-for-mac/features/stealth.md) - Settings to block cookies, UTM tags, and online analytics that collect user information + Configurações de bloqueio cookies, tags UTM e análises online que coletam informações do usuário - [Segurança](/adguard-for-mac/features/security.md) @@ -35,7 +35,7 @@ Este artigo é sobre o AdGuard para Mac, um bloqueador de anúncios multifuncion - [Assistente do navegador](/adguard-for-mac/features/browser-assistant.md) - An extension that complements the desktop app and allows you to manage filtering from your browser + Uma extensão que complementa o aplicativo de computador e permite que você gerencie a filtragem do seu navegador - [Extensões](/adguard-for-mac/features/extensions.md) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-mac/features/stealth.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-mac/features/stealth.md index 59afe4a1e12..70686e4a035 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-mac/features/stealth.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-mac/features/stealth.md @@ -13,4 +13,4 @@ Este artigo é sobre o AdGuard para Mac, um bloqueador de anúncios multifuncion ![Stealth Mode](https://cdn.adtidy.org/content/kb/ad_blocker/mac/tracking_protection.png) -_Tracking protection_ (formerly Stealth Mode) safeguards your privacy by deleting cookies, UTM tags, online counters, and analytics systems. It prevents websites from collecting your IP address, device and browser parameters, search queries, and personal information. [Learn more about Tracking protection settings](/general/stealth-mode) +_Tracking protection_ (formerly Stealth Mode) safeguards your privacy by deleting cookies, UTM tags, online counters, and analytics systems. It prevents websites from collecting your IP address, device and browser parameters, search queries, and personal information. [Saiba mais sobre as configurações do Modo Oculto](/general/stealth-mode) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/adguard-for-windows-8.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/adguard-for-windows-8.md index b62a5715074..232e8d4f2a7 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/adguard-for-windows-8.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/adguard-for-windows-8.md @@ -15,19 +15,19 @@ AdGuard para Windows é uma ferramenta fácil de usar que bloqueia banners, pop- 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. -## [Protection](/adguard-for-windows-8/protection/) +## [Proteção](/adguard-for-windows-8/protection/) Settings to configure _Ad blocking_, _Tracking protection_, _DNS protection_, _Annoyances blocking_, _Browsing security_, _Parental control_, and _Extensions_. -## [Statistics](/adguard-for-windows-8/statistics/) +## [Estatísticas](/adguard-for-windows-8/statistics/) Detailed information about blocked ads, trackers, and data usage. -## [App management](/adguard-for-windows-8/app-management/) +## [Gerenciamento de aplicativos](/adguard-for-windows-8/app-management/) Settings to customize traffic filtering and routing for each app and browser. -## [Settings](/adguard-for-windows-8/settings/) +## [Configurações](/adguard-for-windows-8/settings/) Options to select language and theme, view legal documents, check license information, and contact support. Advanced settings and network settings also live there. diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/ad-blocking.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/ad-blocking.md index 908f4a54b84..78213d6f436 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/ad-blocking.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/ad-blocking.md @@ -9,14 +9,14 @@ This article describes AdGuard for Windows v8.0, a comprehensive ad blocker that ::: -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). +The _Ad blocking_ section is responsible for removing ads from the websites you visit and from the apps installed on your device. Para filtrar banners, pop-ups, rastreadores e outros elementos intrusivos, o AdGuard depende de filtros — conjuntos de regras escritas em uma [sintaxe especial](/general/ad-filtering/create-own-filters). Se você quiser saber mais sobre como eles funcionam, leia nosso [artigo sobre filtros](/general/ad-filtering/how-ad-blocking-works). ![Ad blocking](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/ad_blocking.png) Aqui você pode: - enable basic protection, -- block [search ads and self-promotion](/general/ad-filtering/search-ads), +- bloquear [anúncios de pesquisa e autopromoção](/general/ad-filtering/search-ads), - desativar anúncios no menu Iniciar do Windows 11, - enable automatic activation of language-specific filters - manage user rules. diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/browsing-security.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/browsing-security.md index 94fdb8ee313..bc65afe6027 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/browsing-security.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/browsing-security.md @@ -15,7 +15,7 @@ While AdGuard for Windows is not an antivirus, it does provide essential securit It won’t stop a virus that is already being downloaded, and it won’t remove existing malware. But it will block access to websites that are marked as unsafe, helping you avoid threats in the first place. -For more details about how this protection works, see our article [Phishing and malware protection](/general/browsing-security). +Para mais detalhes sobre como esta proteção funciona, veja nosso artigo [Proteção contra phishing e malware](/general/browsing-security). ![Browsing security](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/browsing.png) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/extensions.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/extensions.md index 34f4fe02a3e..8fb02d3bc67 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/extensions.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/extensions.md @@ -9,7 +9,7 @@ This article describes AdGuard for Windows v8.0, a comprehensive ad blocker that ::: -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. +O AdGuard pode estender a funcionalidade do site atuando como um [gerenciador de userscript](/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) @@ -28,7 +28,7 @@ AdGuard comes with four pre-installed userscripts: ### AdGuard Assistant (Beta) -AdGuard Assistant is the legacy version of Assistant, which you can use if the [new Assistant](/adguard-for-windows/browser-assistant.md) is not available for your browser. As the name suggests, it helps you manage basic AdGuard settings directly from your browser without opening the app. +O Assistente do navegador é a versão legada do Assistente, que você pode usar se o [novo Assistente](/adguard-for-windows/browser-assistant.md) não estiver disponível para o seu navegador. As the name suggests, it helps you manage basic AdGuard settings directly from your browser without opening the app. AdGuard Assistant works with all browsers compatible with Microsoft Windows. It will not appear on websites excluded from filtering or on certain pages where it could cause display issues. diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/protection.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/protection.md index 70148586c27..2fb5587746a 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/protection.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/protection.md @@ -13,16 +13,16 @@ This article describes AdGuard for Windows v8.0, a comprehensive ad blocker that 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. -[Ad blocking](/adguard-for-windows-8/protection/ad-blocking) +[Bloqueio de anúncios](/adguard-for-windows-8/protection/ad-blocking) -[Tracking protection](/adguard-for-windows-8/protection/tracking-protection) +[Proteção contra rastreamento](/adguard-for-windows-8/protection/tracking-protection) -[Annoyance blocking](/adguard-for-windows-8/protection/annoyance-blocking) +[Bloqueio de elementos irritantes](/adguard-for-windows-8/protection/annoyance-blocking) -[DNS protection](/adguard-for-windows-8/protection/dns-protection) +[Proteção de DNS](/adguard-for-windows-8/protection/dns-protection) -[Browsing security](/adguard-for-windows-8/protection/browsing-security) +[Segurança da navegação](/adguard-for-windows-8/protection/browsing-security) -[Parental control](/adguard-for-windows-8/protection/parental-control) +[Controle parental](/adguard-for-windows-8/protection/parental-control) -[Extensions](/adguard-for-windows-8/protection/extensions) +[Extensões](/adguard-for-windows-8/protection/extensions) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/tracking-protection.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/tracking-protection.md index 1a438e5cca3..6f9038356db 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/tracking-protection.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/protection/tracking-protection.md @@ -67,7 +67,7 @@ With this option, you can set a time limit (in minutes) after which all third-pa :::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). +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. Se você deseja bloquear apenas cookies de rastreamento, use o [_Filtro de proteção contra rastreamento do AdGuard_](/general/ad-filtering/filter-policy/#tracking-protection-filter). ::: diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/app-settings.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/app-settings.md index 63cf8114bf1..6a2e188e55a 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/app-settings.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/app-settings.md @@ -17,10 +17,10 @@ If you wish, you can agree to send anonymized app usage data to help us improve In case of issues, you can change the logging level to create detailed logs for the support team. -In [_Filter editor_](/adguard-for-windows-8/settings/app-settings/filter-editor.md), you can add your own filtering rules or import ready-to-use filters. +No [_Editor de filtragem_](/adguard-for-windows-8/settings/app-settings/filter-editor.md), você pode adicionar suas próprias regras de filtragem ou importar filtros prontos para uso. -[_Network_ settings](/adguard-for-windows-8/settings/app-settings/network-settings.md) include all options related to network filtering and how AdGuard interacts with your system’s network. +[_Configurações_ de rede](/adguard-for-windows-8/settings/app-settings/network-settings.md) incluem todas as opções relacionadas à filtragem de rede e como o AdGuard interage com a rede do seu sistema. -[_Advanced_](/adguard-for-windows-8/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. +As configurações [_Avançadas_](/adguard-for-windows-8/settings/app-settings/advanced-settings.md) destinam-se a usuários experientes. 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) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 2211c84aaeb..b860bda9e8e 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/settings.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/settings.md index 166c71a3589..de69c0bdb47 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/settings.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/settings.md @@ -13,18 +13,18 @@ There are other useful AdGuard options that shouldn’t go unnoticed in this art ![Settings](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/setting.png) -## [App settings](/adguard-for-windows-8/settings/app-settings) +## [Configurações do aplicativo](/adguard-for-windows-8/settings/app-settings) Language and theme, update channel and interval, advanced options for experienced users, and a filter editor to quickly create custom rules. -## [License](/adguard-for-windows-8/settings/license) +## [Licença](/adguard-for-windows-8/settings/license) Information about license type, number of available devices, and activation code, with options to refresh or reset license and bind it to your AdGuard account. -## [Support](/adguard-for-windows-8/settings/support) +## [Suporte](/adguard-for-windows-8/settings/support) FAQ and support form, tools to report missed ads and request new features, possibility to rate the app, share feedback, and access AdGuard social networks. -## [About](/adguard-for-windows-8/settings/about) +## [Sobre](/adguard-for-windows-8/settings/about) Details about app version and libraries, as well as links to legal documents. diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 10cd3af8150..7abfe814768 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [Mais informações](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Pronto! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/adguard-for-windows.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/adguard-for-windows.md index 05dbe000015..c1b998bb326 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/adguard-for-windows.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/adguard-for-windows.md @@ -19,7 +19,7 @@ Este artigo aborda o AdGuard para Windows, um bloqueador de anúncios multifunci - [Assistente de navegador](/adguard-for-windows/browser-assistant.md) - An extension that complements the desktop app and allows you to manage filtering from your browser + Uma extensão que complementa o aplicativo de computador e permite que você gerencie a filtragem do seu navegador - [Resolvendo problemas](/adguard-for-windows/solving-problems/solving-problems.md) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/features/features.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/features/features.md index ea48e89a1f2..19653219017 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/features/features.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/features/features.md @@ -27,4 +27,4 @@ Este artigo aborda o AdGuard para Windows, um bloqueador de anúncios multifunci - [Outros recursos](/adguard-for-windows/features/others/) - Support, license management, tray menu options, app version and updates + Suporte, gerenciamento de licença, opções do menu de bandeja, versão do aplicativo e atualizações diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 23859d3cce0..2bb02447249 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ Neste módulo você pode selecionar a caixa de verificação _Usar AdGuard como Por fim, há uma seção com configurações de proxy. Lá você pode especificar qual servidor proxy o AdGuard deve usar para atualizar filtros, obter novas versões e assim por diante. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index 778b0bcf1cd..bae2188f5bf 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -13,11 +13,11 @@ _Configurações_ é a seção que requer mais atenção. É aqui que você pode ### General settings -Here you can set the language and theme (Dark or Light), enable AdGuard launching at system start-up and silent automatic updates, choose the update channel and filter update check interval. Also Settings is the place to go if AdGuard for Windows is not working properly and the support team asked you to [collect _Debug logs_](/adguard-for-windows/solving-problems/adguard-logs.md). +Here you can set the language and theme (Dark or Light), enable AdGuard launching at system start-up and silent automatic updates, choose the update channel and filter update check interval. Além disso, você pode recorrer às configurações se o AdGuard para Windows não estiver funcionando corretamente e o Suporte ao cliente solicitar que você [colete _Logs de depuração_](/adguard-for-windows/solving-problems/adguard-logs.md). ![Settings \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/general_settings.png) -At the very bottom of the screen you will find _Advanced Settings_. Changing some of them mindlessly may potentially cause problems with AdGuard’s performance, break the Internet connection or compromise your security and privacy. That’s why we suggest you open this section only if you are sure of what you are doing or our support team has asked you about it. If you want to know what can be set up in _Advanced Settings_, read the [dedicated article](/adguard-for-windows/solving-problems/low-level-settings.md). +At the very bottom of the screen you will find _Advanced Settings_. Changing some of them mindlessly may potentially cause problems with AdGuard’s performance, break the Internet connection or compromise your security and privacy. That’s why we suggest you open this section only if you are sure of what you are doing or our support team has asked you about it. Se você quiser saber o que pode ser configurado em _Configurações avançadas_, leia o [nosso artigo](/adguard-for-windows/solving-problems/low-level-settings.md). ![Advanced Settings \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/advanced_settings.png) @@ -44,17 +44,13 @@ Antes de começar a escrever manualmente suas próprias regras, leia nosso [guia Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - -To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). +Para saber tudo sobre o Modo Sigiloso e suas diversas opções, [leia este artigo](/general/stealth-mode). ### Segurança da navegação -Browsing security gives strong protection against malicious and phishing websites. No, AdGuard for Windows is not an antivirus. It will neither stop the download of a virus when it’s already started, nor delete the already existing ones. But it will warn you if you’re about to proceed to a website whose domain has been added to our “untrusted sites” database, or to download a file from such website. You can find more information about how this module works in the [dedicated article](/general/browsing-security). +Browsing security gives strong protection against malicious and phishing websites. No, AdGuard for Windows is not an antivirus. It will neither stop the download of a virus when it’s already started, nor delete the already existing ones. But it will warn you if you’re about to proceed to a website whose domain has been added to our “untrusted sites” database, or to download a file from such website. Você pode encontrar mais informações sobre como este módulo funciona no [nosso artigo](/general/browsing-security). In this module, you can: @@ -64,7 +60,7 @@ In this module, you can: ![Browsing security \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/browsing_security.png) -In case you want to learn more about Browsing security, read [this article](/general/browsing-security). +Caso você queira saber mais sobre segurança de navegação, leia [nosso artigo](/general/browsing-security). ### DNS Protection @@ -97,4 +93,4 @@ In the _Parental control_ module you can enable the _Safe search_ and manage the ![Browser Assistant \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/browser_assistant.png) -From this tab you can easily proceed to install AdGuard Browser Assistant, which primary function is to manage filtering directly from the browser. We explained more about how to work with it and what to do if there is no Browser Assistant for your browser in the [separate article](/adguard-for-windows/browser-assistant.md). +From this tab you can easily proceed to install AdGuard Browser Assistant, which primary function is to manage filtering directly from the browser. Explicamos mais sobre como trabalhar com ele e o que fazer se não houver um Assistente de Navegador para o seu navegador no [artigo separado](/adguard-for-windows/browser-assistant.md). diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 015afe010b8..a78efa40912 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` será convertida para -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` Esta opção só é aplicada quando a opção do modo Stealth *Proteger de DPI* está habilitada. diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 10cb00f6e9f..882eff7851e 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [Mais informações](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Pronto! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/adguard-mini-for-mac.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/adguard-mini-for-mac.md index d7704976ae4..b0411fe9a8c 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/adguard-mini-for-mac.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/adguard-mini-for-mac.md @@ -9,20 +9,20 @@ This page is about AdGuard Mini for Mac, which safeguards only your Safari brows ::: -AdGuard Mini for Mac (formerly AdGuard for Safari) was designed to conform to Apple’s restrictions for ad blocking browser extensions. Although it can’t be compared to our desktop ad blocking apps, it’s free and can protect you from ads, trackers, phishing, and malicious websites. +AdGuard Mini for Mac (formerly AdGuard for Safari) was designed to conform to Apple’s restrictions for ad blocking browser extensions. Embora não possa ser comparado aos nossos aplicativos de bloqueio de anúncios para desktop, ele é gratuito e pode protegê-lo contra anúncios, rastreadores, phishing e sites maliciosos. -- [Features](/adguard-mini-for-mac/features/features.md) +- [Recursos](/adguard-mini-for-mac/features/features.md) Main features and settings available in AdGuard Mini for Mac -- [Installation](/adguard-mini-for-mac/installation.md) +- [Instalação](/adguard-mini-for-mac/installation.md) Installation, removal, and system requirements for AdGuard Mini for Mac -- [Safari extensions](/adguard-mini-for-mac/extensions.md) +- [Extensões para Safari](/adguard-mini-for-mac/extensions.md) Mechanisms that enable content blocking and add functionality to the Safari web browser -- [Solving problems](/adguard-mini-for-mac/solving-problems/solving-problems.md) +- [Resolvendo problemas](/adguard-mini-for-mac/solving-problems/solving-problems.md) Problemas conhecidos e possíveis soluções diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/extensions.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/extensions.md index 3edeb4e35a6..d466848eee6 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/extensions.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/extensions.md @@ -52,7 +52,7 @@ User rules and allowlist rules are included in every extension. _AdGuard for Safari_ activates the AdGuard icon next to the search bar. It’s useful if you want to quickly set up protection for a specific website or block ads manually. -_AdGuard for Safari_ extension also contains advanced rules that aren’t converted to the format supported by Safari. These include [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [extended CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets), which allow AdGuard to block complex ads, such as those on YouTube. +_AdGuard for Safari_ extension also contains advanced rules that aren’t converted to the format supported by Safari. Isso inclui [regras CSS](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [seletores CSS Estendidos](/general/ad-filtering/create-own-filters#extended-css-selectors) e [scriptlets](/general/ad-filtering/create-own-filters#scriptlets), que permitem que o AdGuard bloqueie anúncios complexos, como aqueles no YouTube. ## Como gerenciar as extensões do Safari diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/about.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/about.md index bb82a2ed23f..932abc9caf8 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/about.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/about.md @@ -19,6 +19,6 @@ You can also find the links to: :::note Lembrete -AdGuard Mini for Mac can be downloaded for free [from the App Store](https://agrd.io/mini_mac). A detailed setup instruction is available in [this Knowledge Base article](/adguard-mini-for-mac/installation/). +AdGuard Mini for Mac can be downloaded for free [from the App Store](https://agrd.io/mini_mac). Uma instrução de configuração detalhada está disponível neste artigo da Base de conhecimento (/adguard-mini-for-mac/installation/). ::: diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/advanced-blocking.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/advanced-blocking.md index bbf9454367c..cd067660e44 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/advanced-blocking.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/advanced-blocking.md @@ -11,6 +11,6 @@ Here you can turn on the _AdGuard Extra_ userscript — if there’s a website w :::note -_AdGuard Extra_ is a feature of the [full version](/adguard-mini-for-mac/features/full-version.md). +_AdGuard Extra_ é um recurso da [versão completa](/adguard-mini-for-mac/features/full-version.md). ::: diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index 9369ea7587a..3c0995b2c18 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -3,34 +3,34 @@ title: Features sidebar_position: 1 --- -- [Safari protection](/adguard-mini-for-mac/features/safari-protection.md) +- [Proteção do Safari](/adguard-mini-for-mac/features/safari-protection.md) Core filtering feature with customizable options -- [Advanced blocking](/adguard-mini-for-mac/features/advanced-blocking.md) +- [Bloqueio avançado](/adguard-mini-for-mac/features/advanced-blocking.md) Unlocks stronger filtering capabilities -- [User rules](/adguard-mini-for-mac/features/rules.md) +- [Regras de usuário](/adguard-mini-for-mac/features/rules.md) Regras de filtragem personalizadas para ajustar o bloqueio de anúncios -- [Settings](/adguard-mini-for-mac/features/settings/settings.md) +- [Configurações](/adguard-mini-for-mac/features/settings/settings.md) Various options that help you configure the app and filtering -- [Support](/adguard-mini-for-mac/features/support.md) +- [Suporte](/adguard-mini-for-mac/features/support.md) Helpful options for when you have a question or encountered a problem -- [About](/adguard-mini-for-mac/features/about.md) +- [Sobre](/adguard-mini-for-mac/features/about.md) Info about the app’s current version and a list of helpful links -- [Safari toolbar menu](/adguard-mini-for-mac/features/toolbar-menu.md) +- [Menu da barra de ferramentas Safari](/adguard-mini-for-mac/features/toolbar-menu.md) A handy menu in the Safari toolbar -- [Full version](/adguard-mini-for-mac/features/full-version.md) +- [Versão completa](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/safari-extensions.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/safari-extensions.md index 7200064afc6..2a1110aaf3b 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/safari-extensions.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/safari-extensions.md @@ -47,7 +47,7 @@ O _AdGuard Outros_ contém filtros com várias funções. Por exemplo, possui um :::note Isenção de responsabilidade -We don’t have any “acceptable ads” paid by advertisers. Instead, we provide users with an option to see [search ads and websites’ self-promotion](/general/ad-filtering/search-ads). +We don’t have any “acceptable ads” paid by advertisers. Em vez disso, oferecemos aos usuários a opção de ver [anúncios de pesquisa e autopromoção de sites](/general/ad-filtering/search-ads). ::: diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/settings.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/settings.md index 37ca9a61db4..72feddbff22 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/settings.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/settings.md @@ -9,11 +9,11 @@ In _Settings_, you can set up basic things like filters, filter updates, launchi The main two sections are: -- [Filters](/adguard-mini-for-mac/features/settings/filters.md) +- [Filtros](/adguard-mini-for-mac/features/settings/filters.md) Different filters that allow you to customize your ad blocking experience -- [Safari extensions](/adguard-mini-for-mac/features/settings/safari-extensions.md) +- [Extensões para Safari](/adguard-mini-for-mac/features/settings/safari-extensions.md) Info on the current state of content blockers — how many rules and filters are enabled for each of them diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/solving-problems.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/solving-problems.md index 679eba775b4..bd5d1fdfa1b 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/solving-problems.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/solving-problems.md @@ -11,8 +11,8 @@ This article is about AdGuard Mini for Mac, which safeguards only your Safari br Here are some problems you may encounter and workarounds, as well as guides and instructions you may need: -- [Rule limit issues](/adguard-mini-for-mac/solving-problems/rule-limit.md) -- [Filtering doesn’t work and ads aren’t blocked](/adguard-mini-for-mac/solving-problems/ads-not-blocked.md) -- [Filtering doesn’t stop when AdGuard Mini is disabled](/adguard-mini-for-mac/solving-problems/filters-after-disable.md) -- [How to collect logs in AdGuard Mini for Mac](/adguard-mini-for-mac/solving-problems/logs.md) -- [AdGuard Mini doesn’t work in private tabs on macOS Sonoma](/adguard-mini-for-mac/solving-problems/private-sonoma.md) +- [Problemas de limite de regra](/adguard-mini-for-mac/solving-problems/rule-limit.md) +- [A filtragem não funciona e os anúncios não estão bloqueados](/adguard-mini-for-mac/solving-problems/ads-not-blocked.md) +- [A filtragem não para quando o AdGuard Mini está desativado](/adguard-mini-for-mac/solving-problems/filters-after-disable.md) +- [Como coletar registros no AdGuard Mini para Mac](/adguard-mini-for-mac/solving-problems/logs.md) +- [O AdGuard Mini não funciona em abas privadas no macOS Sonoma](/adguard-mini-for-mac/solving-problems/private-sonoma.md) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/extensions.md index ba33704c7a8..f7c73ca5aa4 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/extensions.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/extensions.md @@ -61,7 +61,7 @@ SponsorBlock skips sponsored segments in YouTube videos. It saves time by jumpin :::info -This userscript runs exclusively on our desktop applications, AdGuard for Windows and AdGuard for Mac. +Este script de usuário funciona exclusivamente em nossos aplicativos para desktop, AdGuard para Windows e AdGuard para Mac. ::: diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/how-to-install.md index e7e6b5e31b6..42d55205011 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md index ac8fa4a92f3..cc8918970db 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md @@ -35,7 +35,7 @@ This article is about AdGuard for iOS, a multifunctional ad blocker that protect - [Other features](/adguard-for-ios/features/other-features.md) - General settings: theme, settings and statistics reset, auto-update, inverting the allowlist, and advanced mode. + Definições gerais: tema, reposição de definições e estatísticas, atualização automática, inversão da lista de permissões e modo avançado. - [Compatibility with AdGuard VPN](/adguard-for-ios/features/compatibility-with-adguard-vpn.md) diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 4291a773b47..6640b2382bf 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index c3e4b5dd852..1dd96d2e10a 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 44019e62225..a50174753ee 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 708d37bed3a..fffa43f1b28 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/pt/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/pt/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/pt/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 3b49b357f65..81b84e96389 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Terminat! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 9f66682d0f4..e430f99fa46 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ Modulul _Rețea_ este dedicat filtrării rețelei, și aici veți găsi opțiuni În cele din urmă, există o secțiune dedicată setărilor proxy. Acolo puteți specifica ce server proxy ar trebui să folosească AdGuard pentru a actualiza filtrele, a obține versiunile noi și așa mai departe. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index 4df8fbab309..5b26bca4070 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ In the Ad blocking module you can: Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Securitate la navigare diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 1192e66c984..0521f2fdd8f 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` Această opțiune este aplicată doar atunci când opțiunea *Protejați de DPI* în modul Stealth este activată. diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index bda8a426ab4..09f8386a6b7 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Terminat! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/ro/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/ro/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/ro/docusaurus-plugin-content-docs/current/general/how-to-install.md index 7fa5a598e03..098c024bd64 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- În funcție de care aplicație AdGuard sau extensie de browser doriți să instalați, urmați unul dintre aceste linkuri pentru a găsi articolul relevant: diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md index 2d7ef95e4ab..b53f9158702 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md @@ -11,7 +11,7 @@ sidebar_position: 1 - [Функции](/adguard-browser-extension/features) - Main features and settings available in AdGuard Browser Extension + Основные функции и настройки, доступные в Браузерном расширении AdGuard - [Доступность](/adguard-browser-extension/availability) @@ -23,7 +23,7 @@ sidebar_position: 1 - [Совместимость с автономным приложением](/adguard-browser-extension/compatibility) - Compatibility of AdGuard Browser Extension with the AdGuard desktop apps + Совместимость Браузерного расширения AdGuard с десктопными приложениями AdGuard - [Браузерное расширение AdGuard для Chrome MV3](/adguard-browser-extension/mv3-version/) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md index bedc1116f04..91e7a79daa9 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md @@ -9,18 +9,18 @@ sidebar_position: 1 ::: -- [Main menu](/adguard-browser-extension/features/main-menu.md) +- [Главное меню](/adguard-browser-extension/features/main-menu.md) - The main popup from which you can access settings, filtering log and statistics, and report problems + Основное всплывающее окно, из которого вы можете получить доступ к настройкам, журналу фильтрации и статистике, а также сообщить о проблемах -- [Filters](/adguard-browser-extension/features/filters.md) +- [Фильтры](/adguard-browser-extension/features/filters.md) Фильтры и пользовательские правила для настройки блокировки рекламы -- [Tracking protection (Stealth Mode)](/adguard-browser-extension/features/stealth-mode.md) +- [Защита от трекинга](/adguard-browser-extension/features/stealth-mode.md) - Settings to block cookies, UTM tags, and online analytics that collect user information + Настройки блокировки файлов куки, UTM-меток и онлайн-аналитики, собирающей информацию о пользователях -- [Other features and options](/adguard-browser-extension/features/other-features.md) +- [Другие функции и опции](/adguard-browser-extension/features/other-features.md) - General and additional settings, links to privacy documents and GitHub repository + Основные и дополнительные настройки, ссылки на юридические документы и репозиторий на GitHub diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/stealth-mode.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/stealth-mode.md index e59c067b28f..5ccc72178da 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/stealth-mode.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/stealth-mode.md @@ -1,5 +1,5 @@ --- -title: Tracking protection (formerly Stealth Mode) +title: Защита от трекинга (ранее Антитрекинг) sidebar_position: 3 --- @@ -9,20 +9,20 @@ sidebar_position: 3 ::: -The purpose of _Tracking protection_ is to safeguard your sensitive personal data from online trackers and fraudsters. There are slight differences in the tracking protection features between Chromium-based browsers, which support MV3, and non-Chromium browsers, which support MV2. +Цель _Защиты от трекинга_ — защитить ваши конфиденциальные личные данные от онлайн-трекеров и мошенников. Существуют небольшие различия в функциях защиты от трекинга между браузерами на базе Chromium, которые поддерживают MV3, и не-Chromium браузерами, которые поддерживают MV2. -![Tracking protection in Chromium-based browsers \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_mv3_trackingProtection.png) +![Защита от трекинга в браузерах на основе Chromium \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_mv3_trackingProtection.png) -_Tracking protection_ in Chromium-based browsers +_Защита от трекинга_ в браузерах на базе Chromium -![Tracking protection in non-Chromium browsers \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_mv2_trackingProtection.png) +![Защита от трекинга в браузерах, не основанных на Chromium \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_mv2_trackingProtection.png) -_Tracking protection_ in non-Chromium browsers +_Защита от трекинга_ в не-Chromium браузерах -_Tracking protection_ features prevent websites from seeing the search query you used to find them on the Internet, automatically delete third-party and website cookies, and more. A [separate article](/general/stealth-mode) is devoted to all these features. +Функции _Защиты от трекинга_ не позволяют сайтам видеть поисковые запросы, с помощью которых вы нашли их в интернете, автоматически удаляют сторонние куки и куки сайта. Всем этим функциям посвящена [отдельная статья](/general/stealth-mode). :::note -Browser extensions are limited to a specific browser and are subject to its technical restrictions. Therefore, they cannot offer all the tracking protection features available in full-fledged ad-blocking apps. +Браузерные расширения ограничены конкретным браузером и подвержены его техническим ограничениям. Поэтому они не могут предложить все функции защиты от трекинга, доступные в комплексных приложениях для блокировки рекламы. ::: diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md index d1e6bdd8101..9a9a9f17871 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md @@ -1,15 +1,15 @@ --- -title: Ad blocking issues on search websites in Opera +title: Проблемы с блокировкой рекламы на поисковых сайтах в браузере Opera sidebar_position: 3 --- -If AdGuard Browser Extension fails to block ads on search websites in Opera, either automatically or manually, it means that the extension does not have permission to access search page results. +Если Браузерное расширение AdGuard не блокирует рекламу на поисковых сайтах в Opera автоматически или при ручной настройке, значит у него нет разрешения на доступ к результатам поиска. -To grant the required permission: +Чтобы предоставить необходимое разрешение: -![Allow access to search page results](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/allow-access.png) +![Разрешить доступ к результатам поиска](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/allow-access.png) -1. Click the cube icon next to the address bar → _Manage extensions..._. -2. Find AdGuard AdBlocker in the list of installed extensions and tick the box next to _Allow access to search page results_. +1. Кликните по иконке куба рядом с адресной строкой → _Управление расширениями..._. +2. Найдите AdGuard Антибаннер в списке установленных расширений и поставьте галочку напротив _Разрешить доступ к результатам на странице поиска_. -Once this is done, ads on search websites will be blocked as expected. +После этого реклама на сайтах поисковых систем будет блокироваться корректно. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md index 7c4181abcbd..099fc25c12b 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md @@ -11,7 +11,7 @@ sidebar_position: 1 - [Защита Safari](/adguard-for-ios/features/safari-protection.md) - Available features and settings in the _Safari protection_ tab: _Filters_, _User rules_, and _Allowlist_ + Доступные функции и настройки во вкладке _Защита Safari_: _Фильтры_, _Пользовательские правила_ и _Белый список_ - [DNS-защита](/adguard-for-ios/features/dns-protection/) @@ -35,7 +35,7 @@ sidebar_position: 1 - [Другие функции](/adguard-for-ios/features/other-features.md) - General settings: theme, settings and statistics reset, auto-update, inverting the allowlist, and advanced mode. + Основные настройки: тема, сброс настроек и статистики, автообновление, инвертирование белого списка и расширенный режим. - [Совместимость с AdGuard VPN](/adguard-for-ios/features/compatibility-with-adguard-vpn.md) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md index ff8b97b7431..8c9d9cb14fa 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md @@ -27,7 +27,7 @@ sidebar_position: 1 - [Защита от трекинга](/adguard-for-mac/features/stealth.md) - Settings to block cookies, UTM tags, and online analytics that collect user information + Настройки блокировки файлов куки, UTM-меток и онлайн-аналитики, собирающей информацию о пользователях - [Безопасность](/adguard-for-mac/features/security.md) @@ -35,7 +35,7 @@ sidebar_position: 1 - [Браузерный помощник](/adguard-for-mac/features/browser-assistant.md) - An extension that complements the desktop app and allows you to manage filtering from your browser + Расширение, которое дополняет десктопное приложение и позволяет управлять фильтрацией из браузера - [Расширения](/adguard-for-mac/features/extensions.md) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index d02bd4f602d..7558a57f4ca 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ sidebar_position: 3 ## Использовать драйвер SockFilter -Включите эту опцию, чтобы использовать драйвер SockFilter, который помогает блокировать рекламу и трекеры в приложениях на Windows 8 и более поздних версиях. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -Если эта опция отключена, AdGuard переключится на более старый WFP-драйвер. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 3fdbc75bd72..1b6e2fcfa4a 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ TDI-драйвер — это устаревшая технология Windows, AdGuard уже считает TDI-драйвер устаревшим и планирует его полное удаление. +## Постоянное решение + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Временное решение Определённые изменения в реестре Windows могут заставить браузер перестать использовать AppContainer, в результате чего его процессы снова будут работать вне песочницы. Network Service прекращает использование стека WSK и переключается на сетевой путь, который виден TDI-драйверу. После этого AdGuard восстанавливает способность фильтровать трафик браузера. @@ -123,7 +131,3 @@ AdGuard уже считает TDI-драйвер устаревшим и пла Если такая опция есть, нажмите _Reload policies_. Готово! - -## Постоянное решение - -В будущих версиях мы планируем добавить поддержку драйвера SockFilter. Это решит проблему, устранив конфликты в стеке WFP. [Больше информации](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/adguard-for-windows.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/adguard-for-windows.md index ad85fb49119..852c4061b6a 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/adguard-for-windows.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/adguard-for-windows.md @@ -11,7 +11,7 @@ sidebar_position: 1 - [Функции](/adguard-for-windows/features/features.md) - Main features and settings available in AdGuard for Windows + Основные функции и настройки, доступные в AdGuard для Windows - [Установка](/adguard-for-windows/installation.md) @@ -19,7 +19,7 @@ sidebar_position: 1 - [Браузерный помощник](/adguard-for-windows/browser-assistant.md) - An extension that complements the desktop app and allows you to manage filtering from your browser + Расширение, которое дополняет десктопное приложение и позволяет управлять фильтрацией из браузера - [Решение проблем](/adguard-for-windows/solving-problems/solving-problems.md) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/features.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/features.md index 9a7a1feb554..db7ebd9be31 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/features.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/features.md @@ -11,7 +11,7 @@ sidebar_position: 1 - [Главный экран](/adguard-for-windows/features/home-screen/) - On the main screen you’ll find _Settings_, _Support_, _License_, and _About_, as well as statistics on blocked ads and trackers + На главном экране вы найдёте разделы _Настройки_, _Поддержка_, _Лицензия_ и _О программе_, а также статистику по заблокированной рекламе и трекерам - [Настройки](/adguard-for-windows/features/settings/) @@ -27,4 +27,4 @@ sidebar_position: 1 - [Другие функции](/adguard-for-windows/features/others/) - Support, license management, tray menu options, app version and updates + Поддержка, управление лицензиями, опции трей-меню, версии и обновления приложения diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index cb6b98101bb..825ac7a22f9 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ sidebar_position: 4 Наконец, есть раздел с настройками прокси. Там вы можете указать, какой прокси-сервер AdGuard должен использовать для обновления фильтров или получения новых версий. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index b7cca1952a2..270c7818d1f 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,17 +44,13 @@ sidebar_position: 2 Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - -To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). +[Больше о Защите от трекинга](/general/stealth-mode) ### Защита от фишинга -Browsing security gives strong protection against malicious and phishing websites. No, AdGuard for Windows is not an antivirus. It will neither stop the download of a virus when it’s already started, nor delete the already existing ones. But it will warn you if you’re about to proceed to a website whose domain has been added to our “untrusted sites” database, or to download a file from such website. You can find more information about how this module works in the [dedicated article](/general/browsing-security). +Browsing security gives strong protection against malicious and phishing websites. No, AdGuard for Windows is not an antivirus. It will neither stop the download of a virus when it’s already started, nor delete the already existing ones. But it will warn you if you’re about to proceed to a website whose domain has been added to our “untrusted sites” database, or to download a file from such website. [Как работает Защита от фишинга](/general/browsing-security) In this module, you can: @@ -64,7 +60,7 @@ In this module, you can: ![Browsing security \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/browsing_security.png) -In case you want to learn more about Browsing security, read [this article](/general/browsing-security). +[Больше о Защите от фишинга](/general/browsing-security) ### DNS Protection @@ -97,4 +93,4 @@ In the _Parental control_ module you can enable the _Safe search_ and manage the ![Browser Assistant \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/browser_assistant.png) -From this tab you can easily proceed to install AdGuard Browser Assistant, which primary function is to manage filtering directly from the browser. We explained more about how to work with it and what to do if there is no Browser Assistant for your browser in the [separate article](/adguard-for-windows/browser-assistant.md). +From this tab you can easily proceed to install AdGuard Browser Assistant, which primary function is to manage filtering directly from the browser. Подробнее о том, как с ним работать и что делать, если для вашего браузера нет Помощника, мы рассказали [в отдельной статье](/adguard-for-windows/browser-assistant.md). diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index a2e2ec51963..f1001cb4867 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` будет преобразовано в -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` Эта настройка применяется только в том случае, если в режиме Антитрекинг включён параметр *Защищать от DPI*. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index f51dbf9a497..2435dbfb14b 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ TDI-драйвер — это устаревшая технология Windows, AdGuard уже считает TDI-драйвер устаревшим и планирует его полное удаление. +## Постоянное решение + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Временное решение Определённые изменения в реестре Windows могут заставить браузер перестать использовать AppContainer, в результате чего его процессы снова будут работать вне песочницы. Network Service прекращает использование стека WSK и переключается на сетевой путь, который виден TDI-драйверу. После этого AdGuard восстанавливает способность фильтровать трафик браузера. @@ -136,7 +144,3 @@ You can revert these changes using the undo .reg files provided below. These fil Если такая опция есть, нажмите _Reload policies_. Готово! - -## Постоянное решение - -В будущих версиях мы планируем добавить поддержку драйвера SockFilter. Это решит проблему, устранив конфликты в стеке WFP. [Больше информации](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/ru/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/ru/docusaurus-plugin-content-docs/current/general/how-to-install.md index a6c4014b4d3..3a6f9237fcb 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: Как установить AdGuard -sidebar_position: 9 +sidebar_position: 10 --- В зависимости от того, какое приложение или браузерное расширение AdGuard вы хотите установить, перейдите по одной из этих ссылок и найдите соответствующую инструкцию: diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 2d9c4320c1a..8a69d19a031 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/sk/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/sk/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/sk/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 2d9c4320c1a..8a69d19a031 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/sl/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/sl/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/sl/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 2d9c4320c1a..8a69d19a031 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/sv/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/sv/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/sv/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 2d9c4320c1a..8a69d19a031 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/ta/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/ta/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/ta/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index a01a297324a..84e267a2473 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 5aca7a4ad0c..802eacd51bb 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Bu sebeple, TDI tabanlı trafik görünürlüğü giderek daha istikrarsız hâl AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Geçici çözüm Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Tamamlandı! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index d7168b75558..f04f81f8914 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use Son olarak, proxy ayarlarının bulunduğu bir bölüm vardır. Burada, filtreleri güncellemek, yeni sürümleri edinmek, vb. için AdGuard'ın hangi proxy sunucusunu kullanması gerektiğini belirleyebilirsiniz. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index c1fa9ff38a6..5c46c8bcfb5 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - _İzleme Koruması_ ayarlarını ihtiyacınıza göre düzenleyebilirsiniz. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![İzleme koruması özel özellikler \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Gezinti koruması diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index aa79aea0075..51b7abb01af 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` şuna dönüştürülecektir -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` Bu seçenek yalnızca *DPİ'den koru* Gizlilik Modu seçeneği etkinleştirildiğinde uygulanır. diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 9f2d7334ca1..8b2b717bf46 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Bu sebeple, TDI tabanlı trafik görünürlüğü giderek daha istikrarsız hâl AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Geçici çözüm Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Tamamlandı! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/tr/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/tr/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/tr/docusaurus-plugin-content-docs/current/general/how-to-install.md index 2a54efde143..26ff4e18315 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 2d9c4320c1a..8a69d19a031 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/uk/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/uk/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/uk/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 2d9c4320c1a..8a69d19a031 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/vi/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/vi/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/vi/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md index 0c9efcfd423..d3cb924646e 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md @@ -11,7 +11,7 @@ sidebar_position: 1 - [功能](/adguard-browser-extension/features) - Main features and settings available in AdGuard Browser Extension + AdGuard 浏览器扩展程序中的主要功能和设置 - [可用性](/adguard-browser-extension/availability) @@ -23,7 +23,7 @@ sidebar_position: 1 - [与独立应用程序的兼容性](/adguard-browser-extension/compatibility) - Compatibility of AdGuard Browser Extension with the AdGuard desktop apps + AdGuard 浏览器扩展与 AdGuard 桌面应用程序的兼容性 - [用于 Chrome Manifest 的 AdGuard 浏览器扩展](/adguard-browser-extension/mv3-version/) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/comparison-standalone.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/comparison-standalone.md index 272b744e3ea..3a8ea6b1837 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/comparison-standalone.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/comparison-standalone.md @@ -5,7 +5,7 @@ sidebar_position: 7 :::info -这篇文章是关于 AdGuard 浏览器扩展,它只能保护用户的浏览器。 要全面保护设备,请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock)。 +本文介绍的是 AdGuard 浏览器扩展,它仅保护用户的浏览器。 要全面保护设备,请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock)。 ::: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md index 5813d6c6819..225cb7758cd 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/features.md @@ -9,18 +9,18 @@ sidebar_position: 1 ::: -- [Main menu](/adguard-browser-extension/features/main-menu.md) +- [主菜单](/adguard-browser-extension/features/main-menu.md) - The main popup from which you can access settings, filtering log and statistics, and report problems + 用于访问设置、过滤日志和统计信息以及报告问题的主弹出窗口设置 -- [Filters](/adguard-browser-extension/features/filters.md) +- [过滤器](/adguard-browser-extension/features/filters.md) 过滤和用户规则以微调广告拦截。 -- [Tracking protection (Stealth Mode)](/adguard-browser-extension/features/stealth-mode.md) +- [跟踪保护(隐身模式)](/adguard-browser-extension/features/stealth-mode.md) - Settings to block cookies, UTM tags, and online analytics that collect user information + 用于拦截 Cookie、UTM 标签以及收集用户信息的在线分析工具的设置 -- [Other features and options](/adguard-browser-extension/features/other-features.md) +- [其他功能与选项](/adguard-browser-extension/features/other-features.md) - General and additional settings, links to privacy documents and GitHub repository + 常规和附加设置,以及指向隐私文档和 GitHub 仓库的链接 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/main-menu.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/main-menu.md index c6e988b6ff0..548ed8be6d2 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/main-menu.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/main-menu.md @@ -5,7 +5,7 @@ sidebar_position: 1 :::info -这篇文章是关于 AdGuard 浏览器扩展,它只能保护用户的浏览器。 要全面保护设备,请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock)。 +本文介绍的是 AdGuard 浏览器扩展,它仅保护用户的浏览器。 要全面保护设备,请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock)。 ::: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/other-features.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/other-features.md index 57ad63aaabb..bfa7be6d1a3 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/other-features.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/other-features.md @@ -5,7 +5,7 @@ sidebar_position: 4 :::info -这篇文章是关于 AdGuard 浏览器扩展,它只能保护用户的浏览器。 要全面保护设备,请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock)。 +本文介绍的是 AdGuard 浏览器扩展,它仅保护用户的浏览器。 要全面保护设备,请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock)。 ::: @@ -25,22 +25,22 @@ sidebar_position: 4 「附加设置」部分包含一系列与广告拦截过程和应用程序可用性有关的各种设置。 -![Additional settings \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/additional-settings.png) +![其他设置 \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/additional-settings.png) -From this tab, you can invert the allowlist and add the AdGuard item to the browser’s context menu. You can also enable the display of the number of blocked ads on the AdGuard icon and notifications about extension updates. Additionally, this section lets you enable notifications about the AdGuard app, open the _Filtering log_, clear the statistics of blocked ads and trackers, or reset the settings. +在此标签页中,您可以反转白名单,并将 AdGuard 项目添加到浏览器的上下文菜单中。 用户还可以启用 AdGuard 图标上显示被拦截广告数量以及扩展更新通知的功能。 此外,此部分还允许用户启用关于 AdGuard 应用的通知、打开「过滤日志」、清除已拦截广告和跟踪器的统计数据,或重置设置。 此外,用户可以选择发送应用规则的统计数据以帮助我们开发过滤器:触发哪些规则、在哪些网站上触发以及触发频率。 该选项默认为禁用,因为我们不会在未经同意的情况下收集用户数据。 但是,如果启用该功能,所有数据都将匿名发送。 -You can also choose to help us improve the extension by sending us anonymized usage data. This includes the names of the screens you interact with, the names of the buttons you click, and session identifiers. These insights help us understand where users run into friction, refine the experience, and make the extension faster and easier to use. The _Send anonymized usage data_ option is disabled by default. If you enable it, all data will be strictly anonymized and used only internally. It will never be shared with third parties. +您还可以选择通过向我们发送匿名使用数据来帮助我们改进扩展程序。 这包括您所交互的屏幕名称、您点击的按钮名称以及会话标识符。 这些信息帮助我们了解用户在哪里遇到困难,优化体验,并使扩展更快、更易于使用。 「匿名发送扩展使用数据」选项默认是禁用的。 如果您启用它,所有数据都将严格匿名,且仅用于内部。 绝不会与任何第三方共享。 :::note -The _Send anonymized usage data_ option can also be enabled on the post-installation page in Chromium-based browsers. +在基于 Chromium 的浏览器中,也可以在安装后页面上启用「发送匿名使用数据」选项。 ::: -## About {#about} +## 关于 {#about} -In the _About_ section, you can find info about the current version, links to the EULA and Privacy policy, and to the repository of the Browser extension on GitHub. +在「关于」部分中,用户可以找到有关当前版本的信息、EULA 和隐私政策的链接以及 GitHub 上浏览器扩展存储库的链接。 -![About \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_about.png) +![关于 \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_about.png) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/stealth-mode.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/stealth-mode.md index 29124003d2d..2ebf2ff8fbe 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/stealth-mode.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/stealth-mode.md @@ -1,5 +1,5 @@ --- -title: Tracking protection (formerly Stealth Mode) +title: 跟踪保护(隐身模式) sidebar_position: 3 --- @@ -9,20 +9,20 @@ sidebar_position: 3 ::: -The purpose of _Tracking protection_ is to safeguard your sensitive personal data from online trackers and fraudsters. There are slight differences in the tracking protection features between Chromium-based browsers, which support MV3, and non-Chromium browsers, which support MV2. +「跟踪防护」的目的是保护您的敏感个人数据免受在线跟踪器和欺诈者的侵害。 基于 Chromium(支持 MV3)和非 Chromium(支持 MV2)的浏览器在跟踪防护功能上存在细微差异。 -![Tracking protection in Chromium-based browsers \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_mv3_trackingProtection.png) +![基于 Chromium 的浏览器中的跟踪保护 \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_mv3_trackingProtection.png) -_Tracking protection_ in Chromium-based browsers +基于 Chromium 的浏览器中的「跟踪保护」 -![Tracking protection in non-Chromium browsers \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_mv2_trackingProtection.png) +![非 Chromium 浏览器中的跟踪保护 \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/ad_blocker_browser_extension_mv2_trackingProtection.png) -_Tracking protection_ in non-Chromium browsers +非 Chromium 浏览器中的「跟踪保护」 -_Tracking protection_ features prevent websites from seeing the search query you used to find them on the Internet, automatically delete third-party and website cookies, and more. A [separate article](/general/stealth-mode) is devoted to all these features. +「跟踪防护」功能可防止网站看到您在互联网上用来找到它们的搜索查询、自动删除第三方和网站 Cookie 等。 我们有一篇[文章](/general/stealth-mode)专门介绍这些功能。 :::note -Browser extensions are limited to a specific browser and are subject to its technical restrictions. Therefore, they cannot offer all the tracking protection features available in full-fledged ad-blocking apps. +浏览器扩展仅限于特定的浏览器,并受其技术限制的约束。 因此,它们无法提供完整的广告拦截应用所具备的全部跟踪防护功能。 ::: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md index 769988a50d5..1c56cc2a078 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md @@ -55,7 +55,7 @@ Manifest V3 对每个扩展的静态规则和正则表达式规则施加限制 **动态规则**:严格限制 **5,000** 个规则,其中包括最多 1,000 个正则表达式规则。 -If this limit is exceeded, only **5,000 converted rules** will be applied in the following order: first Allowlist, then User rules and finally Custom filters. +如果超过此限制,将仅应用 **5,000 条转换后的规则**,顺序如下:首先是「允许列表」,然后是「用户规则」,最后是「自定义过滤器」。 > **转换后的规则**是使用[声明性转换器][github-declarative-converter]转换为 \[DNR 格式]的规则。 > 在转换过程中,一些规则会覆盖其他规则(`$badfilter`),一些规则会合并(`$removeparam`),从而导致规则列表的顺序略有不同。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md index d1e6bdd8101..6510fa55025 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md @@ -9,7 +9,7 @@ To grant the required permission: ![Allow access to search page results](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/allow-access.png) -1. Click the cube icon next to the address bar → _Manage extensions..._. -2. Find AdGuard AdBlocker in the list of installed extensions and tick the box next to _Allow access to search page results_. +1. 点击地址栏旁边的立方体图标 →「管理扩展...」。 +2. 在已安装的扩展列表中找到 AdGuard 广告拦截程序,并勾选「允许访问搜索页面结果」旁边的复选框。 -Once this is done, ads on search websites will be blocked as expected. +完成后,搜索引擎网站上的广告将按预期被拦截。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md index 738620e4627..2f113881bb9 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md @@ -3,7 +3,7 @@ title: 解决问题 sidebar_position: 1 --- -Here are some guides you may need to solve problems with AdGuard Browser Extension. +以下是解决与 AdGuard 浏览器扩展有关的问题指南。 - [如何从后台页面导出日志](/adguard-browser-extension/solving-problems/logs.md) - [如何在 Chrome 浏览器 MV3 中调试规则](/adguard-browser-extension/solving-problems/debug-rules.md) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/user-scripts-api.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/user-scripts-api.md index 0e9632fd730..56c7796582f 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/user-scripts-api.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-browser-extension/user-scripts-api.md @@ -5,29 +5,29 @@ sidebar_position: 8 :::info -这篇文章是关于 AdGuard 浏览器扩展,它只能保护用户的浏览器。 To protect your entire device, [download the AdGuard app](https://adguard.com/download.html?auto=true). +这篇文章是关于 AdGuard 浏览器扩展,它只能保护用户的浏览器。 要全面保护设备,请[下载 AdGuard 应用程序](https://adguard.com/download.html?auto=true) ::: -When adding a custom filter or user rule, a notification will appear asking you to enable the Developer mode to use these features in the extension. +当添加自定义过滤器或用户规则时,会出现一个通知,询问您是否启用开发者模式以在扩展中使用这些功能。 -![Notification \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/notification-allow-user-scripts.jpg) +![通知 \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/notification-allow-user-scripts.jpg) -Starting with version 5.2, AdGuard Browser Extension uses the User Scripts API. Chrome requires this new API to follow best practices for user safety. +从 5.2 版本开始,AdGuard 浏览器扩展开始使用 User Scripts API。 Chrome 要求使用这一新 API,以遵循用户安全的最佳实践。 -## What is the User Scripts API? +## 什么是 User Scripts API? -The User Scripts API is a tool that allows extensions to run customized JavaScript scripts on webpages. These are often used to modify or enhance websites in ways that aren’t originally provided by the website itself. +User Scripts API 是一种工具,允许扩展程序在网页上运行自定义的 JavaScript 脚本。 These are often used to modify or enhance websites in ways that aren’t originally provided by the website itself. With the shift to Chrome’s Manifest V3, many older methods of injecting scripts are limited or delayed. However, there is an exception for the User Scripts API. -Learn more about the impacts of the MV3 policies in our [blog post](https://adguard.com/en/blog/review-issues-in-chrome-web-store.html). +更多关于 MV3 政策影响的信息,请参阅我们的[博客文章](https://adguard.com/en/blog/review-issues-in-chrome-web-store.html)。 -## How to enable the Developer mode +## 如何启用开发者模式 -To use custom filters and JavaScript rules in the _User Rules_ tab, you must set up your browser first. This will give the extension a reliable and secure method of injecting scripts into webpages at the optimal time. Follow the instructions below depending on your Chrome version. +要在「用户规则」标签页中使用自定义过滤器和 JavaScript 规则,您必须先设置好浏览器。 这将为扩展程序提供一种可靠且安全的方法,在最佳时机将脚本注入网页。 请根据您的 Chrome 版本,按照以下说明进行操作。 -### For Chrome versions prior to 138 +### 对于 138 版本之前的 Chrome You must enable Developer mode for extensions. To do so, open the Chrome menu by clicking the three dots in the upper-right corner, go to _Extensions_ ⭢ _Manage extensions_, and toggle the _Developer mode_ switch. diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md index 206e59d43d2..4603617032e 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md @@ -35,7 +35,7 @@ sidebar_position: 1 - [其他功能](/adguard-for-ios/features/other-features.md) - General settings: theme, settings and statistics reset, auto-update, inverting the allowlist, and advanced mode. + 常规设置:主题、重置设置和统计数据、自动更新、反转允许列表、高级模式。 - [与 AdGuard VPN 的兼容](/adguard-for-ios/features/compatibility-with-adguard-vpn.md) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md index f12f3be7b40..cbd2babe2d6 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-mac/features/features.md @@ -27,7 +27,7 @@ sidebar_position: 1 - [隐身模式](/adguard-for-mac/features/stealth.md) - Settings to block cookies, UTM tags, and online analytics that collect user information + 用于拦截 Cookie、UTM 标签以及收集用户信息的在线分析工具的设置 - [安全](/adguard-for-mac/features/security.md) @@ -35,7 +35,7 @@ sidebar_position: 1 - [AdGuard 助手](/adguard-for-mac/features/browser-assistant.md) - An extension that complements the desktop app and allows you to manage filtering from your browser + 该扩展是桌面程序的补充,让用户通过浏览器管理过滤功能。 - [扩展](/adguard-for-mac/features/extensions.md) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-safari/adguard-for-safari.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-safari/adguard-for-safari.md index 815031c594f..7d56551a5dc 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-safari/adguard-for-safari.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-safari/adguard-for-safari.md @@ -23,4 +23,4 @@ sidebar_position: 2 - [解决问题](/adguard-for-safari/solving-problems/solving-problems.md) - Known issues and possible solutions + 已知问题和可能的解决方案。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index f8eafc44514..6322cd56b7b 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index cfff1fd07f9..a49b62af21c 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [更多信息](/adguard-for-windows-8/settings/app-settings/network-settings/)。 + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. 完成! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/adguard-for-windows.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/adguard-for-windows.md index 5e3a318f337..dffceaeb09b 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/adguard-for-windows.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/adguard-for-windows.md @@ -19,7 +19,7 @@ sidebar_position: 1 - [AdGuard 助手](/adguard-for-windows/browser-assistant.md) - An extension that complements the desktop app and allows you to manage filtering from your browser + 该扩展是桌面程序的补充,让用户通过浏览器管理过滤功能。 - [解决问题](/adguard-for-windows/solving-problems/solving-problems.md) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/features/features.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/features/features.md index 726e5fbe543..49b76f2d776 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/features/features.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/features/features.md @@ -27,4 +27,4 @@ sidebar_position: 1 - [其他功能](/adguard-for-windows/features/others/) - Support, license management, tray menu options, app version and updates + 支持、许可证管理、托盘菜单选项、程序版本和更新。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 15c804ac7c9..0f685131fbd 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ sidebar_position: 4 最后是代理设置部分。 用户可以在此处指定 AdGuard 更新过滤器,获取新版本等所用的代理服务器。 -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index a5a75326aeb..ddc0e9a0013 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ In the Ad blocking module you can: Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### 浏览安全 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 4f5b5aa74ab..b70c5d5e258 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` 将转换为 -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` 此选项仅在启用隐身模式的「*保护免受 DPI 影响*」选项时被应用。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index d7070ee7c8c..4f370534e58 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [更多信息](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers)。 + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. 完成! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/adguard-mini-for-mac.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/adguard-mini-for-mac.md index b2ecfec10f6..dce4e2907d9 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/adguard-mini-for-mac.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/adguard-mini-for-mac.md @@ -5,24 +5,24 @@ sidebar_position: 1 :::info -This page is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) +此网页是关于 Mac 版的 AdGuard Mini,用于 Safari 浏览器的保护。 要全面保护设备,请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock)。 ::: -AdGuard Mini for Mac (formerly AdGuard for Safari) was designed to conform to Apple’s restrictions for ad blocking browser extensions. Although it can’t be compared to our desktop ad blocking apps, it’s free and can protect you from ads, trackers, phishing, and malicious websites. +AdGuard Mini Mac 版(前称 AdGuard Safari 版)旨在符合 Apple 对广告拦截浏览器扩展的限制。 虽然它无法与我们桌面版的广告拦截应用相提并论,但它是免费的,并且可以保护您免受广告、跟踪器、网络钓鱼和恶意网站的侵害。 -- [Features](/adguard-mini-for-mac/features/features.md) +- [功能](/adguard-mini-for-mac/features/features.md) - Main features and settings available in AdGuard Mini for Mac + Mac 版 AdGuard Mini 的主要功能和可用设置。 -- [Installation](/adguard-mini-for-mac/installation.md) +- [安装](/adguard-mini-for-mac/installation.md) - Installation, removal, and system requirements for AdGuard Mini for Mac + Mac 版 AdGuard Mini 的安装、卸载和系统要求。 -- [Safari extensions](/adguard-mini-for-mac/extensions.md) +- [Safari 扩展](/adguard-mini-for-mac/extensions.md) - Mechanisms that enable content blocking and add functionality to the Safari web browser + 启用内容拦截中并为 Safari 网络浏览器添加功能的机制。 -- [Solving problems](/adguard-mini-for-mac/solving-problems/solving-problems.md) +- [解决问题](/adguard-mini-for-mac/solving-problems/solving-problems.md) - Known issues and possible solutions + 已知问题和可能的解决方案。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/extensions.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/extensions.md index 2a6cc820219..31157b8dad4 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/extensions.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/extensions.md @@ -5,17 +5,17 @@ sidebar_position: 3 :::info -This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) +这篇文章是关于 Mac 版的 AdGuard Mini,用于 Safari 浏览器的保护。 要全面保护 Mac 设备,请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock)。 ::: ## 什么是 Safari 扩展 -Safari 扩展是为 Safari 浏览器添加功能的小型软件程序。 它们允许用户添加浏览器未内置的功能以定制和增强浏览体验。 AdGuard Mini for Mac uses extensions primarily to apply filtering rules on websites opened in Safari. +Safari 扩展是为 Safari 浏览器添加功能的小型软件程序。 它们允许用户添加浏览器未内置的功能以定制和增强浏览体验。 Mac 版 AdGuard Mini 主要使用扩展功能对通过 Safari 打开的网站应用过滤规则。 ## 工作原理 -AdGuard 使用过滤规则阻止网站上的广告、跟踪器和其他骚扰。 The rules from AdGuard’s and your custom filters are converted into ones comprehensible by Safari and are integrated into 6 Safari extensions: +AdGuard 使用过滤规则阻止网站上的广告、跟踪器和其他骚扰。 AdGuard 的规则和用户的自定义过滤器会转换为 Safari 可以“理解”的规则,并集成到六个 Safari 扩展中: - AdGuard 常用 - AdGuard 隐私 @@ -24,53 +24,53 @@ AdGuard 使用过滤规则阻止网站上的广告、跟踪器和其他骚扰。 - AdGuard 自定义 - AdGuard 其它 -每个内容拦截扩展最多可包含 150,000 个启动的过滤规则。 大多数过滤组内的规则数量不超过 15 万个。 不过,如果启动太多特定语言或自定义过滤器,可能会超出限制。 在这种情况下,超过限制的随机规则将被自动禁用,这可能会导致拦截错误。 **We strongly recommend activating only the filters you need**. +每个内容拦截扩展最多可包含 150,000 个启动的过滤规则。 大多数过滤组内的规则数量不超过 15 万个。 不过,如果启动太多特定语言或自定义过滤器,可能会超出限制。 在这种情况下,超过限制的随机规则将被自动禁用,这可能会导致拦截错误。 **我们强烈建议只启动所需要的过滤器**。 -There is also one more extension responsible for other features: _AdGuard for Safari_, which adds the AdGuard icon next to the search bar in Safari and allows using advanced rules to block complex ads. +还有一个负责其他功能的扩展:AdGuard Safari 版,它会在 Safari 的搜索栏旁添加 AdGuard 图标,并允许使用高级规则拦截复杂广告。 -![Safari extensions](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/check-extensions.png) +![Safari 扩展](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/check-extensions.png) 下面我们详细介绍每个扩展。 ## 内容拦截扩展 -_AdGuard General_ applies rules from filters that you can find in _Settings_ → _Filters_ → _Ad blocking_ and _Language-specific_. 该扩展专注于全面广告拦截,包括特定语言的广告过滤器。 +「AdGuard 常用」应用来自「设置」→「过滤器」→「广告拦截」和「语言特定」中过滤器的规则。 该扩展专注于全面广告拦截,包括特定语言的广告过滤器。 -_AdGuard Privacy_ applies rules from filters located in _Filters_ → _Privacy_. 它可以阻止跟踪机制,确保用户的浏览活动保持私密。 +用户可以在「过滤器」→「隐私」中启用「AdGuard 隐私」过滤器规则。 它可以阻止跟踪机制,确保用户的浏览活动保持私密。 -_AdGuard Social_ applies rules from filters that can be found in _Filters_ → _Social Widgets_ and _Filters_ → _Annoyances_. It blocks popups, social media buttons, online assistant windows, and other elements on webpages that you might find annoying. +用户可在「过滤器」→「社交工具」和「过滤器」→「烦人元素中启动「AdGuard 社交 」过滤器规则。 它能拦截弹出窗口、社交媒体按钮、在线助手窗口以及网页上其他用户可能会觉得烦人的元素。 -_AdGuard Security_ applies rules from filters under _Filters_ → _Security_. 该扩展可识别并阻止潜在的有害元素,保护用户免受恶意内容的侵害。 +用户可以在「过滤器」→「安全」中启用「AdGuard 安全」过滤器规则。 该扩展可识别并阻止潜在的有害元素,保护用户免受恶意内容的侵害。 -_AdGuard Other_ applies rules from filters that don’t fall under the above-mentioned categories and that are located in _Filters_ → _Other_: _Filter unblocking search ads and self-promotion_, _AdGuard DNS filter_, and _AdGuard Experimental filter_. +「AdGuard 其他」应用不属于上述类别的过滤器规则。要启动「AdGuard 其他」 前往「过滤器」→「其他」:「解除搜索广告和自我推销过滤器」、「AdGuard DNS 过滤器」,以及「AdGuard 实验性过滤器」。 -_AdGuard Custom_ applies rules from filters that you add on your own to _Custom filters_. +「AdGuard 自定义」应用用户自己添加到「自定义过滤器」的规则。 -User rules and allowlist rules are included in every extension. +每个扩展都包含用户规则和白名单规则。 ## AdGuard Safari版 -_AdGuard for Safari_ activates the AdGuard icon next to the search bar. It’s useful if you want to quickly set up protection for a specific website or block ads manually. +「Safari 版 AdGuard」将在搜索栏旁边激活 AdGuard 图标。 如果您想快速为某个网站设置保护或手动拦截广告,这个功能非常实用。 -_AdGuard for Safari_ extension also contains advanced rules that aren’t converted to the format supported by Safari. These include [CSS rules](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [extended CSS selectors](/general/ad-filtering/create-own-filters#extended-css-selectors), and [scriptlets](/general/ad-filtering/create-own-filters#scriptlets), which allow AdGuard to block complex ads, such as those on YouTube. +AdGuard Safari 版扩展还包含一些无法转换为 Safari 支持格式的高级规则。 这些规则包括 [CSS 规则](/general/ad-filtering/create-own-filters#cosmetic-css-rules)、[扩展 CSS 选择器](/general/ad-filtering/create-own-filters#extended-css-selectors)和[脚本片段](/general/ad-filtering/create-own-filters#scriptlets),它们让 AdGuard 能够拦截 YouTube 等网站上的复杂广告。 ## 如何管理 Safari 扩展程序 -1. Open Safari and click _Safari_ in the upper left corner of the screen to expand the menu. +1. 打开 Safari,单击屏幕左上角的「Safari」展开菜单。 - ![Safari settings \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) + ![Safari 设置 \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-settings1.png) -2. Click _Settings..._ +2. 点击「设置...」。 -3. Select _Extensions_. +3. 选择「扩展」。 - ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) + ![扩展标签](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-extensions1.png) ## 为什么 Safari 版 AdGuard 需要权限 -When enabling the _AdGuard for Safari_ extension, you might notice that it requires **access to webpage content** and **access to browsing history**. Here’s why it needs these permissions: +启用「AdGuard Safari 版」扩展时,用户可能会注意到它需要「**访问网页内容**」和「**访问浏览历史**」的权限。 下面是需要这些权限的原因: -- Access to webpage content is required for manual ad blocking and advanced blocking rules to work correctly +- 访问网页内容,允许手动广告拦截和高级拦截规则正常工作。 - 访问浏览历史记录,允许扩展检查网站的保护状态,并确定应应用哪些高级规则。 -我们不会将这些数据用于任何其他目的或与任何人共享。 For more info, you can consult our [Privacy policy](https://adguard.com/privacy.html). +我们不会将这些数据用于任何其他目的或与任何人共享。 要了解更多信息,请查阅我们的[隐私政策](https://adguard.com/privacy.html)。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/about.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/about.md index a4142c5b8d5..86bb3e2fad2 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/about.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/about.md @@ -3,22 +3,22 @@ title: 关于 sidebar_position: 7 --- -![About tab](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/about.png) +![关于标签](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/about.png) -On the _About_ tab, you can check: +在「关于」标签中,用户可以查看以下信息: -- Current version of your AdGuard Mini app -- Current versions of the libraries +- AdGuard Mini 应用程序当前版本 +- 库的当前版本 -You can also find the links to: +您还可以找到以下链接: -- Our official website -- EULA and Privacy policy -- Acknowledgements +- 我们的官方网站 +- EULA 和隐私协议 +- 致谢 - 版本历史 :::note 请注意 -AdGuard Mini for Mac can be downloaded for free [from the App Store](https://agrd.io/mini_mac). A detailed setup instruction is available in [this Knowledge Base article](/adguard-mini-for-mac/installation/). +Mac 版 AdGuard Mini 可从 [App Store](https://agrd.io/mini_mac) 免费下载。 详细的设置指示说明可在[此知识库文章](/adguard-mini-for-mac/installation/)中查看。 ::: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/advanced-blocking.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/advanced-blocking.md index bbf9454367c..a7461453ca4 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/advanced-blocking.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/advanced-blocking.md @@ -1,16 +1,16 @@ --- -title: Advanced blocking +title: 高级拦截功能 sidebar_position: 3 --- -![Advanced blocking](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/advanced-blocking.png) +![高级拦截](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/advanced-blocking.png) -_Advanced blocking_ is optional, but when enabled it unlocks stronger filtering: for example, it lets us apply extended rules to block tough cases such as some YouTube ads. You decide whether to grant Safari the extra permissions and whether you want that extra power. +「高级拦截」为可选功能,启用后可解锁更强的过滤能力:例如,它能让我们应用扩展规则来拦截某些顽固广告,如部分 YouTube 广告。 由您决定是否授予 Safari 额外权限,以及是否使用这些增强功能。 -Here you can turn on the _AdGuard Extra_ userscript — if there’s a website where ads just won’t go, like Facebook or YouTube. +在这里,可以开启「AdGuard Extra」用户脚本:适用于某些广告难以去除的网站,比如 Facebook 或 YouTube。 :::note -_AdGuard Extra_ is a feature of the [full version](/adguard-mini-for-mac/features/full-version.md). +AdGuard Extra 是[完整版](/adguard-mini-for-mac/features/full-version.md)一项功能。 ::: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index 5a8ef02c88f..b7d1b09b63e 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -1,36 +1,36 @@ --- -title: Features +title: 功能 sidebar_position: 1 --- -- [Safari protection](/adguard-mini-for-mac/features/safari-protection.md) +- [Safari 保护](/adguard-mini-for-mac/features/safari-protection.md) - Core filtering feature with customizable options + 核心过滤功能,支持自定义选项。 -- [Advanced blocking](/adguard-mini-for-mac/features/advanced-blocking.md) +- [高级拦截](/adguard-mini-for-mac/features/advanced-blocking.md) - Unlocks stronger filtering capabilities + 解锁更强大的过滤能力。 -- [User rules](/adguard-mini-for-mac/features/rules.md) +- [用户规则](/adguard-mini-for-mac/features/rules.md) 自定义过滤规则以微调广告拦截。 -- [Settings](/adguard-mini-for-mac/features/settings/settings.md) +- [设置](/adguard-mini-for-mac/features/settings/settings.md) - Various options that help you configure the app and filtering + 帮助用户配置应用和过滤的各种选项。 -- [Support](/adguard-mini-for-mac/features/support.md) +- [支持](/adguard-mini-for-mac/features/support.md) - Helpful options for when you have a question or encountered a problem + 当您遇到问题或疑问时提供帮助的选项。 -- [About](/adguard-mini-for-mac/features/about.md) +- [关于](/adguard-mini-for-mac/features/about.md) - Info about the app’s current version and a list of helpful links + 应用当前版本信息及有用的链接列表。 -- [Safari toolbar menu](/adguard-mini-for-mac/features/toolbar-menu.md) +- [Safari 工具栏菜单](/adguard-mini-for-mac/features/toolbar-menu.md) - A handy menu in the Safari toolbar + Safari 工具栏中的便捷菜单。 -- [Full version](/adguard-mini-for-mac/features/full-version.md) +- [完整版](/adguard-mini-for-mac/features/full-version.md) - Advanced features that enhance filtering speed and power + 提升过滤速度和性能的高级功能。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..16699992159 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,20 +1,20 @@ --- -title: Full version +title: 完整版 sidebar_position: 9 --- -AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. +AdGuard Mini Mac 版的完整版解锁高级功能,可提供更快的过滤速度和更强大的过滤能力。 -To activate it, you can use a regular AdGuard license, which is obtainable [on our website](https://adguard.com/license.html) or through in-app purchase. You can also use the 14-day trial to test the features beforehand. +要激活它,您可以使用常规的 AdGuard 许可证,该许可证可从[我们的网站](https://adguard.com/license.html)或通过应用内购买获取。 您也可以先使用 14 天试用期来测试这些功能。 ### AdGuard Extra -AdGuard Extra is an advanced script that handles complex ads, mostly on social media and online video platforms. It also shuts down ad blocking circumvention technologies such as ad re-insertion. +AdGuard Extra 是一个高级脚本,用于处理复杂广告,主要针对社交媒体和在线视频平台。 它还能阻止广告重新插入等广告拦截规避技术。 ![AdGuard Extra](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/advanced-blocking.png) -### Real-time filter updates +### 实时过滤器更新 -Receive filter updates as soon as there is a new rule or a fix. This ensures that your filters are always up-to-date and no ad slips through. +一旦有新规则或修复,立即接收过滤器更新。 这能确保您的过滤器始终是最新的,不会漏掉任何广告。 -![Real-time updates](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/real-time-updates.png) +![实时更新](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/real-time-updates.png) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/rules.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/rules.md index 577140f86c5..ad7671362be 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/rules.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/rules.md @@ -3,18 +3,18 @@ title: 用户过滤器 sidebar_position: 4 --- -![User rules](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/user-rules.png) +![用户规则](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/user-rules.png) -User rules can be used to customize ad blocking when you want something personal: exclude a website from filtering, unblock requests, or allow scripts on a certain webpage. 它们可以手动添加、导入,也可以在屏蔽页面元素时自动创建。 +当您有特殊需求时,用户规则可用于自定义广告拦截:例如,将某个网站排除在过滤之外、取消拦截请求,或允许特定网页上的脚本。 它们可以手动添加、导入,也可以在屏蔽页面元素时自动创建。 要添加自己的过滤规则,请使用[专用语法](/general/ad-filtering/create-own-filters)。 -### Rule constructor +### 规则构造器 -We understand that writing filtering rules yourself is not every user’s cup of tea. That’s why you can just click _Create rule_ to use a rule constructor: choose what you want to do, click through a few options, and you’re done. Block images, videos, scripts, or any other elements you’d rather not see on a page. +我们知道,自己编写过滤规则并非每位用户的专长。 因此,用户只需点击「创建规则」即可使用规则构造器:选择想执行的操作,按提示点击几下,就完成了。 拦截图片、视频、脚本或页面上您不想看到的任何其他元素。 -![Rule constructor](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/build-a-rule.png) +![规则构造器](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/build-a-rule.png) -Here’s an example of a tricky case — a cookie popup that resists filtering. Find it in the page code, then open _User rules_ and create a rule to block it: +这里有一个棘手情况的示例:一个难以过滤的 Cookie 弹窗。 在页面代码中找到它,然后打开「用户规则」并创建一条规则来拦截它: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/safari-protection.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/safari-protection.md index 65bf309e8e6..afc479acc42 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/safari-protection.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/safari-protection.md @@ -5,18 +5,18 @@ sidebar_position: 2 :::info -This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) +这篇文章是关于 Mac 版的 AdGuard Mini,用于 Safari 浏览器的保护。 要全面保护设备,请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock)。 ::: ## Safari 防护 -![General tab](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/safari-protection.png) +![常规标签](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/safari-protection.png) -_Safari protection_ section is the most important area for the app’s core purpose. Settings are grouped logically and explained in plain language so you can quickly see what each option does. +「Safari 保护」部分是应用核心功能最重要的区域。 设置项按逻辑分组,并用通俗易懂的语言加以说明,让您快速了解每个选项的作用。 -Here’s a simple explanation on what each group of settings does: +以下是对每组设置功能的简要说明: -![Protection screen part one \*border](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/new/safari_protection_1.png) +![保护屏幕第一部分 \*border](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/new/safari_protection_1.png) -![Protection screen part two \*border](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/new/safari_protection_2.png) +![保护屏幕第二部分 \*border](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/new/safari_protection_2.png) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/filters.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/filters.md index adc88484f88..bf9dd1b420b 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/filters.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/filters.md @@ -3,22 +3,22 @@ title: 过滤器 sidebar_position: 2 --- -![Filters tab](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/filters.png) +![过滤器标签](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/filters.png) 前往「_设置_」→「_过滤_」,启用单独的过滤器或整个过滤器类别。 -Filters are the backbone of ad blocking and basically it’s what keeps the Internet clean. 过滤器是用特殊语法编写的规则列表。 根据这些规则,内容拦截器可以过滤网络流量:拦截广告或对恶意网站的请求。 +过滤器是广告拦截的核心,本质上正是它们让互联网保持整洁。 过滤器是用特殊语法编写的规则列表。 内容拦截器遵循这些规则来过滤网络流量:拦截广告或恶意网站的请求。 -Filters are combined into eight thematic categories: _Ad Blocking, Privacy, Social widgets, Annoyances, Security, Language-specific filters, Custom,_ and _Other filters_. +过滤器共分为八个主题类别:广告拦截、隐私、社交插件、恼人元素、安全、语言专用过滤器、自定义过滤器和其他过滤器。 -了解更多有关 [AdGuard 过滤器](/general/ad-filtering/adguard-filters)或[一般广告过滤](/general/ad-filtering/how-ad-blocking-works)的信息。 +阅读更多关于 [AdGuard 过滤器](/general/ad-filtering/adguard-filters) 或[广告过滤的一般信息(/general/ad-filtering/how-ad-blocking-works)。 -Changes in _Filters_ are also reflected in _Settings_ → _Safari extensions_. +过滤器的更改也会同步反映在「设置」→「Safari 扩展」中。 ## 自定义过滤器 -![Create custom filter](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/create-custom.png) +![建立自定义过滤器](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/create-custom.png) -To add a custom filter, go to _Settings_ → _Filters_ → _Custom filters_ and enter a URL or a local file path in the relevant field. +要添加自定义过滤器,请转到「设置」→「过滤器」→「自定义过滤器」,并在相关字段中输入 URL 或本地文件路径。 -You can find a lot of filters at [filterlists.com](https://filterlists.com/). +在 [filterlists.com](https://filterlists.com/) 上可以找到很多过滤器。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/safari-extensions.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/safari-extensions.md index 3e892b4efca..2752cc603a7 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/safari-extensions.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/safari-extensions.md @@ -3,31 +3,31 @@ title: Safari 扩展 sidebar_position: 3 --- -![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/extensions.png) +![扩展标签](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/extensions.png) -Safari extensions are mechanisms that allow implementing content blockers — thematic clusters of filters. For example, privacy-related filters are included in the content blocker with the corresponding name — _AdGuard Privacy_. +Safari 扩展是一种实现内容拦截器的机制,内容拦截器是过滤器的主题集合。 例如,与隐私相关的过滤器包含在内容拦截器中,其相应名称为「AdGuard 隐私」。 -Content blockers were designed for two reasons: to structure filters and to conform to Apple’s restrictions. +设计内容拦截器有两个原因:结构过滤器和符合 Apple 公司的限制。 -[2019年](https://adguard.com/en/blog/adguard-safari-1-5.html),Apple 对 Safari 浏览器的广告拦截器设置了限制,只允许它们同时使用5万个过滤规则。 As this number was not enough for an ad blocker to provide a good filtering quality (_AdGuard Base Filter_ alone has 30,000 filtering rules), we divided AdGuard for Safari into six content blockers each containing up to 50,000 rules. +[2019年](https://adguard.com/en/blog/adguard-safari-1-5.html),Apple 对 Safari 浏览器的广告拦截器设置了限制,只允许它们同时使用5万个过滤规则。 由于这个数量不足以让一个广告拦截器提供良好的过滤质量(仅 AdGuard 基础过滤器就有 30,000 个过滤规则),我们将 AdGuard Safari 版分成六个内容拦截器,每个拦截器包含多达 50,000 个规则。 -[2022年](https://adguard.com/en/blog/adguard-for-safari-1-11.html),Apple 将每个内容拦截器的过滤规则数量限制提高到同时应用15万个规则。 Regarding AdGuard Mini for Mac, up to 900,000 rules can be enabled for all six content blockers. +[2022年](https://adguard.com/en/blog/adguard-for-safari-1-11.html),Apple 将每个内容拦截器的过滤规则数量限制提高到同时应用15万个规则。 关于 Mac 版 AdGuard Mini,六种内容拦截器最多可以启用 900,000 个规则。 虽然数量限制提高了,但内容拦截器的结构却保持不变。 -In _Safari extensions_, you can see which content blockers are enabled, how many rules each of them is using, and which filters are functioning. +在「Safari 扩展」中,用户可以查看哪些内容拦截器已启用、每个拦截器使用了多少条规则,以及哪些过滤器正在运行。 :::tip -You can manage enabled filters in _Settings_ → _Filters_. In _Safari extensions_, you can only see the list of enabled filters and the number of enabled rules. +用户可以在「设置」→「过滤器」中管理已启用的过滤器。 在「Safari 扩展」中,用户只能看到已启用的过滤器列表和已启用的规则数量。 ::: -## List of AdGuard Mini’s Safari extensions +## AdGuard Mini 的 Safari 扩展列表 ### AdGuard 常用 -「AdGuard 常规」是一款内容拦截器,结合最基本的拦截广告过滤器。 We recommend keeping _AdGuard Base Filter_ always enabled. +「AdGuard 常规」是一款内容拦截器,结合最基本的拦截广告过滤器。 我们建议始终启用「AdGuard 基础过滤器」。 ### AdGuard 隐私 @@ -35,7 +35,7 @@ You can manage enabled filters in _Settings_ → _Filters_. In _Safari extension ### AdGuard 社交 -「AdGuard 社交」包含针对社交媒体按钮、小工具、脚本和图标的过滤器。 Other annoyance filters can also be found in this section: filters against popups, banners, cookie notices, and more. To enable them, find _Social Widgets_ in _Settings_ → _Filters_. +「AdGuard 社交」包含针对社交媒体按钮、小工具、脚本和图标的过滤器。 本部分还包含其他恼人元素过滤器:用于拦截弹窗、横幅、Cookie 通知等。 要启用它们,请在「设置」→「过滤器」中找到「社交插件」。 ### AdGuard 安全 @@ -47,14 +47,14 @@ You can manage enabled filters in _Settings_ → _Filters_. In _Safari extension :::note 免责声明 -We don’t have any “acceptable ads” paid by advertisers. Instead, we provide users with an option to see [search ads and websites’ self-promotion](/general/ad-filtering/search-ads). +我们没有任何由广告商付费的“可接受广告”。 我们为用户提供查看[搜索广告和网站自我宣传](/general/ad-filtering/search-ads)的选项。 ::: ### AdGuard 自定义 -![Create custom filter](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/create-custom.png) +![创建自定义过滤器](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/create-custom.png) -If you need more filters, you can add them to _AdGuard Custom_ extension. +如果需要更多过滤器,可以将其添加到「AdGuard 自定义」扩展中。 -To add a custom filter, go to _Settings_ → _Filters_ → _Custom filters_ and enter a URL or a local file path in the relevant field. 用户可以在「filterlists.com](https://filterlists.com」上查看新的过滤器。 +要添加自定义过滤器,请转到「设置」→「过滤器」→「自定义过滤器」,并在相关字段中输入 URL 或本地文件路径。 用户可以在「filterlists.com](https://filterlists.com」上查看新的过滤器。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/settings.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/settings.md index 2e399c04733..8259c2082fc 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/settings.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/settings/settings.md @@ -3,18 +3,18 @@ title: 设置 sidebar_position: 5 --- -![Settings tab](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/settings.png) +![设置标签](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/settings.png) -In _Settings_, you can set up basic things like filters, filter updates, launching AdGuard at system startup, and so on. You can also choose whether to show the AdGuard icon in the menu bar. +在「设置」中,您可以配置过滤器、过滤器更新、开机自启动等基本选项。 您还可以选择是否在菜单栏中显示 AdGuard 图标。 -The main two sections are: +主要包含两个部分: -- [Filters](/adguard-mini-for-mac/features/settings/filters.md) +- [过滤器](/adguard-mini-for-mac/features/settings/filters.md) - Different filters that allow you to customize your ad blocking experience + 不同的过滤器,让您自定义广告拦截体验。 -- [Safari extensions](/adguard-mini-for-mac/features/settings/safari-extensions.md) +- [Safari 扩展](/adguard-mini-for-mac/features/settings/safari-extensions.md) - Info on the current state of content blockers — how many rules and filters are enabled for each of them + 内容拦截器的当前状态信息,每个拦截器启用多少条规则和多少个过滤器。 -At the bottom of the _Settings_ screen, you can find options that come in handy when communicating with our support team: _Debug logging_ and _Export logs_. +在「设置」屏幕底部,可以找到一些在与我们的支持团队沟通时会派上用场的选项:「调试日志」和「导出日志」。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/support.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/support.md index fb0538d85af..cac0fd22c56 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/support.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/support.md @@ -3,24 +3,24 @@ title: 支持 sidebar_position: 6 --- -![Support tab](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/support.png) +!支持标签](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/support.png) -_Support_ section has helpful options in case you have a question or encounter a problem: +「支持」部分包含有用的选项,当您遇到问题或疑问时可以使用: - 常见问题 - Answers to a lot of questions and problems can be found here + 许多常见问题和解答都可以在这里找到 - 报告错误拦截 - Takes you to the page where you can report a bug or a problem in details + 跳转到可以详细报告错误或问题的页面。 -- Contact support +- 联系支持 - Contact our support team directly from the app, allowing you to attach logs and app info + 直接从应用中联系我们的支持团队,并允许附加日志和应用信息。 - ![Contact support screen](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/contact-support.png) + ![联系支持屏幕](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/contact-support.png) - 讨论 - Takes you to a page where you can find links to AdGuard’s social media and GitHub + 跳转到包含 AdGuard 社交媒体和 GitHub 链接的页面 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/toolbar-menu.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/toolbar-menu.md index e00b2cef48b..5856c5ee429 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/toolbar-menu.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/toolbar-menu.md @@ -1,36 +1,36 @@ --- -title: Safari toolbar menu +title: Safari 工具栏菜单 sidebar_position: 8 --- -![Safari toolbar assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/assistant.png) +![Safari 工具栏助手](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/assistant.png) -AdGuard Mini has a handy menu right in the Safari toolbar. To open it, click the icon located to the left of the search bar. +AdGuard Mini 在 Safari 工具栏中有一个便捷的菜单。 要打开它,请点击搜索栏左侧的图标。 -Here’s what you can do in the toolbar menu: +在工具栏菜单中,可以进行以下操作: -- **Pause icon** +- **暂停图标** - Disables AdGuard Mini + 暂停 AdGuard Mini -- **Settings icon** +- **设置图标** - Takes you to AdGuard Mini’s _Settings_ screen + 前往 AdGuard Mini 的「设置」界面 -- **Website info** +- **网站信息** - Indicates the website you are currently on + 表示您当前所在的网站 -- **Protection** +- **防护** - Turning it off disables filtering on the website you are currently on. Turning it back on resumes filtering on the website + 关闭后,将对当前网站禁用过滤。 重新开启后,恢复对当前网站的过滤。 -- **Block element** +- **拦截元素** - Lets you manually select and block any element on the page: select the element, adjust the selection frame (if needed), and click the _Block_ button. To unblock an element, go to _Settings_ → _User rules_ and delete or uncheck the corresponding rule + 让用户手动选择并拦截页面上的任意元素:选择元素,调整选择框(如果需要),然后点击「拦截」按钮。 要取消拦截某个元素,请前往「设置」→「用户规则」,删除或取消勾选对应的规则 - ![Manual blocking](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/manual-blocking.png) + ![手动拦截](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/manual-blocking.png) -- **Report an issue** +- **报告错误** - Takes you to a special form for reporting issues with some information automatically pre-filled + 跳转至问题报告表单,部分信息会自动预填。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/installation.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/installation.md index d716cd142bd..e5b359c4ace 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/installation.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/installation.md @@ -5,7 +5,7 @@ sidebar_position: 2 :::info -这篇文章是关于 Mac 版的 AdGuard Mini,用于 Safari 浏览器的保护。 To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) +这篇文章是关于 Mac 版的 AdGuard Mini,用于 Safari 浏览器的保护。 要全面保护设备,请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock)。 ::: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/ads-not-blocked.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/ads-not-blocked.md index bd72e78f832..93907db35de 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/ads-not-blocked.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/ads-not-blocked.md @@ -5,24 +5,24 @@ sidebar_position: 2 :::info -这篇文章是关于 Mac 版的 AdGuard Mini,用于 Safari 浏览器的保护。 To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) +这篇文章是关于 Mac 版的 AdGuard Mini,用于 Safari 浏览器的保护。 要全面保护设备,请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock)。 ::: -In some cases, filtering may not work and ads may still be displayed even though AdGuard Mini for Mac and the proper filters are enabled. 这种情况通常发生在 Safari 浏览器的 Bug 错误导致过滤器更新出错时。 +在某些情况下,过滤可能不起作用,即使 AdGuard Mini Mac 版和适当的过滤器已启用,广告仍可能被显示。 这种情况通常发生在 Safari 浏览器的 Bug 错误导致过滤器更新出错时。 ### 解决方案 1. 打开 Safari 浏览器。 2. 点击左上角菜单中的「_Safari_」。 3. 单击「_设置…_」→「_扩展_」。 -4. Clear the checkboxes for AdGuard Mini’s extensions: _Custom_, _General_, _Other_, _Privacy_, _Security_, _Social_, and _AdGuard for Safari_. - ![Unchecked extensions](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/unchecked-extensions.png) +4. 清除 AdGuard Mini 扩展的复选框:「自定义」、「一般」、「其他」、「隐私」、「安全」、「社交」和「Safari 版 AdGuard」。 + ![未勾选扩展](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/unchecked-extensions.png) 5. 重新启动 Safari 浏览器。 6. 返回 Safari → 「_设置..._」→「_扩展_」并重新启用 AdGuard 扩展。 7. 打开 AdGuard Mini 菜单。 8. 点击「_检查更新_」图标。 - ![Update button \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/update-button.png) + ![更新按钮 \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/update-button.png) 9. 在过滤器更新完成之前,请勿关闭 AdGuard Mini 窗口。 如果上述方法无效,广告仍未被拦截,请通过 [support@adguard.com](mailto:support@adguard.com) 联系我们的支持团队。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/filters-after-disable.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/filters-after-disable.md index a0e48ed63db..10fa9af7fc2 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/filters-after-disable.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/filters-after-disable.md @@ -1,24 +1,24 @@ --- -title: Filtering doesn’t stop when AdGuard Mini is disabled +title: 禁用 AdGuard Mini 后,过滤不会停止 sidebar_position: 3 --- :::info -This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) +这篇文章是关于 Mac 版的 AdGuard Mini,用于 Safari 浏览器的保护。 要全面保护设备,请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock)。 ::: -If filtering doesn’t stop when AdGuard Mini for Mac is disabled, it may be because content blockers take too long to update. +如果在禁用 AdGuard Mini Mac 版后过滤仍未停止,可能是因为内容拦截器更新耗时过长。 ## 解决方案 1. 打开 Safari 浏览器。 2. 点击左上角菜单中的「_Safari_」。 3. 单击「_设置…_」→「_扩展_」。 -4. Clear the checkboxes for AdGuard Mini’s extensions: _Custom_, _General_, _Other_, _Privacy_, _Security_, _Social_, and _AdGuard for Safari_. - ![Unchecked extensions](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/unchecked-extensions.png) +4. 取消选中 AdGuard 扩展:「自定义」、「一般」、「其他」、「隐私」、「安全」、「社交」、「Safari 版 AdGuard」和「AdGuard 助手」。 + ![未勾选扩展](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/unchecked-extensions.png) 5. 重新启动 Safari 浏览器。 -6. Return to Safari → _Settings..._ → _Extensions_ and re-enable the AdGuard extensions. +6. 返回 Safari → 「_设置..._」→「_扩展_」并重新启用 AdGuard 扩展。 -Now everything should work as intended: filtering is on when AdGuard Mini is enabled, and filtering is off when it is disabled. +现在一切应正常工作:启用 AdGuard Mini 时过滤开启,禁用时过滤关闭。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/logs.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/logs.md index 56ebf9f6ebe..e9fd6bb8a7b 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/logs.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/logs.md @@ -1,32 +1,32 @@ --- -title: How to collect logs in AdGuard Mini for Mac +title: 如何在 Mac 版 AdGuard Mini 中收集日志 sidebar_position: 4 --- :::info -This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) +这篇文章是关于 Mac 版的 AdGuard Mini,用于 Safari 浏览器的保护。 要全面保护设备,请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock)。 ::: -To analyze and diagnose various problems that may occur with AdGuard Mini for Mac, the AdGuard support service may need its log files. 这些文件包含错误和其他软件事件的日志记录。 下面我们简述获取日志文件的方式并在需要的时候反送给我们的客服支持。 +为了分析和诊断 AdGuard Mini Mac 版可能出现的各种问题,AdGuard 支持服务可能需要其日志文件。 这些文件包含错误和其他软件事件的日志记录。 下面我们简述获取日志文件的方式并在需要的时候反送给我们的客服支持。 ### 如何收集日志记录 -1. Open AdGuard Mini. -2. Go to _Settings_, scroll down, and click _Export logs_. +1. 打开 AdGuard Mini。 +2. 前往「设置」,向下滚动并点击「导出日志」。 3. 选择保存 .zip 文件的位置,然后点击「_保存_」。 -Now you can send this file to [support@adguard.com](mailto:support@adguard.com) or attach it to your bug report on GitHub. +现在您可以将此文件发送至 [support@adguard.com](mailto:support@adguard.com),或将其附加到您在 GitHub 上的错误报告中。 :::note -AdGuard 致力于保护用户的个人隐私。 We strictly follow our [Privacy Policy](https://adguard.com/privacy.html) and do not collect any private information about users. 请注意:在将您的日志记录发送给客户支持团队之前,请检查文件,因为它会包含您不想分享的附加信息。 如果其中包含此类个人信息,我们建议您先将其删除。 +AdGuard 致力于保护用户的个人隐私。 我们严格遵守[隐私政策](https://adguard.com/privacy.html),不收集用户的私人信息。 请注意:在将您的日志记录发送给客户支持团队之前,请检查文件,因为它会包含您不想分享的附加信息。 如果其中包含此类个人信息,我们建议您先将其删除。 ::: -### How to attach your log to a bug report on GitHub +### 如何在 GitHub 上提交错误报告时附加日志 -1. Go to the [AdGuard Mini for Mac GitHub repo](https://github.com/AdguardTeam/AdGuardMiniForMac/issues) and click _New issue_. -2. Send the log file to [devteam@adguard.com](mailto:devteam@adguard.com). 包括错误发生的时间并附加指向您的问题或其编号的链接(它在标题旁边显示为 #number)。 - Alternatively, you can upload the log file to Google Drive and send it to [devteam@adguard.com](mailto:devteam@adguard.com). 将文件链接添加到您的 GitHub 问题. +1. 前往 [AdGuard Mini Mac 版 GitHub 仓库](https://github.com/AdguardTeam/AdGuardMiniForMac/issues),点击「新建问题」(英文:New issue)。 +2. 将日志记录文件发送至 [devteam@adguard.com](mailto:devteam@adguard.com)。 包括错误发生的时间并附加指向您的问题或其编号的链接(它在标题旁边显示为 #number)。 + 或者,您可以将日志文件上传到 Google Drive 并将其发送至 [devteam@adguard.com](mailto:devteam@adguard.com)。 将文件链接添加到您的 GitHub 问题. diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/private-sonoma.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/private-sonoma.md index d6f5ea6e3cf..f8e216c7d44 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/private-sonoma.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/private-sonoma.md @@ -1,11 +1,11 @@ --- -title: AdGuard Mini doesn’t work in private tabs on macOS Sonoma +title: AdGuard Mini 无法在 macOS Sonoma 上的私人标签中运行 sidebar_position: 5 --- :::info -This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) +这篇文章是关于 Mac 版的 AdGuard Mini,用于 Safari 浏览器的保护。 要全面保护设备,请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock)。 ::: @@ -19,4 +19,4 @@ This article is about AdGuard Mini for Mac, which safeguards only your Safari br 如果上述方法无效,广告仍未被屏蔽,请发送电子邮件至 support@adguard.com 联系我们的支持人员。 -If you only have problems with a specific page or website, you can report it directly from the browser: click the AdGuard Mini icon next to the Safari search bar, and then click _Report an issue_. +如果只有特定网页或网站出现问题,可以直接从浏览器举报:点击 Safari 搜索栏旁的 AdGuard Mini 图标,然后点击「举报问题」。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/rule-limit.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/rule-limit.md index 372d5e1ea07..2938316b06d 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/rule-limit.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/rule-limit.md @@ -5,15 +5,15 @@ sidebar_position: 1 :::info -This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) +这篇文章是关于 Mac 版的 AdGuard Mini,用于 Safari 浏览器的保护。 要全面保护设备,请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock)。 ::: ## Safari 内容拦截器规则数量限制 -AdGuard Mini for Mac uses the Content Blocking API to apply filtering rules to pages in the Safari browser. 目前,每个内容拦截扩展最多可使用 150,000 个规则。 +AdGuard Mini Mac 版使用内容拦截 API 将过滤规则应用于 Safari 浏览器中的页面。 目前,每个内容拦截扩展最多可使用 150,000 个规则。 -AdGuard Mini for Mac has 6 content blockers: +Mac 版 AdGuard Mini 有六种内容拦截器: - AdGuard 常用 - AdGuard 隐私 @@ -24,13 +24,13 @@ AdGuard Mini for Mac has 6 content blockers: 这样,总共有 900 000 个过滤规则。 -However, **one extension can contain only up to 150,000 rules**. 如果用户超过此数量限制,某些规则将无法应用。 这可能会导致错误拦截。 +不过,**一个扩展最多只能包含 150 000 个规则**。 如果用户超过此数量限制,某些规则将无法应用。 这可能会导致错误拦截。 ## 如何检查是否超出规则数量限制 -1. Open AdGuard Mini app. -2. Go to _Settings_ → _Safari extensions_. -3. Below each extension, you can see the enabled filters and the number of active rules. - ![Extensions tab](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/extensions.png) +1. 打开 AdGuard Mini 应用程序。 +2. 转至「_设置_」→「_Safari 扩展_」。 +3. 在每个扩展下方,用户将看到已启用的过滤器和活动规则的数量。 + ![扩展标签](https://cdn.adtidy.org/content/kb/ad_blocker/mini_mac/extensions.png) 如果内容拦截器中启用的规则数量超过 150,000 个,则可能需要禁用其中的某些过滤器或用户规则。 请转到「_过滤器_」,选择有问题的过滤器类别,禁用不需要的过滤器或用户规则。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/solving-problems.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/solving-problems.md index 284c2c76e22..a0e409509c7 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/solving-problems.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/solving-problems/solving-problems.md @@ -5,14 +5,14 @@ sidebar_position: 1 :::info -This article is about AdGuard Mini for Mac, which safeguards only your Safari browser. To protect your Mac entirely, [download the AdGuard app](https://agrd.io/download-kb-adblock) +这篇文章是关于 Mac 版的 AdGuard Mini,用于 Safari 浏览器的保护。 要全面保护设备,请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock)。 ::: -Here are some problems you may encounter and workarounds, as well as guides and instructions you may need: +以下是用户会遇到的一些问题以及可能需要的解决方法、指南和指示说明。 -- [Rule limit issues](/adguard-mini-for-mac/solving-problems/rule-limit.md) -- [Filtering doesn’t work and ads aren’t blocked](/adguard-mini-for-mac/solving-problems/ads-not-blocked.md) -- [Filtering doesn’t stop when AdGuard Mini is disabled](/adguard-mini-for-mac/solving-problems/filters-after-disable.md) -- [How to collect logs in AdGuard Mini for Mac](/adguard-mini-for-mac/solving-problems/logs.md) -- [AdGuard Mini doesn’t work in private tabs on macOS Sonoma](/adguard-mini-for-mac/solving-problems/private-sonoma.md) +- [规则数量上限的问题](/adguard-mini-for-mac/solving-problems/rule-limit.md) +- [过滤无效,无法拦截广告](/adguard-mini-for-mac/solving-problems/ads-not-blocked.md) +- [禁用 AdGuard Mini 后过滤不停止](/adguard-mini-for-mac/solving-problems/filters-after-disable.md) +- [如何在 Mac 版 AdGuard Mini 中收集日志](/adguard-mini-for-mac/solving-problems/logs.md) +- [AdGuard Mini 在 macOS Sonoma 的隐私标签页中无法正常工作](/adguard-mini-for-mac/solving-problems/private-sonoma.md) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index fb6d24f79b6..307be043325 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -2757,7 +2757,7 @@ This modifier completely changes the rule behavior. If it is applied, the rule w You will need some knowledge of regular expressions to use `$replace` modifier. -**Features** +**功能** - `$replace` rules apply to any text response, but will not apply to binary (`media`, `image`, `object`, etc.). - `$replace` rules do not apply if the size of the original response is more than 10 MB. @@ -2830,7 +2830,7 @@ Rules with `$replace` modifier are supported by AdGuard for Windows, AdGuard for The `$urltransform` rules allow you to modify the request URL by replacing text matched by a regular expression. -**Features** +**功能** - `$urltransform` rules normally only apply to the path and query parts of the URL, see below for one exception. - `$urltransform` will not be applied if the original URL is blocked by other rules. diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/extensions.md index a7130bf6f18..500a9612c04 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/extensions.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/extensions.md @@ -61,7 +61,7 @@ SponsorBlock skips sponsored segments in YouTube videos. It saves time by jumpin :::info -This userscript runs exclusively on our desktop applications, AdGuard for Windows and AdGuard for Mac. +此用户脚本仅在我们的桌面应用程序 AdGuard Windows 版和 AdGuard Mac 版上运行。 ::: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/how-to-install.md index 70c6f007a71..b695be5edd1 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: 如何安装 AdGuard -sidebar_position: 9 +sidebar_position: 10 --- 根据您想安装的 AdGuard 应用程序或浏览器扩展,请按照以下不同的链接找到相关文章: diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md index 3953f47d26f..05642d350b0 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows-8/settings/app-settings/network-settings.md @@ -43,6 +43,14 @@ Here you can choose which proxy AdGuard should use to download filter updates or ## Use SockFilter driver -Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. +Enable this option to use the SockFilter driver, which helps block ads and trackers in apps on Windows 8 and later. If this option is disabled, AdGuard will switch to the older WFP driver instead. -If this option is disabled, AdGuard will switch to the older WFP driver instead. +SockFilter was first introduced in v8.0 RC. It is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. + +When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: + +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. +- **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md index 251e49cf286..1ab588bb16c 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows-8/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v8.0 RC, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows-8/settings/app-settings/network-settings/). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -123,7 +131,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md index 5945618ea9c..f8074e9cfa1 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/features/network.md @@ -17,23 +17,35 @@ In this module you can select the checkbox _Use AdGuard as an HTTP proxy_ to use At last, there is a section with proxy settings. There you can specify which proxy server AdGuard should use to update filters, get new versions, and so on. -### SockFilter and other network drivers +### Enable traffic filtering -In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. +Traffic filtering is the core mechanism that allows AdGuard to inspect and control the network traffic generated by applications on your computer. When it is enabled, AdGuard intercepts outgoing and incoming connections and checks them against its filtering rules. If a request matches a blocking rule, AdGuard can block it, modify it, or allow it depending on the configuration. In AdGuard for Windows, this interception is implemented through network drivers. -**WFP** (Windows Filtering Platform) is a powerful driver, but it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) for some users. +If HTTPS filtering is enabled, AdGuard performs a controlled local TLS interception: it decrypts the traffic using its local certificate, applies filtering rules, and then re-encrypts the traffic before sending it to the browser. The driver simply provides the system-level access needed for AdGuard to intercept these connections. -The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. +In _Network_, you can also enable traffic filtering and choose which driver to use: SockFilter, WFP, or TDI. + +#### SockFilter **SockFilter** is an _experimental_, lightweight kernel-mode network driver that works at the socket level (TCP/UDP). Instead of inspecting or modifying packets as they travel through the full Windows networking stack, a sock filter intercepts socket calls (e.g., connect, send, receive, bind) at a higher, more stable abstraction level. This makes it ideal for applications that need to monitor or control network activity without deep packet processing. -Currently, SockFilter Right is still unstable, and you may encounter bugs. When fully tested and implemented, SockFilter has the potential to bring several advantages over other drivers: +SockFilter was first implemented in version 7.22.4, and it is still considered unstable — you may encounter bugs. Once fully tested and implemented, SockFilter has the potential to offer several advantages over other drivers: -- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP's low-level packet filtering. +- **It operates at a higher, socket-level layer**: SockFilter works with socket operations rather than raw packets, making it less complex and more stable than WFP’s low-level packet filtering. - **No interference with other network drivers**: Because it sits above VPN, firewall, and antivirus WFP filters, it avoids filter-ordering problems and compatibility conflicts common in the WFP stack. -- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn't run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. +- **Greatly reduced risk of NETIO-related BSODs**: SockFilter doesn’t run inside the NETIO packet pipeline, so it avoids the typical crash scenarios caused by WFP callouts mishandling buffers, classification results, or packet memory. + +When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that’s exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. -When it comes to disadvantages, SockFilter driver sees only socket-level operations and does not capture traffic generated by other kernel drivers or components that bypass the standard Winsock API. From a low-level networking perspective, this can be viewed as a limitation, since the driver cannot access raw packets or inspect non-socket traffic. However, for an ad-blocking application, this behavior is not just acceptable but optimal. All relevant traffic from browsers and user-mode applications goes through standard sockets, and that's exactly what we need to control. At the same time, ignoring low-level driver traffic removes unnecessary complexity, avoids compatibility issues, and keeps the system stable. +#### WFP + +**WFP** (Windows Filtering Platform) is a Microsoft networking framework built into Windows that allows software to filter and monitor network packets at different layers of the system networking stack. AdGuard uses WFP to safely hook into the network flow of applications and apply filtering rules before the traffic reaches the browser or the Internet. [More information](https://learn.microsoft.com/en-us/windows/win32/fwp/windows-filtering-platform-architecture-overview). + +While it is a powerful driver, it may present stability risks, such as [occasional system crashes (BSOD)](https://github.com/AdguardTeam/AdguardForWindows/issues/5792) and lower Internet speed for some users. + +#### TDI + +The **TDI** driver is also available, but it is outdated and may cause [filtering issues in some versions of Google Chrome](https://github.com/AdguardTeam/AdguardForWindows/issues/5771). [A temporary workaround exists](https://adguard.com/kb/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142/), but it’s not a reliable long-term solution. ### AdGuard VPN diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md index ab90a964b9f..5699b31b033 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/features/settings.md @@ -44,12 +44,8 @@ Before you start manually writing your own rules read our detailed [syntax guide Many websites gather information about their visitors, such as their IP addresses, browser and operating system details, screen resolution, and the webpage from which the user came or was redirected. Some websites use cookies to mark and identify your browser, save your personal settings and preferences. This allows them to “recognize” you on your next visit. Tracking protection safeguards your personal information from these data- and statistics-gathering systems. -![Tracking protection levels \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection1.png) - You can adjust the _Tracking Protection_ settings as needed. For example, you can prevent websites from receiving the search request that you used to find them on the Internet, automatically delete third- and first-party cookies, and disable location sharing in your browser, to prevent tracking of your whereabouts. -![Tracking protection custom features \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/settings/tracking_protection2.png) - To learn everything about _Tracking protection_ and its many options, [read this article](/general/stealth-mode). ### Browsing security diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md index 2d9c4320c1a..8a69d19a031 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/low-level-settings.md @@ -112,8 +112,8 @@ Host: example.org` will be converted to -`GET /foo/bar/ HTTP/1.1 -Host: example.org` +`GET /foo/bar/ HTTP/1.1 +Host:example.org` This option is only applied when the *Protect from DPI* Stealth mode option is enabled. diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 62370bf3eb1..bec08d0c665 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -33,6 +33,14 @@ Because of this, TDI-based traffic visibility becomes increasingly unstable. In AdGuard already treats the TDI driver as deprecated, and its complete removal is planned as the product evolves. +## Permanent solution + +From v7.22.4, we’ve added experimental support for the SockFilter driver. It fixes the issue by solving conflicts in the WFP stack. [More information](/adguard-for-windows/features/network/#sockfilter-and-other-network-drivers). + +To use it, go to _Settings → Network → Traffic filtering_, enable traffic filtering, and select _SockFilter (Experimental)_ from the list of available options. + +Since it’s experimental, there may be bugs. If you notice anything unusual, unexpected, or just plain broken, **you can switch back to TDI or WFP at any time** in the same section. + ## Temporary solution Certain Windows registry changes can force the browser to stop using AppContainer, causing its processes to run in a non-sandboxed mode again. Network Service stops using the WSK stack and falls back to a network path that the TDI driver can see. AdGuard then regains the ability to filter browser traffic. @@ -136,7 +144,3 @@ You should see the following policies active: If available, click _Reload policies_. Done! - -## Permanent solution - -We’re planning to add support for the SockFilter driver in the upcoming versions. It will fix the issue by solving conflicts in the WFP stack. [More information](https://github.com/AdguardTeam/AdguardForWindows/issues/5780). diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/github-repos.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/github-repos.md new file mode 100644 index 00000000000..dfb164c44bc --- /dev/null +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/github-repos.md @@ -0,0 +1,238 @@ +--- +title: AdGuard’s GitHub repositories +sidebar_position: 9 +--- + +At AdGuard, our goal is to make the Internet safer, more comfortable, and more transparent. This commitment is reflected not only in our product features and strict privacy policies, but also in the fact that we keep our work as open as possible. That includes actively interacting with our community. + +This is why [all of our products have public repositories](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse) — online spaces where anybody can see what we are working on, report issues directly to AdGuard developers, and even contribute to our open-source projects. The repositories cover our ad-blocking apps, filters, browser extensions, DNS solutions, VPN tools, developer utilities, and more. There are different platforms that offer such functionality, but the most popular one by far is GitHub, and all AdGuard projects are stored there. + +This article lists the most important repositories by category, summarizes the purpose of each one, and gives a simple breakdown of what users can do there. + +:::tip + +Pro tip: Creating an issue on GitHub is the most effective way to bring the attention of AdGuard developers to a problem. Just make sure to check that a similar issue doesn’t already exist and describe the problem in a comprehensive but concise way. If it does exist, you can upvote it. + +::: + +## What is Github and its repositories + +Very simply put, you can think of GitHub as sort of Google Docs for code, where multiple people can work on the same project, track changes, and see who made which updates. It provides a central, cloud-based place to store your code so it’s accessible from anywhere. It also has teamwork tools for reviewing changes, fixing issues, and merging everyone’s work smoothly. + +GitHub is widely used for open-source projects, letting anyone view the code, suggest improvements, and contribute. + +A repository (often called “repo” for short) is the most basic element of GitHub. It’s a place where you can store your code, your files, and each file’s revision history. Repositories can have multiple collaborators and can be either public or private. + +## What can you do in AdGuard’s repositories + +You can find links to key repositories below in this article or visit the [general AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all) for a full list. In most repos, you can: + +- **View README file** on the main page: it gives you an introduction to the product and its repo + ![README file \*border](https://cdn.adtidy.org/content/blog/github-repos/see-readme.png) + +- **Check existing bug reports or feature requests**, comment and upvote + ![Check issues \*border](https://cdn.adtidy.org/content/blog/github-repos/check-issues.png) + +- **Create issues** to report bugs or request features + ![Create issues \*border](https://cdn.adtidy.org/content/blog/github-repos/create-issue.png) + +- **Check releases** for different versions and their changelogs (and install an older version if needed) + ![Check releases \*border](https://cdn.adtidy.org/content/blog/github-repos/check-releases.png) + +- **Install any older or beta version** if needed + ![Download builds \*border](https://cdn.adtidy.org/content/blog/github-repos/download-releases.png) + +:::note + +If you are new to GitHub, you’ll need to create a GitHub account in order to create new issues and comment on the existing ones. + +::: + +In open-source repos advanced users can also: + +- **Browse code** to understand product logic, what technologies are used and how they are implemented +- **Fork and contribute** via pull requests + +Whether you’re a casual user, technical expert, or a developer, AdGuard welcomes all community participation across its GitHub repos. + +## Legal documents + +### [LegalDocs](https://github.com/AdguardTeam/LegalDocs) + +As part of our commitment to transparency, we host all legal documents — such as End-User License Agreements, Privacy Policies, and Terms and Conditions — on GitHub. Our _LegalDocs_ repo lets anyone check the full history of changes to these documents. + +## AdGuard Ad Blocker products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdguardForAndroid](https://github.com/AdguardTeam/AdguardForAndroid) + +Repository of AdGuard for Android — an app that provides system-wide ad blocking. + +### [AdguardForiOS](https://github.com/AdguardTeam/AdguardForiOS) + +Repository of AdGuard for iOS — Safari content blocker with DNS and custom filters. Users can also check open-source code. + +### [AdguardForWindows](https://github.com/AdguardTeam/AdguardForWindows) + +Repository of AdGuard for Windows. Non-open-source; GitHub used as an open bug tracker. + +### [AdguardForMac](https://github.com/AdguardTeam/AdguardForMac) + +Repository of AdGuard for Mac — macOS standalone content blocker. Bug tracker only. + +### [AdguardBrowserExtension](https://github.com/AdguardTeam/AdguardBrowserExtension) + +Repository of AdGuard Browser Extension — extension that provides ad blocking with enhanced privacy for Chrome, Firefox, Opera, Edge. + +### [AdguardForSafari](https://github.com/AdguardTeam/AdGuardForSafari) + +Repository of AdGuard for Safari — Safari ad blocking extension for Mac. Users can also check open-sourced code. + +### [AdGuardCLI](https://github.com/AdguardTeam/AdGuardCLI) + +Repository of AdGuard for Linux — a command‑line interface for managing ad blocking. + +## AdGuard VPN products + +In these repositories, users can: + +- View and report bugs or feature requests via GitHub issues +- Check changelogs, track release history, monitor updates +- Download latest, previous, and beta builds (except for iOS) + +### [AdGuardVPNForiOS](https://github.com/AdguardTeam/AdGuardVPNForiOS) + +Repository of AdGuard VPN for iOS. Serves as an open bug tracker. + +### [AdGuardVPNForAndroid](https://github.com/AdguardTeam/AdGuardVPNForAndroid) + +Repository of AdGuard VPN for Android. Serves as an open bug tracker. + +### [AdGuardVPNForWindows](https://github.com/AdguardTeam/AdGuardVPNForWindows) + +Repository of AdGuard VPN for Windows. Serves as an open bug tracker. + +### [AdGuardVPNForMac](https://github.com/AdguardTeam/AdGuardVPNForMac) + +Repository of AdGuard VPN for Mac — app designed for macOS. + +### [AdGuardVPNExtension](https://github.com/AdguardTeam/AdGuardVPNExtension) + +Repository of AdGuard VPN Browser Extension. + +### [AdGuardVPNCLI](https://github.com/AdguardTeam/AdGuardVPNCLI) + +Repository of AdGuard VPN for Linux — a command‑line interface for managing VPN connection. The repo acts as a bug tracker. + +## DNS-based products + +### [AdGuardDNS](https://github.com/AdguardTeam/AdGuardDNS) + +Open-source repository that is also used for tracking bugs and issues related to AdGuard DNS service. Users can: + +- View and report DNS issues +- Suggest improvements + +### [AdGuardHome](https://github.com/AdguardTeam/AdGuardHome) + +Repository of AdGuard Home — free network-wide software for blocking ads and trackers via DNS. Users can: + +- Check and file bug reports or feature requests +- Review or contribute to code +- Download and install releases + +## Documentation and Knowledge bases + +Knowledge bases are aimed to help users better understand and use AdGuard. They describe each AdGuard product in detail: from feature overviews and problem-solving guides to advanced setting manuals and API documentations. In the repositories users can: + +- Suggest corrections or edits to knowledge base articles +- Propose new articles +- Test or run the local version + +### [KnowledgeBase](https://github.com/AdguardTeam/KnowledgeBase) + +Central documentation for AdGuard Ad Blocker and the technologies related to it. + +### [KnowledgeBaseDNS](https://github.com/AdguardTeam/KnowledgeBaseDNS) + +Detailed feature overview, troubleshooting guides and documentation for AdGuard DNS (both Public and Private), AdGuard Home, and everything related to them. + +### [KnowledgeBaseVPN](https://github.com/AdguardTeam/KnowledgeBaseVPN) + +Detailed feature overview and troubleshooting guides for AdGuard VPN. + +### [KnowledgeBaseMail](https://github.com/AdguardTeam/KnowledgeBaseMail) + +Detailed feature overview and troubleshooting guides of AdGuard Mail. + +## Core libraries + +### [CoreLibs](https://github.com/AdguardTeam/CoreLibs) + +AdGuard’s cross-platform core filtering engine. Used in Android, Windows, and Mac products. Users can: + +- Explore filtering logic and DNS handling +- Report bugs and suggest features via Issues + +### [DNSLibs](https://github.com/AdguardTeam/DNSLibs) + +A DNS library used by CoreLibs and AdGuardHome. Users can: + +- Review and contribute to low-level DNS implementation +- Suggest optimizations + +### [VPNLibs](https://github.com/AdguardTeam/VPNLibs) + +Shared codebase used in AdGuard VPN products across platforms for AdGuard VPN protocol implementation. Users can: + +- Contribute to VPN stack behavior +- Report or view performance issues and bugs + +## Core ad blocking and filtering technologies + +### [AdguardFilters](https://github.com/AdguardTeam/AdguardFilters) + +Contains AdGuard’s core filter lists. Users can: + +- View and download filter lists +- Create issues to report false positives or suggest new rules +- Monitor updates to filter logic + +### [AdGuardSDNSFilter](https://github.com/AdguardTeam/AdGuardSDNSFilter) + +Repository of AdGuard DNS filter — the main DNS-level blocking list used in AdGuard DNS and DNS filtering features. Users can: + +- Inspect the current rule set +- Propose changes or additions + +### [AGLint](https://github.com/AdguardTeam/AGLint) + +A linter for adblock filter list syntax. Users can: + +- Install AGLint to check their projects for rule issues +- Contribute to lint rules + +### [Scriptlets](https://github.com/AdguardTeam/Scriptlets) + +JavaScript helpers used in filtering rules. Users can: + +- Explore available scriptlets +- Submit pull requests for new scriptlets + +### [tsurlfilter](https://github.com/AdguardTeam/tsurlfilter) + +TypeScript content blocker library for browser extensions. Users can: + +- Explore how filtering logic is implemented +- Contribute fixes and features + +## There’s more + +Above, we listed 27 main public AdGuard repositories out of 96 total. If you want to go down the rabbit hole, you can [find the rest on the AdGuardTeam GitHub page](https://github.com/orgs/AdguardTeam/repositories?type=all&q=visibility%3Apublic+archived%3Afalse). + +We’ll be waiting for your feedback there! Stay safe online and offline. diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/how-to-install.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/how-to-install.md index 106a29529a8..4ba78d7a094 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/how-to-install.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/how-to-install.md @@ -1,6 +1,6 @@ --- title: How to install AdGuard -sidebar_position: 9 +sidebar_position: 10 --- Depending on which AdGuard app or browser extension you want to install, follow one of these links to find the relevant article: