diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..9e4df49d235 --- /dev/null +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/be/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/be/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/be/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/be/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/be/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index b47f9e3dfad..44d6755f2db 100644 --- a/i18n/be/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/be/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..9e4df49d235 --- /dev/null +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/bn/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/bn/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/bn/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index b47f9e3dfad..44d6755f2db 100644 --- a/i18n/bn/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/bn/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/cs/code.json b/i18n/cs/code.json index 2c66013d469..5030672dde9 100644 --- a/i18n/cs/code.json +++ b/i18n/cs/code.json @@ -1,10 +1,10 @@ { "siteConfig.title": { - "message": "AdGuard Knowledge Base", + "message": "Databáze znalostí AdGuard", "description": "The site title used in the browser tab and metadata" }, "siteConfig.tagline": { - "message": "Knowledge Base for AdGuard products", + "message": "Databáze znalostí pro produkty AdGuard", "description": "The site tagline used in meta description" }, "theme.ErrorPageContent.title": { diff --git a/i18n/cs/docusaurus-plugin-content-docs/current.json b/i18n/cs/docusaurus-plugin-content-docs/current.json index da181e7cbe0..554d3c096f8 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current.json +++ b/i18n/cs/docusaurus-plugin-content-docs/current.json @@ -208,7 +208,7 @@ "description": "The label for category 'Solving problems' in sidebar 'tutorialSidebar'" }, "sidebar.tutorialSidebar.category.AdGuard for Windows v7": { - "message": "AdGuard for Windows v7", + "message": "AdGuard pro Windows v7", "description": "The label for category 'AdGuard for Windows v7' in sidebar 'tutorialSidebar'" } } diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/filters.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/filters.md index 87aa78ad517..3a3483d2414 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/filters.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/filters.md @@ -9,36 +9,36 @@ Tento článek je o Rozšíření prohlížeče AdGuard, které chrání pouze v ::: -- [Custom filters](#custom-filters) -- [User rules](#user-rules) -- [Allowlist](#allowlist) +- [Vlastní filtry](#custom-filters) +- [Uživatelská pravidla](#user-rules) +- [Seznam povolených](#allowlist) -Blocking ads is the core functionality of any ad blocker, and AdGuard Browser Extension is no exception. Blokování reklam je založeno na filtrech — sadách pravidel napsaných ve speciálním jazyce. These rules define which page elements should be blocked and which should not. AdGuard interprets these rules and modifies web requests accordingly. V důsledku toho se na vašich webových stránkách přestanou zobrazovat reklamy. +Blokování reklam je jednoznačně klíčovou funkcí každého blokátoru reklam, Rozšíření prohlížeče AdGuard není výjimkou. Blokování reklam je založeno na filtrech — sadách pravidel napsaných ve speciálním jazyce. Tato pravidla určují, které prvky mají být blokovány a které ne. AdGuard interpretuje tato pravidla a na jejich základě upravuje webové požadavky. V důsledku toho se na vašich webových stránkách přestanou zobrazovat reklamy. ![Filters \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/filters.png) Všechny filtry jsou seskupeny podle kategorií na základě jejich funkce: -- Ad blocking: Block various types of advertisements -- Privacy: Block online trackers and analytical systems to protect your data -- Social widgets: Block social media elements like _Like_ and _Share_ buttons -- Annoyances: Block irritating web elements, such as cookie notices, third-party widgets, or in-page popups -- Security: Block requests to phishing and malicious websites -- Other: Contain miscellaneous filters that do not fit into the main categories -- Language-specific: Block ads on websites in specific languages -- Custom: Allow you to add your own filters from a local file or URL +- Blokování reklam: Blokování různých typů reklam +- Ochrana soukromí: Blokování online sledovacích nástrojů a analytických systémů pro ochranu dat +- Widgety sociálních sítí: Blokování prvků sociálních sítí, jako jsou tlačítka _Líbí se mi_ a _Sdílet_ +- Obtěžující prvky: Blokování rušivých prvků na webu, jako jsou upozornění na soubory cookie, widgety třetích stran nebo vyskakovací okna přímo na stránce +- Zabezpečení: Blokování požadavků na phishingové a škodlivé webové stránky +- Ostatní: Obsahuje různé filtry, které nespadají do hlavních kategorií +- Jazykově specifické: Blokování reklam na webových stránkách v konkrétních jazycích +- Vlastní: Umožňuje přidat vlastní filtry z lokálního souboru nebo z URL adresy -You can enable either individual filters or entire groups at once. +Můžete aktivovat buď jednotlivé filtry, nebo celé skupiny najednou. ![Security filters \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/security_filters.png) -## Custom filters {#custom-filters} +## Vlastní filtry {#custom-filters} Zatímco funkce ostatních skupin filtrů jsou víceméně jasné, existuje skupina s názvem _Vlastní_, která může vyvolat další otázky. ![Custom filters \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/custom_filters.png) -In this tab, you can add filters that are not included in the extension by default. Na internetu je k dispozici spousta [veřejně dostupných filtrů](https://filterlists.com). Navíc můžete vytvářet a přidávat vlastní filtry. Ve skutečnosti si můžete vytvořit libovolnou sadu filtrů a přizpůsobit blokování reklam podle svých představ. +Na této kartě můžete přidat filtry, které ve výchozím nastavení rozšíření neobsahuje. Na internetu je k dispozici spousta [veřejně dostupných filtrů](https://filterlists.com). Navíc můžete vytvářet a přidávat vlastní filtry. Ve skutečnosti si můžete vytvořit libovolnou sadu filtrů a přizpůsobit blokování reklam podle svých představ. Chcete-li přidat filtr, stačí kliknout na _Přidat vlastní filtr_, zadat adresu URL nebo cestu k souboru filtru, který chcete přidat a kliknout na _Další_. @@ -54,7 +54,7 @@ _Uživatelská pravidla_ jsou další nástroj, který vám pomůže přizpůsob Nová pravidla lze přidávat několika způsoby. Nejjednodušší je prostě zadat pravidlo, ale vyžaduje to určitou znalost [syntaxe pravidel](/general/ad-filtering/create-own-filters). -Seznam filtrů připravený k použití můžete importovat také z textového souboru. **Make sure that different rules are separated by line breaks.** +Seznam filtrů připravený k použití můžete importovat také z textového souboru. **Ujistěte se, že jednotlivá pravidla jsou oddělena zalomením řádků.** :::note @@ -62,18 +62,18 @@ Import seznamu filtrů připravených k použití je lepší provést na zálož ::: -You can export your own filtering rules. Tato možnost je vhodná pro přenos seznamu pravidel mezi prohlížeči nebo zařízeními. +Můžete exportovat svá vlastní pravidla filtrování. Tato možnost je vhodná pro přenos seznamu pravidel mezi prohlížeči nebo zařízeními. -When you add a website to _Allowlist_ or use the Assistant tool to hide an element on a page, the corresponding rule is automatically saved in _User rules_. +Když přidáte webovou stránku na _Seznam povolených_, nebo použijete nástroj Asistent pro skrytí prvku na stránce, uloží se příslušné pravidlo také do _Uživatelských pravidel_. ## Seznam povolených {#allowlist} -_Allowlist_ is used to exclude specific websites from filtering. None of the blocking rules will apply to the websites on this list. +_Seznam povolených_ se používá k vyloučení určitých webových stránek z filtrování. Na webové stránky uvedené v tomto seznamu se nevztahuje žádné z pravidel blokování. ![Allowlist \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/allowlist.png) -_Allowlist_ can also be inverted, allowing you to unblock ads everywhere except on the websites added to this list. To do this, go to _Additional settings_ and enable _Invert Allowlist_. Before it activates, a confirmation dialog will appear to explain how it works and prevent accidental activation. +_Seznam povolených_ lze také obrátit, což vám umožní odblokovat reklamy všude kromě webových stránek přidaných do tohoto seznamu. Chcete-li to provést, přejděte do části _Další nastavení_ a zapněte možnost _Invertovat seznam povolených_. Než se funkce aktivuje, zobrazí se potvrzovací dialogové okno, které vysvětlí její fungování a zabrání náhodné aktivaci. ![Invert allowlist \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/invert_allowlist_dialog.png) -Můžete také importovat a exportovat stávající seznamy povolených. It is useful if you want to apply the same rules across all your browsers. +Můžete také importovat a exportovat stávající seznamy povolených. To se hodí, pokud chcete ve všech svých prohlížečích použít stejná pravidla. diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/main-menu.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/main-menu.md index 9819ba39ad6..e1d014aa6a5 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/main-menu.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/main-menu.md @@ -13,12 +13,12 @@ Hlavní stránka rozšíření je přístupná po kliknutí na ikonu rozšířen ![Main menu \*mobile_border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/main_popup_mv2.png) -From the main page, you can manage your protection and access key features: +Na hlavní stránce můžete spravovat svou ochranu a přistupovat k klíčovým funkcím: -- Manually hide any element on a webpage (a custom rule will be automatically added to your _User rules_) -- Open _Filtering log_ to view detailed information about your browser’s traffic and block requests on the fly -- Submit a complaint about missed ads or broken page elements so our filter engineers can review and fix the issue -- Check a website’s security report -- See statistics on all blocked elements +- Ručně skrýt libovolný prvek na stránce (vlastní pravidlo bude automaticky přidáno do vašich _Uživatelských pravidel_) +- Otevřít _Log filtrování_, abyste si mohli prohlédnout podrobné informace o provozu ve vašem prohlížeči a za běhu blokovat požadavky +- Nahlásit problém s nezablokovanýma reklamami nebo nefunkčními prvky stránky, aby jej naši inženýři zabývající se filtry mohli prověřit a vyřešit +- Zkontrolovat bezpečnostní zprávu o webové stránce +- Zobrazit statistiky všech zablokovaných prvků Kliknutím na ikony v pravém horním rohu hlavní nabídky rozšíření můžete otevřít nastavení rozšíření nebo pozastavit ochranu. diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/other-features.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/other-features.md index 537a952c600..1a0e2252071 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/other-features.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/features/other-features.md @@ -9,7 +9,7 @@ Tento článek je o Rozšíření prohlížeče AdGuard, které chrání pouze v ::: -Apart from the main settings of AdGuard Browser Extension, there are several more specific features that can be configured in the [_General_](#general) and [_Additional settings_](#misc) tabs. +Kromě velkých klíčových modulů rozšíření prohlížeče AdGuard existuje několik dalších specifických funkcí, které lze konfigurovat na kartách [_Obecné_](#general) a [_Další nastavení_](#misc). ## Obecné {#general} @@ -17,7 +17,7 @@ Karta _Obecné_ obsahuje hlavní nastavení rozšíření a umožňuje ovládat ![General settings \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/general_settings.png) -Můžete také uložit aktuální nastavení a rychle je použít v jiném prohlížeči nebo na jiném zařízení. To do this, click _Share settings_: the extension will generate a special link and a QR code that contain your current settings. Můžete buď zkopírovat odkaz a otevřít jej v prohlížeči, nebo naskenovat QR kód na zařízení s aplikací AdGuard a otevřít odkaz přímo v aplikaci. Zobrazí se výzva k použití sdílené konfigurace, abyste mohli stejné nastavení obnovit po přeinstalování prohlížeče nebo na novém zařízení. +Můžete také uložit aktuální nastavení a rychle je použít v jiném prohlížeči nebo na jiném zařízení. Chcete-li to provést, klikněte na _Sdílet nastavení_: rozšíření vygeneruje speciální odkaz a QR kód, které obsahují vaše aktuální nastavení. Můžete buď zkopírovat odkaz a otevřít jej v prohlížeči, nebo naskenovat QR kód na zařízení s aplikací AdGuard a otevřít odkaz přímo v aplikaci. Zobrazí se výzva k použití sdílené konfigurace, abyste mohli stejné nastavení obnovit po přeinstalování prohlížeče nebo na novém zařízení. V případě potřeby můžete tento odkaz sdílet s dalšími lidmi nebo jej připojit k žádosti o podporu, aby náš tým mohl vidět vaši přesnou konfiguraci. @@ -25,7 +25,7 @@ Kromě toho můžete svá nastavení i nadále exportovat do souboru ve formátu ## Další nastavení {#misc} -The _Additional settings_ section contains various settings that are related to the ad-blocking process and usability. +Sekce _Další nastavení_ obsahuje řadu různých nastavení, která souvisejí s procesem blokování reklam a použitelností aplikace. ![Additional settings \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/additional_settings.png) @@ -47,8 +47,8 @@ The _Send anonymized usage data_ option can also be enabled on the post-installa ::: -## About {#about} +## Informace {#about} -In the _About_ section, you can find information about the current version, links to the Privacy policy, and a link to the repository of the Browser Extension on GitHub. +V sekci _Informace_ najdete informace o aktuální verzi, odkazy na Zásady ochrany osobních údajů a odkaz na repozitář rozšíření prohlížeče na GitHubu. ![About \*border](https://cdn.adtidy.org/content/Kb/ad_blocker/browser_extension/about.png) diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md index 9b75d3b2345..c67799b548b 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/logs.md @@ -15,11 +15,11 @@ sidebar_position: 3 ![Developer mode \*border](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/chrome_extensions.png) -4. Find AdGuard Browser Extension and click `service worker`. +4. Vyhledejte rozšíření prohlížeče AdGuard a klikněte na `service worker`. ![Background \*border](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/chrome_developer_mode.png) -5. Open the tab _Console_, right-click anywhere inside the console area, and select _Save as…_. +5. Otevřete kartu _Konzola_, klikněte pravým tlačítkem kamkoli do oblasti konzole a vyberte _Uložit jako…_. ![Save as \*border](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/chrome_console_save.png) @@ -29,7 +29,7 @@ sidebar_position: 3 2. Přejděte na `about:addons`. -3. Click the gear icon and select _Debug Add-ons_. +3. Klikněte na ikonu ozubeného kola a vyberte _Doplňky ladění_. ![Debug Add-ons \*border](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/firefox_debug_addons.png) @@ -37,7 +37,7 @@ sidebar_position: 3 ![Inspect \*border](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/firefox_inspect.png) -5. In the tab _Console_ tab, right-click anywhere inside the console area and select _Save all Messages to File_. +5. Na kartě _Konzola_ klikněte pravým tlačítkem kamkoli do oblasti konzole a vyberte možnost _Uložit všechny zprávy do souboru_. ![Console \*border](https://cdn.adtidy.org/content/kb/ad_blocker/browser_extension/firefox_console_save.png) diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index c9abca895d0..d2dc396eda8 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..41f089bbd0e --- /dev/null +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +Tento článek popisuje AdGuard pro Windows, multifunkční blokátor reklam, který chrání vaše zařízení na úrovni systému. Chcete-li se podívat, jak to funguje, [stáhněte si aplikaci AdGuard](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + Zakazuje prohlížeči Google Chrome odesílat informace o verzi a modifikaci s požadavky na domény Google (včetně DoubleClick a Google Analytics). + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Spusťte AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index 08657307b83..b9cd5a005df 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 Praktické menu v nástrojové liště Safari +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Plná verze](/adguard-mini-for-mac/features/full-version.md) Pokročilé funkce, které zvyšují rychlost a výkon filtrování diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 8a46eb2b685..ae6bbec4d35 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Plná verze -sidebar_position: 9 +sidebar_position: 10 --- Plná verze aplikace AdGuard Mini pro Mac odemyká pokročilé funkce, které poskytují zvýšenou rychlost a sílu filtrování. diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..be343b23ca7 --- /dev/null +++ b/i18n/cs/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## Jak to funguje + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/adguard-for-windows.md b/i18n/cs/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/adguard-for-windows.md index dbf4a57a954..f46d6a2e471 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/adguard-for-windows.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/adguard-for-windows.md @@ -1,5 +1,5 @@ --- -title: AdGuard for Windows v7 +title: AdGuard pro Windows v7 sidebar_position: 1 --- diff --git a/i18n/cs/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/cs/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index c557fb07bd0..ea0cd39b8ca 100644 --- a/i18n/cs/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/cs/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Některá pravidla lze použít pouze v důvěryhodných filtrech. Tato kategori - seznamy filtrů [vytvořené týmem AdGuard](../adguard-filters), - seznamy vlastních filtrů nainstalované jako `trusted`, -- uživatelská pravidla. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### Blokátor obsahu AdGuard diff --git a/i18n/da/code.json b/i18n/da/code.json index 283a489b727..d375d4e0d4e 100644 --- a/i18n/da/code.json +++ b/i18n/da/code.json @@ -36,7 +36,7 @@ "description": "The default label used for the Tip admonition (:::tip)" }, "theme.admonition.danger": { - "message": "danger", + "message": "fare", "description": "The default label used for the Danger admonition (:::danger)" }, "theme.admonition.info": { @@ -44,7 +44,7 @@ "description": "The default label used for the Info admonition (:::info)" }, "theme.admonition.caution": { - "message": "caution", + "message": "forsigtig", "description": "The default label used for the Caution admonition (:::caution)" }, "theme.AnnouncementBar.closeButtonAriaLabel": { diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md index 8527e38b554..2483da328f1 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/adguard-browser-extension.md @@ -27,7 +27,7 @@ Denne artikel omhandler AdGuard Browser Extension, der kun beskytter webbrowsere - [AdGuard Browser Extension MV3](/adguard-browser-extension/mv3-version/) - MV3 versions of the AdGuard Browser Extension for Chrome, Microsoft Edge, and Opera + MV3-versioner af AdGuard Browser Extension til Chrome, Microsoft Edge og Opera - [Browserbeskyttede sider](/adguard-browser-extension/protected-pages) diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md index e79cda39444..280bfaf58ee 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/mv3-version.md @@ -3,14 +3,14 @@ title: AdGuard Browser Extension MV3 sidebar_position: 5 --- -[Chrome has removed all remaining Manifest V2 (MV2) extensions from the Chrome Web Store](https://adguard.com/en/blog/adguard-adblocker-manifestv2-removal.html), and other Chromium-based browsers, Opera and Microsoft Edge among them, are moving to MV3 as well. Users of these browsers need an MV3 extension, compatible with the new API Manifest V3. Our thoughts on this topic are extensively discussed on [our blog](https://adguard.com/en/blog/tag/manifest-v3.html). +[Chrome har fjernet alle resterende Manifest V2-udvidelser (MV2) fra Chrome Webshop](https://adguard.com/en/blog/adguard-adblocker-manifestv2-removal.html), og andre Chromium-baserede webbrowseren, bl.a. Microsoft Edge og Opera, overgår ligeledes til MV3. Brugere af disse webbrowsere behøver en MV3-udvidelse kompatibel med det nye API Manifest V3. Vores tanker om dette emne drøftes udførligt på [vores blog](https://adguard.com/en/blog/tag/manifest-v3.html). Vores MV3-udvidelse blokerer effektivt annoncer og trackere, mens den ubemærket håndterer sociale widgets, bannere og videoreklamer. De fleste brugere vil ikke bemærke nogen operationelle forskelle, men der er visse begrænsninger og ændringer at være opmærksom på. ## Her findes vores udvidelser **MV3-versionen** er vores primære Chrome-udvidelse og er tilgængelig i -[Chrome Webshop](https://chromewebstore.google.com/detail/adguard-adblocker/bgnkhhnnamicmpeenaelnjfhikgbkllg). MV3 builds are also published on [GitHub Releases](https://github.com/AdguardTeam/AdguardBrowserExtension/releases/latest) as `chrome-mv3.zip` for Chrome and `opera-mv3.zip` for Opera. +[Chrome Webshop](https://chromewebstore.google.com/detail/adguard-adblocker/bgnkhhnnamicmpeenaelnjfhikgbkllg). MV3-builds udgives også på [GitHub Releases](https://github.com/AdguardTeam/AdguardBrowserExtension/releases/latest) som `chrome-mv3.zip`. **MV3-beta** er tilgængelig i [Chrome Webshop](https://chromewebstore.google.com/detail/adguard-adblocker-mv3-exp/apjcbfpjihpedihablmalmbbhjpklbdf). diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/debug-rules.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/debug-rules.md index b7fb7d493f7..c4638a41229 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/debug-rules.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/debug-rules.md @@ -1,9 +1,9 @@ --- -title: How to debug rules in the MV3 extension +title: Sådan fejlrettes regler i MV3-udvidelsen sidebar_position: 2 --- -In the [AdGuard Browser Extension MV3](/adguard-browser-extension/mv3-version), the Filtering log only shows the approximate rules that were applied, which we call “assumed rules”. Dette skyldes, at webbrowseren ikke giver detaljer om, hvilke specifikke deklarative regler, som blev brugt, medmindre udvidelsen er i et "udpakket" format. For at få præcise oplysninger, skal brugeren selv installere den udpakkede version af udvidelsen i sin webbrowser. +I [AdGuard Browser Extension MV3](/adguard-browser-extension/mv3-version) viser filtreringsloggen kun de omtrentlige anvendte regler, hvilke vi kalder "antagne regler". Dette skyldes, at webbrowseren ikke giver detaljer om, hvilke specifikke deklarative regler, som blev brugt, medmindre udvidelsen er i et "udpakket" format. For at få præcise oplysninger, skal brugeren selv installere den udpakkede version af udvidelsen i sin webbrowser. Disse vejledninger er også beregnet til problematiske tilfælde, hvor reglerne, som følger med udvidelsen, ønskes ændret statisk. I de fleste tilfælde bør brug af _Brugerregler_ i udvidelsen være tilstrækkeligt. @@ -55,10 +55,10 @@ Disse vejledninger er også beregnet til problematiske tilfælde, hvor reglerne, yarn dev chrome-mv3 ``` -3. For Opera, run `yarn dev opera-mv3` instead — the built extension will - be located in the `./build/dev/opera-mv3` directory. +3. I Opera, kør i stedet `yarn dev opera-mv3` — den indbyggede udvidelse vil + være placeret i mappen `./build/dev/opera-mv3`. -4. The built extension will be located in the directory: +4. Den byggede udvidelse vil være placeret i mappen: ```bash ./build/dev/chrome-mv3 diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/mv2-removal-in-chrome.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/mv2-removal-in-chrome.md index 3b0cea1e280..94f571511eb 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/mv2-removal-in-chrome.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/mv2-removal-in-chrome.md @@ -34,7 +34,7 @@ automatisk, da de to versioner har forskellige udvidelses-ID'er. Sådan skiftes 4. Genindlæs åbne faner. MV3 anvender de fleste blokeringsregler via webbrowserens deklarative motor, hvilket begrænser antallet -af regler og ændrer, hvordan filtre opdateres. Before switching, see the [AdGuard Browser Extension MV3](/adguard-browser-extension/mv3-version/) article. +af regler og ændrer, hvordan filtre opdateres. Før der skiftes, tjek artiklen [AdGuard Browser Extension MV3](/adguard-browser-extension/mv3-version/). ## Fortsat brug af MV2 i andre webbrowsere @@ -97,8 +97,8 @@ og indlæs buildet igen. ::: -For the full _Developer mode_ → _Load unpacked_ flow, see the _How to install unpacked in the -browser_ section in [How to debug rules in the MV3 extension](/adguard-browser-extension/solving-problems/debug-rules/). +For den fulde _Udviklertilstand_ → _Indlæs udpakket_ flowet, se afsnittet _Sådan installeres udpakket i +webbrowseren_ i [Sådan fejlfindes i regler i MV3-udvidelse](/adguard-browser-extension/solving-problems/debug-rules/). ### Microsoft Edge diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md index 4f3a647a4a0..1c065e98ebd 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-browser-extension/solving-problems/solving-problems.md @@ -6,6 +6,6 @@ sidebar_position: 1 Her er nogle guider, der muligvis kan blive behov for til at løse problemer med AdGuard Browser Extension. - [Sådan fortsættes med at bruge AdGuard, efter Chrome har fjernet MV2](/adguard-browser-extension/solving-problems/mv2-removal-in-chrome.md) -- [How to debug rules in the MV3 extension](/adguard-browser-extension/solving-problems/debug-rules.md) +- [Sådan fejlrettes regler i MV3-udvidelsen](/adguard-browser-extension/solving-problems/debug-rules.md) - [Sådan eksporteres logfiler fra baggrundssiden](/adguard-browser-extension/solving-problems/logs.md) - [Adblockingproblemer på søgewebsteder i Opera] (/adguard-browser-extension/solving-problems/ads-not-blocked-in-opera.md) diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/adguard-for-android.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/adguard-for-android.md index bca317b3975..48bb8dad92c 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/adguard-for-android.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/adguard-for-android.md @@ -5,18 +5,18 @@ sidebar_position: 1 :::info -This article is about AdGuard for Android, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Android, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -- [Features](/adguard-for-android/features/features.md) +- [Funktioner](/adguard-for-android/features/features.md) - Main features and settings available in AdGuard for Android + Hovedfunktioner og indstillinger tilgængelige i AdGuard til Android - [Installation](/adguard-for-android/installation.md) - Installation, removal, and system requirements for AdGuard for Android + Installation, fjernelse og systemkrav til AdGuard til Android -- [Solving problems](/adguard-for-android/solving-problems/solving-problems.md) +- [Løsning af problemer](/adguard-for-android/solving-problems/solving-problems.md) - Known issues and possible solutions + Kendte problemer og mulige løsninger diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/features/low-level-settings.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/features/low-level-settings.md index 246c93705ec..2116c05c63f 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/features/low-level-settings.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/features/low-level-settings.md @@ -249,7 +249,7 @@ Er denne indstilling aktiveret, viser AdGuard kun DNS-ikonet på appens startsk #### Detektér Samsung Pay -Er denne indstilling slået til, pauseres AdGuard-beskyttelsen, når Samsung Pay-appen åbnes. 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. +Er denne indstilling slået til, pauseres AdGuard-beskyttelsen, når Samsung Pay-appen åbnes. Denne funktion kræves til koreanske brugere, da de oplever [problemer med Samsung Pay](/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea), når AdGuard er slået til. #### Vis klonede apps diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/installation.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/installation.md index cc573337e58..5d0de7aebab 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/installation.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/installation.md @@ -5,70 +5,70 @@ sidebar_position: 2 :::info -This article is about AdGuard for Android, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Android, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: ## Systemkrav -**OS version:** Android 9.0 or higher +**OS-version:** Minimum Android 9.0 **RAM:** Minimum 2 GB -**Free disk space:** 500 MB +**Ledig diskplads:** 500 MB ## Installation -Most Android-based apps are distributed via Google Play; however, AdGuard is not presented there, because Google prohibits distribution of network-level ad blockers via Google Play, i.e. apps that block commercials in other apps. You will find more information about Google restrictive policy [in our blog](https://adguard.com/blog/adguard-google-play-removal.html). +De fleste Android-baserede apps distribueres via Google Play, men AdGuard er dog ikke repræsenteret dér, da Google forbyder distribution af netværksniveau-adblockere via Google Play, dvs. apps, som blokerer reklamer i andre apps. Der findes flere oplysninger om Googles restriktive politik [på vores blog](https://adguard.com/blog/adguard-google-play-removal.html). -That’s why you can only install AdGuard for Android manually. To use the app on your mobile device, you will need to do the following. +Derfor kan AdGuard til Android kun installeres manuelt. Gør flg. for at bruge appen på en mobilenhed. -1. **Download the app on your device**. Here are a few ways you can do this: +1. **Download appen på enheden**. Her er et par måder at gøre dette på: - - head over to [our website](https://adguard.com/adguard-android/overview.html) and tap the *Download* button - - start the browser and type in the following URL: [https://adguard.com/apk](https://adguard.com/apk) - - or scan this QR code: + - gå til [vores websted](https://adguard.com/adguard-android/overview.html) og tryk på knappen *Download* + - start browseren og angiv flg. URL: [https://adguard.com/apk](https://adguard.com/apk) + - eller skan denne QR-kode: - ![QR code *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/inst-qr-en-1.png) + ![QR-kode *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/inst-qr-en-1.png) -1. **Allow installing apps from unknown sources**. Once the file download is complete, tap *Open* in the notification. +1. **Tillad installation af apps fra ukendte kilder**. Når filen er downloadet, tryk i notifikationen på *Åbn*. - ![Installing apps from unknown sources *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/inst_1.png) + ![Installation af apps fra ukendte kilder *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/inst_1.png) - A popup will appear. Tap *Settings*, navigate to *Install unknown apps*, and grant permission for the browser you've used to download the file. + En pop op vises. Tryk på *Indstillinger*, gå til *Installér ukendte apps* og giv tilladelse til webbrowseren, der er brugt til at downloade filen. - ![Installing apps from unknown sources *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/inst_3.png) + ![Installation af apps fra ukendte kilder *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/inst_3.png) -1. **Install the app**. Once the browser has obtained the necessary permissions, the system will ask you if you want to install the AdGuard app. Tap *Install*. +1. Tryk på **Installér appen**. Når webbrowseren er tildelt de nødvendige tilladelser, spørger systemet, om AdGuard-appen ønskes installeret. Tryk på *Installér*. - ![Installing apps from unknown sources *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/inst_4.png) + ![Installation af apps fra ukendte kilder *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/inst_4.png) - You will then be asked to read AdGuard's *License agreement* and *Privacy policy*. You can also participate in product development. To do this, check the boxes for *Send crash reports automatically* and *Send technical and interaction data*. Then tap *Continue*. + Brugeren anmodes dernæst om at læse AdGuards *Licensaftale* og *Fortrolighedspolitik*. Det er også muligt at deltage i produktudviklingen. Dette gøres ved at markere afkrydsningsfelterne for *Indsend nedbrudsrapporter automatisk* og *Indsend tekniske data og interaktionsdata*. Tryk dernæst på *Fortsæt*. - ![Privacy policy *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/fl_3.png) + ![Fortrolighedspolitik *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/fl_3.png) -1. **Create a local VPN**. In order to filter all traffic directly on your device and not route it through a remote server, AdGuard needs to establish a VPN connection. +1. **Opret et lokalt VPN**. AdGuard skal oprette en VPN-forbindelse for at filtrere al trafik direkte på enheden uden at rute den igennem en fjernserver. - ![Create a local VPN *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/fl_2.png) + ![Opret et lokalt VPN *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/fl_2.png) -1. **Enable HTTPS filtering**. It is not a mandatory option, however, we advice to turn it on for the best ad-blocking quality. +1. **Slå HTTPS-filtrering til**. Indstillingen er ikke obligatorisk, men den anbefales slået til for bedste adblockingkvalitet. - If your device is running Android 7–9, you'll be prompted to install a root certificate and configure HTTPS filtering after the local VPN setup. + Kører enheden Android 7–9, anmodes der efter den lokale VPN-opsætning om at installere et rodcertifikat og opsætte HTTPS-filtrering. - ![Enable HTTPS filtering on Android 7-9 *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/cert_1.jpg) + ![Slå HTTPS-filtrering til på Android 7-9 *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/cert_1.jpg) - After you tap *Install now*, a prompt will appear asking you to authenticate the certificate installation with a password or fingerprint. + Efter et tryk på *Installér nu*, anmodes via en prompt om at godkende certifikatinstallationen med adgangskode eller fingeraftryk. - ![Enable HTTPS filtering on Android 7-9. Step 2 *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/cert_2.jpg) + ![Slå HTTPS-filtrering til på Android 7-9. Trin 2 *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/cert_2.jpg) - If you have Android 10+ on your device, then after creating a local VPN, you will see the main app screen with a snack bar at the bottom with a suggestion to enable HTTPS filtering: tap *Enable* and follow the instructions on the next screen or check [the article about certificate installation](solving-problems/manual-certificate.md) for more information. + På en Android 10+ enhed vises efter oprettelsen af et lokalt VPN appens hovedskærm og en snackbar i bunden, der foreslår at aktivere HTTPS-filtrering: Tryk på *Aktivér* og følg vejledningen på næste skærm eller tjek [artiklen om certifikatinstallation](solving-problems/manual-certificate.md) for yderligere information. - ![Enable HTTPS filtering *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/fl_5.png) + ![Slå HTTPS-filtrering til *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/fl_5.png) -## Uninstalling/Reinstalling AdGuard +## Afinstallation/geninstallation af AdGuard -If you need to uninstall AdGuard on your mobile device, open *Settings* and choose *Apps* (Android 7) or *Apps & notifications* (Android 8+). Find AdGuard in the list of installed apps and press *Uninstall*. +Skal AdGuard afinstalleres på mobilenhed, åbn *Indstillinger* og vælg *Apps* (Android 7) eller *Apps og notifikationer* (Android 8+). Find AdGuard på listen over installerede apps, og tryk på *Afinstallér*. -![Reinstall AdGuard *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/inst_4.png) +![Geninstallere AdGuard *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/installation/inst_4.png) -To reinstall AdGuard, just download the apk file again and follow the steps outlined in the Installation section. Uninstallation is not required beforehand. +For at geninstallere AdGuard, download apk-filen igen og følg trinene beskrevet i afsnittet Installation. Forudgående afinstallation kræves ikke. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/manual-certificate.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/manual-certificate.md index a8bc9411a50..77703ae8417 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/manual-certificate.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/manual-certificate.md @@ -1,54 +1,54 @@ --- -title: Certificate installation on devices with Android 11+ +title: Certifikatinstallation på enheder med Android 11+ sidebar_position: 11 --- :::info -This article is about AdGuard for Android, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Android, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -To be able to [filter HTTPS traffic](/general/https-filtering/what-is-https-filtering.md) (which is extremely important as most ads use HTTPS), AdGuard needs to install its certificate into your device’s user storage. On older versions of the Android OS this was done automatically, but on Android 11 and later users have to install it manually. +For at kunne [filtrere HTTPS-trafik](/general/https-filtering/what-is-https-filtering.md) (hvilket er ekstremt vigtigt, da de fleste annoncer bruger HTTPS), skal AdGuard installere sit certifikat i enhedens brugerlager. På ældre Android OS- versioner skete dette automatisk, men fra Android 11 skal det installeres manuelt af brugeren. -![Certificate *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/manual-certificate/screenCA.gif) +![Certifikat *mobile_border](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/manual-certificate/screenCA.gif) -Follow these steps to install the AdGuard certificate: +Følg disse trin for at installere AdGuard-certifikatet: -1. Open the app. On the *Home* screen, tap *HTTPS filtering is off*. +1. Åbn appen. Tryk fra *Start*-skærmen på *HTTPS-filtrering er slået fra*. -1. Then you’ll be presented with three screens: - - HTTPS filtering is critical for ad blocking - - AdGuard’s HTTPS filtering is safe - - AdGuard certificate +1. Dernæst følger tre skærmbillederr: + - HTTPS-filtrering er kritisk for adblocking + - AdGuards HTTPS-filtrering er sikker + - AdGuard-certifikat -1. Consecutively, tap *Continue* → *Next* → *Save certificate*. +1. Tryk gentagne gange i træk på *Fortsæt* → *Næste* → *Gem certifikat*. -1. Tap *Save* at the bottom of the opened *Download* folder. +1. Tryk på *Gem* nederst i den åbnede *Download*-mappe. -1. After saving, copy the text from the *CA Certificate* field and tap *Open Settings*. +1. Efter at have gemt, kopiér teksten fra feltet *CA-certifikat* og tryk på *Åbn indstillinger*. -1. Open *Settings* and either paste or type *CA Certificate* in the search bar. Tap the respective option. +1. Åbn *Indstillinger* og indsæt/skriv *CA-certifikat* på søgebjælken. Tryk på den relevante mulighed. -1. You might see a warning. If so, tap *Install anyway* and enter your PIN if necessary. +1. En advarsel vises muligvis. Er det tilfældet, tryk på *Installér alligevel* og angiv om nødvendigt PIN-koden. -1. Select the AdGuard certificate file. Its name should look like *adguard_1342_020322.crt*. +1. Vælg AdGuard-certifikatfilen. Dens navn bør være noget i stil med *adguard_1342_020322.crt*. -You’re all set! Once the certificate is installed successfully, you’ve enabled HTTPS filtering. +Alt er nu klar! Når certifikatet er installeret korrekt, er HTTPS-filtrering aktiveret. -If you experience issues during the manual certificate installation (for example, you installed the certificate, but the application keeps ignoring it), you can follow one of the solutions below. +Opleves problemer under den manuelle certifikatinstallation (certifikatet er f.eks. blevet installeret, men det ignoreres af appen), kan en af nedenstående løsninger følges. -1. Restart AdGuard. -1. Try to install the correct certificate (AdGuard Personal CA) one more time. +1. Genstart AdGuard. +1. Prøv at installere det korrekte certifikat (AdGuard Personal CA) igen. -## Security warnings +## Sikkerhedsadvarsler -In earlier versions of Android, the quick settings panel displayed the message “Network may be monitored.” Tapping it will open a window with detailed information. +I tidligere versioner af Android viste panelet hurtig-indstillinger beskeden "Netværk kan være monitoreret." Et tryk på den åbner et vindue med detaljerede oplysninger. -Starting with Android 15, in addition to “Network may be monitored”, users will see a warning notification after installing a certificate and after restarting the device: “Certificate authorities installed by an unknown third party.” This means that the system has detected third-party certificates in the user certificate store. Tapping the notification opens a list of certificates in the user certificate store. +Fra og med Android 15 vil brugere, ud over "Netværk kan være monitoreret", se en advarselsnotifikation efter installation af et certifikat og efter genstart af enheden: "Certifikatmyndigheder installeret af en ukendt tredjepart." Det angiver, at systemet har registreret tredjepartscertifikater i brugercertifikatlageret. Et tryk på notifikationen åbner en liste over certifikater i brugercertifikatlageret. -Despite these warnings, your traffic remains secure. Your connection to remote servers stays encrypted. What AdGuard does is simply verify the server’s certificate before deciding whether to filter the connection — similar to how a browser works. +Trods disse advarsler, forbliver trafikken sikker. Forbindelsen til fjernservere forbliver krypteret. Hvad AdGuard gør, er blot at bekræfte serverens certifikat, før den beslutter, om forbindelsen skal filtreres — ligesom en webbrowser vil gøre. -[Learn more about HTTPS filtering and how the certificate works](/general/https-filtering/what-is-https-filtering.md). +[Få mere at vide om HTTPS-filtrering, og hvordan certifikatet fungerer](/general/https-filtering/what-is-https-filtering.md). -If you still encounter a problem and can’t install the certificate, please contact our support team at [support@adguard.com](mailto:support@adguard.com). +Opleves fortsat et problem, og kan certifikatet ikke installeres, kontakt venligst vores supportteam via . diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/multiple-user-profiles.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/multiple-user-profiles.md index dda13e5825a..4e46f38a624 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/multiple-user-profiles.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/multiple-user-profiles.md @@ -5,21 +5,21 @@ sidebar_position: 9 :::info -This article is about AdGuard for Android, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Android, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -In this article you will find the methods on how to solve problems with AdGuard when you set up *multiple accounts* or *Restricted Profiles* on your Android devices. +I denne artikel findes metoder til at løse problemer med AdGuard under oprettelse af *flere konti* eller *Begrænsede profiler* på Android-enheder. ## Problemer forårsaget af flere brugerprofiler -Er AdGuard installeret på Android 9 og senere for mere end én brugerprofil på enheden, kan der opstå problemer ved afinstallation af appen. Når AdGuard afinstalleres i én brugerprofil, vises appen stadig på app-listen, men den vil hverken kunne afinstallere eller geninstalleres. This happens because AdGuard is installed for a different user profile on the device. +Er AdGuard installeret på Android 9 og senere til mere end én brugerprofil på enheden, kan der opstå problemer ved afinstallation af appen. Når AdGuard afinstalleres i én brugerprofil, vises appen stadig på app-listen, men den vil hverken kunne afinstallere eller geninstalleres. Dette sker, fordi AdGuard er installeret i en anden brugerprofil på enheden. -If you try to reinstall AdGuard after an unsuccessful removal attempt, you will see the error message “You can't install the app on your device”. +Forsøges AdGuard geninstalleret efter et mislykket afinstallationsforsøg, vises fejlmeddelelsen "Appen kan ikke installeres på denne enhed”. -For at løse dette problem skal appen afinstalleres for alle brugere: Gå til Indstillinger → Alle apps → AdGuard. Tap the three-dot menu in the top right corner and select *Uninstall for all users*. +For at løse dette problem skal appen afinstalleres for alle brugere: Gå til Indstillinger → Alle apps → AdGuard. Tryk på de tre prikker øverste til højre og vælg *Afinstallér for alle brugere*. -![Uninstall *mobile border](https://cdn.adtidy.org/blog/new/tu49hmultiple_users.png) +![Afinstallation *mobile border](https://cdn.adtidy.org/blog/new/tu49hmultiple_users.png) ## Problemer forårsaget af brug af en Begrænset tilstandsprofil @@ -51,7 +51,7 @@ Denne tilgang er tilgængelig fra **AdGuard v3.5 nightly 6**. Benyttes en ældre ::: -1. [Install and configure](https://www.xda-developers.com/install-adb-windows-macos-linux/) ADB; On the Windows platform, **Samsung** owners may need to install [this utility](https://developer.samsung.com/mobile/android-usb-driver.html). +1. [Installér og opsæt](https://www.xda-developers.com/install-adb-windows-macos-linux/) ADB; På Windows-platformen skal **Samsung**-brugere muligvis også installere [dette værktøj](https://developer.samsung.com/mobile/android-usb-driver.html). 1. Tilslut via et **USB-kabel** enheden til den computer/bærbare, på hvilken **ADB** er installeret; @@ -68,7 +68,7 @@ Information om håndtering af brugerkonti på en Android-enhed kan findes [hér] :::note -Begrænsede brugerkonti oprettes i visse tilfælde obligatorisk og ikke kan fjernes. For instance, when you use Dual Messenger or Dual App features on **Samsung** or **LG** devices. Nedenfor beskrives, hvordan problemet løses i sådanne tilfælde. +Begrænsede brugerkonti oprettes i visse tilfælde obligatorisk og ikke kan fjernes. Eksempelvis, når Dual Messenger- eller Dual App-funktioner bruges på enheder fra **Samsung** eller **LG**. Nedenfor beskrives, hvordan problemet løses i sådanne tilfælde. ::: @@ -84,8 +84,8 @@ Ejere af mobiler fra **Samsung** eller **LG** kan også støde på et lignende p - Åbn **Indstillinger**; - Tryk på **Avanceret**; -- Scroll down and press **Dual Messenger**; -- Disable the **Dual Messenger** for all apps; +- Rul ned og tryk på **Dual Messenger**; +- Deaktivér **Dual Messenger** for alle apps; - Lås enheden i 5 minutter; - Oplås skærmen, og prøv at oprette VPN-profilen igen. @@ -93,6 +93,6 @@ Ejere af mobiler fra **Samsung** eller **LG** kan også støde på et lignende p - Åbn **Indstillinger**; - Vælg fanen **Generelt**; -- Scroll down and press **Dual App**; -- Remove all apps from the list; +- Rul ned og tryk på **Dual App**; +- Fjern alle apps fra listen; - Genstart enheden. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/outbound-proxy.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/outbound-proxy.md index 6982eba3e72..c6f49131cdf 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/outbound-proxy.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/outbound-proxy.md @@ -1,182 +1,182 @@ --- -title: How to set up outbound proxy +title: Sådan opsættes en udgående proxy sidebar_position: 7 --- :::info -This article is about AdGuard for Android, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Android, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -Below is a list of the most well-known applications that can be configured to work as proxies in AdGuard. +Nedenfor findes en liste over de mest velkendte apps, som kan opsættes som fungerende proxyer i AdGuard. :::note -If your app is not listed below, please check on its proxy configurations in the settings or contact its support team. +Mangler den anvendte app på listen nedenfor, tjek da dens proxyopsætning i indstillingerne, eller kontakt dens supportteam. ::: -AdGuard allows you to route your device's traffic through a proxy server. To access proxy settings, open **Settings** and then proceed to **Filtering** → **Network** → **Proxy**. +AdGuard muliggør rutning af enhedens trafik igennem en proxyserver. For at tilgå proxyindstillinger, åbn **Indstillinger** og fortsæt dernæst til **Filtrering** → **Netværk** → **Proxy**. -## Proxy configuration examples +## Eksempler på proxyopsætninger -In this article we give examples of how to set up some of the most popular proxies to work with AdGuard. +I denne artikel gives eksempler på, hvordan nogle af de mest populære proxyer opsættes til at fungere med AdGuard. -### How to use AdGuard with Tor +### Sådan bruges AdGuard med Tor -1. Open AdGuard and go to **Settings** → **Filtering** → **Network** → **Proxy**. Download “Orbot: Proxy with Tor” directly from [Google Play](https://play.google.com/store/apps/details?id=org.torproject.android&noprocess) or by tapping **Integrate with Tor** and then **Install**. +1. Åbn AdGuard, og gå til **Indstillinger** → **Filtrering** → **Netværk** → **Proxy**. Download "Orbot: Proxy with Tor" direkte fra [Google Play](https://play.google.com/store/apps/details?id=org.torproject.android&noprocess) eller ved at trykke på **Integrér med Tor** og dernæst **Installér**. -1. Open Orbot and press the **Start** button on the application's main screen. +1. Åbn Orbot, og tryk på knappen **Start** på appens hovedskærm. -1. Go back to the **Proxy** screen of AdGuard. +1. Returnér til skærmen **Proxy** i AdGuard. -1. Tap the **Integrate with Tor** button. +1. Tryk på knappen **Integrér med Tor**. -1. All the required fields will be pre-filled: +1. Alle obligatoriske felter vil være præudfyldt: - | Field | Value | - | ---------- | -------------------- | - | Proxy type | *SOCKS4* or *SOCKS5* | - | Proxy host | *127.0.0.1* | - | Proxy port | *9050* | + | Felt | Værdi | + | --------- | ----------------------- | + | Proxytype | *SOCKS4* eller *SOCKS5* | + | Proxyvært | *127.0.0.1* | + | Proxyport | *9050* | - Or you can tap **Proxy server** → **Add proxy server**, enter these values manually, and set Orbot as the default proxy. + Alternativt, tryk på **Proxyserver** → **Tilføj proxyserver**, angiv disse værdier manuelt og sæt Orbot til standardproxy. -1. Enable the main Proxy switch and AdGuard protection to route your device's traffic through the proxy. +1. Slå hovedproxy-kontakten samt AdGuard-beskyttelsen til for at rute enhedens trafik igennem proxyen. - Now AdGuard will route all traffic through Orbot. If you disable Orbot, Internet connection will be unavailable until you disable the outbound proxy settings in AdGuard. + AdGuard ruter herefter al trafik igennem Orbot. Deaktiveres Orbot, bliver internetforbindelsen utilgængelig, indtil de udgående proxyindstillinger i AdGuard deaktiveres. -### How to use AdGuard with PIA (Private Internet Access) +### Sådan bruges AdGuard med PIA (Private Internet Access) -*Here we presume that you are already a PIA VPN client and have it installed on your device.* +*Det antages her, at brugeren allerede er en PIA VPN-klient, samt har den installeret på enheden.* -1. Open AdGuard and go to **Settings** → **Filtering** → **Network** → **Proxy** → **Proxy server**. +1. Åbn AdGuard og gå til **Indstillinger** → **Filtrering** → **Netværk** → **Proxy** → **Proxyserver**. -1. Tap the **Add proxy server** button and enter the following data: +1. Tryk på knappen **Tilføj proxyserver** og angiv flg. data: - | Field | Value | - | ---------- | ------------------------------------ | - | Proxy type | *SOCKS5* | - | Proxy host | *proxy-nl.privateinternetaccess.com* | - | Proxy port | *1080* | + | Felt | Værdi | + | --------- | ------------------------------------ | + | Proxytype | *SOCKS5* | + | Proxyvært | *proxy-nl.privateinternetaccess.com* | + | Proxyport | *1080* | -1. You also need to fill out the **Username/Password** fields. To do so, log in to the [Client Control Panel](https://www.privateinternetaccess.com/pages/client-sign-in) on the PIA website. Tap the **Generate Password** button under the **Generate PPTP/L2TP/SOCKS Password** section. A username starting with “x” and a random password will be shown. Use them to fill out the **Proxy username** and **Proxy password** fields in AdGuard. +1. Felterne **Brugernavn/Adgangskode** er obligatoriske. For at gøre dette, log ind på [Client Control Panel](https://www.privateinternetaccess.com/pages/client-sign-in) på PIA-webstedet. Tryk på knappen **Generér adgangskode** under afsnittet **Generere PPTP/L2TP/SOCKS Adgangskode**. Et brugernavn startende med "x" og en tilfældig adgangskode vil blive vist. Brug dem ved udfyldelsen af felterne **Proxy-brugernavn** og **Proxy-adgangskode** i AdGuard. -1. Tap **Save and select**. +1. Tryk på **Gem og vælg**. -1. Enable the main Proxy switch and AdGuard protection to route your device's traffic through the proxy. +1. Slå hovedproxy-kontakten samt AdGuard-beskyttelsen til for at rute enhedens trafik igennem proxyen. -### How to use AdGuard with TorGuard +### Sådan bruges AdGuard med TorGuard -*Here we presume that you are already a TorGuard client and have it installed on your device.* +*Her antages det, at en Clash-klient allerede er installeret på den relevante enhed.* -1. Open AdGuard and go to **Settings** → **Filtering** → **Network** → **Proxy** → **Proxy server**. +1. Åbn AdGuard og gå til **Indstillinger** → **Filtrering** → **Netværk** → **Proxy** → **Proxyserver**. -1. Tap the **Add proxy server** button and enter the following data: +1. Tryk på knappen **Tilføj proxyserver** og angiv flg. data: - | Field | Value | - | ---------- | ------------------------------------------- | - | Proxy type | *SOCKS5* | - | Proxy host | *proxy.torguard.org* or *proxy.torguard.io* | - | Proxy port | *1080* or *1085* or *1090* | + | Felt | Værdi | + | --------- | ---------------------------------------------- | + | Proxytype | *SOCKS5* | + | Proxyvært | *proxy.torguard.org* eller *proxy.torguard.io* | + | Proxyport | *1080* eller *1085* eller *1090* | -1. For **Username** and **Password** fields, enter your proxy username and proxy password you have chosen at TorGuard signup. +1. I felterne **Username** og **Password** angives proxy-brugernavnet og -adgangskoden, som blev valgt ved TorGuard-tilmeldingen. -1. Tap **Save and select**. +1. Tryk på **Gem og vælg**. -1. Enable the main Proxy switch and AdGuard protection to route your device's traffic through the proxy. +1. Slå hovedproxy-kontakten samt AdGuard-beskyttelsen til for at rute enhedens trafik igennem proxyen. -### How to use AdGuard with NordVPN +### Sådan bruges AdGuard med NordVPN -1. Log in to your NordVPN account. +1. Log ind på NordVPN-kontoen. -1. Go to **Services** → **NordVPN** → **Manual setup** and set up your service credentials manually. +1. Gå til **Tjenester** → **NordVPN** → **Manuel opsætning** og opsæt tjenestelegitimationsoplysningerne manuelt. -1. You will receive a verification code on the email address you use for NordVPN. Use it on your NordVPN account as requested, then tap *Apply* and *OK* to save the changes. +1. En bekræftelseskode sendes til den e-mailadresse, der bruges til NordVPN. Brug den på NordVPN-kontoen, når den udbedes, og tryk derefter på *Anvend* og *OK* for at gemme ændringerne. -![Manual setup](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/outbound-proxy/nordvpn-manual-setup.png) +![Manuel opsætning](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/outbound-proxy/nordvpn-manual-setup.png) -1. Open the AdGuard app, go to **Settings** → **Filtering** → **Network** → **Proxy** → **Proxy server** → **Add proxy server**. +1. Åbn AdGuard-appen, gå til **Indstillinger** → **Filtrering** → **Netværk** → **Proxy** → **Proxyserver** → **Tilføj proxyserver**. -1. Enter the following data: +1. Angiv flg. data: - | Field | Value | - | ---------- | ----------------------------------------------------------------------------------------------------------------------------- | - | Proxy type | *SOCKS5* | - | Proxy host | Any server from [this list](https://support.nordvpn.com/hc/en-us/articles/20195967385745-NordVPN-proxy-setup-for-qBittorrent) | - | Proxy port | *1080* | + | Felt | Værdi | + | --------- | --------------------------------------------------------------------------------------------------------------------------------- | + | Proxytype | *SOCKS5* | + | Proxyvært | Enhver server fra [denne liste](https://support.nordvpn.com/hc/en-us/articles/20195967385745-NordVPN-proxy-setup-for-qBittorrent) | + | Proxyport | *1080* | -1. Enter your NordVPN credentials in the **Username** and **Password** fields. +1. Angiv NordVPN-legitimationsoplysninger i felterne **Brugernavn** og **Adgangskode**. -1. Tap **Save and select**. +1. Tryk på **Gem og vælg**. -1. Enable the main Proxy switch and AdGuard protection to route your device's traffic through the proxy. +1. Slå hovedproxy-kontakten samt AdGuard-beskyttelsen til for at rute enhedens trafik igennem proxyen. -### How to use AdGuard with Shadowsocks +### Sådan bruges AdGuard med Shadowsocks -*Here we presume that you have already configured a Shadowsocks server and a client on your device.* +*Det antages, at der allerede er opsat en Shadowsocks-server og en klient på enheden.* :::note -You should remove Shadowsocks app from filtering before setting up the process (**App management** → **Shadowsocks** → **Route traffic through AdGuard**) to avoid infinite loops and drops. +For at undgå uendelige løkker og udfald bør Shadowsocks-appen fjernes fra filtreringen inden opsætning af processen (**App-håndtering** → **Shadowsocks** → **Rut trafik igennem AdGuard**). ::: -1. Open AdGuard and go to **Settings** → **Filtering** → **Network** → **Proxy** → **Proxy server**. +1. Åbn AdGuard og gå til **Indstillinger** → **Filtrering** → **Netværk** → **Proxy** → **Proxyserver**. -1. Tap the **Add proxy server** and fill in the fields: +1. Tryk på **Tilføj proxyserver** og udfyld felterne: - | Field | Value | - | ---------- | ----------- | - | Proxy type | *SOCKS5* | - | Proxy host | *127.0.0.1* | - | Proxy port | *1080* | + | Felt | Værdi | + | --------- | ----------- | + | Proxytype | *SOCKS5* | + | Proxyvært | *127.0.0.1* | + | Proxyport | *1080* | -1. Tap **Save and select**. +1. Tryk på **Gem og vælg**. -1. Enable the main Proxy switch and AdGuard protection to route your device's traffic through the proxy. +1. Slå hovedproxy-kontakten samt AdGuard-beskyttelsen til for at rute enhedens trafik igennem proxyen. -### How to use AdGuard with Clash +### Sådan bruges AdGuard med Clash -*Here we presume that you are already a Clash client and have it installed on your device.* +*Her antages det, at en Clash-klient allerede er installeret på den relevante enhed.* -1. Open Clash and go to **Settings** → **Network** → **Route System Traffic** and toggle the switch on. This will set Clash to proxy mode. +1. Åbn Clash og gå til **Indstillinger** → **Netværk** → **Rut systemtrafik** og slå kontakten på Til. Dette skifter Clash til proxytilstand. -1. Open AdGuard and go to **App management**. Choose **Clash For Android** and disable **Route traffic through AdGuard**. This will eliminate traffic looping. +1. Åbn Adguard og gå til **App-håndtering**. Vælg **Clash til Android** og deaktivér **Rut trafik igennem AdGuard**. Dette eliminerer trafikløkker. -1. Then go to **Settings** → **Filtering** → **Network** → **Proxy** → **Proxy server**. +1. Gå dernæst til **Indstillinger** → **Filtrering** → **Netværk** → **Proxy** → **Proxyserver**. -1. Tap **Add proxy server** and fill in the fields: +1. Tryk på **Tilføj proxyserver** og udfyld felterne: - | Field | Value | - | ---------- | ----------- | - | Proxy type | *SOCKS5* | - | Proxy host | *127.0.0.1* | - | Proxy port | *7891* | + | Felt | Værdi | + | --------- | ----------- | + | Proxytype | *SOCKS5* | + | Proxyvært | *127.0.0.1* | + | Proxyport | *7891* | -### How to use AdGuard with WG Tunnel +### Sådan bruges AdGuard med WG Tunnel -*The proxy mode was added in version 4.0. We presume that you already have WG Tunnel installed on your device and have added the WireGuard configuration.* +*Proxy-tilstanden blev tilføjet i version 4.0. Her antages det, at WG Tunnel allerede er installeret på enheden og at WireGuard-opsætningen er tilføjet.* -1. Open WG Tunnel and go to **Settings** (the cog wheel at the bottom) → **App Mode** → **Proxy (experimental)**. This will set WG Tunnel to proxy mode. +1. Åbn WG Tunnel og gå til **Indstillinger** (tandhjulet nederst) → **App-tilstand** → **Proxy (eksperimentel)**. Dette sætter WG Tunnel i proxytilstand. -1. Open AdGuard and go to **App management**. Choose **WG Tunnel** and disable **Route traffic through AdGuard**. This will eliminate traffic looping. +1. Åbn Adguard og gå til **App-håndtering**. Vælg **WG Tunnel** og deaktivér **Rut trafik igennem AdGuard**. Dette eliminerer trafikløkker. -1. Then go to **Settings** → **Filtering** → **Network** → **Proxy** → **Proxy server**. +1. Gå dernæst til **Indstillinger** → **Filtrering** → **Netværk** → **Proxy** → **Proxyserver**. -1. Tap **Add proxy server** and fill in the fields: +1. Tryk på **Tilføj proxyserver** og udfyld felterne: - | Field | Value | - | ---------- | ----------- | - | Proxy type | *SOCKS5* | - | Proxy host | *127.0.0.1* | - | Proxy port | *25344* | + | Felt | Værdi | + | --------- | ----------- | + | Proxytype | *SOCKS5* | + | Proxyvært | *127.0.0.1* | + | Proxyport | *25344* | -1. Tap **Save and select**. +1. Tryk på **Gem og vælg**. -1. Enable the main proxy switch and AdGuard protection to route your device’s traffic through the proxy. +1. Slå proxy-hovedkontakten til og AdGuard-beskyttelsen til for at rute enhedens trafik igennem proxyen. ## Begrænsninger -However, at least one factor may prevent certain traffic from being routed through the outbound proxy, even after configuring the AdGuard proxy settings. That would be if the app itself isn't configured to send its traffic through AdGuard. To do it, you need to proceed to **App management**, choose the app, and turn on **Route traffic through AdGuard**. +Mindst én faktor kan dog forhindre bestemt trafik i at blive rutet igennem den udgående proxy, selv efter opsætning af AdGuard-proxyindstillingerne. Det ville være, hvis selve appen ikke var opsat til at sende sin trafik igennem AdGuard. For at opsætte dette, gå til **App-håndtering**, vælg appen og slå **Rut trafik igennem AdGuard** til. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea.md index 8904b9a319f..d7da0725d12 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea.md @@ -1,38 +1,38 @@ --- -title: How to use Samsung Pay with AdGuard in South Korea +title: Sådan benyttes Samsung Pay med AdGuard i Sydkorea sidebar_position: 16 --- :::info -This article is about AdGuard for Android, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Android, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -A number of users have encountered an issue where Samsung Pay does not work while AdGuard is running. This issue occurs almost exclusively on devices registered in South Korea. +En række brugere har oplevet det problem, at Samsung Pay ikke fungerer, mens AdGuard kører. Problemet opstår næsten udelukkende på enheder registreret i Sydkorea. -What is causing this issue? Sometimes Samsung Pay does not work on devices with VPN services running, and AdGuard is one of these apps. By default, AdGuard uses a local VPN to filter traffic, which can cause problems when using Samsung Pay. +Hvad forårsager dette problem? Nogle gange fungerer Samsung Pay ikke på enheder med kørende VPN-tjenester, og AdGuard er en sådan app. Som standard anvender AdGuard et lokalt VPN til trafikfiltrering, hvilket kan forårsage problemer under brug af Samsung Pay. -As a consequence, users had to disable AdGuard when making payments with Samsung Pay. This can be avoided with the *Detect Samsung Pay* feature. When this option is enabled, the AdGuard app is paused whenever the user opens the Samsung Pay app and resumes when the app is closed. +Som en konsekvens måtte brugerne deaktivere AdGuard, inden de foretog betalinger med Samsung Pay. Dette kan nu undgås med funktionen *Detektér Samsung Pay*. Når denne indstilling er slået til, pauseres AdGuard-appen, hver gang brugeren åbner Samsung Pay-appen og genoptages, når appen lukkes. :::note -This feature will work only if the Local VPN filtering mode is chosen in AdGuard settings. If another mode is being used, Samsung Pay will function without any interruptions. +Denne funktion fungerer kun, såfremt tilstanden Lokal VPN-filtrering er valgt i AdGuard-indstillingerne. Bruges en anden tilstand, fungerer Samsung Pay uden nogen afbrydelser. ::: -To enable *Detect Samsung Pay*, follow these steps: +Følg disse trin for at slå *Detektér Samsung Pay* til: -1. Go to *Settings* → *General* → *Advanced*→ *Low-level settings*. +1. Gå til *Indstillinger* → *Generelt* → *Avanceret* → *Lavniveauindstillinger*. -1. Scroll to *Detect Samsung Pay* and move the slider to the right. +1. Rul til *Detektér Samsung Pay*, og flyt skyderen til højre. -1. Tap *Allow permissions* and give AdGuard access to information about the use of other apps. +1. Tryk på *Tildel tilladelser* og giv AdGuard adgang til oplysninger om brugen af andre apps. -We need it to collect statistics about the operation of Samsung Pay in order for the *Detect Samsung Pay* feature to work. +Den kræves for indsamling af statistik om driften af Samsung Pay, således at funktionen *Detektér Samsung Pay* kan fungere. -After enabling this feature, when you switch from Samsung Pay to AdGuard, the following message will appear as shown in the screenshot. +Når der efter aktivering af funktionen skiftes fra Samsung Pay til AdGuard, vises meddelelsen som vist på skærmfotoet. ![samsungpay *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/samsungpay-with-adguard-in-south-korea/samsung_pay.png) -Alternatively, you can disable filtering for Samsung Pay in *App management*. Simply go to the *App management* screen (third tab from the bottom), find Samsung Pay in the list, and turn off the switch at *Route traffic through AdGuard*. +Alternativt kan filtrering for Samsung Pay deaktiveres via *App-håndtering*. Gå blot til skærmen *App-håndtering* (tredje fane fra bunden), find Samsung Pay på listen og slå kontakten fra for *Rut trafik igennem AdGuard*. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/secure-folder.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/secure-folder.md index 5df65be467c..3eec6d26c56 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/secure-folder.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/secure-folder.md @@ -1,24 +1,24 @@ --- -title: Certificate installation in a Secure folder +title: Certifikatinstallation i en Sikker-mappe sidebar_position: 12 --- :::info -This article is about AdGuard for Android, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Android, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -If you install AdGuard [in the *Secure folder*](https://www.samsung.com/uk/support/mobile-devices/what-is-the-secure-folder-and-how-do-i-use-it/) on your Android device (this mainly applies to Samsung devices), you may have difficulty installing the HTTPS certificate. The *Secure folder* has its own storage space for certificates. However, if you follow the [regular certificate installation instructions](/adguard-for-android/features/settings#https-filtering), the certificate will be installed in the main memory and will not affect your ad blocker in the *Secure folder*. To install the certificate for AdGuard for Android in the *Secure folder’s* storage, follow these instructions instead: +Installeres AdGuard i [*Sikker-mappen* i Android](https://www.samsung.com/uk/support/mobile-devices/what-is-the-secure-folder-and-how-do-i-use-it/) (dette gælder hovedsageligt Samsung-enheder), kan der opleves problemer under installationen af HTTPS-certifikatet. *Sikker-mappen* harnnemlig sin egen lagerplads til certifikater. Følges imidlertid den [almindelige vejledning til certifikatinstallation](/adguard-for-android/features/settings#https-filtering), installeres certifikatet på hovedlagerpladsen og får ingen indflydelse på adblockeren i *Sikker-mappen*. Følg i stedet denne vejledning for at installere certifikatet for AdGuard til Android på den *Sikker-mappe*-lagerplads: -1. After installing the app and connecting the local VPN, tap *HTTPS filtering is off* on the main screen. -1. Tap **Continue** → **Next** → **Save certificate**. -1. Save the certificate (at this stage, you can rename it to make it easier to locate it later, which you will need to do). -1. After the *Installation instructions* popup appears, **DO NOT** tap **Open Settings**. -1. Minimize the app and go to the *Secure folder*. -1. Tap the three-dot menu and go to **Settings** → **Other security settings**. -1. Tap **Install from device storage** → **CA certificate** → **Install anyway**. -1. Confirm installation with your graphic key/password/fingerprint. -1. Find and select the previously saved certificate, then tap **Done**. -1. Return to the AdGuard app and navigate back to the main screen. -1. Udført! The certificate has been installed. +1. Efter installation af appen og tilslutning til lokalt VPN, tryk på *HTTPS-filtrering er fra* på hovedskærmen. +1. Tryk på **Fortsæt** → **Næste** → **Gem certifikat**. +1. Gem certifikatet (på dette stadium kan det omdøbes for at gøre det lettere at finde senere, hvilket vil være nødvendigt). +1. Efter pop op'en til *Installationsvejledningen* vises, **TRYK IKKE ** på **Åbn Indstillinger**. +1. Minimer appen og gå til *Sikker-mappen*. +1. Tryk på trepriksmenuen og gå til **Indstillinger** → **Andre sikkerhedsindstillinger**. +1. Tryk på **Installér fra enhedslager** → **CA-certifikat** → **Installér alligevel**. +1. Bekræft installationen med den grafiske nøgle/adgangskode/fingeraftryk. +1. Find og vælg det tidligere gemte certifikat, og tryk dernæst på **Færdig**. +1. Returnér til AdGuard-appen og gå tilbage til hovedskærmen. +1. Færdig! Certifikatet er hermed installeret. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/solving-problems.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/solving-problems.md index 947344340b7..be6663262d5 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/solving-problems.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/solving-problems.md @@ -5,26 +5,26 @@ sidebar_position: 1 :::info -This article is about AdGuard for Android, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Android, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -Here are some problems you may encounter and workarounds, guides, and instructions you may need. +Her er nogle problemer, som kan opleves, og løsninger samt guider og vejledninger, der muligvis bliver brug for. -- [Battery and traffic consumption issues](/adguard-for-android/solving-problems/battery.md) -- [How to collect debug logs](/adguard-for-android/solving-problems/log.md) -- [How to automate AdGuard for Android](/adguard-for-android/solving-problems/tasker.md) -- [How to get system logs](/adguard-for-android/solving-problems/logcat.md) -- [How to generate HAR files](/adguard-for-android/solving-problems/har.md) -- [How to block ads in the YouTube app](adguard-for-android/solving-problems/youtube-ads.md) -- [How to set up outbound proxy](/adguard-for-android/solving-problems/outbound-proxy.md) -- [How to protect AdGuard from being disabled by the system](/adguard-for-android/solving-problems/background-work.md) -- [Problems caused by multiple user profiles](/adguard-for-android/solving-problems/multiple-user-profiles.md) -- [Manual installation of the security certificate into the Firefox browser](/adguard-for-android/solving-problems/firefox-certificates.md) -- [Certificate installation on devices with Android 11+](/adguard-for-android/solving-problems/manual-certificate.md) -- [Certificate installation in a Secure folder](/adguard-for-android/solving-problems/secure-folder.md) -- [Moving the CA certificate to the system store on rooted devices](/adguard-for-android/solving-problems/https-certificate-for-rooted.md) -- [Known compatibility issues with Android apps](/adguard-for-android/solving-problems/compatibility-issues.md) -- [How to install AdGuard for Android TV](/adguard-for-android/solving-problems/adguard-for-android-tv.md) -- [How to use Samsung Pay with AdGuard in South Korea](/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea.md) -- [Problems caused by extending restricted settings](/adguard-for-android/solving-problems/extending-restricted-settings.md) +- [Batteri- og trafikforbrugsproblemer](/adguard-for-android/solving-problems/battery.md) +- [Sådan indsamles fejlretningslogger](/adguard-for-android/solving-problems/log.md) +- [Sådan automatiseres AdGuard til Android](/adguard-for-android/solving-problems/tasker.md) +- [Sådan hentes systemlogger](/adguard-for-android/solving-problems/logcat.md) +- [Sådan genereres HAR-filer](/adguard-for-android/solving-problems/har.md) +- [Sådan blokeres reklamer i YouTube-appen](adguard-for-android/solving-problems/youtube-ads.md) +- [Sådan opsættes udgående proxy](/adguard-for-android/solving-problems/outbound-proxy.md) +- [Sådan beskyttes AdGuard mod at blive deaktiveret af systemet](/adguard-for-android/solving-problems/background-work.md) +- [Problemer forårsaget af flere brugerprofiler](/adguard-for-android/solving-problems/multiple-user-profiles.md) +- [Manuel installation af sikkerhedscertifikatet i Firefox-webbrowseren](/adguard-for-android/solving-problems/firefox-certificates.md) +- [Certifikatinstallation på enheder med Android 11+](/adguard-for-android/solving-problems/manual-certificate.md) +- [Certifikatinstallation i en Sikker mappe](/adguard-for-android/solving-problems/secure-folder.md) +- [Flytning af CA-certifikat til systemlageret på rootede enheder](/adguard-for-android/solving-problems/https-certificate-for-rooted.md) +- [Kendte kompatibilitetsproblemer med Android-apps](/adguard-for-android/solving-problems/compatibility-issues.md) +- [Sådan installeres AdGuard til Android TV](/adguard-for-android/solving-problems/adguard-for-android-tv.md) +- [Sådan benyttes Samsung Pay med AdGuard i Sydkorea](/adguard-for-android/solving-problems/samsungpay-with-adguard-in-south-korea.md) +- [Problemer forårsaget af udvidelse af begrænsningsindstillinger](/adguard-for-android/solving-problems/extending-restricted-settings.md) diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/tasker.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/tasker.md index 2f2d234abfd..b1b9bad4c64 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/tasker.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-android/solving-problems/tasker.md @@ -1,149 +1,149 @@ --- -title: How to automate AdGuard for Android +title: Sådan automatiseres AdGuard til Android sidebar_position: 3 --- :::info -This article is about AdGuard for Android, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Android, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -Many people choose Android because they like customizing settings and want to control their device completely. And it's totally normal if some of AdGuard users are not satisfied with its default behavior. Let's say, you want protection to stop when a certain app is launched, and then restart it again when the app is closed. This is a job for the Tasker app. +Mange brugere vælger Android, fordi de kan lide at tilpasse indstillinger og ønsker at styre deres enhed fuldstændigt. Det er derfor helt normalt, hvis nogle af AdGuard-brugerne ikke er tilfredse med standardadfærden. Lad os f.eks. sige, at beskyttelsen ønskes stoppet, når en bestemt app startes, og derefter genstartet igen, når appen lukkes. Dette er en opgave for Tasker-appen. -## AdGuard interface +## AdGuard-grænseflade -There are a lot of tasker apps out there, for example [Tasker](https://play.google.com/store/apps/details?id=net.dinglisch.android.taskerm&noprocess), [AutomateIt](https://play.google.com/store/apps/details?id=AutomateIt.mainPackage&noprocess) etc. AdGuard provides an interface that allows these apps to setup various automation rules. +Der findes mange tasker-apps, f.eks. [Tasker](https://play.google.com/store/apps/details?id=net.dinglisch.android.taskerm&noprocess), [AutomateIt](https://play.google.com/store/apps/details?id=AutomateIt.mainPackage&noprocess) etc. AdGuards grænseflade giver disse apps mulighed for at opsætte forskellige automatiseringsregler. -![Automation *mobile_border](https://cdn.adtidy.org/blog/new/mmwmfautomation.jpg) +![Automatisering *mobile_border](https://cdn.adtidy.org/blog/new/mmwmfautomation.jpg) -Thanks to this interface, any app can send a special message (called “intent”) that contains the name of the action and some additional data, if needed. AdGuard will look at this intent and perform the required actions. +Denne grænseflade lader enhver app sende en særlig besked (kaldet "intent") indeholdende navnet på handlingen og om nødvendigt yderligere data. AdGuard vil se på denne intent og udføre de nødvendige handlinger. -### Security concerns +### Sikkerhedsovervejelser -Isn't it dangerous to let some random apps manage what AdGuard does? It is, and that's why a password is sent along with the intent. This password will be generated by AdGuard automatically, but you can, of course, change it at any time. +Er det ikke farligt at lade nogle tilfældige apps styre, hvad AdGuard gør? Det er det, og derfor sendes en adgangskode sammen med intent'en. Denne adgangskode genereres automatisk af AdGuard, men den kan selvfølgelig ændres til enhver tid. -### Available actions +### Tilgængelige handlinger -Here are actions that, when included in the intent, will be understood by AdGuard: +Her er handlinger, som, når de er inkluderet i intent'en, vil blive forstået af AdGuard: -`start` starts the protection, no extra data is needed; +`start` starter beskyttelsen, ingen ekstra data kræves; -`stop` stops the protection, no extra data required; +`stop` stopper beskyttelsen, ingen ekstra data kræves; -`pause` pauses the protection. The difference between this and `stop` is that a notification will appear that restarts the protection when you tap it. No extra data required; +`pause` pauserer beskyttelsen. Forskellen mellem dette og `stop` er, at der vises en notifikation, der genstarter beskyttelsen, når der trykkes på den. Ingen ekstra data kræves; -`update` checks for available filter and app updates, no additional data is needed; +`update` tjekker for tilgængelige filter- og app-opdateringer, ingen ekstra data kræves; ----- -`dns_filtering` turns DNS filtering on and off. Requires an extra flag: +`dns_filtering` slår DNS-filtrering til og fra. Kræver et ekstra flag: -`enable:true` or `enable:false` enables or disables DNS filtering, accordingly. +`enable:true` eller `enable:false` slår DNS-filtrering hhv. til og fra. -`fake_dns` allows resolving DNS requests on the specified proxy server. This requires an extra flag: +`fake_dns` tillader opløsning af DNS-forespørgsler på den angivne proxyserver. Kræver et ekstra flag: -`enable:true` or `enable:false` enables or disables the *Use FakeDNS* setting, respectively. +`enable:true` eller `enable:false` slår indstillingen af *Brug FakeDNS* hhv. til eller fra. :::note -When the *Use FakeDNS* setting is enabled, *DNS Protection* will be automatically disabled. DNS requests won't be filtered locally. +Aktivering af indstillingen *Brug FakeDNS* deaktiverer automatisk *DNS-beskyttelse*. DNS-forespørgsler vil ikke blive filtreret lokalt. ::: ----- -`dns_server` switches between DNS servers, you need to include additional data: +`dns_server` skifter mellem DNS-servere, ekstra data kræves: - `server:adguard dns` switches to AdGuard DNS server; + `server:adguard dns` skifter til AdGuard DNS-server; :::note -The full list of supported provider names can be found in our [known DNS providers list](https://adguard-dns.io/kb/general/dns-providers/). +En komplet oversigt over understøttede udbydernavne findes på vores [liste over kendte DNS-udbydere](https://adguard-dns.io/kb/general/dns-providers/). ::: - `server:custom` switches to the previously added server named `custom`; + `server:custom` skifter til den tidligere tilføjede server ved navn `custom`; - `server:tls://dns.adguard.com` creates a new server and switches to it if the previously added servers and providers don't contain a server with the same address. Otherwise, it switches to the respective server. You can add server addresses as IP ( regular DNS), `sdns://…` (DNSCrypt or DNS-over-HTTPS), `https://…` (DNS-over-HTTPS) or `tls://...` (DNS-over-TLS); + `server:tls://dns.adguard.com` opretter en ny server og skifter til den, hvis tidligere tilføjede servere og udbydere ikke indeholder en server med samme adresse. Ellers skifter den til den respektive server. Serveradresser kan tilføjes som IP (alm. DNS), `sdns://…` (DNSCrypt eller DNS-over-HTTPS), `https://…` (DNS-over-HTTPS) eller `tls://…` (DNS-over-TLS); - `server:1.1.1.1, tls://1.1.1.1` creates a server with comma separated addresses and switches to it. When adding a server via `server:1.1.1.1, tls://1.1.1.1`, the previously added server is removed. + `server:1.1.1.1, tls://1.1.1.1` opretter en server med kommaseparerede adresser og skifter til den. Når en server tilføjes via `server:1.1.1.1, tls://1.1.1.1`, fjernes den tidligere tilføjede server. - `server:system` resets DNS settings to default system DNS servers. + `server:system` nulstiller DNS-indstillingerne til systemets standard DNS-servere. ----- -`proxy_state` enables/disables the outbound proxy. Requires an extra flag: +`proxy_state` slår den udgående proxy til/fra. Kræver et ekstra flag: -`enable:true` or `enable:false` activates or deactivates the outbound proxy, accordingly. +`enable:true` eller `enable:false` slår den udgåede proxy hhv. til og fra. ----- -`proxy_default` sets the proxy from the list of previously added ones as default or creates a new one if server has not been added before. +`proxy_default` indstiller proxyen fra listen over tidligere tilføjede som standard eller opretter en ny, hvis serveren ikke tidligere er tilføjet. -You need to specify additional data: +Yderligere data skal angives: -`server:[name]` where `[name]` is the name of the outbound proxy from the list. +`server:[name]`, hvor `[name]` er navnet på den udgående proxy fra listen. -Or you can configure server parameters manually: +Eller serverparametrene kan opsættes manuelt: `server:[type=…&host=…&port=…&username=…&password=…&udp=…&trust=…]`. -`proxy_remove` removes the proxy server from the list of previously added ones. +`proxy_remove` fjerner proxyserveren fra listen over tidligere tilføjede. -`server:[name]` where `[name]` is the name of the outbound proxy from the list. +`server:[name]`, hvor `[name]` er navnet på den udgående proxy fra listen. -Or you can configure remove parameters manually: +Eller remove-parametre kan opsættes manuelt: `server:[type=…&host=…&port=…&username=…&password=…&udp=…&trust=…]`. -- **Compulsory parameters**: +- **Obligatoriske parametre**: -`[type]` — proxy server type: +`[type]` — proxyservertype: - HTTP - SOCKS4 - SOCKS5 - HTTPS_CONNECT -`[host]` — outbound proxy domain or IP address; +`[host]` — udgående proxydomæne eller IP-adresse; -`[port]` — outbound proxy port (integer number from 1 to 65535); +`[port]` — udgående proxyport (heltal fra 1 til 65535); -- **Optional parameters**: +- **Valgfrie parametre**: - `[login and password]` — only if proxy requires it. This data is ignored when setting up **SOCKS4**; + `[login og adgangskode]` — kun hvis proxyen kræver det. Disse data ignoreres ved opsætning af **SOCKS4**; - `[udp]` applied only on **SOCKS5** server type and include option **UDP through SOCKS5**. It is necessary to set **true or false** value; + `[udp]` anvendes kun på **SOCKS5**-servertypen og inkluderer indstillingen **UDP via SOCKS5**. Det er nødvendigt at sætte værdien **true eller false**; - `[trust]` applies for **HTTPS_CONNECT** server type only and include option **Trust any certificates**. It is necessary to set **true or false** value. + `[trust]` gælder kun for **HTTPS_CONNECT**-servertypen og inkluderer muligheden **Gør alle certifikatr betroede**. Det er nødvendigt at sætte værdien **true eller false**. -:::note Example +:::note Eksempel -`setting by name`: server:MyServer +`indstilling pr. navn`: server:MinServer -`manually settings`: server:host=1.2.3.4&port=80&type=SOCKS5&username=foo&password=bar&udp=true +`manuelle indstillinger`: server:host=1.2.3.4&port=80&type=SOCKS5&username=foo&password=bar&udp=true ::: -**Don't forget to include the password, package name, and class. You need to do so for every intent.** +**Husk at inkludere adgangskoden, pakkenavn og klasse. Dette skal gøres for hver enkel intent.** -Extra: `password:*******` +Ekstra: `adgangskode:*******` -Package name: `com.adguard.android` +Pakkenavn: `com.adguard.android` -Class: `com.adguard.android.receiver.AutomationReceiver` +Klasse: `com.adguard.android.receiver.AutomationReceiver` :::note -Before v4.0 the class was called `com.adguard.android.receivers.AutomationReceiver` but then we changed its name to `com.adguard.android.receiver.AutomationReceiver`. If this function is used, remember to update to the new name. +Før v4.0 hed klassen `com.adguard.android.receivers.AutomationReceiver`, men så ændrede vi navnet til `com.adguard.android.receiver.AutomationReceiver`. Bruges denne funktion, husk da at opdatere til det nye navn. ::: -### Execution without notification +### Eksekvering uden notifikation -To perform a task without showing a toast, add an additional EXTRA `quiet: true` +For at udføre en opgave uden at vise en toast, tilføj en yderligere EKSTRA `quit: true` -### Example +### Eksempel -![Automation *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/tasker/automation2.png) +![Automatisering *mobile](https://cdn.adtidy.org/content/kb/ad_blocker/android/solving_problems/tasker/automation2.png) diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/adguard-and-adguard-pro.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/adguard-and-adguard-pro.md index 3c0997aa51b..e4622fc87a0 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/adguard-and-adguard-pro.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/adguard-and-adguard-pro.md @@ -5,7 +5,7 @@ sidebar_position: 5 :::info -This article is about AdGuard for iOS, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til iOS, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/activity.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/activity.md index 8a35ecc07cd..17cbc6256c7 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/activity.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/activity.md @@ -1,34 +1,34 @@ --- -title: Activity and statistics +title: Aktivitet og statistik sidebar_position: 4 --- :::info -This article is about AdGuard for iOS, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Android, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -_Activity_ screen is the 'information hub' of AdGuard's DNS protection suite. You can quickswitch to it by tapping the third icon in the bottom bar. N.b. this screen is only seen when DNS protection is enabled. +Skærmen _Aktivitet_ er 'informationsknudepunktet' i AdGuards DNS-beskyttelsessuite. Der kan hurtig-skiftes til den med et tryk på 3. ikon på den nederst bjælke. NB denne skærm ses kun, når DNS-beskyttelsen er slået til. -![Activity screen \*mobile_border](https://cdn.adtidy.org/content/github/ad_blocker/ios/activity.png) +![Skærmen Aktivitet \*mobile_border](https://cdn.adtidy.org/content/github/ad_blocker/ios/activity.png) -This is where AdGuard displays statistics about the device's DNS requests, such as total number, number of blocked requests and data saved by blocking them. AdGuard can display the statistics for a day, a week, a month or in total. +Her viser AdGuard statistik om enhedens DNS-forespørgsler, såsom samlet antal, antal blokerede og data sparet ved at blokere dem. AdGuard kan vise statistik for dag, uge, måned eller i alt. -Below is the _Recent activity_ feed. AdGuard stores the last 1500 DNS requests that have originated on your device and shows their attributes such as protocol type and target domain. +Nedenfor ses feedet _Seneste aktivitet_. AdGuard gemmer de seneste 1.500 DNS-forespørgsler fra enheden, og viser deres attributter, såsom protokoltype og destinationsdomæne. :::note -AdGuard does not send this information anywhere. It is 100% local and does not leave your device. +AdGuard sender ikke disse oplysninger nogen steder hen. Informationen er 100% lokal og forlader ikke enheden. ::: -Tap any request to view more details. There will also be buttons to add the request to Blocklist/Allowlist in one tap. +Tryk på en forespørgsel for at se flere detaljer. Der er også knapper til at føje forespørgslen til Sortliste/Hvidliste med ét tryk. -![Request details \*mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/request_info_en.jpeg) +![Forespørgselsdetaljer \*mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/request_info_en.jpeg) -Above the activity feed, there are _Most active_ and _Most blocked_ companies. Tap each to see data based on the last 1500 requests. +Over aktivitetsfeedet ses _Mest aktive_ og _Hyppigst blokerede_ virksomheder. Tryk på de enkelte for at se data fra på de seneste 1.500 forespørgsler. -### Statistics {#statistics} +### Statistik {#statistics} -Aside from the _Activity_ screen, you can find global statistics on the home screen and in widgets. +Udover skærmen _Aktivitet_ findes globale statistikker på startskærmen og på widgets. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md index 2c8df14f063..2c173576e3a 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/advanced-protection.md @@ -1,26 +1,26 @@ --- -title: Advanced protection +title: Avanceret beskyttelse sidebar_position: 3 --- :::info -This article is about AdGuard for iOS, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til iOS, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -In iOS 15, Apple added support for Safari Web Extensions and we added a new _Advanced protection_ module to AdGuard for iOS. It allows AdGuard to apply advanced filtering rules, such as [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) to deal with even the complex ads, such as YouTube ads. +I iOS 15 har Apple tilføjet understøttelse af Safari Web Extensions, og vi føjede til gengæld et nyt modul, _Avanceret beskyttelse_, til AdGuard til iOS. Det tillader AdGuard at anvende avancerede filtreringsregler, såsom [CSS-regler](/general/ad-filtering/create-own-filters#cosmetic-css-rules), [Udvidede CSS-vælgere](/general/ad-filtering/create-own-filters#extended-css-selectors) og [scriptlets](/general/ad-filtering/create-own-filters#scriptlets) til at håndtere selv de komplekse annoncer, såsom YouTube-ditto. -![Advanced protection screen \*mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) +![Skærmen Avanceret beskyttelse \*mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_15_en.jpeg) -### How to enable +### Sådan sker aktivering -To enable _Advanced protection_, open the _Protection_ tab by tapping the second left icon at the bottom of the screen, select the _Advanced protection_ module, activate the feature by toggling the switch slider, and follow the on-screen instructions. +For at aktivere _Avanceret beskyttelse_, åbn fanen _Beskyttelse_ ved at trykke på 2. ikon til venstre nederst på skærmen, vælg modulet _Avanceret beskyttelse_, slå funktionen til ved at flytte skyderen og følge vejledningen på skærmen. :::note -The _Advanced protection_ only works on iOS 15 and later versions. If you are using earlier versions of iOS, you will see the _YouTube ad blocking_ module in the app instead of the _Advanced protection_. +Funktionen _Avanceret beskyttelse_ kræver minimum iOS 15. Anvendes en tidligere versioner af iOS, vil modulet _YouTube-adblocking_ ses i appen i stedet for _Avanceret beskyttelse_. ::: -![Protection screen on iOS 14 and earlier \*mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_14_en.jpeg) +![Skærmen Beskyttelse i iOS 14 og ældre \*mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/protection_screen_14_en.jpeg) diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/assistant.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/assistant.md index 3bdd70435f6..559badc5e40 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/assistant.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/assistant.md @@ -5,27 +5,27 @@ sidebar_position: 5 :::info -This article is about AdGuard for iOS, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til iOS, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -### Assistant {#assistant} +### Assistent {#assistant} -![Safari Assistant \*mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/assistant_en.jpeg) +![Safari Assistent \*mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/assistant_en.jpeg) -Assistant is a tool that helps you manage filtering in Safari right from the browser without switching back to the app. +Assistent er et værktøj, der bistår med filtreringshåndteringen i Safari direkte fra webbrowseren uden at skifte tilbage til appen. -To see it, do the following: open Safari and tap the arrow-in-a-box symbol. Then scroll down to AdGuard/AdGuard Pro (depending on the app you use) and tap it to fetch a window with several options: +For at få den vist, åbn Safari og tryk på symbolet pil-i-en-boks. Rul dernæst ned til AdGuard/AdGuard Pro (afhængigt af den anvendte app), og tryk på den for at åbne et vindue med flere indstillinger: -- **Enable on this page.** - Turn the switch off to add the current domain to the Allowlist. -- **Block an element on this page.** - Tap it to enter the 'Element blocking' mode: choose any element on the page, adjust the size by tapping '+' or '–', preview if necessary and then tap the checkmark icon to confirm. The selected element will be hidden from the page and a corresponding rule will be added to User rules. Remove or disable it to revert the change. -- **Report an issue on this page.** - Opens a web reporting tool that will help you send a report to our support team in just a few taps. Use it if you noticed a missed ad or an incorrect blocking on the page. +- **Aktivér på denne side.** + Slå kontakten fra for at føje det aktuelle domæne til Hvidliste. +- **Blokér et element på denne side.** + Tryk på den for at gå til tilstanden 'Elementblokering', vælg et element på siden, justér størrelsen ved at trykke på '+' eller '-', se om nødvendigt en prævisning, og tryk dernæst på fluebenikonet for at bekræfte. Det valgte element skjules på siden, og en korresponderende regel føjes til Brugerregler. Fjern eller slå den fra ophæve ændringen. +- **Anmeld et problem på denne side.** + Åbner et webrapporteringsværktøj, der bistår med at indsende en anmeldelse til supportteamet med nogle få tryk. Brug det, hvis en glemt annonce eller en forkert blokering på siden bemærkes. :::tip -On iOS 15 devices, the Assistant features are available through [AdGuard Safari Web Extension](/adguard-for-ios/web-extension), which enhances the capabilities of AdGuard for iOS and allows you to take advantage of iOS 15. With this web extension, AdGuard can apply advanced filter rules and, as a result, block more ads. +På iOS 15-enheder er Assistent-funktionerne tilgængelige via [AdGuard Safari Web Extension](/adguard-for-ios/web-extension), hvilket forbedrer funktionerne i AdGuard til iOS med muligheden for at drage fordel af iOS 15. AdGuard kan med denne webudvidelse anvende avancerede filterregler og dermed blokere flere annoncer. ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/compatibility-with-adguard-vpn.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/compatibility-with-adguard-vpn.md index c7b86f72106..2c8cd0f012f 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/compatibility-with-adguard-vpn.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/compatibility-with-adguard-vpn.md @@ -1,32 +1,32 @@ --- -title: Compatibility with AdGuard VPN +title: Kompatibilitet med AdGuard VPN sidebar_position: 8 --- :::info -This article is about AdGuard for iOS, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til iOS, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -In most cases, an ad blocker app and a VPN app cannot work together, due to certain system limitations. +I de fleste tilfælde kan en adblocker og VPN-app ikke fungere sammen grundet visse systemrestriktioner. -Nevertheless, we've managed to find a solution to befriend [AdGuard VPN](https://adguard-vpn.com/) and AdGuard Ad Blocker. +Det er dog lykkedes os at finde en løsning på konflikten mellem [AdGuard VPN](https://adguard-vpn.com/) og AdGuard Ad Blocker. -On the _Protection_ section, you can easily switch between two apps. +I afsnittet _Beskyttelse_ kan der nemt skiftes mellem to apps. -### How to enable compatibility mode +### Sådan aktiveres kompatibilitetstilstanden -**If you already have AdGuard Ad Blocker when installing AdGuard VPN, integrated (compatibility) mode will turn on automatically, allowing you to use our apps at the same time.** +**Er AdGuard Ad Blocker allerede installeret, når AdGuard VPN installeres, aktiveres integreret (kompatibilitets-) tilstand automatisk, så apperne kan bruges samtidigt.** -If you have installed AdGuard VPN first and only then decided to try AdGuard Ad Blocker, follow these steps to use the two apps together: +Er AdGuard VPN allerede installeret, og det så besluttes at afprøve AdGuard Ad Blocker, følg da disse trin for brug af to apps sammen: -1. Open AdGuard VPN for iOS app and select ⚙ _Settings_ in the lower right corner of the screen. -2. Go to _App settings_ and select _Operating mode_. -3. Switch the mode from VPN to Integrated. +1. Åbn AdGuard VPN til iOS og vælg ⚙ _Indstillinger_ nederste til højre på skærmen. +2. Gå til _App-indstillinger_ og vælg _Driftstilstand_. +3. Skift tilstanden fra VPN til Integreret. :::note -In _Integrated mode_, AdGuard VPN's _Exclusions_ and _DNS server_ features are not available. +I _Integreret tilstand_ er AdGuard VPN-funktionerne _Undtagelser_ og _DNS-server_ utilgængelige. ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/dns-protection.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/dns-protection.md index f8ff5623db0..7f2cfed3d85 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/dns-protection.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/dns-protection.md @@ -5,70 +5,70 @@ sidebar_position: 2 :::info -This article is about AdGuard for iOS, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til iOS, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -[DNS protection module](https://adguard-dns.io/kb/general/dns-filtering/) enhances your privacy by encrypting your DNS traffic. Unlike with Safari content blocking, DNS protection works system-wide, i.e. beyond Safari, in apps and other browsers. You have to enable this module before you're able to use it. You can do this on the home screen by tapping the shield icon at the top of the screen, or by going to the _Protection_ → _DNS protection_ tab. +[DNS-beskyttelsesmodulet](https://adguard-dns.io/kb/general/dns-filtering/) forbedrer brugerfortroligheden ved at kryptere DNS-trafikken. Modsat Safaris indholdsblokering, fungerer DNS-beskyttelse på systemniveau, dvs. også i apps og andre webbrowsere end Safari. Dette modul skal aktiveres, før det kan anvendes. Dette kan gøres ved at trykke på skjoldikonet øverst på skærmen eller ved at gå til fanen _Beskyttelse_ → _DNS-beskyttelse_. :::note -To be able to manage DNS settings, AdGuard apps require establishing a local VPN. It will not route your traffic through any remote servers. Nevertheless, the system will ask you to confirm access permission. +For at kunne håndtere DNS-indstillinger kræver AdGuard-apps oprettelse af et lokalt VPN. Den vil ikke rute trafikken igennem nogen fjernservere. Systemet vil dog stadig kræve, at tilladelsesadgangen bekræftes. ::: -### DNS implementation {#dns-implementation} +### DNS-implementering {#dns-implementation} -![DNS implementation screen \*mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/implementation_en.jpeg) +![Skærmen DNS-implementering \*mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/implementation_en.jpeg) -This section has two options: AdGuard and Native implementation. Basically, these are two methods of setting up DNS. +Dette afsnit har to muligheder: AdGuard- og Native-implementering. Disse er grundlæggende to metoder til opsætning af DNS. -In Native implementation, the DNS is handled by the system and not the app. This means that AdGuard doesn't have to create a local VPN. Sadly, this will not help you circumvent system restrictions and use AdGuard alongside other VPN-based applications — if any VPN is enabled, native DNS is ignored. Consequently, you won't be able to filter traffic locally or to use our brand new [DNS-over-QUIC protocol (DoQ)](https://adguard-dns.io/blog/dns-over-quic.html). +I Native-implementeringen håndteres DNS af systemet og ikke appen. Det betyder, at AdGuard ikke behøver oprette et lokalt VPN. Desværre vil dette ikke hjælpe med at omgå systemrestriktioner og anvende AdGuard sammen med andre VPN-baserede apps — er et andet VPN aktivt, ignoreres den indbyggede DNS. Følgelig vil trafikfiltrering lokalt eller brug af vores helt nye [DNS-over-QUIC-protokol (DoQ)](https://adguard.com/en/blog/dns-over-quic.html) ikke være mulig. -### DNS servers {#dns-servers} +### DNS-servere: {#dns-servers} -The next section you'll see on the DNS Protection screen is DNS server. It shows the currently selected DNS server and encryption type. To change either, tap the button to enter the DNS server screen. +Det næste afsnit vist på skærmen DNS-beskyttelse er DNS-server. Den viser den aktuelt valgte DNS-server og krypteringstype. For at skifte den, tryk på knappen for at åbne skærmen DNS-server. -![DNS servers \*mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/dns_server_en.jpeg) +![DNS-servere \*mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/dns_server_en.jpeg) -Servers differ by their speed, employed protocol, trustworthiness, logging policy, etc. By default, AdGuard will suggest several DNS servers from among the most popular ones (including AdGuard DNS). Tap any to change the encryption type (if such option is provided by the server's owner) or to view the server's homepage. We added labels such as `No logging policy`, `Ad blocking`, `Security` to help you make a choice. +Servere adskiller sig efter deres hastighed, anvendte protokol, troværdighed, logningspolitik mv. Som standard vil AdGuard foreslå flere DNS-servere blandt de mest populære (inkl. AdGuard DNS). Tryk på en hvilken som helst for at skifte krypteringstypen (såfremt muligheden tilbydes af serverejeren) eller for at se serverens hjemmeside. Etiketter, såsom `Ingen logningspolitik`, `Adblocking` og `Sikkerhed`, er tilføjet for nemmere valg. -In addition, at the bottom of the screen there is an option to add a custom DNS server. It supports regular, DNSCrypt, DNS-over-HTTPS, DNS-over-TLS, and DNS-over-QUIC servers. +I bunden af skærmen er der også mulighed for at tilføje en tilpasset DNS-server. Den understøtter almindelige DNSCrypt-, DNS-over-HTTPS-, DNS-over-TLS- og DNS-over-QUIC-servere. -#### HTTP basic authentication for DNS-over-HTTPS +#### HTTP-basisgodkendelse for DNS-over-HTTPS -This feature brings the authentication capabilities of the HTTP protocol to DNS, which does not have built-in authentication. Authentication in DNS is useful if you want to restrict access to your custom DNS server to specific users. +Denne funktion bringer godkendelsesmulighederne for HTTP-protokollen til DNS, der ikke har indbygget godkendelse. Godkendelse i DNS er nyttig, hvis adgangen til en tilpassede DNS-server ønskes begrænset til bestemte brugere. -To enable this feature: +Sådan aktiveres denne funktion: -1. In AdGuard DNS, go to _Server settings_ → _Devices_ → _Settings_ and change the DNS server to the one with authentication. Clicking _Deny other protocols_ will remove other protocol usage options, leaving only DNS-over-HTTPS authentication enabled and preventing its use by third parties. Copy the generated address. +1. I AdGuard DNS, gå til _Serverindstillinger_ → _Enheder_ → _Indstillinger_ og skift DNS-serveren til den med godkendelse. Klikkes på _Afvis andre protokoller_, fjernes andre protokolbrugsindstillinger, så kun DNS-over-HTTPS-godkendelse er aktiveret og tredjeparter forhindres i at bruge den. Kopiér den genererede adresse. -![DNS-over-HTTPS with authentication](https://cdn.adtidy.org/content/release_notes/dns/v2-7/http-auth/http-auth-en.png) +![DNS-over-HTTPS med godkendelse](https://cdn.adtidy.org/content/release_notes/dns/v2-7/http-auth/http-auth-en.png) -1. In AdGuard for iOS, go to the _Protection tab_ → _DNS protection_ → _DNS server_ and paste the generated address into the _Add a custom DNS server_ field. Save and select the new configuration. +1. I AdGuard til iOS, gå til fanen _Beskyttelse_ → _DNS-beskyttelse_ → _DNS-server_ og indsæt den genererede adresse i feltet _Tilføj en tilpasset DNS-server_. Gem og vælg den nye opsætning. -To check if everything is set up correctly, visit our [diagnostics page](https://adguard.com/en/test.html). +Besøg vores [diagnostikside](https://adguard.com/en/test.html) for at tjekke, om alt er korrekt opsat. -### Network settings {#network-settings} +### Netværksindstillinger {#network-settings} -![Network settings screen \*mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/network_settings_en.jpeg) +![Skærmen Netværksindstillinger \*mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/network_settings_en.jpeg) -Users can also handle their DNS security on the Network settings screen. _Filter mobile data_ and _Filter Wi-Fi_ enable or disable DNS protection for the respective network types. Further down, at _Wi-Fi exceptions_, you can exclude particular Wi-Fi networks from DNS protection (for example, you might want to exclude your home network if you use [AdGuard Home](https://adguard.com/adguard-home/overview.html)). +På skærmen Netværksindstillinger kan brugere også håndtere DNS-sikkerhed. _Filtrér mobildata_ og _Filtér Wi-Fi_ slår DNS-beskyttelse til/fra for de respektive netværkstyper. Længere nede kan der via _Wi-Fi undtagelser_ undtages bestemte Wi-Fi netværk fra DNS-beskyttelsen (f.eks. hjemmenetværket, hvis der gøres brug af [AdGuard Home](https://adguard.com/adguard-home/overview.html)). -### DNS filtering {#dns-filtering} +### DNS-filtrering {#dns-filtering} -DNS filtering allows you to customize your DNS traffic by enabling AdGuard DNS filter, adding custom DNS filters, and using the DNS blocklist/allowlist. +DNS-filtrering muliggør at tilpasse DNS-trafikken ved at aktivere AdGuard DNS-filter, tilføje tilpassede DNS-filtre og benytte DNS-sortlisten/hvidlisten. -How to access: +Sådan opnås adgang: -_Protection_ (the shield icon in the bottom menu bar) → _DNS protection_ → _DNS filtering_ +_Beskyttelse_ (skjoldikonet på nederste menubjælke) → _DNS-beskyttelse_ → _DNS-filtrering_ -![DNS filtering screen \*mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/dns_filtering_en.jpeg) +![Skærmen DNS-filtrering \*mobile_border](https://cdn.adtidy.org/public/Adguard/kb/iOS/features/dns_filtering_en.jpeg) -#### DNS filters {#dns-filters} +#### DNS-filtre {#dns-filters} -Similar to filters that work in Safari, DNS filters are sets of rules written according to special [syntax](https://adguard-dns.io/kb/general/dns-filtering-syntax/). AdGuard will monitor your DNS traffic and block requests that match one or more rules. You can use filters such as [AdGuard DNS filter](https://github.com/AdguardTeam/AdguardSDNSFilter) or add hosts files as filters. Multiple filters can be added simultaneously. To know how to do it, get acquainted with [this exhaustive manual](/adguard-for-ios/solving-problems/system-wide-filtering). +I lighed med filtre, som fungerer i Safari, er DNS-filtre sæt af regler skrevet i en særlig [syntaks](https://adguard-dns.io/kb/general/dns-filtering-syntax/). AdGuard vil overvåge DNS-trafikken og blokere forespørgsler matchende en eller flere regler. Der kan bruges filtre såsom [AdGuard DNS-filter](https://github.com/AdguardTeam/AdguardSDNSFilter) eller tilføjes værtsfiler som filtre. Flere filtre kan tilføjes samtidigt. For at vide, hvordan dette gøres, konsultér [denne udtømmende manual](adguard-for-ios/solving-problems/system-wide-filtring). -#### Allowlist and Blocklist {#allowlist-blocklist} +#### Hvidliste og Sortliste {#allowlist-blocklist} -On top of DNS filters, you can have targeted impact on DNS filtering by adding single domains to Blocklist or to Allowlist. Blocklist even supports the same DNS syntax, and both of them can be imported and exported, just like Allowlist in Safari content blocking. +Ud over DNS-filtre, kan DNS-filtrering målrettet påvirkes ved at føje enkelte domæner til sort- eller hvidlisten. Sortlisten understøtter endda den samme DNS-syntaks, og begge kan importeres og eksporteres, ligesom hvidlisten i Safari-indholdsblokering. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md index 6f20c0b3512..0738bf3230e 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/features.md @@ -5,42 +5,42 @@ sidebar_position: 1 :::info -This article is about AdGuard for iOS, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til iOS, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -- [Safari protection](/adguard-for-ios/features/safari-protection.md) +- [Safari-beskyttelse](/adguard-for-ios/features/safari-protection.md) - Available features and settings in the _Safari protection_ tab: _Filters_, _User rules_, and _Allowlist_ + Tilgængelige funktioner og indstillinger via fanen _Safari-beskyttelse_: _Filtre_, _Brugerregler_ og _Hvidliste_ -- [DNS protection](/adguard-for-ios/features/dns-protection/) +- [DNS-beskyttelse](/adguard-for-ios/features/dns-protection/) - DNS-servere og DNS-filtre, som muliggør blokering af annoncer, trackere og farlige websteder + DNS-servere og DNS-filtre, som muliggør at blokere annoncer, trackere og farlige websteder -- [Advanced protection](/adguard-for-ios/features/advanced-protection.md) +- [Avanceret beskyttelse](/adguard-for-ios/features/advanced-protection.md) - A feature that allows AdGuard to apply advanced filtering rules and scriptlets to handle complex ads + En funktion, der giver AdGuard mulighed for at anvende avancerede filtreringsregler og scriptlets til at håndtere komplekse annoncer -- [Activity and statistics](/adguard-for-ios/features/activity.md) +- [Aktivitet og statistik](/adguard-for-ios/features/activity.md) - Statistics with detailed activity reports that allow you to monitor blocked ads, trackers, and DNS queries + Statistik med detaljerede aktivitetsrapporter, som muliggør at monitorere blokerede annoncer, trackere og DNS-forespørgsler -- [Assistant](/adguard-for-ios/features/assistant.md) +- [Assistent](/adguard-for-ios/features/assistant.md) - A tool that lets you quickly manage filtering in Safari right from the browser without opening the AdGuard interface + Et værktøj, der muliggør hurtig filtreringshåndtering i Safari direkte fra webbrowseren uden at åbne appen -- [Low-level settings](/adguard-for-ios/features/low-level-settings.md) +- [Lavniveauindstillinger](/adguard-for-ios/features/low-level-settings.md) - Settings that allow advanced users to fine-tune app performance and adjust DNS protection + Lavniveauindstillinger giver avancerede brugere mulighed for at finjustere app-ydeevne og justere DNS-beskyttelse -- [Other features](/adguard-for-ios/features/other-features.md) +- [Andre funktioner](/adguard-for-ios/features/other-features.md) - General settings: theme, settings and statistics reset, auto-update, inverting the allowlist, and advanced mode. + Generelle indstillinger: Tema, indstillinger og statistiknulstilling, auto--opdatering, hvidlisteinvertering og avanceret tilstand. -- [Compatibility with AdGuard VPN](/adguard-for-ios/features/compatibility-with-adguard-vpn.md) +- [Kompatibilitet med AdGuard VPN](/adguard-for-ios/features/compatibility-with-adguard-vpn.md) Integreret tilstand, der tillader AdGuard Ad Blocker og AdGuard VPN at køre sideløbende trods systembegrænsninger -- [Free vs. full version](/adguard-for-ios/features/free-vs-full.md) +- [Gratis kontra fuld version](/adguard-for-ios/features/free-vs-full.md) - Sammenligning af funktioner mellem den gratis og den betalte version + Sammenligning af funktioner mellem den gratis og den betalte version. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/free-vs-full.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/free-vs-full.md index 6f6dd5f305b..d738eb05f6a 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/free-vs-full.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/free-vs-full.md @@ -5,28 +5,28 @@ sidebar_position: 9 :::info -This article is about AdGuard for iOS, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til iOS, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: :::note -Both AdGuard for iOS with enabled Premium and AdGuard Pro block ads on Apple smartphones and tablets. They used to differ in functionality due to certain changes made to App Store review policies in the past, but now AdGuard with a purchased subscription and AdGuard Pro are identical in their functionality. +Både AdGuard til iOS med aktiveret Premium og AdGuard Pro blokerer annoncer på Apple-smartphones og -tablets. De plejede at adskille sig i funktionalitet grundet visse ændringer foretaget i App Stores anmeldelsespolitikker tidligere, men nu har AdGuard med betalt abonnement og AdGuard Pro identisk funktionalitet. ::: -Premium AdGuard for iOS features several differences from the free version, including custom DNS settings. With these settings, you can block ads not only in Safari but in other apps too, protect your kids from adult content online, and keep your personal information safe from theft. There are other differences, too. Let’s explore them all in more detail. +Premium AdGuard til iOS har flere forskelle ift. den gratis version, herunder tilpassede DNS-indstillinger. Med disse indstillinger kan annoncer blokeres ikke kun i Safari, men også i andre apps, beskytte børn mod voksenindhold online og beskytte personlige oplysninger mod tyveri. Der er også andre forskelle. Lad os se på dem alle mere detaljeret. -1. The **DNS protection** module encrypts your DNS traffic to enhance privacy. It works across all apps and browsers, not just Safari, offering broad protection against ads and trackers. +1. Modulet **DNS-beskyttelse** krypterer DNS-trafikken for at forbedre fortroligheden. Den fungerer på tværs af alle apps og webbrowsere, ikke kun Safari, og tilbyder bred beskyttelse mod annoncer og trackere. - - **Custom DNS servers:** Choose from one of the popular DNS servers from our list or add your own custom server. + - **Tilpassede DNS-servere:** Vælg mellem en af de populære DNS-servere fra vores liste, eller tilføj en egen tilpassede server. - - **Family Protection:** The Internet isn’t always kid-friendly. With AdGuard Premium, you can switch to DNS providers that block adult content and other inappropriate material to keep your children safe online. + - **Family-beskyttelse:** Internet er ikke altid børnevenligt. Med AdGuard Premium kan der skiftes til DNS-udbydere, som blokerer voksenindhold og andet upassende materiale for at holde børn beskyttet online. - - **Monitoring and flexible configuration:** Recent activity log allows you to view all DNS requests sent by your device and easily manage your traffic by adding websites to blocklist or allowlist with just a tap. + - **Monitorering og fleksibel opsætning:** Loggen Seneste aktivitet muliggør at se alle DNS-forespørgsler sendt af enheden samt nem trafikhåndtering ved at tilføje websteder til sortlisten eller hvidlisten med blot ét tryk. -2. **Advanced protection** lets you use advanced filtering rules to block more complex ads that would be left unblocked otherwise. +2. **Avanceret beskyttelse** giver mulighed for at bruge avancerede filtreringsregler til at blokere mere komplekse annoncer, som ellers ville være ublokeret. -3. **More filter options:** When purchasing AdGuard Premium, you get access to custom and security filters. +3. **Flere filtermuligheder:** Ved køb af AdGuard Premium opnås adgang til tilpassede filtre og sikkerhedsfiltre. -Access these features by [purchasing a license](https://adguard.com/license.html). +Tilgå disse funktioner ved at [købe en licens](https://adguard.com/license.html). diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/low-level-settings.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/low-level-settings.md index 90f9424e43f..1a9de13aa0e 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/low-level-settings.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/low-level-settings.md @@ -5,25 +5,25 @@ sidebar_position: 6 :::info -This article is about AdGuard for iOS, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til iOS, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -![Low-level settings \*mobile_border](https://cdn.adtidy.org/public/Adguard/Blog/ios_lowlevel.PNG) +![Lavniveauindstillinger \*mobile_border](https://cdn.adtidy.org/public/Adguard/Blog/ios_lowlevel.PNG) -To open the _Low-level settings_, go to _Settings_ → _General_ → (Enable _Advanced mode_ if it's off) → _Advanced settings_ → _Low-level settings_. +For at åbne _Lavniveauindstillinger_, gå til _Indstillinger_ → _Generelt_ → (slå _Avanceret tilstand_ til, hvis den er slået fra) → _Avancerede indstillinger_ → _Lavniveauindstillinger_. -For the most part, the settings in this section are best left untouched: only use them if you're sure about what you're doing, or if the support team has asked for them. But some settings could be changed without any risk. +Generelt bør indstillingerne i dette afsnit forblive uændrede: De bør kun bruges, såfremt man ved, hvad man foretager sig, eller såfremt supportteamet har givet andre dessiner. Nogle af indstillingerne kan dog ændres uden risiko. -### Block IPv6 {#blockipv6} +### Blokér IPv6 {#blockipv6} -For any DNS query sent to get an IPv6 address, our app returns an empty response (as if this IPv6 address does not exist). Now there is an option not to return IPv6 addresses. At this point the description of this function becomes too technical: configuring or disabling IPv6 is the exclusive domain of advanced users. Presumably, if you are one of them, it will be good to know that we now have this feature, if not — there is no need to dive into it. +For enhver DNS-forespørgsel sendt for at hente en IPv6-adr. returnerer appen et tomt svar (som om denne IPv6-adr. ikke findes). Nu er der en mulighed for ikke at returnere IPv6-adresser. På dette stadie bliver beskrivelsen af denne funktion for teknisk: Opsætning eller deaktivering af IPv6 er udelukkende for avancerede brugere. Er man én af dem, vil det formentlig det være godt at vide, at vi nu har denne funktion, og er man ikke, er der ingen grund til at dykke ned i den. -### Bootstrap and Fallback servers {#bootstrap-fallback} +### Bootstrap- og Reserveservere (fallback) {#bootstrap-fallback} -Fallback is a backup DNS server. If you chose a DNS server and something happened to it, a fallback is needed to set the backup DNS server until the main server responds. +Fallback er en reserve-DNS-server. Ophører den valgte DNS-server med at svare, er der behov for, at en reserve-DNS-server (fallback) tager over, indtil primærserveren atter svarer. -With Bootstrap, it’s a little more complicated. For AdGuard for iOS to use a custom secure DNS server, our app needs to get its IP address first. For this purpose, the system DNS is used by default, but sometimes this is not possible for various reasons. In such cases, Bootstrap could be used to get the IP address of the selected secure DNS server. Here are two examples to illustrate when a custom Bootstrap server might help: +Med Bootstrap er det lidt mere kompliceret. For at AdGuard til iOS kan bruge en tilpasset sikker DNS-server, skal appen først hente sin IP-adresse. Til dette formål bruges systemets DNS som standard, men nogle gange er dette ikke muligt af forskellige årsager. I sådanne tilfælde kan Bootstrap bruges til at hente IP-adressrn på den valgte sikre DNS-server. Her er to eksempler til illustration af, hvornår en tilpasset Bootstrap-server kan hjælpe: -1. When a system default DNS server does not return the IP address of a secure DNS server and it is not possible to use a secure one. -2. When our app and third-party VPN are used simultaneously and it is not possible to use System DNS as a Bootstrap. +1. Når en systemstandardmDNS-server ikke returnerer IP-adressen på en sikker DNS-server, og det ikke er muligt at bruge en sikker én. +2. Når AdGuard-appen og et tredjeparts-VPN bruges samtidigt, og det ikke er muligt at bruge System DNS som en Bootstrap. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/other-features.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/other-features.md index 986a1dae2cb..892e845f724 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/other-features.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/other-features.md @@ -5,7 +5,7 @@ sidebar_position: 7 :::info -This article is about AdGuard for iOS, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til iOS, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/safari-protection.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/safari-protection.md index 2ce3367de6f..ecc1b2808af 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/safari-protection.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/features/safari-protection.md @@ -5,7 +5,7 @@ sidebar_position: 1 :::info -This article is about AdGuard for iOS, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til iOS, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/solving-problems/solving-problems.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/solving-problems/solving-problems.md index f1b5ab4ac3f..7c49adba69e 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/solving-problems/solving-problems.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-ios/solving-problems/solving-problems.md @@ -9,7 +9,7 @@ Denne artikel dækker AdGuard til iOS, en multifunktionel adblocker, der beskytt ::: -Here are some problems you may encounter and workarounds, guides, and instructions you may need. +Her er nogle problemer, som kan opleves, og løsninger samt guider og vejledninger, der muligvis bliver brug for. - [How to activate premium features](/adguard-for-ios/solving-problems/premium-activation.md) - [How to enable system-wide filtering in AdGuard for iOS](/adguard-for-ios/solving-problems/system-wide-filtering.md) diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-linux/settings.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-linux/settings.md index fd1fc67ac79..187e9e9d701 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-linux/settings.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-linux/settings.md @@ -309,7 +309,7 @@ AdGuard Browser Assistant allows you to manage AdGuard protection directly from ![The Assistant window \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/mac/assistant_window.png) -### How it works +### Sådan fungerer den AdGuard Browser Assistant is a browser extension. It allows you to quickly manage AdGuard for Linux: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-mac/features/browser-assistant.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-mac/features/browser-assistant.md index 6bb3908c753..e4c2b46fc94 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-mac/features/browser-assistant.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-mac/features/browser-assistant.md @@ -13,7 +13,7 @@ AdGuard Browser Assistant allows you to manage AdGuard protection directly from ![The Assistant window \*mobile](https://cdn.adtidy.org/content/kb/ad_blocker/mac/assistant_window.png) -## How it works +## Sådan fungerer den AdGuard Browser Assistant is a browser extension. It allows you to quickly manage the AdGuard app: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index f5ac63ae6e8..1a4e3c05b57 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,39 +13,58 @@ Grundet politikopdateringer i macOS 27 kan AdGuard muligvis ikke kommunikere med ## Anbefalede løsninger -Da dette problem kan påvirke alle Chromium-baseret webbrowsere, gennemgår dette afsnit, hvordan AdGuard kan tildeles de nødvendige tilladelser, uanset benyttet webbrowser. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Trin 1: Tildel adgang via Filer og mapper -1. Åbn _Filer og mapper_ - - via AdGuard-indstillinger: Klik på tandhjulsikonet i appens hovedvindue → _Præferencer…_ → fanen _Assistent_ → _Åbn Filer og mapper_ - ![AdGuard-indstillinger](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Opsætningsassistent: Klik fra browserassistentens installationsskærm på _Åbn Filer og mapper_ — denne knap vises, hvis AdGuard ikke har adgang til webbrowserens mappe - ![AdGuard Opsætningsassistent](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) - - via _Systemindstillinger_ → _Fortrolighed og Sikkerhed_ → _Filer og mapper_ - ![Systemindstillinger](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) -2. Find _AdGuard_ på listen, og klik på den for at vise rullemenuen -3. Find webbrowseren (f.eks. Chrome eller Brave), og slå kontakten ud for den til +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + +1. Open _Files & Folders_ + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ + ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) +2. Find _AdGuard_ in the list and click it to expand the dropdown +3. Locate the browser (for example, Chrome or Brave) and turn on the toggle next to it :::note -En til/fra-knap til en bestemt webbrowser vises kun på denne liste, hvis webbrowseren allerede er installeret. Er den aktuelle webbrowser eller Google Chrome ikke på listen, fortsæt til trin 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Trin 2: Hvis webbrowseren ikke er på listen +### Step 2: If the browser isn’t listed + +**Option A: Install Google Chrome or Mozilla Firefox** -**Mulighed A: Installér Google Chrome** +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -Nogle webbrowsere, såsom f.eks. Opera, er afhængige af Native Messaging-mappen tilhørende Google Chrome i stedet for at bruge deres egen mappe. På tidligere macOS-versioner kunne AdGuard blot oprette denne mappe selv. Fra og med macOS 27 tillader macOS dog ikke AdGuard at anmode om adgang til Chromes mappe, medmindre Chrome faktisk er installeret. Installation af Chrome giver AdGuard mulighed for at anmode om den nødvendige tilladelse. +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +3. Find _AdGuard_ in the list and click it to expand the dropdown +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). -1. Installér Google Chrome, og åbn den mindst én gang — den obligatoriske Native Messaging-mappe bliver tilgængelig på systemet -2. Åbn _Filer og mapper_ (via AdGuard-indstillingerne, AdGuard Opsætningsassistent eller Mac-systemindstillingerne, som beskrevet i trin 1) -3. Find _AdGuard_ på listen, og klik på den for at vise rullemenuen -4. Find Google Chrome, og slå kontakten ud for den til. Browser Assistent vil herefter begynde at fungere i den webbrowser, der er afhængig af Chromes mappe (såsom Opera). +**Option B: Grant Full Disk Access** -**Mulighed B: Tildel Fuld diskadgang** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: -1. Åbn _Systemindstillinger_ → _Fortrolighed og Sikkerhed_ → _Fuld diskaadgang_ -2. Find _AdGuard_ på listen og slå kontakten til - ![Fuld diskadgang](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) +1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ +2. Find _AdGuard_ in the list and turn on the toggle + ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/solving-problems.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/solving-problems.md index 84435a90e83..09e6ff4df0e 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/solving-problems.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/solving-problems.md @@ -9,7 +9,7 @@ Denne artikel dækker AdGuard til Mac, en multifunktionel adblocker, der beskytt ::: -Here are some problems you may encounter and workarounds, guides, and instructions you may need. +Her er nogle problemer, som kan opleves, og løsninger samt guider og vejledninger, der muligvis bliver brug for. - [Manual certificate installation](/adguard-for-mac/solving-problems/manual-certificate-installation.md) - [Protection cannot be enabled](/adguard-for-mac/solving-problems/protection-cannot-be-enabled.md) diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-mac/versions b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-mac/versions index 7d69c7dd99a..9e662d27fe3 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-mac/versions +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-mac/versions @@ -20,21 +20,21 @@ If you purchase AdGuard VPN for Mac on our website, your license will be linked After completing the purchase, we recommend binding the license to your email address. Once bound, you can activate AdGuard VPN on any supported platform using your email address and access your license at any time via your [AdGuard account](https://adguardaccount.com/account/licenses). To do it, go to the *License* tab and click *Bind license*. -All devices activated by your license, regardless of which version you use, will appear in your AdGuard account as usual. +Alle enheder aktiveret af licensen, uanset anvendt version, vil som normalt fremgå i AdGuard-kontoen. -## Apple’s policies +## Apples politikker -Because of Apple’s App Store restrictions, some traffic attribution features work differently in the Mac App Store version. As a result, *Statistics* and app exclusions are not available in the current MAS version. We are working to get these features back in the future versions of the app. +Grundet Apples App Store-restriktioner fungerer visse trafiktilskrivningsfunktioner anderledes i Mac App Store-versionen. Som en konsekvens er *Statistik* og app-undtagelser ikke tilgængelige i den aktuelle MAS-version. Vi arbejder på at få disse funktioner tilbage i fremtidige app-versioner. -## Different ways of operating +## Forskellige operationsmåder -Another difference between the two app versions is the processes they use to do their work, and again the difference is due to Apple limitations. +En anden forskel de to app-versioner imellem er de processer, de bruger til at udføre deres arbejde, og igen skyldes forskellen Apple-begrænsninger. -The MAS version of AdGuard VPN for Mac uses Apple’s NetworkExtension framework. It allows developers to customize and extend key network functions of the operating system — for example, VPN management, Wi‑Fi configuration, and interaction with access points through Hotspot Helper — making networks more flexible and adaptable to specific app needs. -More broadly, the term “network extension” can also refer to any hardware or software means of expanding a network to improve its coverage, performance, or functionality. +MAS-versionen af AdGuard VPN til Mac bruger Apples NetworkExtension-framework. Det lader udviklere at tilpasse og udvide centrale netværksfunktioner i operativsystemet — såsom VPN-håndtering, Wi‑Fi-opsætning og interaktion med adgangspunkter via Hotspot Helper —, hvilket gør netværk mere fleksible og tilpasningsdygtige til bestemte app-behov. +Mere generelt kan begrebet "netværksudvidelse" også henvise til enhver hardware- eller softwaremetode til udvidelse af et netværk for at forbedre dets dækning, ydeevne eller funktionalitet. -The standalone version operates under the *utun* interface. Utun (short for user tunnel) is a virtual network interface in macOS that apps use to create a secure tunnel for your internet traffic. In practice, this means the app can route your data through an encrypted connection without changing your regular network settings. +Den selvstændige version kører under *utun*-grænsefladen. Utun (forkortelse for 'user tunnel') er en virtuel netværksgrænseflade i macOS brugt af apps til oprettelse af en sikker tunnel til internettrafik. I praksis betyder det, at appen kan sende data igennem en krypteret forbindelse uden at ændre de normale netværksindstillinger. -## Summary +## Sammenfatning -Both versions of AdGuard VPN for Mac protect your privacy, though they use slightly different means to achieve this. The main differences lie in the available subscription options and the way the apps work, based on Apple’s technical policies. \ No newline at end of file +Begge versioner af AdGuard VPN til Mac beskytter fortroligheden, selvom de bruger lidt forskellige metoder til at gøre dette. De vigtigste forskelle ligger i de tilgængelige abonnementsmuligheder og den måde, appsene fungerer på, baseret på Apples tekniske politikker. \ No newline at end of file diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/app-management/app-management.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/app-management/app-management.md index 31332da4f75..3cc253f6b1f 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/app-management/app-management.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/app-management/app-management.md @@ -15,7 +15,7 @@ When routing and filtering are enabled for an app, the icons below each app will You can leave the settings as they are, disable both filtering and routing, or fine-tune them manually for each app. You can also access the app’s stats. -![App stats \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/app_management/stats_app.png) +![App-statistikker \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/app_management/stats_app.png) ## Sådan fungerer app-filtrering og rutning i AdGuard til Windows v8.0 diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/protection/parental-control.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/protection/parental-control.md index 83c50ded4a1..ee15e9572ee 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/protection/parental-control.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/protection/parental-control.md @@ -5,7 +5,7 @@ sidebar_position: 6 There are several websites that children shouldn’t be able to access. _Parental control_ helps you solve this problem. -![Parental control \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/parental.png) +![Forældrekontrol \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/protection/parental.png) When _Parental control_ is enabled, AdGuard scans the content of webpages and blocks those that may be harmful or inappropriate for children. This includes adult images and text, crude language, violence, and drug-related content. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/settings/app-settings/network-settings.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/settings/app-settings/network-settings.md index 564a9b958db..5e372840ff7 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/settings/app-settings/network-settings.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/settings/app-settings/network-settings.md @@ -5,7 +5,7 @@ sidebar_position: 3 This section lets you manage how AdGuard filters your Internet traffic and provides additional tools to control network-related features. -![Network settings \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/network_settings.png) +![Netværksindstillinger \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/network_settings.png) ## Use AdGuard as an HTTP proxy @@ -33,7 +33,7 @@ With this option, you can: Here you can choose which proxy AdGuard should use to download filter updates or new app versions — the system proxy, a custom proxy, or no proxy at all. -![Proxy settings \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/proxy_apps.png) +![Proxyindstillinger \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/settings/proxy_apps.png) ## Use SockFilter driver diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/adguard-logs.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/adguard-logs.md index 4c376776d6f..00238d99d7f 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/adguard-logs.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/adguard-logs.md @@ -5,13 +5,13 @@ sidebar_position: 3 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock). +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock). ::: :::note -Data and files provided in logs are processed in accordance with the [AdGuard Privacy Policy](https://adguard.com/en/privacy.html). +Data og filer tilgængelige i logfiler behandles i overensstemmelse med [AdGuard Fortrolighedspolitik](https://adguard.com/en/privacy.html). ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/backup-and-restore.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/backup-and-restore.md index 69cfb7f2513..2f69dfbca08 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/backup-and-restore.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/backup-and-restore.md @@ -62,7 +62,7 @@ AdGuard til Windows v8.0 introducerer væsentlige ændringer. Findes den nye bru ::: -4. Installer den foregående version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). +4. Installer den foregående version. Downloadlinket til den seneste stabile v7-udgivelse findes i afsnittet _Assets_ [på GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). 5. Afslut version 7 fra systembakken for at stoppe filtrering. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/common-installer-errors.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/common-installer-errors.md index 1ff2503c6ea..addf1f64a32 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/common-installer-errors.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/common-installer-errors.md @@ -5,7 +5,7 @@ sidebar_position: 6 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/dump-file.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/dump-file.md index d6f2a003d16..a1ef4741339 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/dump-file.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/dump-file.md @@ -5,7 +5,7 @@ sidebar_position: 8 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock). +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock). ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/installation-logs.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/installation-logs.md index 06ab48b0ed2..09bf96c8ff8 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/installation-logs.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/installation-logs.md @@ -5,7 +5,7 @@ sidebar_position: 4 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/known-issues.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/known-issues.md index 5be02a739a4..3183979f32c 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/known-issues.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/known-issues.md @@ -5,7 +5,7 @@ sidebar_position: 11 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/minidump.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/minidump.md index 30ae5d4fbaa..1bccbfa6bf4 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/minidump.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/minidump.md @@ -5,7 +5,7 @@ sidebar_position: 9 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/mozilla-error.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/mozilla-error.md index c0b6b39b933..7289fa3493c 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/mozilla-error.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/mozilla-error.md @@ -5,7 +5,7 @@ sidebar_position: 12 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/network-dump.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/network-dump.md index a2781b72aee..7a3f78791ff 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/network-dump.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/network-dump.md @@ -5,7 +5,7 @@ sidebar_position: 13 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..8ba20d072d1 --- /dev/null +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: Sådan skiftes tilbage til v7 efter opdatering til v8.0 +sidebar_position: 14 +--- + +:::info + +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) + +::: + +## Sådan skiftes tilbage til v7 efter opdatering til v8.0 + +AdGuard til Windows v8.0 introducerer væsentlige ændringer. Findes den nye brugerflade ubekvem, eller opleves problemer, kan der skiftes tilbage til version 7. + +:::note + +Ønskes de aktuelle indstillinger bevaret, anbefales det, at de eksporteres, før der skiftes version. De gamle indstillinger kan derefter importeres efter opdatering af appen. De nødvendige trin for at gøre dette er anført nedenfor. + +::: + +1. Efter opgradering til v8, åbn mappen `C:\ProgramData\Adguard\Backups` og lokalisér ZIP-filen med et navn i stil med `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Kopiér denne ZIP-fil til et sted uden for `C:\ProgramData\Adguard`, f.eks. til skrivebordet. Dette er vigtigt, da mappen renses i næste trin. + +3. Afinstallér v8.0 via _Indstillinger_ → _Apps_ → _Installerede apps_. Markér i afinstallationsdialoen afkrydsningsfeltet for at fjerne alle brugerindstillinger og data, så ingen v8-rester efterlades. + + ![Afinstallation \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For trinvis vejledning, se [Sådan afinstalleres AdGuard til Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Installer den foregående version. Downloadlinket til den seneste stabile v7-udgivelse findes i afsnittet _Assets_ [på GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Afslut version 7 fra systembakken for at stoppe filtrering. + +6. Udpak indholdet af ZIP-filen fra trin 2, og erstat flg. filer: + + - `adguard.db` → `C:\ProgramData\Adguard` — hovedindstillingsdatabase, inkl. filtre og tilpassede regler + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS-filterdatabase + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standardfilterdatabase + +7. Start AdGuard. Version 7 starter med sine tidligere indstillinger gendannet. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/system-logs.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/system-logs.md index 726babd1150..5c131bd436c 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/system-logs.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/system-logs.md @@ -5,7 +5,7 @@ sidebar_position: 5 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/extensions.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/extensions.md index 3cd57fc05cd..eb5feea7d82 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/extensions.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/extensions.md @@ -13,7 +13,7 @@ This article is about AdGuard Mini for Mac, which safeguards only your Safari br Safari extensions are small software programs that add functionality to the Safari web browser. They allow users to customize and enhance their browsing experience by adding features that are not natively built into the browser. AdGuard Mini for Mac uses extensions primarily to apply filtering rules on websites opened in Safari. -## How it works +## Sådan fungerer den To block ads, trackers, and annoyances on websites, AdGuard uses filtering rules. The rules from AdGuard’s and your custom filters are converted into ones comprehensible by Safari and are integrated into 6 Safari extensions: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index f44db6ddc6a..2ce82389178 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [Systemniveaubeskyttelse](/adguard-mini-for-mac/features/system-wide-protection.md) + + En funktion, der blokerer annoncer og trackere, ikke kun i Safari, men i alle øvrige apps på Mac'en. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index b8887a700f0..c6259e0db13 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/da/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..cfecadf0ba2 --- /dev/null +++ b/i18n/da/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: Systemniveaubeskyttelse +sidebar_position: 9 +--- + +Fra version 3.0 introducerer AdGuard Mini til Mac _Systemniveaubeskyttelse_, en funktion, der blokerer annoncer og trackere, ikke kun i Safari, men i alle øvrige apps på Mac'en. + +Funktionen er tilgængelig for brugere med en AdGuard-licens. [Køb en licensen med det samme](https://adguard.com/license.html) eller klik på _Prøv gratis_ i _Avanceret beskyttelse_ for at starte en 14-dages gratis prøveperiode. + +## Sådan fungerer den + +_Systemniveaubeskyttelse_ er indbygget i Apples [**URL-filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), en systemfiltrerings-API til brug for systemniveautrafikfiltrering. Sådan fungerer det. + +Først tjekker macOS en URL mod et bloom-filter — et præfilter gemt på Mac'en, der opdateres i baggrunden. De fleste adresser godkendes lokalt, uden netværksforespørgsel til selve tjekket. + +Finder præfilteret et muligt match, beder macOS AdGuards server om en afgørelse via Private Information Retrieval (PIR). Denne metode lader Mac'en anmode om data fra serveren uden at afsløre, præcis hvilken adresse den spurgte om. Anmodningen kan ikke knyttes til brugerkontoen eller enheden. Svarer serveren ikke, indlæses siden normalt. + +Læs evt. [den detaljerede analyse af Apples tilgang til systemniveaufiltrering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) på vores blog. + +## Sådan aktiveres systemniveaubeskyttelse + +_Systemniveaubeskyttelse_ findes under _Avanceret beskyttelse_ i AdGuard Mini-appen. For at aktivere den, slå kontakten til. + +![Systemniveaubeskyttelse](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +Når _Systemniveaubeskyttelse_ aktiveres første gang, anmodes om installation af URL-filteret på computeren. Klik på _Installér_, hvorefter en systemmeddelelse anmoder om tilføjelse af filteropsætninger. Dette er standard macOS-adfærd. AdGuard hverken ser eller gemmer ikke nogen af disse data. + +![Systemniveaubeskyttelse kræver et URL-filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +Efter URL-filteret er installeret, forbliver _Systemniveaubeskyttelse_ slået til som standard. Ønskes det slået det fra, slå kontakten _Systemniveaubeskyttelse_ fra under _Avanceret beskyttelse_. + +Der kan også klikkes på kontekstmenuen øverst til højre (⋮) og vælges _Fjern URL-filter_. Ønskes filteret nulstillet uden at slette det for at fejlfinde forbindelsesproblemer, vælg _Nulstil cache_. + +Det er også muligt at deaktivere URL-filteret i Mac'ens _Systemindstillinger_ → _Netværk_ → _VPN og filtre_ → _Filtre og proxyer_. Skift _Aktiveret_ til _Deaktiveret_ i _Statusmenuen_. AdGuard Mini vil derefter automatisk slå _Systemniveaubeskyttelse_ fra. + +## Beskyttelsesniveauer + +Der er tre beskyttelsesniveauer at vælge imellem. _Essentiel_ er valgt som standard. + +- _Essentiel_ — blokerer annoncer og trackere +- _Sikker_ — blokerer annoncer, trackere, phishing og malware +- _Familie_ — blokerer annoncer, sporere, phishing, malware og voksenindhold + +![Tre beskyttelsesniveauer](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Fejlfinding + +### Systemniveaubeskyttelse fungerer ikke med alle apps eller webbrowsere + +Dækningen afhænger af, hvordan hver enkelt app håndterer netværksforespørgsler, så nogle apps filtreres muligvis ikke. Dette er en begrænsning fra Apples side. + +Chromium-baserede webbrowsere, såsom Chrome, Edge, Opera og Brave, bruger deres egen netværkskode i stedet for Apples frameworks, så URL-filteret kan ikke tjekke deres forespørgsler. + +### Systemniveaubeskyttelse slås ikke til + +- **Mac'en kører en ældre macOS-version.** Apples URL-filter kræver minimum macOS 26 Tahoe. I tidligere versioner er indstillingen deaktiveret, og appen anmoder om at _opdatere til minimum macOS Tahoe 26_. +- **Kontoen understøttes ikke.** _Systemniveaubeskyttelse_ fungerer kun med den første brugerkonto, der er oprettet på en Mac. Er kontoen tilføjet senere, er indstillingen deaktiveret og viser _Ikke understøttet på denne Mac-konto_. Se [Kan bruger-ID'et på en Mac-konto skiftes?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) nedenfor. +- **Den gratis version benyttes.** For brug af _Systemniveaubeskyttelse_, [køb en AdGuard-licens](https://adguard.com/license.html) eller klik på _Prøv gratis_ under _Avanceret beskyttelse_ for at starte en 14-dages gratis prøveperiode. + +### Kan en Mac-kontos bruger-ID skiftes? + +Ja. _Systemomniveaubeskyttelse_ virker kun med den første brugerkonto oprettet på en Mac med bruger-ID'et (UID) 501. Har Mac'en mere end én konto, eller er en konto overført fra en ældre Mac, kan UID'et være et andet. Følg nedenstående trin for at tjekke UID'et og om nødvendigt frigøre 501 og tildele det til kontoen. + +:::warning + +Dette er en avanceret og risikabel handling. Gør kun dette, hvis der ikke er andre muligheder. At frigøre UID 501 indebærer at slette en eksisterende konto og oprette en ny via Terminal. Går noget galt, kan det medføre permanent datatab. Sikkerhedskopiér alle data på Mac'en, før der fortsættes. + +::: + +1. **Tjek det aktuelle UID.** Åbn Terminal, skriv `id -u` og tryk på Retur. Er resultatet 501, har kontoen allerede det korrekte UID. Der behøves ikke at gøres yderligere. + +2. **Find ud af, hvem der har UID 501.** Er UID'et ikke er 501, eksekvér denne kommando: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + Dette viser brugernavnet, UID og det fulde navn for den konto. Sørg for, at der ikke har brug for nogen filer fra den, eller sikkerhedskopiér dem, før der fortsættes. + +3. **Slet kontoen med UID 501.** Mens der er logget ind på den egen admin-konto, åbn _Systemindstillinger_ → _Brugere og grupper_, vælg kontoen fra trin 2 og slet den. Når macOS spørger, hvad den skal ske med dens hjemmemappen, vælg _Gem hjemmemappen i en diskafbildning_ – dette gemmer kontoens filer, såfremt de behøves senere. + +4. **Opret en ny konto med UID 501.** Kør flg. kommando, og erstat `brugernavn` og `Navn Efternavn` med de relevante oplysninger: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` får Terminalen til at anmode om adgangskoden interaktivt; `-admin` giver den nye konto administratorrettigheder. + +5. **Bekræft ændringen.** Log ind på den nye konto, og tjek derefter UID'et igen: Åbn Terminal, skriv `id -u`, og tryk på Retur. Resultatet bør nu være 501. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/adguard-for-safari.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/adguard-for-safari.md index c1d43fb2baa..d0a479debc1 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/adguard-for-safari.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/adguard-for-safari.md @@ -9,7 +9,7 @@ Denne artikel omhandler AdGuard til Safari, der kun beskytter Safari-webbrowsere ::: -- [Features](/archive/adguard-for-safari/features/features.md) +- [Funktioner](/archive/adguard-for-safari/features/features.md) Main features and settings available in AdGuard for Safari @@ -17,10 +17,10 @@ Denne artikel omhandler AdGuard til Safari, der kun beskytter Safari-webbrowsere Installation, removal, and system requirements for AdGuard for Safari -- [Safari extensions](/archive/adguard-for-safari/extensions.md) +- [Safari-udvidelser](/archive/adguard-for-safari/extensions.md) Extensions that add functionality to the Safari web browser -- [Solving problems](/archive/adguard-for-safari/solving-problems/solving-problems.md) +- [Problemløsning](/archive/adguard-for-safari/solving-problems/solving-problems.md) Known issues and possible solutions diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/extensions.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/extensions.md index c6b840ae3c7..2e948430422 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/extensions.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/extensions.md @@ -13,7 +13,7 @@ Denne artikel omhandler AdGuard til Safari, der kun beskytter Safari-webbrowsere Safari extensions are small software programs that add functionality to the Safari web browser. They allow users to customize and enhance their browsing experience by adding features that are not natively built into the browser. AdGuard for Safari uses extensions primarily to apply filtering rules on websites opened in Safari. -## How it works +## Sådan fungerer den To block ads, trackers, and annoyances on websites, AdGuard uses filtering rules. The rules from AdGuard's and your custom filters are converted into ones comprehensible by Safari and are integrated into 6 Safari extensions: @@ -28,13 +28,13 @@ Each content-blocking extension can include up to 150,000 active filtering rules 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. -![Safari extensions](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-icon1.png) +![Safari-udvidelser](https://cdn.adtidy.org/content/kb/ad_blocker/safari/adguard-for-safari-icon1.png) More on each extension below. ## Content-blocking extensions -_AdGuard General_ applies rules from filters that you can find in _Filters_ → _Ad blocking_ and _Filters_ → _Language-specific_. This extension focuses on comprehensive ad blocking and includes filters for ads in specific languages. +_AdGuard Generel_ anvender regler fra filtre, som findes i _Filtre_ → _Adblocking_ og _Filtre_ → _Sprogspecifikke_. This extension focuses on comprehensive ad blocking and includes filters for ads in specific languages. _AdGuard Privacy_ applies rules from filters located in _Filters_ → _Privacy_. It blocks tracking mechanisms and ensures that your browsing activity remains private. @@ -42,7 +42,7 @@ _AdGuard Social_ applies rules from filters that can be found in _Filters_ → _ _AdGuard Security_ applies rules from filters under _Filters_ → _Security_. This extension identifies and blocks potentially harmful elements, safeguarding users from malicious content. -_AdGuard Other_ applies rules from filters that 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 Andre_ anvender regler fra filtre, som ikke falder ind under ovennævnte kategorier og er placeret under _Filtre_ → _Andre_: _Filter til afblokering af søgeannoncer og selvpromovering_, _AdGuard DNS-filter_, og _AdGuard Eksperimentelt filter_. _AdGuard Custom_ applies rules from filters that you add on your own to _Custom filters_. @@ -66,7 +66,7 @@ _AdGuard for Safari_ activates the AdGuard icon next to the search bar. It's use ## Why AdGuard for Safari requires permission -When enabling the _AdGuard for Safari_ extension, you might notice that it requires **access to web page content** and **access to browsing history**. Here's why it needs these permissions: +Når _AdGuard til Safari_-udvidelsen aktiveres, bemærkes muligvis, at den kræver **adgang til websideindhold** og **adgang til webbrowserhistorik**. Here's why it needs these permissions: - Access to web page content is required for manual ad blocking and advanced blocking rules to work correctly - Access to browsing history is required to check the protection status on websites and determine which advanced rules should be applied diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/features/about.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/features/about.md index d4fde6e76a2..9c1977f651d 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/features/about.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/features/about.md @@ -9,6 +9,6 @@ In the About tab, you can see info about the current version of your product and :::note Reminder -AdGuard for Safari can be downloaded for free [from the App Store](https://apps.apple.com/app/adguard-for-safari/id1440147259). A detailed setup instruction is available in the [Knowledge Base](/archive/adguard-for-safari/installation/). +AdGuard for Safari can be downloaded for free [from the App Store](https://apps.apple.com/app/adguard-for-safari/id1440147259). En detaljeret opsætningsvejledning er tilgængelig i [vidensbasen](/archive/adguard-for-safari/installation/). ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/features/features.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/features/features.md index e4442f323b0..3f40e457ebc 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/features/features.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/features/features.md @@ -3,22 +3,22 @@ title: Funktioner sidebar_position: 1 --- -- [General](/archive/adguard-for-safari/features/general.md) +- [Generel](/archive/adguard-for-safari/features/general.md) Basic features, including notifications, update intervals, and logging level -- [Filters](/archive/adguard-for-safari/features/filters.md) +- [Filtre](/archive/adguard-for-safari/features/filters.md) Different filters that allow you to customize ad blocking -- [Content Blockers](/archive/adguard-for-safari/features/content-blockers/content-blockers.md) +- [Indholdsblockere](/archive/adguard-for-safari/features/content-blockers/content-blockers.md) Six thematic content blockers that conform to Apple’s restrictions -- [User rules](/archive/adguard-for-safari/features/rules.md) +- [Brugerregler](/archive/adguard-for-safari/features/rules.md) Custom filtering rules to fine-tune ad blocking -- [About](/archive/adguard-for-safari/features/about.md) +- [Om](/archive/adguard-for-safari/features/about.md) A section with links to privacy documents, GitHub repository, and version history diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/solving-problems/logs.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/solving-problems/logs.md index 0404373d7bf..b3781d5e041 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/solving-problems/logs.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-safari/solving-problems/logs.md @@ -25,6 +25,6 @@ AdGuard is committed to protecting your privacy. We strictly follow our [Privacy ::: -1. Open the [GitHub repo](https://github.com/AdguardTeam/AdguardMiniForMac/issues) and click _New issue_. +1. Åbn [GitHub-repo'et](https://github.com/AdguardTeam/AdguardMiniForMac/issues), og klik på _New issue_. 2. Send the log file to devteam@adguard.com. Medtag tidspunktet for fejlen, og vedhæft et link til problematikken eller dens nummer (angivet som #number ved siden af titlen). Alternatively, you can upload the log file to Google Drive and send it to devteam@adguard.com. Add the file link to your GitHub issue. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/adguard-for-windows.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/adguard-for-windows.md index 47ecd2fb433..bb9ee8a5885 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/adguard-for-windows.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/adguard-for-windows.md @@ -5,7 +5,7 @@ sidebar_position: 1 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/browser-assistant.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/browser-assistant.md index 117a5ef6568..63af60f90f3 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/browser-assistant.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/browser-assistant.md @@ -43,4 +43,4 @@ Basically, there are two cases when you might want to pick it instead of the new If you want to install the Browser Assistant for your default browser, you can do it directly from the app settings, but you also have an opportunity to install it for other browsers. -AdGuard Browser Assistant is available for all popular browsers: Chrome, Firefox, Edge, Opera, and Yandex. To install the one you need (or many, it is not prohibited but even encouraged), go to [our website](https://adguard.com/adguard-assistant/overview.html), click the browser icon and then the _Install_ button. That’s it! +AdGuard Browser Assistant is available for all popular browsers: Chrome, Firefox, Edge, Opera, and Yandex. To install the one you need (or many, it is not prohibited but even encouraged), go to [our website](https://adguard.com/adguard-assistant/overview.html), click the browser icon and then the _Install_ button. Det var det! diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/extensions.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/extensions.md index 6991c0c142e..97d446deb98 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/extensions.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/extensions.md @@ -5,7 +5,7 @@ sidebar_position: 3 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/features.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/features.md index f98b60f5531..04ac5c86eb6 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/features.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/features.md @@ -5,7 +5,7 @@ sidebar_position: 1 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/home-screen.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/home-screen.md index f91b67577dc..76ec3e80669 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/home-screen.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/home-screen.md @@ -5,11 +5,11 @@ sidebar_position: 1 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -AdGuard for Windows is an easy-to-use tool that blocks annoying banners, popups, video ads, and trackers. But that's not all: it helps you save traffic, load web pages faster, and protect your computer from undesirable and potentially malicious websites. AdGuard beskytter også mod phishing-websteder og beskytter børn mod upassende indhold. +AdGuard til Windows er et brugervenligt værktøj, der blokerer irriterende bannere, pop op'ere, videoreklamer og trackere. But that's not all: it helps you save traffic, load web pages faster, and protect your computer from undesirable and potentially malicious websites. AdGuard beskytter også mod phishing-websteder og beskytter børn mod upassende indhold. ![Main screen \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/overview/main_screen_en.png) diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/network.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/network.md index 94b85146208..9b4d09a2f75 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/network.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/network.md @@ -5,7 +5,7 @@ sidebar_position: 4 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/others.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/others.md index c7c7e985f00..58fc606217a 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/others.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/others.md @@ -5,7 +5,7 @@ sidebar_position: 5 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/settings.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/settings.md index ab705e77495..aa14befc249 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/settings.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/features/settings.md @@ -5,7 +5,7 @@ sidebar_position: 2 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/installation.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/installation.md index f9f4d900340..31318e74db1 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/installation.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/installation.md @@ -5,7 +5,7 @@ sidebar_position: 2 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/adguard-logs.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/adguard-logs.md index 73b432493ff..75d288a136b 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/adguard-logs.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/adguard-logs.md @@ -5,7 +5,7 @@ sidebar_position: 3 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/connection-not-trusted.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/connection-not-trusted.md index 4ccf31790db..e21e6d519e7 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/connection-not-trusted.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/connection-not-trusted.md @@ -5,7 +5,7 @@ sidebar_position: 2 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/dns-leaks.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/dns-leaks.md index b5103887b09..1eea101f6da 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/dns-leaks.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/dns-leaks.md @@ -5,7 +5,7 @@ sidebar_position: 10 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/low-level-settings.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/low-level-settings.md index acc5961576e..b0f5dfacab0 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/low-level-settings.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/low-level-settings.md @@ -5,7 +5,7 @@ sidebar_position: 7 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: @@ -13,13 +13,13 @@ Previously known as low-level settings, Advanced Settings mostly contain options :::caution -Mindlessly changing _Advanced Settings_ can potentially cause problems with the performance of AdGuard, may break the Internet connection or compromise your security and privacy. You should only make changes to these settings if you are sure of what you are doing or if our support team has asked you to do so. +Tankeløs ændring af _Lavniveauindstillinger_ kan forårsage problemer med AdGuards ydeevne, ødelægge internetforbindelsen eller kompromittere brugersikkerhed og -fortrolighed. You should only make changes to these settings if you are sure of what you are doing or if our support team has asked you to do so. ::: ## How to reach Advanced Settings -To go to _Advanced settings_, in the main windows click _Settings → General Settings_ and scroll down to _Advanced Settings_. Alternatively, select _Advanced → Advanced settings..._ in the tray menu. +For at gå til _Avancerede indstillinger_, klik i hovedvinduerne på _Indstillinger → Generelle indstillinger_ og rul ned til _Avancerede indstillinger_. Alternativt, vælg _Avanceret → Avancerede indstillinger..._ i bakkemenuen. ## Advanced Settings @@ -31,7 +31,7 @@ If enabled, AdGuard will block TCP Fast Open in the Edge browser. To apply setti ### Use Encrypted Client Hello -Every encrypted Internet connection has an unencrypted part. This is the very first packet which contains the name of the server you are connecting to. Encrypted Client Hello technology is supposed to solve this issue and encrypt that last bit of unencrypted information. To benefit from it, enable the _Use Encrypted Client Hello_ option. It uses a local DNS proxy to look for the ECH configuration for the domain. If it is found, Client Hello packet will be encrypted. +Every encrypted Internet connection has an unencrypted part. This is the very first packet which contains the name of the server you are connecting to. Encrypted Client Hello technology is supposed to solve this issue and encrypt that last bit of unencrypted information. Aktivér muligheden _Brug Encrypted Client Hello_ for at drage fordel af den. It uses a local DNS proxy to look for the ECH configuration for the domain. If it is found, Client Hello packet will be encrypted. ### Check websites' certificate transparency @@ -59,7 +59,7 @@ Aktivér denne funktion for at se AdGuard pop op-notifikationer. De vises ikke f ### Opsnap automatisk filterabonnements-URL'er -Enable this feature if you want AdGuard to automatically intercept filter subscription URLs (i.e. `abp:subscribe` and alike) and to open a custom filter installation dialog. +Aktivér denne funktion, hvis AdGuard automatisk skal opsnappe filterabonnements-URL'er (dvs. `abp:subscribe` o.lign.) og åbne en dialogboks til installation af tilpassede filter. ### Filterér HTTP/3 @@ -71,7 +71,7 @@ If this option is enabled, AdGuard will filter requests sent over HTTP/3 in addi - Firefox-baserede webbrowsere opfører sig som standard tilsvarende, men `network.http.http3.disable_when_third_party_roots_found`-indstillingen kan i `about:config` sættes til `false` for at tillade brugercertifikater til HTTP/3. - Safari understøtter HTTP/3-filtrering uden yderligere opsætning. -### Use redirect driver mode +### Brug omdirigeringsdrivertilstand If this option is enabled, AdGuard intercepts all the traffic and redirects it to the local proxy server for further filtering. @@ -79,7 +79,7 @@ Otherwise, AdGuard will filter all the traffic on the fly, without redirection. ### Open main window at system start-up -Enable this option to make the main AdGuard window open after the system is loaded. This setting, which doesn't affect whether the actual filtering service is launched or not, is located in _Settings → General Settings_. +Enable this option to make the main AdGuard window open after the system is loaded. Denne indstilling, der ingen indflydelse har på, hvorvidt filtreringstjenesten faktisk startes eller ej, er placeret i _Indstillinger → Generelle indstillinger_. ### Aktivér filtrering ved systemstart @@ -87,7 +87,7 @@ Starting from v7.12, by default, AdGuard's service does not filter traffic after :::note -Before v7.12, the AdGuard service started in filtering mode by default (even if the _Launch AdGuard at system start-up_ was disabled). If you were satisfied with the old behavior, enable this option. +Før v7.12 startede AdGuard-tjenesten som standard i filtreringstilstand (selv hvis _Start AdGuard ved systemopstart_ var slået fra). If you were satisfied with the old behavior, enable this option. ::: @@ -97,11 +97,11 @@ If you want AdGuard to filter loopback connections, check the box. This option w ### Exclude specified IP ranges from filtering -If you don't want AdGuard to filter particular subnets, enable this feature and specify the IP ranges in the CIDR notation (e.g. 98.51.100.14/24) in the **IP ranges excluded from filtering** section below. +Aktivér denne funktion, hvis AdGuard ikke skal filtrere bestemte undernet, og angiv IP-intervallerne i CIDR-notationen (f.eks. 98.51.100.14/24) i afsnittet **IP-intervaller undtaget fra filtrering** nedenfor. ### Enable HAR writing -This option should be enabled **only for debugging purposes**. Ticking the checkbox will make AdGuard create a file in the HAR 1.2 format containing information about all filtered HTTP requests. This file can be analyzed with the Fiddler app. Note that it may slow down your web browsing significantly. +Denne indstilling bør kun være aktiveret **til fejlfindingsformål**. Ticking the checkbox will make AdGuard create a file in the HAR 1.2 format containing information about all filtered HTTP requests. This file can be analyzed with the Fiddler app. Note that it may slow down your web browsing significantly. ### Add an extra space to the plain HTTP request @@ -119,7 +119,7 @@ GET /foo/bar/ HTTP/1.1 Host:example.org ``` -This option is only applied when the _Protect from DPI_ Stealth mode option is enabled. +Denne indstilling anvendes kun, når indstillingen _Beskyt mod DPI_ Stealth-tilstanden er aktiv. ### Adjust size of fragmentation of initial TLS packet @@ -127,13 +127,13 @@ Specifies the size of the TCP packet fragmentation, avoiding deep packet inspect If this option is enabled, AdGuard splits the initial TLS packet (the Client Hello packet) into two parts: the first one has the specified length and the second one has the rest, up to the length of the whole initial TLS packet. -Gyldige værdier: 1–1500. If invalid size is specified, the value selected by the system will be used. This option is only applied when the _Protect from DPI_ Stealth mode option is enabled. +Gyldige værdier: 1–1500. If invalid size is specified, the value selected by the system will be used. Denne indstilling anvendes kun, når indstillingen _Beskyt mod DPI_ Stealth-tilstanden er aktiv. ### Plain HTTP request fragment size Justerer størrelsen af HTTP-forespørgselsfragmenteringen. This option only affects plain HTTP traffic. If this option is enabled, AdGuard splits the initial packet into two parts: the first one has the specified length and the second one has the rest, up to the length of the whole original packet. -Gyldige værdier: 1–1500. If invalid size is specified, the value selected by the system will be used. This option is only applied when the _Protect from DPI_ Stealth mode option is enabled. +Gyldige værdier: 1–1500. If invalid size is specified, the value selected by the system will be used. Denne indstilling anvendes kun, når indstillingen _Beskyt mod DPI_ Stealth-tilstanden er aktiv. ### Show QUIC @@ -149,7 +149,7 @@ Here you can specify an idle time period, in seconds, before sending a keepalive :::note -This setting only works when the _Enable TCP keepalive_ option is enabled. +Denne indstilling fungerer kun, når indstillingen _Aktivér TCP keepalive_ er slået til. ::: @@ -159,13 +159,13 @@ Here you can specify time in seconds before sending another keepalive probe to a :::note -This setting only works when the _Enable TCP keepalive_ option is enabled. +Denne indstilling fungerer kun, når indstillingen _Aktivér TCP keepalive_ er slået til. ::: ### Block Java -Some websites and web services still support Java Plug-Ins. The API that serves as the basis for Java plug-ins has serious security vulnerabilities. You can disable such plug-ins for security purposes. Nevertheless, even if you decide to use _Block Java_ option, JavaScript will still be enabled. +Some websites and web services still support Java Plug-Ins. The API that serves as the basis for Java plug-ins has serious security vulnerabilities. You can disable such plug-ins for security purposes. Selvom det besluttes at bruge muligheden _Blokér Java_, vil JavaScript stadig være aktiveret. ### DNS server timeout period diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/solving-problems.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/solving-problems.md index aadbbf29dc7..1ee262813d1 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/solving-problems.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/solving-problems.md @@ -5,11 +5,11 @@ sidebar_position: 1 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -Here are some problems you may encounter and workarounds, guides, and instructions you may need. +Her er nogle problemer, som kan opleves, og løsninger samt guider og vejledninger, der muligvis bliver brug for. - [WFP driver compatibility](/archive/adguard-for-windows/solving-problems/wfp-driver/) - [Certificate-related issues](/archive/adguard-for-windows/solving-problems/connection-not-trusted/) diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md index 7b63ef5782e..09a9e333cba 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/tdi-driver-and-Chrome-142.md @@ -5,7 +5,7 @@ sidebar_position: 14 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/wfp-driver.md b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/wfp-driver.md index bf3ce9984c3..1cfb4e9555b 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/wfp-driver.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/archive/adguard-for-windows/solving-problems/wfp-driver.md @@ -5,7 +5,7 @@ sidebar_position: 1 :::info -This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) +Denne artikel omhandler AdGuard til Windows, en multifunktionel adblocker, der beskytter enheden på systemniveau. For at se, hvordan den fungerer, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: diff --git a/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 8d2ba4dcfd6..62688f926fa 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -32,8 +32,8 @@ This article is about the filters we create to use in AdGuard and other ad-block - **French filter** removes ads from websites in French. Originally based on the [Liste FR](https://forums.lanik.us/viewforum.php?f=91) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_16_French/filter.txt) - **Japanese filter** removes ads from websites in Japanese. Originally based on the [Fanboy’s Japanese](https://www.fanboy.co.nz/fanboy-japanese.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_7_Japanese/filter.txt) - **Dutch filter** removes ads from websites in Dutch. Originally based on the [EasyList Dutch](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_8_Dutch/filter.txt) -- **Italian filter** removes ads from websites in Italian. Originally based on the [EasyList Italy](https://github.com/easylist/easylistitaly/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_26_Italian/filter.txt) -- **Polish filter** removes ads from websites in Polish. Originally based on the [Official Polish filters for AdBlock, uBlock Origin & AdGuard](https://github.com/MajkiIT/polish-ads-filter#polish-filters-for-adblock-ublock-origin--adguard) and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_27_Polish/filter.txt) +- **Italian filter** fjerner annoncer fra italiensksprogede websteder. Oprindeligt baseret på filteret [EasyList Italy](https://github.com/easylist/easylistitaly/) og efterfølgende ændret af os iht. klager fra brugere. [Vis regler](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_26_Italian/filter.txt) +- **Polish filter** fjerner annoncer fra polsksprogede websteder. Oprindeligt baseret på [Official Polish filters for AdBlock, uBlock Origin & AdGuard](https://github.com/MajkiIT/polish-ads-filter#polish-filters-for-adblock-ublock-origin--adguard) og efterfølgende ændret af os iht. klager fra brugere. [Vis regler](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_27_Polish/filter.txt) - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) diff --git a/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index f9a340ab0b9..34246fc12f6 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -1,5 +1,5 @@ --- -title: How to create your own ad filters +title: Sådan oprettes egne adblockingfiltre sidebar_position: 5 toc_min_heading_level: 2 toc_max_heading_level: 4 @@ -7,168 +7,169 @@ toc_max_heading_level: 4 :::info -In this article, we explain how to write custom filtering rules for use in AdGuard products. To test your rules, you can [download the AdGuard app](https://agrd.io/download-kb-adblock) +I denne artikel forklarer vi, hvordan der skrives tilpassede filtreringsregler til brug i AdGuard-produkter. For at teste reglerne, [download AdGuard-appen](https://agrd.io/download-kb-adblock) ::: -A filter is a set of filtering rules applied to specific content, such as banners or popups. AdGuard has a list of standard filters created by our team. We constantly improve and update them, striving to meet the needs of most of our users. +Et filter er et sæt filtreringsregler anvendt på specifikt indhold, såsom bannere eller pop op-vinduer. AdGuard har en liste over standardfiltre oprettet af teamet. Vi forbedrer og opdaterer dem konstant og stræber efter at opfylde behovene hos de fleste af vores brugere. -At the same time, AdGuard allows you to create your own custom filters using the same types of rules that we have in our filters. +AdGuard muliggør at oprette egne tilpassede filtre ved brug samme type regler som i vores egne filtre. -To describe the syntax of our filtering rules, we use [Augmented BNF for Syntax Specifications](https://tools.ietf.org/html/rfc5234), but we do not always strictly follow this specification. +Til at beskrive syntaksen for vores filtreringsregler bruges [Augmented BNF for Syntax Specifications](https://tools.ietf.org/html/rfc5234), men vi følger ikke altid denne specifikation slavisk. :::info -Originally, the AdGuard's syntax was based on the syntax of Adblock Plus rules. Later, we extended it with new types of rules for better ad filtering. Some parts of this article about the rules common both to AdGuard and ABP were taken from [the Adblock Plus guide on how to write filters](https://adblockplus.org/en/filters). +Oprindeligt var AdGuards syntaks baseret på Adblock Plus-regelsyntaksen. Senere blev den udvidet med nye regeltyper for bedre annoncefiltrering. Visse dele af denne artikel om reglerne, som er fælles for både AdGuard og ABP, stammer fra [Adblock Plus-vejledningen til, hvordan der skrives filtre](https://adblockplus.org/en/filters). ::: -## Comments +## Kommentarer -Any line that starts with an exclamation mark is a comment. In the list of rules it is displayed in gray color. AdGuard will ignore this line, so you can write anything you want. Comments are usually placed above the rules and used to describe what a rule does. +Enhver linje startende med et udråbstegn udgør en kommentar. På listen over regler vises den med grå. AdGuard ignorerer denne linje, så der kan skrives, hvad der ønskes. En kommentarer beskriver, hvad en regel gør, og den placeres normalt over reglen. F.eks.: ```adblock -! This is the comment. Below this line, there is an actual filtering rule. +! Dette er en kommentar. Under denne linje er der en egentlig filtreringsregel. ||example.org^ ``` ## Eksempler -### Blocking by domain name +### Blokering efter domænenavn -![Blocking by domain name](https://cdn.adtidy.org/content/kb/ad_blocker/general/0_blocking_domain.svg) +![Blokering efter domænenavn](https://cdn.adtidy.org/content/kb/ad_blocker/general/0_blocking_domain.svg) -**This rule blocks:** +**Denne regel blokerer:** - `https://example.org/ad1.gif` - `https://subdomain.example.org/ad1.gif` - `https://ads.example.org:8000/` -**This rule does not block:** +**Denne regel blokerer ikke:** - `https://ads.example.org.us/ad1.gif` - `https://example.com/redirect/https://ads.example.org/` -By default, such rules do not work for document requests. This means that the `||example.org^` rule will block a request made to `example.org` when you try to navigate to this domain from another website, but if you type `example.org` into the address bar and try to navigate to it, the website will open. To block the document request, you will need to use a rule with the [`$document` modifier](#document-modifier): `||example.org^$document`. +Som standard virker sådanne regler ikke for dokumentforespørgsler. Det betyder, at reglen `||example.org^` blokerer en forespørgsel til `example.org`, når domænet forsøges tilgået fra et andet websted, men skrives `example.org` på adresselbjælken, og det forsøges tilgået, åbnes webstedet. For at blokere dokumentforespørgslen skal der bruges en regel med modifikatoren [`$document`](#document-modifier): `||example.org^$document`. -### Blocking exact address +### Blokering af præcis adresse -![Blocking exact address](https://cdn.adtidy.org/content/kb/ad_blocker/general/1_exact_address.svg) +![Blokering af præcis adresse](https://cdn.adtidy.org/content/kb/ad_blocker/general/1_exact_address.svg) -**This rule blocks:** +**Denne regel blokerer:** - `https://example.org/` -**This rule does not block:** +**Denne regel blokerer ikke:** - `https://example.org/banner/img` -### Basic rule modifiers {#basic-rule-modifiers-examples} +### Basisregelmodifikatorer {#basic-rule-modifiers-examples} -Filtering rules support numerous modifiers that allow you to fine-tune the rule behavior. Here is an example of a rule with some simple modifiers. +Filtreringsregler understøtter adskillige modifikatorer, som muliggør at finjustere regeladfærden. Eksempel på en regel med nogle simple modifikatorer. -![Basic rule modifiers](https://cdn.adtidy.org/content/kb/ad_blocker/general/2_basic_rule_options.svg) +![Basisregelmodifikatorer](https://cdn.adtidy.org/content/kb/ad_blocker/general/2_basic_rule_options.svg) -**This rule blocks:** +**Denne regel blokerer:** -- `https://example.org/script.js` if this script is loaded from `example.com`. +- `https://example.org/script.js`, hvis dette script indlæses fra `example.com`. -**This rule does not block:** +**Denne regel blokerer ikke:** -- `https://example.org/script.js` if this script is loaded from `example.org`. -- `https://example.org/banner.png` because it is not a script. +- `https://example.org/script.js`, hvis dette script indlæses fra `example.org`. +- `https://eksempel.org/banner.png`, da det ikke er et script. -### Unblocking an address +### Afblokering af en adresse -![Unblocking an address](https://cdn.adtidy.org/content/kb/ad_blocker/general/3_basic_exception.svg) +![Afblokering af en adresse](https://cdn.adtidy.org/content/kb/ad_blocker/general/3_basic_exception.svg) -**This rule unblocks:** +**Denne regel afblokerer:** -- `https://example.org/banner.png` even if there is a blocking rule for this address. +- `http://eksempel.org/banner.png`, selv hvis der findes en blokeringsregel for adressen. -Blocking rules with [`$important`](#important-modifier) modifier can override exceptions. +Blokeringsregler med modifikatoren [`$important`](#important-modifier) kan tilsidesætte undtagelser. -### Unblocking an entire website +### Afblokering af et helt websted -![Unblocking an entire website](https://cdn.adtidy.org/content/kb/ad_blocker/general/4_unblock_entire_website.svg) +![Afblokering af et helt websted](https://cdn.adtidy.org/content/kb/ad_blocker/general/4_unblock_entire_website.svg) -**This rule unblocks** +**Denne regel afblokerer** -- It disables all cosmetic rules on `example.com`. -- It unblocks all requests sent from this website even if there is are blocking rules matching these requests. +- Den deaktiverer alle kosmetiske regler på `example.com`. +- Den afblokerer alle forespørgsler sendt fra webstedet, selv hvis der findes blokeringsregler matchende disse forespørgsler. -### Cosmetic rule +### Kosmetisk regel -![Cosmetic rule](https://cdn.adtidy.org/content/kb/ad_blocker/general/5_cosmetic_rules.svg) +![Kosmetisk regel](https://cdn.adtidy.org/content/kb/ad_blocker/general/5_cosmetic_rules.svg) -Cosmetic rules are based on using a special language named CSS, which every browser understands. Basically, it adds a new CSS style to the website which purpose is to hide particular elements. You can [learn more about CSS](https://developer.mozilla.org/en-US/docs/Learn/CSS/Introduction_to_CSS/Selectors) in general. +Kosmetiske regler er baseret på et særligt sprog kaldet CSS, hvilket enhver webbrowser forstår. Grundlæggende føjer den en ny CSS-typografi til webstedet beregnet på at skjule bestemte elementer. Der kan læses mere om CSS generelt [hér](https://developer.mozilla.org/en-US/docs/Learn/CSS/Introduction_to_CSS/Selectors). -AdGuard [extends CSS](#extended-css-selectors) and lets filters developers handle much more complicated cases. However, to use these extended rules, you need to be fluent in regular CSS. +AdGuard [udvider CSS](#extended-css-selectors), hvilket lader filterudviklere håndtere meget mere komplekse tilfælde. Brug af disse udvidede regler kræver dog, at almindelig CSS mestres. -**Popular CSS selectors** +**Populære CSS-vælgere** -| Name | CSS selector | Description | -| ---------------------------- | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| ID selector | `#banners` | Matches all elements with `id` attribute equal to `banners`.
![ID selector](https://cdn.adtidy.org/public/Adguard/kb/en/rules_syntax/css_id_selector.png) | -| Class selector | `.banners` | Matches all elements with `class` attribute containing `banners`.
![Class selector](https://cdn.adtidy.org/public/Adguard/kb/en/rules_syntax/css_class_selector.png) | -| Attribute selector | `div[class="banners"]` | Matches all `div` elements with `class` attribute **exactly equal** to `banners`.
![Attribute selector](https://cdn.adtidy.org/public/Adguard/kb/en/rules_syntax/css_class_attr.png) | -| Attribute substring selector | `div[class^="advert1"]` | Matches all `div` elements which `class` attribute **starts with** the `advert1` string.
![Attribute substring selector](https://cdn.adtidy.org/public/Adguard/kb/en/rules_syntax/css_class_attr_start.png) | -| Attribute substring selector | `div[class$="banners_ads"]` | Matches all `div` elements which `class` attribute **ends with** the `banners_ads` string.
![Attribute substring selector](https://cdn.adtidy.org/public/Adguard/kb/en/rules_syntax/css_class_attr_end.png) | -| Attribute substring selector | `a[href^="https://example.com/"]` | Matches all links that are loaded from `https://example.com/` domain.
![Attribute substring selector](https://cdn.adtidy.org/public/Adguard/kb/en/rules_syntax/css_attr_start.png) | -| Attribute selector | `a[href="https://example.com/"]` | Matches all links to **exactly** the `https://example.com/` address.
![Attribute selector](https://cdn.adtidy.org/public/Adguard/kb/en/rules_syntax/css_attr_equal.png) | +| Navn | CSS-vælger | Beskrivelse | +| -------------------------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| ID-vælger | `#banners` | Matcher alle elementer med `id`-attributten svarende til `bannere`.
![ID-vælger](https://cdn.adtidy.org/public/Adguard/kb/en/rules_syntax/css_id_selector.png) | +| Class-vælger | `.banners` | Matcher alle elementer med `class`-attributten indeholdende `banners`.
![Class-vælger](https://cdn.adtidy.org/public/Adguard/kb/en/rules_syntax/css_class_selector.png) | +| Attributvælger | `div[class="banners"]` | Matcher alle `div`-elementer med `class`-attributten **nøjagtigt lig med** `banners`.
![Attributvælger](https://cdn.adtidy.org/public/Adguard/kb/en/rules_syntax/css_class_attr.png) | +| Attributunderstrengsvælger | `div[class^="advert1"]` | Matcher alle `div`-elementer med attributten `class` **startende med** strengen `advert1`.
![Attributunderstrengsvælger](https://cdn.adtidy.org/public/Adguard/kb/en/rules_syntax/css_class_attr_start.png) | +| Attributunderstrengsvælger | `div[class$="banners_ads"]` | Matcher alle `div`-elementer med attributten `class` **sluttende med** strengen `banner_ads`.
![Attributunderstrengsvælger](https://cdn.adtidy.org/public/Adguard/kb/en/rules_syntax/css_class_attr_end.png) | +| Attributunderstrengsvælger | `a[href^="https://example.com/"]` | Matcher alle links indlæst fra domænet `http://example.com/`.
![Attributunderstrengsvælger](https://cdn.adtidy.org/public/Adguard/kb/en/rules_syntax/css_attr_start.png) | +| Attributvælger | `a[href="https://example.com/"]` | Matcher alle links til **den eksakte** `http://example.com/`-adresse.
![Attributvælger](https://cdn.adtidy.org/public/Adguard/kb/en/rules_syntax/css_attr_equal.png) | -## Restrictions and limitations +## Restriktioner og begrænsninger -### Trusted filters {#trusted-filters} +### Betroede filtre {#trusted-filters} -Some rules can be used only in trusted filters. This category includes: +Visse regler kan kun bruges i betroede filtre. Denne kategori omfatter: -- filter lists [created by the AdGuard team](../adguard-filters), -- custom filter lists installed as `trusted`, -- user rules. +- filterlister [oprettet af AdGuard-teamet](../adguard-filters), +- tilpassede filterlister installeret som `betroede`, +- brugerregler. +- prægodkendte tredjepartsfilterlister tilgængelige via fanen *Filtre*. ### AdGuard Content Blocker -AdGuard Content Blocker is an extension for Samsung and Yandex browsers that can be installed from Google Play. It is not to be confused with the fully functional AdGuard for Android that can only be downloaded from [our website](https://adguard.com/adguard-android/overview.html). Unfortunately, AdGuard Content Blocker capabilities are limited by what the browsers allow and they only support an old Adblock Plus filters syntax: +AdGuard Content Blocker er en udvidelse til Samsung- og Yandex-webbrowsere, der kan installeres fra Google Play. Den skal ikke forveksles med den fuldt funktionelle AdGuard til Android, der kun kan downloades fra [vores websted](https://adguard.com/adguard-android/overview.html). Desværre er mulighederne i AdGuard Content Blocker begrænset af, hvad webbrowserne tillader, og de understøtter kun en gammel Adblock Plus-filtersyntaks: -- Basic blocking rules with the following modifiers: `$domain`, `$third-party`, [content-type modifiers](#content-type-modifiers). -- Basic exception rules with the following modifiers: `$document`, `$elemhide`. -- Basic [element hiding rules](#cosmetic-elemhide-rules) with no extended CSS support. +- Basisblokeringsregler med flg. modifikatorer: `$domain`, `$third-party`, [indholdstypemodifikatorer](#content-type-modifiers). +- Basisundtagelsesregler med flg. modifikatorer: `$document`, `$elemhide`. +- Basis [elementskjulningsregler](#cosmetic-elemhide-rules) uden udvidet CSS-understøttelse. -Because of the limitations above AdGuard Content Blocker will not be mentioned in the compatibility notes. +Grundet ovennævnte begrænsninger nævnes AdGuard Content Blocker ikke i kompatibilitetsnotaterne. ### SafariConverterLib {#safari-converter-lib} -Safari Converter aims to support AdGuard filtering rules syntax as much as possible, but still there are limitations and shortcomings that are hard to overcome. +Målet med Safari Converter er at understøtte AdGuard-filtreringsregelsyntaks så meget som muligt, men der er stadig begrænsninger og mangler, som er svære at overvinde. -#### Basic (network) rules +#### Basisregler (netværk) -Safari Converter supports a substantial subset of [basic rules](#basic-rules) and certainly supports the most important types of those rules. +Safari Converter understøtter et betydeligt udvalg af [basisregler](#basic-rules) og understøtter bestemt de vigtigste typer af disse regler. -##### Supported with limitations {#safari-converter--basic--supported-with-limitations} +##### Understøttet med begrænsninger {#safari-converter--basic--supported-with-limitations} -- [Regular expression rules](#regexp-support) are limited to the subset of regex that is [supported by Safari](https://developer.apple.com/documentation/safariservices/creating-a-content-blocker#Capture-URLs-by-pattern). +- [Regulære udtryk-regler](#regexp-support) er begrænset til udvalget af regex [understøttet af Safari](https://developer.apple.com/documentation/safariservices/creating-a-content-blocker#Capture-URLs-by-pattern). -- `$domain` - [domain modifier](#domain-modifier) is supported with several limitations: +- `$domain` - [domæne-modifikator](#domain-modifier) understøttes med flere begrænsninger. - - It's impossible to mix allowed and disallowed domains (like `$domain=example.org|~sub.example.org`). Please upvote the [feature request](https://bugs.webkit.org/show_bug.cgi?id=226076) to WebKit to lift this limitation. - - "Any TLD" (i.e. `domain.*`) is not fully supported. In the current implementation the converter just replaces `.*` with top 100 popular TLDs. This implementation will be improved [in the future](https://github.com/AdguardTeam/SafariConverterLib/issues/20#issuecomment-2532818732). - - Using regular expressions in `$domain` is not supported, but it also will be improved [in the future](https://github.com/AdguardTeam/SafariConverterLib/issues/20#issuecomment-2532818732). + - Det er umuligt at blande tilladte og ikke-tilladte domæner (såsom `$domain=example.org|~sub.example.org`). Stem venligst for [funktionsanmodningen](https://bugs.webkit.org/show_bug.cgi?id=226076) til WebKit for at ophæve denne begrænsning. + - "Ethvert TLD" (dvs. `domæne.*`) understøttes ikke fuldt ud. I den nuværende implementering erstatter konverteren blot `.*` med de 100 mest populære TLD'er. Denne implementering forbedres [i fremtiden](https://github.com/AdguardTeam/SafariConverterLib/issues/20#issuecomment-2532818732). + - Brug af regulære udtryk i `$domain` understøttes ikke, men det forbedres også [i fremtiden](https://github.com/AdguardTeam/SafariConverterLib/issues/20#issuecomment-2532818732). -- `$denyallow` - this modifier is supported via converting `$denyallow` rule to a set of rules (one blocking rule + several unblocking rules). +- `$denyallow` - denne modifikator understøttes via konvertering af `$denyallow`-reglen til et sæt af regler (én blokeringsregel + flere afblokeringsregler). - Due to that limitation `$denyallow` is only allowed when the rule also has `$domain` modifier. + Grundet denne begrænsning er `$denyallow` kun tilladt, når reglen også har `$domain`-modifikatoren. - - Generic rule `*$denyallow=x.com,image,domain=a.com` will be converted to: + - Den generiske regel `*$denyallow=x.com,image,domain=a.com` konverteres til: ```adblock *$image,domain=a.com @@||x.com$image,domain=a.com ``` - - Rule `/banner.png$image,denyallow=test1.com|test2.com,domain=example.org` will be converted to: + - Reglen `/banner.png$image,denyallow=test1.com|test2.com,domain=example.org` konverteres til: ```adblock /banner.png$image,domain=example.org @@ -178,44 +179,44 @@ Safari Converter supports a substantial subset of [basic rules](#basic-rules) an @@||test2.com/*/banner.png$image,domain=example.org ``` - - Rule without `$domain` is **not supported**: `$denyallow=a.com|b.com`. + - Regler uden `$domain` er **uunderstøttet**: `$denyallow=a.com|b.com`. -- `$popup` - popup rules are supported, but they're basically the same as `$document`-blocking rules and will not attempt to close the tab. +- `$popup` - pop op-regler understøttes, men de er grundlæggende de samme som `$document`-blokeringsregler og vil ikke forsøge at lukke fanen. -- Exception rules (`@@`) disable cosmetic filtering on matching domains. +- Undtagelsesregler (`@@`) deaktiverer kosmetisk filtrering på matchende domæner. - Exception rules in Safari rely on the rule type `ignore-previous-rules` so to make it work we have to order the rules in a specific order. Exception rules without modifiers are placed at the end of the list and therefore they disable not just URL blocking, but cosmetic rules as well. + Undtagelsesregler i Safari er afhængige af regeltypen `ignore-previous-rules`, så for at få det til at fungere, skal reglerne arrangeres i en bestemt rækkefølge. Undtagelsesregler uden modifikatorer placeres i slutningen af listen, og derfor deaktiverer de ikke kun URL-blokering, men også kosmetiske regler. - This limitation may be lifted if [#70](https://github.com/AdguardTeam/SafariConverterLib/issues/70) is implemented. + Denne begrænsning kan ophæves, hvis [#70](https://github.com/AdguardTeam/SafariConverterLib/issues/70) implementeres. -- `$urlblock`, `$genericblock` is basically the same as `$document`, i.e. it disables all kinds of filtering on websites. +- `$urlblock`, `$genericblock` er grundlæggende det samme som `$document`, dvs. den deaktiverer alle former for filtrering på websteder. - These limitations may be lifted when [#69](https://github.com/AdguardTeam/SafariConverterLib/issues/69) and [#71](https://github.com/AdguardTeam/SafariConverterLib/issues/71) are implemented. + Disse begrænsninger kan ophæves, når [#69](https://github.com/AdguardTeam/SafariConverterLib/issues/69) og [#71](https://github.com/AdguardTeam/SafariConverterLib/issues/71) implementeres. -- `$content` makes no sense in the case of Safari since HTML filtering rules are not supported so it's there for compatibility purposes only. Rules with `$content` modifier are limited to `document` resource type. +- `$content` giver ingen mening ift. Safari, da HTML-filtreringsregler ikke understøttes, så den medtages kun af kompatibilitetshensyn. Regler med modifikatoren `$content` er begrænset til ressourcetypen `dokument`. -- `$specifichide` is implemented by scanning existing element hiding rules and removing the target domain from their `if-domain` array. +- `$specifichide` implementeres ved at skanne eksisterende elementskjulningsregler og fjerne måldomænet fra deres `if-domain`-struktur. - - `$specifichide` rules MUST target a domain, i.e. be like this: `||example.org^$specifichide`. Rules with more specific patterns will be discarded, i.e. `||example.org/path$specifichide` will not be supported. - - `$specifichide` rules only cover rules that target the same domain as the rule itself, subdomains are ignored. I.e. the rule `@@||example.org^$specifichide` will disable `example.org##.banner`, but will ignore `sub.example.org##.banner`. This limitation may be lifted if [#72](https://github.com/AdguardTeam/SafariConverterLib/issues/72) is implemented. + - `$specifichide`-regler SKAL være målrettet et domæne, dvs. ligne dette: `||example.org^$specifichide`. Regler med mere specifikke mønstre kasseres, dvs. `||example.org/path$specifichide` er uunderstøttet. + - `$specifichide`-regler dækker kun regler, som er målrettet det samme domæne som reglen selv, underdomæner ignoreres. Dvs. reglen `@@||example.org^$specifichide` deaktiverer `example.org##.banner`, men ignorerer `sub.example.org##.banner`. Denne begrænsning kan ophæves, hvis [#72](https://github.com/AdguardTeam/SafariConverterLib/issues/72) implementeres. -- `urlblock`, `genericblock`, `generichide`, `elemhide`, `specifichide`, and `jsinject` modifiers can be used only as a single modifier in a rule. This limitation may be lifted in the future: [#73](https://github.com/AdguardTeam/SafariConverterLib/issues/73). +- Modifikatorerne `urlblock`, `genericblock`, `generichide`, `elemhide`, `specifichide` og `jsinject` kan kun bruges som én enkelt modifikator i en regel. Denne begrænsning kan blive ophævet i fremtiden: [#73](https://github.com/AdguardTeam/SafariConverterLib/issues/73). -- `$websocket` (fully supported starting with Safari 15). +- `$websocket` (fuldt understøttet fra Safari 15). -- `$ping` (fully supported starting with Safari 14). +- `$ping` (fuldt understøttet fra Safari 14). -##### Not supported +##### Uunderstøttet - `$app` - `$header` - `$method` -- `$strict-first-party` (to be supported in the future: [#64](https://github.com/AdguardTeam/SafariConverterLib/issues/64)) -- `$strict-third-party` (to be supported in the future: [#65](https://github.com/AdguardTeam/SafariConverterLib/issues/65)) -- `$to` (to be supported in the future: [#60](https://github.com/AdguardTeam/SafariConverterLib/issues/60)) +- `$strict-first-party` (vil blive understøttet i fremtiden: [#64](https://github.com/AdguardTeam/SafariConverterLib/issues/64)) +- `$strict-third-party` (vil blive understøttet i fremtiden: [#65](https://github.com/AdguardTeam/SafariConverterLib/issues/65)) +- `$to` (vil blive understøttet i fremtiden: [#60](https://github.com/AdguardTeam/SafariConverterLib/issues/60)) - `$extension` - `$stealth` -- `$cookie` (partial support in the future: [#54](https://github.com/AdguardTeam/SafariConverterLib/issues/54)) +- `$cookie` (delvis understøttelse i fremtiden: [#54](https://github.com/AdguardTeam/SafariConverterLib/issues/54)) - `$csp` - `$hls` - `$inline-script` @@ -232,71 +233,71 @@ Safari Converter supports a substantial subset of [basic rules](#basic-rules) an - `$replace` - `$urltransform` -#### Cosmetic rules {#cosmetic-rules-safari-limitations} +#### Kosmetiske regler {#cosmetic-rules-safari-limitations} -Safari Converter supports most of the [cosmetic rules](#cosmetic-rules) although only element hiding rules with basic CSS selectors are supported natively via Safari Content Blocking, everything else needs to be interpreted by an additional extension. +Safari Converter understøtter de fleste af de [kosmetiske regler](#cosmetic-rules), selvom kun regler til elementskjulning med basis CSS-vælgere understøttes indbygget via Safari Content Blocking; alt andet kræver fortolkning af en ekstra udvidelse. -##### Limitations of cosmetic rules +##### Begrænsninger af kosmetiske regler -- Specifying domains is subject to the same limitations as the `$domain` modifier of basic rules. +- Specifikation af domæner er underlagt de samme begrænsninger som for modifikatoren `$domain` for basisregler. -- [Non-basic rules modifiers](#non-basic-rules-modifiers) are supported with some limitations: +- [Ikke-basisregelmodifikatorer](#non-basic-rules-modifiers) understøttes med visse begrænsninger: - - `$domain` - the same limitations as everywhere else. - - `$path` - supported, but if you use regular expressions, they will be limited to the subset of regex that is [supported by Safari](https://developer.apple.com/documentation/safariservices/creating-a-content-blocker#Capture-URLs-by-pattern). - - `$url` - to be supported in the future: [#68](https://github.com/AdguardTeam/SafariConverterLib/issues/68) + - `$domain` - de samme begrænsninger som alle andre steder. + - `$path` - understøttet, men bruges regulære udtryk, vil disse være begrænset til udvalget af regulære udtryk, som [understøttes af Safari](https://developer.apple.com/documentation/safariservices/creating-a-content-blocker#Capture-URLs-by-pattern). + - `$url` - bliver understøttet i fremtiden: [#68](https://github.com/AdguardTeam/SafariConverterLib/issues/68) -#### Script/scriptlet rules +#### Script-/scriptlet-regler -Safari Converter fully supports both [script rules](#javascript-rules) and [scriptlet rules](#scriptlets). However, these rules can only be interpreted by a separate extension. +Safari Converter understøtter fuldt ud både [script-regler](#javascript-rules) og [scriptlet-regler](#scriptlets). Imidlertid kan disse regler kun fortolkes af en separat udvidelse. :::warning -For scriptlet rules, it is **very important** that they are run as early as possible when the page loads. The reason for that is that it's important to run them before the page scripts. Unfortunately, with Safari there will always be a slight delay that can decrease the quality of blocking. +For scriptlet-regler er det **meget vigtigt**, at de afvikles så tidligt som muligt, når siden indlæses. Årsagen er, at det er vigtigt, at de afvikles tidligere end selve side-scriptene. Med Safari vil der desværre altid være en lille forsinkelse, der kan reducere blokeringskvaliteten. ::: -#### HTML filtering rules {#html-filtering-rules-safari-limitations} +#### HTML-filtreringsregler {#html-filtering-rules-safari-limitations} -[HTML filtering rules](#html-filtering-rules) are **not supported** and will not be supported in the future. Unfortunately, Safari does not provide necessary technical capabilities to implement them. +[HTML-filtreringsregler](#html-filtering-rules) er **uunderstøttet**, hvilket ikke ændres fremadrettet. Desværre tilbyder Safari ikke de nødvendige tekniske funktioner til implementering heraf. -## Basic rules +## Basisregler -The most simple rules are so-called *Basic rules*. They are used to block requests to specific URLs. Or to unblock it, if there is a special marker "@@" at the beginning of the rule. The basic principle for this type of rules is quite simple: you have to specify the address and additional parameters that limit or expand the rule scope. +De mest simple regler er såkaldte *Basisregler*. De bruges til at blokere forespørgsler til bestemte URL'er. Eller til afblokering, hvis reglen starter med den særlige markør "@@". Basisprincippet for denne regeltype er ret simpelt: Angiv adressen samt yderligere parametre, som begrænser eller udvider reglens omfang. -:::note Sub-requests +:::note Underforespørgsel -Basic rules for blocking requests are applied only to **sub-requests**. That means they will not block the loading of the page unless it is explicitly specified with a `$document` modifier. +Basisregler til forespørgselsblokering anvendes kun på **underforespørgsler**. Det betyder, at de ikke vil blokere indlæsningen af siden, medmindre det udtrykkeligt er angivet med en `$document`-modifikator. ::: -:::note Response status +:::note Svarstatus -Browser detects a blocked request as completed with an error. +Webbrowseren registrerer en blokeret forespørgsel som udført med en fejl. ::: -:::note Rule length +:::note Regellængde -Rules shorter than 4 characters are considered incorrect and will be ignored. +Regler kortere end 4 tegn betragtes som ukorrekte og ignoreres. ::: -### Basic rule syntax {#basic-rules-syntax} +### Basisregelsyntaks {#basic-rules-syntax} ```text - rule = ["@@"] pattern [ "$" modifiers ] -modifiers = [modifier0, modifier1[, ...[, modifierN]]] + regel = ["@@"] mønster [ "$" modifikatorer ] +modifikatorer = [modifikator0, modifikator1[, ...[, modifikatorN]]] ``` -- **`pattern`** — an address mask. Every request URL is collated to this mask. In the template, you can also use the special characters described [below](#basic-rules-special-characters). Note that AdGuard truncates URLs to a length of 4096 characters in order to speed up matching and avoid issues with ridiculously long URLs. -- **`@@`** — a marker that is used in rules of exception. To turn off filtering for a request, start your rule with this marker. -- **`modifiers`** — parameters that "clarify" the basic rule. Some of them limit the rule scope and some can completely change they way it works. +- **`mønster`** — en adressemaske. Hver forespørgsels-URL kombineres til denne maske. I skabelonen kan der også bruges specialtegnene beskrevet [nedenfor](#basic-rules-special-characters). Bemærk, at AdGuard afkorter URL'er til en længde på 4.096 tegn for at accelerere matchning og undgå problemer med ekstremt lange URL'er. +- **`@@`** — en markør brugt i undtagelsesregler. For at deaktivere filtrering af en forespørgsel, skal reglen starte med denne markør. +- **`modifikatorer`** — parametre, som tydeliggør basisreglen. Nogle af dem begrænser regelomfanget, andre kan fuldstændig ændre dens måde at fungere på. -### Special characters {#basic-rules-special-characters} +### Specialtegn {#basic-rules-special-characters} -- **`*`** — a wildcard character. It is used to represent any set of characters. This can also be an empty string or a string of any length. -- **`||`** — an indication to apply the rule to the specified domain and its subdomains. With this character, you do not have to specify a particular protocol and subdomain in address mask. It means that `||` stands for `https://*.`, `https://*.`, `ws://*.`, `wss://*.` at once. +- **`*`** — et jokertegn. Det bruges til at repræsentere et hvilket som helst tegn. Dette kan også være en tom streng eller en streng af enhver længde. +- **`||`** — en indikation om at anvende reglen på det angivne domæne, inkl. underdomæner. Med dette tegn kræves ingen bestemt protokol og underdomæne angivet i adressemasken. Det betyder, at `||` står for både `http://*.`, `https://*.`, `ws://*.` og `wss://*.`. - **`^`** — a separator character mark. Separator character is any character, but a letter, a digit, or one of the following: `_` `-` `.` `%`. In this example separator characters are shown in bold: `http:`**`//`**`example.com`**`/?`**`t=1`**`&`**`t2=t3`. The end of the address is also accepted as separator. - **`|`** — a pointer to the beginning or the end of address. The value depends on the character placement in the mask. For example, a rule `swf|` corresponds to `https://example.com/annoyingflash.swf` , but not to `https://example.com/swf/index.html`. `|https://example.org` corresponds to `https://example.org`, but not to `https://domain.com?url=https://example.org`. @@ -360,7 +361,7 @@ Rules with wildcard for TLD are not supported by AdGuard Content Blocker. - `@@||example.com$document` — general exception rule. It completely disables filtering for `example.com` and all subdomains. There is a number of modifiers which can be used in exception rules. For more details, please follow the link [below](#exception-modifiers). -### Basic rule modifiers +### Basisregelmodifikatorer - [Basic modifiers](#basic-rules-basic-modifiers) - [Content-type modifiers](#content-type-modifiers) @@ -2968,7 +2969,7 @@ Below is an example of how to obtain the clean destination link to bypass tracki In our first example, the destination URL is percent-encoded: 1. The initial URL (with click tracking): `https://www.aff.example.com/visit?url=https%3A%2F%2Fwww.somestore.com%2F&ref=ref-123` - 1. The website you want to visit: `https://www.somestore.com/` + 1. Webstedet, der skal besøges: `https://www.somestore.com/` For at rense URL'en, udtræk den kodede destination fra parameteren `url` og afkod den med transformationen `pct`: @@ -3024,8 +3025,8 @@ Rules with the `$urltransform` modifier and [content-type modifiers](#content-ty In [AdGuard for Chromium MV3][ext-mv3], the `$urltransform` modifier has the following limitations: 1. **Ingen afkodningstrin** — pipeline-transformationer indeholdende trinnene `b64` (Base64-afkodning) eller `pct` (procentafkodning) understøttes ikke og kasseres derfor. -2. **Ingen global erstatning** — kun det **første match** erstattes. Flaget `/g` (globalt) ignoreres. This is usually not an issue for full-URL transforms anchored with `^`, but path-only patterns that rely on replacing all occurrences will only replace the first one. -3. **Single redirect per request** — when multiple `$urltransform` rules match the same request, only the highest-priority one takes effect. In CoreLibs, all matching rules are applied sequentially. +2. **Ingen global erstatning** — kun det **første match** erstattes. Flaget `/g` (globalt) ignoreres. Dette er normalt ikke et problem for fuld-URL-transformationer forankret med `^`, men sti-kun-mønstre, som er afhængige af at erstatte alle forekomster, vil kun erstatte den første. +3. **Enkelt omdirigering pr. forespørgsel** — når flere `$urltransform`-regler matcher den samme forespørgsel, træder kun den højestprioriterede i kraft. I CoreLibs anvendes alle matchende regler sekventielt. ::: #### **`$reason`** {#reason-modifier} @@ -3338,7 +3339,7 @@ However, basic rules may not be enough to block ads. Sometimes you need to hide ::: -## Cosmetic rules {#cosmetic-rules} +## Kosmetiske regler {#cosmetic-rules} :::info @@ -4255,7 +4256,7 @@ The way **element hiding** and **CSS rules** are applied is platform-specific. **Extended CSS selectors** use JavaScript to work and basically add an inline style themselves, therefore they can override any style. -## HTML filtering rules {#html-filtering-rules} +## HTML-filtreringsregler {#html-filtering-rules} In most cases, the basis and cosmetic rules are enough to filter ads. But sometimes it is necessary to change the HTML-code of the page itself before it is loaded. This is when you need filtering rules for HTML content. They allow to indicate the HTML elements to be cut out before the browser loads the page. @@ -4981,9 +4982,9 @@ where: - `adguard_ext_chromium_mv3` — [AdGuard for Chromium MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - - `adguard_ext_edge_mv3` — AdGuard Browser Extension for Edge MV3 + - `adguard_ext_edge_mv3` — AdGuard Browser Extension til Edge MV3 - `adguard_ext_opera` — AdGuard Browser Extension for Opera - - `adguard_ext_opera_mv3` — AdGuard Browser Extension for Opera MV3 + - `adguard_ext_opera_mv3` — AdGuard Browser Extension til Opera MV3 - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, AdGuard for Android, and AdGuard for Linux @@ -5167,11 +5168,11 @@ Used to specify the platforms to apply the rules. List of existing platforms and - `ext_edge` — AdGuard Browser Extension for Edge — [https://filters.adtidy.org/extension/edge/filters/2.txt](https://filters.adtidy.org/extension/edge/filters/2.txt) -- `ext_edge_mv3` — AdGuard Browser Extension for Edge MV3 — [https://filters.adtidy.org/extension/edge-mv3/filters/2.txt](https://filters.adtidy.org/extension/edge-mv3/filters/2.txt) +- `ext_edge_mv3` — AdGuard Browser Extension til Edge MV3 — [https://filters.adtidy.org/extension/edge-mv3/filters/2.txt](https://filters.adtidy.org/extension/edge-mv3/filters/2.txt) - `ext_opera` — AdGuard Browser Extension for Opera — [https://filters.adtidy.org/extension/opera/filters/2.txt](https://filters.adtidy.org/extension/opera/filters/2.txt) -- `ext_opera_mv3` — AdGuard Browser Extension for Opera MV3 — [https://filters.adtidy.org/extension/opera-mv3/filters/2.txt](https://filters.adtidy.org/extension/opera-mv3/filters/2.txt) +- `ext_opera_mv3` — AdGuard Browser Extension til Opera MV3 — [https://filters.adtidy.org/extension/opera-mv3/filters/2.txt](https://filters.adtidy.org/extension/opera-mv3/filters/2.txt) - `ext_safari` — AdGuard for Safari — [https://filters.adtidy.org/extension/safari/filters/2_optimized.txt](https://filters.adtidy.org/extension/safari/filters/2_optimized.txt) diff --git a/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/how-ad-blocking-works.md b/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/how-ad-blocking-works.md index aaa6f25f30f..4475fbde6cd 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/how-ad-blocking-works.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/general/ad-filtering/how-ad-blocking-works.md @@ -51,7 +51,7 @@ Every web page has a Document Object Model (DOM), an HTML document containing th This method allows you to avoid above-mentioned blank spaces and ad leftovers, as well as perform other more complicated tasks. -### HTML filtering rules +### HTML-filtreringsregler In most cases, it's enough to use the above-mentioned basic and cosmetic rules to filter ads. But when it is necessary to change the HTML code of the page itself before it is loaded, you need filtering rules for HTML content. These rules allow you to specify the HTML elements to be cut out before the browser even loads the page. diff --git a/i18n/da/docusaurus-plugin-content-docs/current/general/extensions.md b/i18n/da/docusaurus-plugin-content-docs/current/general/extensions.md index 410994ee822..446f3556d0c 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/general/extensions.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/general/extensions.md @@ -177,7 +177,7 @@ All listed old Greasemonkey functions are deprecated but still supported. You can find more information about Greasemonkey API in [its manual](https://wiki.greasespot.net/Greasemonkey_Manual:API). -#### Example +#### Eksempel ```javascript // ==UserScript== @@ -492,7 +492,7 @@ We don’t support userstyles that contain `@var` or `@advanced` in the metadata 5. Once you’re finished, press _Save and Close_. Your new userstyle has been successfully added to AdGuard -### Example +### Eksempel ```css /* ==UserStyle== diff --git a/i18n/da/docusaurus-plugin-content-docs/current/general/stealth-mode.md b/i18n/da/docusaurus-plugin-content-docs/current/general/stealth-mode.md index 2bee232a67a..d88a3342a6d 100644 --- a/i18n/da/docusaurus-plugin-content-docs/current/general/stealth-mode.md +++ b/i18n/da/docusaurus-plugin-content-docs/current/general/stealth-mode.md @@ -171,7 +171,7 @@ These features are only available in AdGuard for Windows. This feature disables sending technical data about your system and app usage. -### Disable Windows Recall {#windowsrecall} +### Deaktivering af Windows Recall {#windowsrecall} This feature prevents Windows from taking and analyzing screenshots of your desktop activity. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 8790931efac..e822422148a 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..250ba41a6db --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +Dieser Artikel behandelt AdGuard für Windows, einem multifunktionalen Werbeblocker, der Ihr Gerät auf Systemebene schützt. Um zu sehen, wie es funktioniert, [laden Sie die AdGuard-App herunter](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Starten Sie AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index 2c29ad4938b..8f6a205a01e 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 Ein praktisches menü in der Safari-Symbolleiste +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Vollversion](/adguard-mini-for-mac/features/full-version.md) Fortschrittliche Funktionen, die die Filtergeschwindigkeit und -leistung verbessern diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 14ed605e69b..f71d597ab67 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Vollversion -sidebar_position: 9 +sidebar_position: 10 --- Die Vollversion von AdGuard Mini für Mac schaltet erweiterte Funktionen frei, die für zusätzliche Filtergeschwindigkeit und Leistung sorgen. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/de/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..e6902520843 --- /dev/null +++ b/i18n/de/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## So funktioniert es + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 2880533a329..af49d5b162f 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/de/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Einige Regeln können nur in vertrauenswürdigen Filtern verwendet werden. Diese - Filterlisten, [die vom AdGuard-Team erstellt wurden](../adguard-filters), - benutzerdefinierte Filterlisten, die als `vertrauenswürdig` installiert wurden, -- Benutzerregeln. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard-Inhaltsblocker diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 543760d2853..ab68704b84d 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..4957c5c2c2d --- /dev/null +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 16 +--- + +:::info + +Este artículo trata sobre AdGuard para Windows, un bloqueador de anuncios multifuncional que protege tu dispositivo a nivel de sistema. Para ver cómo funciona, [descarga la app de AdGuard](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Inicia AdGuard. Version 7 will start with your previous settings restored. 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 4e5c0d24cc2..5943f41bdf1 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 @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [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/full-version.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..32ed7d5b9e3 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 11 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..101cc24432e --- /dev/null +++ b/i18n/es/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## Cómo funciona + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/es/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/es/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 2d49e7beaa3..59d0b76680c 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/es/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### Bloqueador de contenido AdGuard diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..9e4df49d235 --- /dev/null +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/fa/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/fa/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/fa/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index b47f9e3dfad..44d6755f2db 100644 --- a/i18n/fa/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/fa/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..9e4df49d235 --- /dev/null +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/fi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/fi/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/fi/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index b47f9e3dfad..44d6755f2db 100644 --- a/i18n/fi/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/fi/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 5774ed344ea..f84320bcd7f 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..89ec33ee8e6 --- /dev/null +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +Cet article parle de AdGuard pour Windows, un bloqueur de contenus multifonctionnel qui protège votre appareil au niveau du système. Pour voir comment ça fonctionne, [téléchargez l'application AdGuard](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Lancez AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index 8d55d15b07a..329a00d0251 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 Un menu pratique dans la barre d'outils Safari +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Version complète](/adguard-mini-for-mac/features/full-version.md) Des fonctionnalités avancées qui améliorent la rapidité et la puissance du filtrage diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index b3e7854f288..5ab883a41f1 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Version complète -sidebar_position: 9 +sidebar_position: 10 --- La version complète de AdGuard Mini pour Mac débloque des fonctionnalités avancées qui offrent une vitesse et une puissance de filtrage supplémentaires. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..76505e583a2 --- /dev/null +++ b/i18n/fr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## Comment ça marche + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/fr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 5a294988f8e..8de4aff0866 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### Bloqueur de contenu AdGuard diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..9e4df49d235 --- /dev/null +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/hr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/hr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/hr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index b47f9e3dfad..44d6755f2db 100644 --- a/i18n/hr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/hr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..9e4df49d235 --- /dev/null +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/hu/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/hu/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/hu/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 1f16e445bfe..26fd9f9de13 100644 --- a/i18n/hu/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/hu/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Tartalomblokkoló diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 20f10d6ba68..f2f39ca388b 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..a11ade45228 --- /dev/null +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +Questo articolo riguarda AdGuard per Windows, un blocca-inserzioni multifunzionale che protegge il tuo dispositivo a livello di sistema. Per vedere come funziona, [scarica l'app di AdGuard](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Avviare AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index 329d4256730..53d79abefdf 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 Un pratico menu nella barra degli strumenti di Safari +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Versione Completa](/adguard-mini-for-mac/features/full-version.md) Funzionalità avanzate che migliorano la velocità e la potenza del filtraggio diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index e4f6a27af65..a82a4c33939 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Versione completa -sidebar_position: 9 +sidebar_position: 10 --- La versione completa di AdGuard Mini per Mac sblocca funzionalità avanzate che forniscono una maggiore velocità e potenza di filtraggio. diff --git a/i18n/it/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/it/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..5efac408235 --- /dev/null +++ b/i18n/it/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## Come funziona + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/it/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/it/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 5ab3504ff8a..536b360da91 100644 --- a/i18n/it/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/it/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### Blocco contenuti AdGuard diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 351cca8678a..c0cfc54a0e2 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..620eb5db9a5 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +この記事では、システムレベルでお使いのデバイスを保護する多機能広告ブロッカー、「AdGuard for Windows」について書いています。実際どのように機能するのかを確認するには、 [AdGuard アプリ](https://agrd.io/download-kb-adblock)をダウンロードしてください。 + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. AdGuard を起動します。 Version 7 will start with your previous settings restored. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index c13b2a6a367..91f1f072498 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..e0d1af3a0b0 --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## 仕組み + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/ja/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index d7d82c74bd4..bfcb1c71bf5 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuardコンテンツブロッカー diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 33e27ebd4f9..7d80c8421a3 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..b08b5023ff9 --- /dev/null +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +본 문서는 시스템 수준에서 기기를 보호하는 다기능 광고 차단기인 Windows용 AdGuard에 대해 다룹니다. 이용하고자 한다면 [AdGuard 앱을 다운로드](https://agrd.io/download-kb-adblock)해 보세요. + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. AdGuard를 실행합니다. Version 7 will start with your previous settings restored. diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index 08cd792841d..4ca1e26ba8c 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..395d6e9f05d --- /dev/null +++ b/i18n/ko/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## 작동 방식 + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/ko/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 90d40065ef0..ef0cd671d46 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard 콘텐츠 차단기 diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..9e4df49d235 --- /dev/null +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/nl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/nl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/nl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index b47f9e3dfad..44d6755f2db 100644 --- a/i18n/nl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/nl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..9e4df49d235 --- /dev/null +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/no/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/no/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/no/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/no/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/no/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index b47f9e3dfad..44d6755f2db 100644 --- a/i18n/no/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/no/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..9e4df49d235 --- /dev/null +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/pl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/pl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/pl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index b47f9e3dfad..44d6755f2db 100644 --- a/i18n/pl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/pl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index a77b38cf3dc..cce99884f66 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..00693bb4999 --- /dev/null +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +Este artigo aborda o AdGuard para Windows, um bloqueador de anúncios multifuncional que protege seu dispositivo a nível de sistema. Para ver como funciona, [baixe o aplicativo AdGuard](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + Proíbe o Google Chrome de enviar sua versão e informações de modificação com solicitações para domínios do Google (incluindo Double Click e Google Analytics). + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Inicie o AdGuard. Version 7 will start with your previous settings restored. 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 3c0995b2c18..af58985d0fb 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 @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [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/full-version.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f163037c537 --- /dev/null +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## Como funciona + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index c1fee32045a..159744dc5cf 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### Bloqueador de conteúdo do AdGuard diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..747be0e6f08 --- /dev/null +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +Este artigo aborda o AdGuard para Windows, um bloqueador de anúncios multifuncional que protege o seu dispositivo ao nível do sistema. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/pt/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/pt/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/pt/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 18a84bc8388..47b1063b1c1 100644 --- a/i18n/pt/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/pt/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 972926a5688..eb544be778a 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..66332eb27eb --- /dev/null +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +Acest articol se referă la AdGuard pentru Windows, un blocant de reclame multifuncțional care protejează dispozitivul dumneavoastră la nivel de sistem. Pentru a vedea cum funcționează, [descărcați aplicația AdGuard](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..e8bc8ce5864 --- /dev/null +++ b/i18n/ro/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## Cum funcționează + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/ro/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/ro/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index fb800c6c276..0388843e7d9 100644 --- a/i18n/ro/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/ro/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index cc853117c8b..7cc3cf674e1 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..2c354ab8ac5 --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +В этой статье рассказывается об AdGuard для Windows — многофункциональном блокировщике рекламы, который защищает ваше устройство на системном уровне. [Скачайте приложение AdGuard](https://agrd.io/download-kb-adblock), чтобы увидеть, как оно работает + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Запустите AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index 20b31c950ed..bbaf4f979da 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 Удобное меню на панели инструментов Safari +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Полная версия](/adguard-mini-for-mac/features/full-version.md) Расширенные функции, повышающие скорость и мощность фильтрации diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index b2c556a4404..f42e19cc304 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Полная версия -sidebar_position: 9 +sidebar_position: 10 --- Полная версия AdGuard Mini для Mac открывает расширенные функции, которые обеспечивают дополнительную скорость и мощность фильтрации. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..9a0c82ee2c9 --- /dev/null +++ b/i18n/ru/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## Как это работает + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/ru/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/ru/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 2f573dc51d7..8fc830ba1a8 100644 --- a/i18n/ru/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/ru/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ AdGuard [расширяет возможности CSS](#extended-css-selectors) - Списки фильтров, [созданные командой AdGuard](../adguard-filters) - Пользовательские списки фильтров, помеченные как `trusted` (доверенные) -- Пользовательские правила +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..9e4df49d235 --- /dev/null +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/sk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/sk/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/sk/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index b47f9e3dfad..44d6755f2db 100644 --- a/i18n/sk/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/sk/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..9e4df49d235 --- /dev/null +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/sl/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/sl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/sl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index b47f9e3dfad..44d6755f2db 100644 --- a/i18n/sl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/sl/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..9e4df49d235 --- /dev/null +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/sv/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/sv/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/sv/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index b47f9e3dfad..44d6755f2db 100644 --- a/i18n/sv/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/sv/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..9e4df49d235 --- /dev/null +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/ta/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/ta/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/ta/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index b47f9e3dfad..44d6755f2db 100644 --- a/i18n/ta/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/ta/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index d6f10297bbb..59003e58a1f 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..f4ab3ad61c2 --- /dev/null +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +Bu makale, cihazınızı sistem düzeyinde koruyan çok işlevli bir reklam engelleyici olan Windows için AdGuard'ı ele alır. Nasıl çalıştığını görmek için [AdGuard uygulamasını indirin](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. AdGuard'ı başlatın. Version 7 will start with your previous settings restored. diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..c0743f19ce8 --- /dev/null +++ b/i18n/tr/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## Nasıl çalışır + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md b/i18n/tr/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md index 8cac127befd..b193c21e84d 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/general/ad-filtering/adguard-filters.md @@ -32,8 +32,8 @@ This article is about the filters we create to use in AdGuard and other ad-block - **French filter** removes ads from websites in French. Originally based on the [Liste FR](https://forums.lanik.us/viewforum.php?f=91) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_16_French/filter.txt) - **Japanese filter** removes ads from websites in Japanese. Originally based on the [Fanboy’s Japanese](https://www.fanboy.co.nz/fanboy-japanese.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_7_Japanese/filter.txt) - **Dutch filter** removes ads from websites in Dutch. Originally based on the [EasyList Dutch](https://easylist.to/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_8_Dutch/filter.txt) -- **Italian filter** removes ads from websites in Italian. Originally based on the [EasyList Italy](https://github.com/easylist/easylistitaly/) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_26_Italian/filter.txt) -- **Polish filter** removes ads from websites in Polish. Originally based on the [Official Polish filters for AdBlock, uBlock Origin & AdGuard](https://github.com/MajkiIT/polish-ads-filter#polish-filters-for-adblock-ublock-origin--adguard) and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_27_Polish/filter.txt) +- **İtalyanca filtresi**, İtalyanca sitelerdeki reklamları kaldırır. Başlangıçta [EasyList Italy](https://github.com/easylist/easylistitaly/) filtresini temel almış ve sonrasında kullanıcılardan gelen şikayetlere göre tarafımızca değiştirilmiştir. [Kuralları görüntüle](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_26_Italian/filter.txt) +- **Lehçe filtresi**, Lehçe web sitelerindeki reklamları kaldırır. Originally based on the [Official Polish filters for AdBlock, uBlock Origin & AdGuard](https://github.com/MajkiIT/polish-ads-filter#polish-filters-for-adblock-ublock-origin--adguard) and subsequently modified by us according to the complaints from users. [Kuralları görüntüle](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_27_Polish/filter.txt) - **Spanish/Portuguese filter** removes ads from websites in Spanish and Portuguese. Originally based on the [Fanboy’s Spanish/Portuguese](https://www.fanboy.co.nz/fanboy-espanol.txt) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_9_Spanish/filter.txt) - **Turkish filter** removes ads from websites in Turkish. Created by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_13_Turkish/filter.txt) - **Chinese filter** removes ads from websites in Chinese. Originally based on the [EasyList China](https://github.com/easylist/easylistchina) filter and subsequently modified by us according to the complaints from users. [View rules](https://raw.githubusercontent.com/AdguardTeam/FiltersRegistry/master/filters/filter_224_Chinese/filter.txt) diff --git a/i18n/tr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/tr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index 77ca7bc88fa..1b51d4d69b8 100644 --- a/i18n/tr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/tr/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Bazı kurallar yalnızca güvenilir filtrelerde kullanılabilir. Bu kategori şu - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard İçerik Engelleyici @@ -4981,9 +4982,9 @@ where: - `adguard_ext_chromium_mv3` — [AdGuard for Chromium MV3][ext-mv3] - `adguard_ext_firefox` — AdGuard Browser Extension for Firefox - `adguard_ext_edge` — AdGuard Browser Extension for Edge Legacy - - `adguard_ext_edge_mv3` — AdGuard Browser Extension for Edge MV3 + - `adguard_ext_edge_mv3` — Edge MV3 için AdGuard Tarayıcı Uzantısı - `adguard_ext_opera` — AdGuard Browser Extension for Opera - - `adguard_ext_opera_mv3` — AdGuard Browser Extension for Opera MV3 + - `adguard_ext_opera_mv3` — Opera MV3 için AdGuard Tarayıcı Uzantısı - `adguard_ext_android_cb` — AdGuard Content Blocker for mobile Samsung and Yandex browsers - `ext_ublock` — special case; this one is declared when a uBlock version of a filter is compiled by the [FiltersRegistry][] - `cap_html_filtering` — products that support HTML filtering rules: AdGuard for Windows, AdGuard for Mac, AdGuard for Android, and AdGuard for Linux @@ -5167,11 +5168,11 @@ Used to specify the platforms to apply the rules. List of existing platforms and - `ext_edge` — AdGuard Browser Extension for Edge — [https://filters.adtidy.org/extension/edge/filters/2.txt](https://filters.adtidy.org/extension/edge/filters/2.txt) -- `ext_edge_mv3` — AdGuard Browser Extension for Edge MV3 — [https://filters.adtidy.org/extension/edge-mv3/filters/2.txt](https://filters.adtidy.org/extension/edge-mv3/filters/2.txt) +- `ext_edge_mv3` — Edge MV3 için AdGuard Tarayıcı Uzantısı — [https://filters.adtidy.org/extension/edge-mv3/filters/2.txt](https://filters.adtidy.org/extension/edge-mv3/filters/2.txt) - `ext_opera` — AdGuard Browser Extension for Opera — [https://filters.adtidy.org/extension/opera/filters/2.txt](https://filters.adtidy.org/extension/opera/filters/2.txt) -- `ext_opera_mv3` — AdGuard Browser Extension for Opera MV3 — [https://filters.adtidy.org/extension/opera-mv3/filters/2.txt](https://filters.adtidy.org/extension/opera-mv3/filters/2.txt) +- `ext_opera_mv3` — Opera MV3 için AdGuard Tarayıcı Uzantısı — [https://filters.adtidy.org/extension/opera-mv3/filters/2.txt](https://filters.adtidy.org/extension/opera-mv3/filters/2.txt) - `ext_safari` — AdGuard for Safari — [https://filters.adtidy.org/extension/safari/filters/2_optimized.txt](https://filters.adtidy.org/extension/safari/filters/2_optimized.txt) diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..9e4df49d235 --- /dev/null +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/uk/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/uk/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index b47f9e3dfad..44d6755f2db 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..9e4df49d235 --- /dev/null +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/vi/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/vi/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/vi/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index b47f9e3dfad..44d6755f2db 100644 --- a/i18n/vi/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/vi/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index bc03210f0e1..3d5967fdda9 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..4ac41fe9c1a --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +本文适用于 Windows 版的 AdGuard，它是一种多功能广告拦截器，可在系统级别保护用户的设备。要了解其工作原理，请[下载 AdGuard 应用程序](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. 启动 AdGuard。 Version 7 will start with your previous settings restored. 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 b7d1b09b63e..c02cacb73a9 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 @@ -31,6 +31,10 @@ sidebar_position: 1 Safari 工具栏中的便捷菜单。 +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [完整版](/adguard-mini-for-mac/features/full-version.md) 提升过滤速度和性能的高级功能。 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 f10f5e6c186..fae2e5dbbf8 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,6 +1,6 @@ --- title: 完整版 -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini Mac 版的完整版解锁高级功能，可提供更快的过滤速度和更强大的过滤能力。 diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..820450b8fcd --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## 工作原理 + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. 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 4bd05539a19..59dbb5ab46b 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 @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard 内容拦截器 diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md index 0032898af90..8fae10c883f 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-mac/solving-problems/browser-assistant-macos-27.md @@ -13,15 +13,28 @@ Due to policy updates in macOS 27, AdGuard may be unable to communicate with its ## Recommended solutions -Since this issue can affect any Chromium-based browser, this section covers how to grant AdGuard the required permissions regardless of which browser is used. +This section covers how to grant AdGuard the required permissions across Chromium- and Gecko-based browsers. ### Step 1: Grant access via Files & Folders +:::note + +AdGuard checks folder access **only for your system default browser**. Consequently, the in-app prompts and the _Allow Access…_ button will not appear if the browser is not set as default. In this case, you will need to grant permission manually via macOS _System Settings_. + +::: + 1. Open _Files & Folders_ - - via AdGuard settings: click the gear icon on the app’s main window → _Preferences…_ → the _Assistant_ tab → _Open Files & Folders_ - ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings.png) - - via AdGuard Setup Assistant: on the Browser Assistant installation screen, click _Open Files & Folders_ — this button appears if AdGuard doesn’t have access to the browser’s folder - ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant.png) + + - via AdGuard Setup Assistant upon first launch: on the Browser Assistant installation screen, click _Allow Access…_. You’ll be taken directly to the _Files & Folders_ section + ![AdGuard Setup Assistant](https://cdn.adtidy.org/content/kb/ad_blocker/mac/setup-assistant-new.png) + - via the AdGuard main window: + - click _Allow access to your browser folder for the Assistant_ at the bottom → _Assistant_ → _Allow Access…_. This prompt only appears if the Assistant was installed at least once and access is currently denied for your default browser. It permanently disappears after the first click. If you don’t see it, use the Preferences option below. + - or click the gear icon in the top-right corner → _Preferences…_ → _Assistant_ → _Allow Access…_ + + | | | + | :----------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------: | + | ![AdGuard popup](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-popup.png) | ![AdGuard settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/adguard-settings-new.png) | + - via _System Settings_ → _Privacy & Security_ → _Files & Folders_ ![System Settings](https://cdn.adtidy.org/content/kb/ad_blocker/mac/system-settings-new.png) 2. Find _AdGuard_ in the list and click it to expand the dropdown @@ -29,23 +42,29 @@ Since this issue can affect any Chromium-based browser, this section covers how :::note -A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser or Google Chrome is not listed, proceed to Step 2. +A toggle for a specific browser will only appear in this list if the browser is already installed. If your browser, Google Chrome, or Mozilla Firefox is not listed, proceed to Step 2. ::: -### Step 2: If the browser isn't listed +### Step 2: If the browser isn’t listed -**Option A: Install Google Chrome** +**Option A: Install Google Chrome or Mozilla Firefox** -Some browsers, like Opera, rely on the Native Messaging folder that belongs to Google Chrome instead of using a folder of their own. On earlier macOS versions, AdGuard could simply create this folder itself. Starting with macOS 27, however, macOS does not allow AdGuard to request access to Chrome's folder unless Chrome is actually installed. Installing Chrome allows AdGuard to request the required permission. +Some browsers built on Chromium or Gecko do not create their own dedicated Native Messaging directory. Instead, they share the directory used by Chrome or Firefox. On earlier macOS versions, AdGuard could simply create these folders itself. Starting with macOS 27, macOS does not allow AdGuard to request access to these folders unless the corresponding browser — Google Chrome or Mozilla Firefox — is actually installed on the system. -1. Install Google Chrome and open it at least once — the required Native Messaging folder will become available on the system -2. Open _Files & Folders_ (via the AdGuard settings, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) +1. Install Google Chrome or Mozilla Firefox (depending on whether your browser is Chromium- or Gecko-based) and open it at least once — the required Native Messaging folder will become available on the system +2. Open _Files & Folders_ (via the AdGuard main window, AdGuard Setup Assistant, or Mac System Settings, as described in Step 1) 3. Find _AdGuard_ in the list and click it to expand the dropdown -4. Locate Google Chrome and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome's folder (such as Opera). +4. Locate Google Chrome or Mozilla Firefox and turn on the toggle next to it. As a result, Browser Assistant will start working in the browser that relies on Chrome’s or Mozilla Firefox’s folder (such as Opera or Zen). **Option B: Grant Full Disk Access** +:::caution + +Granting _Full Disk Access_ is a last-resort measure: we strongly recommend trying the options above first. _Full Disk Access_ is not required for AdGuard in general. Use it only as a workaround for Browser Assistant if the options above did not work and you fully understand what you are doing. + +::: + 1. Open _System Settings_ → _Privacy & Security_ → _Full Disk Access_ 2. Find _AdGuard_ in the list and turn on the toggle ![Full Disk Access](https://cdn.adtidy.org/content/kb/ad_blocker/mac/full-disk-access-new.png) diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md new file mode 100644 index 00000000000..9e4df49d235 --- /dev/null +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-for-windows/solving-problems/switch-back-to-v7.md @@ -0,0 +1,46 @@ +--- +title: How to switch back to v7 after updating to v8.0 +sidebar_position: 14 +--- + +:::info + +This article covers AdGuard for Windows, a multifunctional ad blocker that protects your device at the system level. To see how it works, [download the AdGuard app](https://agrd.io/download-kb-adblock) + +::: + +## How to switch back to v7 after updating to v8.0 + +AdGuard for Windows v8.0 introduces significant changes. If you find the new interface uncomfortable or encounter issues, you can switch back to version 7. + +:::note + +If you wish to preserve your settings, it’s recommended that you export them before changing versions. You can then import your saved settings after updating the app. The steps needed to do so are listed below. + +::: + +1. After upgrading to v8, open the folder `C:\ProgramData\Adguard\Backups` and find a ZIP file with a name similar to `adguard_settings_7.22.5008.0-08-04-2025-13_42_15.276.zip`. + +2. Copy this ZIP file somewhere outside `C:\ProgramData\Adguard`, for example, to your Desktop. This is important because the folder will be cleaned during the next step. + +3. Uninstall v8.0 via _Settings_ → _Apps_ → _Installed apps_. In the uninstaller dialog, check the box to remove all user settings and data so that no v8 leftovers remain. + + ![Uninstall \*border](https://cdn.adtidy.org/content/kb/ad_blocker/windows/version_8/solving_problems/uninstall.png) + + :::note + + For step-by-step instructions, see [How to uninstall AdGuard for Windows](/adguard-for-windows/installation#uninstall). + + ::: + +4. Install the previous version. You can find the download link in the _Assets_ section of the latest stable v7 release on [GitHub](https://github.com/AdguardTeam/AdguardForWindows/releases/tag/v7.22.9). + +5. Exit version 7 from the system tray to stop filtering. + +6. Extract the contents of the ZIP file from step 2 and replace the following files: + + - `adguard.db` → `C:\ProgramData\Adguard` — main settings database, including filters and custom rules + - `agflm_dns.db` → `C:\ProgramData\Adguard\FLM` — DNS filter database + - `agflm_standard.db` → `C:\ProgramData\Adguard\FLM` — standard filter database + +7. Launch AdGuard. Version 7 will start with your previous settings restored. diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md index ddd2bf25c13..f329bfaba00 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/features.md @@ -31,6 +31,10 @@ sidebar_position: 1 A handy menu in the Safari toolbar +- [System-wide protection](/adguard-mini-for-mac/features/system-wide-protection.md) + + A feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + - [Full version](/adguard-mini-for-mac/features/full-version.md) Advanced features that enhance filtering speed and power diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md index 4201b9d8a37..2d0c3442c24 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/full-version.md @@ -1,6 +1,6 @@ --- title: Full version -sidebar_position: 9 +sidebar_position: 10 --- AdGuard Mini for Mac’s full version unlocks advanced features that provide extra filtering speed and power. diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md new file mode 100644 index 00000000000..f3dbb0cac42 --- /dev/null +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/adguard-mini-for-mac/features/system-wide-protection.md @@ -0,0 +1,94 @@ +--- +title: System-wide protection +sidebar_position: 9 +--- + +Starting with version 3.0, AdGuard Mini for Mac introduces _System-wide protection_, a feature that blocks ads and trackers not just in Safari, but across other apps on your Mac. + +The feature is available for users with an AdGuard license. You can [purchase the license right away](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +## How it works + +_System-wide protection_ is built on Apple’s [**URL filter**](https://developer.apple.com/documentation/networkextension/filtering-traffic-by-url), a system filtering API used for system-wide traffic filtering. Here’s how it works. + +First, macOS checks a URL against a bloom filter — a prefilter stored on your Mac that updates in the background. Most addresses are cleared locally, with no network request for the check itself. + +If the prefilter finds a possible match, macOS asks AdGuard’s server for a verdict using Private Information Retrieval (PIR). This method lets your Mac request data from the server without revealing which exact address it asked about. The request can’t be linked to your account or device. If the server doesn’t respond, the page loads normally. + +You can read [a detailed analysis of Apple’s approach to system-wide filtering](https://adguard.com/en/blog/apple-url-filter-system-wide-filtering-api.html) in our blog. + +## How to turn on System-wide protection + +You’ll find _System-wide protection_ under _Advanced protection_ in the AdGuard Mini app. To enable it, toggle the switch on. + +![System-wide protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/system-wide-protection.png) + +When you first enable _System-wide protection_, you’ll get a request to install the URL filter on your computer. Click _Install_, after which a system message will appear requesting to add filter configurations. This is standard macOS behavior. AdGuard does not see or store any of this data. + +![System-wide protection requires a URL filter](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/install-screen.png) + +After you install the URL filter, _System-wide protection_ will remain on by default. If you want it off, toggle off the _System-wide protection_ switch in _Advanced protection_. + +You can also click the context menu in the top right corner (⋮) and select _Remove URL Filter_. If you want to reset the filter without deleting it to troubleshoot connection issues, choose _Reset Cache_. + +It’s also possible to disable the URL filter in your Mac’s _System Settings_ → _Network_ → _VPN & Filters_ → _Filters & Proxies_. Change _Enabled_ to _Disabled_ in the _Status menu_. AdGuard Mini will then switch off _System-wide protection_ automatically. + +## Protection levels + +There are three levels of protection you can choose from. _Essential_ is selected by default. + +- _Essential_ — blocks ads and trackers +- _Safe_ — blocks ads, trackers, phishing, and malware +- _Family_ — blocks ads, trackers, phishing, malware, and adult content + +![Three levels of protection](https://cdn.adtidy.org/content/release_notes/ad_blocker/mini_for_mac/v3.0/levels-of-protection.png) + +## Troubleshooting + +### System-wide protection doesn’t work with every app or browser + +Coverage depends on how each app handles network requests, so some apps may not be filtered. This is a limitation on Apple’s side. + +Chromium-based browsers, such as Chrome, Edge, Opera, and Brave, use their own networking code instead of Apple’s frameworks, so the URL filter can’t check their requests. + +### System-wide protection doesn’t turn on + +- **Your Mac runs an older version of macOS.** Apple’s URL filter needs macOS 26 Tahoe or later. On earlier versions, the setting is disabled and the app asks you to _Update to macOS Tahoe 26 or later_. +- **Your account isn’t supported.** _System-wide protection_ only works with the first user account created on a Mac. If your account was added later, the setting is disabled and shows _Not supported on this Mac account_. See [Can I change my Mac account’s user ID?](/adguard-mini-for-mac/features/system-wide-protection/#can-i-change-my-mac-accounts-user-id) below. +- **You’re on the free version.** To use _System-wide protection_, [purchase an AdGuard license](https://adguard.com/license.html) or click _Try for free_ in _Advanced protection_ to start a 14-day free trial. + +### Can I change my Mac account’s user ID? + +Yes. _System-wide protection_ only works with the first user account created on a Mac with the user ID (UID) of 501. If your Mac has more than one account, or if you migrated your account from an older Mac, your UID might be different. Follow the steps below to check your UID and, if needed, free up 501 and assign it to your account. + +:::warning + +This is an advanced, risky operation. Only do this if you have no other option. Freeing up UID 501 means deleting an existing account and creating a new one from Terminal. If something goes wrong, this can cause permanent data loss. Back up all the data on your Mac before proceeding. + +::: + +1. **Check your current UID.** Open Terminal, type `id -u`, and press Return. If the result is 501, your account already has the right UID. You don’t need to do anything else. + +2. **Find out who has UID 501.** If your UID is not 501, run this command: + + ```bash + dscacheutil -q user -a uid 501 | grep -E '^(name|uid|gecos):' + ``` + + This shows the username, UID, and full name of that account. Make sure you don’t need any files from it, or back them up before continuing. + +3. **Delete the account with UID 501.** While logged in to your own admin account, open _System Settings_ → _Users & Groups_, select the account from step 2, and delete it. When macOS asks what to do with its home folder, choose _Save the home folder in a disk image_ — this keeps the account’s files in case you need them later. + +4. **Create a new account with UID 501.** Run the following command, replacing `username` and `Name Surname` with the details you want: + + ```bash + sudo sysadminctl -addUser username \ + -fullName "Name Surname" \ + -password - \ + -admin \ + -UID 501 + ``` + + `-password -` makes Terminal prompt you for the password interactively; `-admin` gives the new account administrator rights. + +5. **Verify the change.** Log in to the new account, then check the UID again: open Terminal, type `id -u`, and press Return. The result should now be 501. diff --git a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md index b47f9e3dfad..44d6755f2db 100644 --- a/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md +++ b/i18n/zh-TW/docusaurus-plugin-content-docs/current/general/ad-filtering/create-own-filters.md @@ -127,7 +127,8 @@ Some rules can be used only in trusted filters. This category includes: - filter lists [created by the AdGuard team](../adguard-filters), - custom filter lists installed as `trusted`, -- user rules. +- user rules, +- pre-approved third-party filter lists available in the *Filters* tab. ### AdGuard Content Blocker