不同 macOS 版本的兼容性问题
本文介绍 Mac 版 AdGuard。这是一款多功能广告拦截程序，可在系统级别保护设备。要了解其工作原理， 请下载 AdGuard 应用程序。
存在的问题
Apple 公司每年都会发布 macOS 的更新，推出创新解决方案并添加新的实用功能。不过，有些改进，包括网络扩展 API（Big Sur）或 iCloud 专用代理（Monterey），给许多应用程序带来一些问题，AdGuard 也不例外。在本文中，我们将介绍每个 macOS 版本特有的已知问题，以及解决这些问题的方式。
Monterey 12：存在的问题
Apple 公司尚未解决这些问题，或者只解决了部分问题。
与 iCloud 专用代理兼容
目前，AdGuard 和 iCloud 专用代理不能同时工作。 AdGuard 无法阻止广告，因为 iCloud 专用代理会在 AdGuard 过滤网络连接之前对流量进行加密。当 iCloud 专用代理处于活动状态时，应用就无法进行过滤（包括本地过滤）。因此，AdGuard 无法在 Safari 中过滤流量或执行 DNS 过滤。这就是 AdGuard 默认使用「默认路由」功能，禁用 iCloud 专用代理的原因。
要深入了解这一问题，请阅读本文。
建议的解决方案
我们建议将 AdGuard 与更传统的 VPN 服务（如 AdGuard VPN）一起使用。
替代解决方案
用户可以禁用 AdGuard，防止它使用「默认路由」功能。前往「高级设置」→「network.extension.monterey.force.split.tunnel」进行设置。请注意，启用此设置会导致上述问题。
与保护邮件活动（Protect Mail Activity）的兼容性
Apple 邮件应用现于下载邮件图像时使用代理以隐藏用户的 IP 地址。但如有启动的 VPN 连接，则它无法工作。因其视 AdGuard 为 VPN，所以它不会自动预载图像。
要深入了解这一问题，请阅读本文。
建议的解决方案
此时，我们建议使用更传统的 VPN 服务，如 AdGuard VPN，而不是较新的 Apple 隐私功能。
Monterey 12、Big Sur 11.6 及更高版本：存在的问题
Apple 公司尚未解决这些问题，或者只解决了部分问题。
与 Cisco AnyConnect 兼容
在「网络扩展」模式下，AdGuard 无法与 Cisco AnyConnect 一起工作。用户必须将 AdGuard 切换到「自动代理」模式。为此，请按照以下说明执行操作。
与 Flutter 兼容
这个问题在 2021 年 6 月发布的 Flutter 2.2 中得到了解决。但要修复 Flutter 开发的应用程序，用户需要等待更新。
如果在 Monterey 或 Big Sur 上使用「网络扩展」模式下的 Flutter 和 AdGuard（或任何其他“透明代理”类型的应用程序），就会遇到问题：项目无法打开，Flutter 也将无法正常运行。我们已经向 Apple 公司报告了这个错误。同时，用户可以使用这些临时解决方案：
使用旧版 API 的 VPN 应用程序
尽管 AdGuard 在系统设置中显示为 VPN，但与其他基于 VPN 的应用程序一起使用时应该不会引起任何冲突。但是，如果使用的是在 App Store 以外下载的基于 VPN 的应用程序，有可能是具有旧 VPN API 的应用，因此需要将其排除在过滤范围之外：
- 开启 AdGuard 菜单。
- 选择「首选项...」。
- 切换到「网络」选项卡。
- 单击「应用程序」按钮。
- 找到要排除的应用程序，取消选中旁边的复选框。
已修复的问题
Apple 公司现已修复了以下问题，但在旧版本的 macOS Big Sur 中用户还会遇到一些问题。
与 Little Snitch 5 兼容
目前，AdGuard 的「网络扩展」模式无法与 Little Snitch 5 兼容。当这两个程序都在运行时，有可能会遇到各种应用程序的行为问题，即使它们没有被 AdGuard 过滤。这个问题是由 Big Sur 中的一个错误造成的，我们已经向 Apple 公司通报这一情况。这让我们相信，这个问题会在下一次更新中得到解决。
但是，禁用 Little Snitch 中的连接监控无法解决问题，因为该行为无法从系统内存中卸载 Little Snitch 扩展。我们建议，至少在 Apple 修复该错误之前，切换到「自动代理」过滤模式。
与本地代理的兼容性
现在，AdGuard 可以顺利过滤本地代理（在大多数情况下）。如果用户在操作系统版本 11.1+ 或 Big Sur 11.0 中遇到任何问题，请从系统设置中移除本地代理，并按照以下说明在 AdGuard 中配置上游代理。
在 Big Sur 的 AdGuard for Mac 中配置上游代理：
- 打开 AdGuard 设置的*「首选项」→「网络」→「出站代理」*。
- 根据代理类型选择 HTTP、HTTPS、SOCKS4 或 SOCKS5。
- 填写以下字段：
host是代理服务器的 IP 地址、port是代理服务器希望使用的端口号、user和password是代理的相应用户名和密码（如需要）。如果不需要，忽略其中一个或两个。
如果您遇到任何问题，请通过 support@adguard.com 联系我们的技术支持。
示例 1：配置上游 Shadowsocks 代理
下面举例说明如何为 Shadowsocks 配置上游代理。
首先，用户需要一个能正常工作的代理服务器。最有可能的是，您要设置它，可以使用这样一个 JSON 文件（server 和 password 值在此随机选择）：
{
"server":"111.222.333.444",
"server_port":8388,
"local_port":1080,
"password":"barfoo!",
"timeout":600,
"method":"chacha20-ietf-poly1305"
}
请参阅 Shadowsocks 网站 了解更多信息。
然后，用户要在 Mac 上安装 Shadowsocks 客户端。请确保在设置中选择「手动模式」或「自动模式」！如果您选择「全局模式」（或 11.1 之前 Big Sur 版本中的「自动模式」），配置将不起作用。
现在进入AdGuard 菜单 →「高级」→「高级设置」，并将 upstream.proxy 设置的数值设置为 socks5://localhost:1080。请注意，需要使用 JSON 文件中的 “local_port” 值。
由于 Shadowsocks 使用 SOCKS5，因此还需要将 AdGuard 高级设置中的 upstream.proxy.socks5udp 值设置为 true，以便 AdGuard 将 UDP 流量路由到代理服务器。
示例 2：配置上游 Surge 代理
在 Big Sur v11.1+ 中，AdGuard 和 Surge 代理之间没有已知的冲突。如果用户使用的是旧版本的 Big Sur（11.1 之前的版本），请检查右下角的「系统代理」是否已禁用。否则，Surge 无法与 AdGuard 一起使用。另一方面，「增强模式」可以在任何 Big Sur 版本中启用而不会引起冲突。
请转到*「首选项」→「网络」→「出站代理」*并填写字段。 SOCKS5 代理类型：
host：localhostport：6153 HTTP 代理类型：host：localhostport：6152
使用网络扩展的替代方案
我们无法预见到 Big Sur 或 Monterey 可能出现的所有问题，因为有无数不同的硬件/软件和设置配置。如果您遇到任何兼容性问题，联系我们的支持团队前，请尝试使用以下解决方案。
使用「自动代理」过滤模式
如果用户在 Big Sur 或 Monterey 上遇到的问题无法通过上述任何方法解决，您可以尝试将 AdGuard 切换到「自动代理」模式。
- 开启 AdGuard 菜单。
- 选择「首选项...」。
- 切换到「网络」选项卡。
- 单击「选择模式...」按钮。
- 选择「自动代理」。
现在，AdGuard 自动在 Mac 的网络设置中添加一个 .pac 文件。这样系统就会将 AdGuard 视为代理，并尝试通过 AdGuard 发送所有流量。
有些应用程序可能会忽略这一系统设置，其流量将不会被过滤。
在 Big Sur 和 Monterey 中启用内核扩展
默认情况下，Big Sur 和 Monterey 禁用了旧内核扩展框架，因此 AdGuard 使用网络扩展框架。这可能会导致兼容性问题，但要重新启用内核扩展，必须首先禁用系统完整性保护（英语：System Integrity Protection，英语缩写：SIP）。要禁用 SIP，请按此说明操作：
- 单击菜单栏中的 * Apple 符号*。
- 点击「重启…」。
- 按住 Command-R 重启进入恢复模式。
- 单击「实用程序」。
- 选择「终端」。
- 输入
csrutil disable。 - 按键盘上的 Return 或 Enter 键。
- 单击菜单栏中的 * Apple 符号*。
- 点击「重启…」。
禁用 SIP 后，就可以启用内核扩展：
- 开启 AdGuard 菜单。
- 选择「首选项...」。
- 切换到「网络」选项卡。
- 单击「选择模式...」按钮。
- 选择「内核扩展」。
- 确认要切换到内核扩展。
不过，我们只建议在其他方法都失败的情况下使用上述方法，因为这可能会导致一些问题。