이 문서는 시스템 수준에서 기기를 보호하는 다기능 광고 차단기인 Mac용 AdGuard에 대해 다룹니다. To see how it works, download the AdGuard app
Problem description in a nutshell
By default, AdGuard uses the "default route" which disables iCloud Private Relay.
Currently, AdGuard and iCloud Private Relay cannot work at the same time. AdGuard cannot block ads because iCloud Private Relay encrypts traffic before AdGuard can filter network connections. When iCloud Private Relay is active, any filtering (including local filtering) becomes impossible. Thus, AdGuard can't filter traffic or perform DNS filtering in Safari. Yet, AdGuard still filters traffic in other browsers. To keep using iCloud Private Relay, consider installing AdGuard for Safari.
The same applies to using any VPN apps on Mac: you have to choose between using iCloud Private Relay or a VPN service.
AdGuard for Mac now uses macOS built-in socket filtering based on the network extensions API. This new and rather buggy mechanism replaced good old Kernel extensions. Over the last 1.5 years, we've reported more than 20(!) bugs to Apple regarding their new filtering method.
The network extensions API has a VPN-like configuration with a list of route-like entries. On Big Sur, AdGuard developed "split-tunnel" rules to avoid creating the "default route" rule because it causes problems on early Big Sur releases.
On Monterey, iCloud Private Relay got introduced. Privacy features of the Mail app also use Private Relay servers.
As a result, AdGuard can't work together with iCloud Private Relay and the Mail app privacy features:
- iCloud Private Relay is applied to connections at the library level — before they reach the socket level, where AdGuard operates.
- iCloud Private Relay uses QUIC, which AdGuard can't filter in filtered apps because HTTP/3 filtering is not yet available.
- As AdGuard blocks QUIC, including iCloud Private Relay traffic — otherwise, ad blocking is impossible.
- When you use iCloud Private Relay and switch AdGuard into the "split-tunnel" mode, you can't open websites in Safari.
- To work around this issue for Monterey, we apply the "default route" rule. When Private Relay sees that rule, it disables itself automatically. So, AdGuard works seamlessly on Monterey, but iCloud Private Relay gets disabled.
network.extension.monterey.force.split.tunnel restores the "Big Sur" behavior, but this option may break access to websites due to (3) and (4). We keep searching for a solution to this issue. One of the options is implementing HTTP/3 filtering.
We recommend using AdGuard together with a more traditional VPN service such as AdGuard VPN.
You can prevent AdGuard from using the "default route" by disabling the "default route". It can be done via Advanced Settings →
Bear in mind that, in this case, you'll face the issues described above.