AdGuardHomeRules项目：QQ空间图片屏蔽问题分析与解决方案

问题背景

在使用AdGuardHomeRules进行网络广告过滤时，部分用户反馈QQ空间中的正常图片和表情无法正常显示。经过技术分析，发现这是由于AdGuard的过滤规则误拦截了QQ空间的相关图片资源域名所致。

技术分析

受影响的域名

通过抓包和分析，确认以下两个主要域名被误拦截：

1. 图片资源域名：a1.qpic.cn
2. 表情资源域名：qzonestyle.gtimg.cn

这些域名属于腾讯公司的CDN资源分发网络，用于托管QQ空间的各种静态资源。当这些域名被AdGuardHome的过滤规则拦截后，会导致：

• QQ空间图片无法加载
• 表情符号显示为空白
• 手机端QQ空间内容显示不完整

问题根源

AdGuardHome的默认过滤规则可能会将这些CDN域名识别为广告或追踪域名而进行拦截。特别是当使用较为严格的过滤列表时，这种误拦截现象更为常见。

解决方案

推荐解决方案

在AdGuardHome的自定义过滤规则中添加以下白名单规则：

@@||gtimg.cn^
@@||qpic.cn^

这两条规则的作用是：

1. @@||gtimg.cn^ - 放行所有gtimg.cn域名及其子域名的请求
2. @@||qpic.cn^ - 放行所有qpic.cn域名及其子域名的请求

规则解释

• @@ 符号表示白名单规则
• || 表示匹配域名及其所有子域名
• ^ 表示匹配URL的开头部分

实施步骤

1. 登录AdGuardHome管理界面
2. 进入"过滤器"→"自定义过滤规则"页面
3. 添加上述两条白名单规则
4. 保存设置并应用更改
5. 清除浏览器缓存后测试QQ空间图片显示

注意事项

1. 不同客户端环境可能有不同表现，建议在多个设备上测试
2. 如果问题仍然存在，可以尝试更具体的白名单规则，如：

   @@||a1.qpic.cn^
   @@||qzonestyle.gtimg.cn^
   

3. 定期检查规则有效性，因为腾讯可能会调整其CDN域名策略

技术建议

对于类似问题，建议采取以下排查方法：

1. 使用浏览器开发者工具查看被拦截的资源请求
2. 检查AdGuardHome的拦截日志确认具体被拦截的域名
3. 从通用到具体逐步添加白名单规则
4. 在移动端和PC端分别测试，确保兼容性

通过以上方法，可以有效解决AdGuardHomeRules过滤规则导致的QQ空间图片显示问题，同时保持其他广告过滤功能不受影响。