Azure CDN加速静态站点时Google Analytics过滤器失效问题求助

问题根源分析 #

当你启用Azure CDN后，用户的请求会先经过CDN节点再转发到你的Blob存储。Google Analytics默认会抓取请求的源IP（也就是CDN节点的IP），而不是用户的真实IP。这就是你的IP过滤器失效的核心原因——GA后台记录的全是CDN的IP段，自然匹配不上你设置的过滤规则。

你之前的认知没错：客户端脚本本身不会被CDN篡改（除非你配置了CDN的代码优化规则），但GA收集IP的逻辑是基于请求链路的，CDN作为反向代理改变了这个链路的源IP。

解决办法1：通过Azure CDN注入真实用户IP到GA（推荐长期方案） #

Azure CDN默认会在转发请求时添加X-Forwarded-For请求头，这个头里包含了用户的真实IP。但前端JS无法直接读取请求头，所以我们需要通过CDN的规则引擎把这个IP注入到页面中，再让GA使用这个真实IP。

具体步骤：

1. 登录Azure Portal，找到你的CDN资源，进入规则引擎
2. 创建一条新规则，条件设置为“所有请求”
3. 添加一个注入HTML操作：
   • 选择“在开头注入”或“在结尾注入”
   • 输入这段脚本：

     <script>window.realUserIp = "{{X-Forwarded-For}}";</script>
     

   （Azure CDN的规则引擎支持用{{头名称}}的方式引用请求头的值）
4. 保存规则并等待生效（通常几分钟）
5. 修改你的GA初始化代码，让它使用这个真实IP：

   // GA4示例
   gtag('config', '你的GA测量ID', {
     ip_override: window.realUserIp
   });
   
   // UA（Universal Analytics）示例
   ga('create', '你的UA ID', 'auto', {
     'ipOverride': window.realUserIp
   });
   

这样GA就会记录用户的真实IP，你的过滤器就能正常工作了。

解决办法2：临时适配CDN IP段（不推荐长期使用） #

如果你暂时不想修改代码，可以把Azure CDN的所有IP段添加到GA的过滤器中，但这个方法的弊端是Azure CDN的IP范围会定期更新，你需要手动维护，长期来看很繁琐。

操作步骤：

1. 获取Azure官方发布的CDN IP段列表
2. 登录GA后台，进入管理 > 视图 > 过滤器
3. 创建新过滤器：
   • 如果你的过滤器是“允许特定IP访问”，就添加一个“排除”过滤器，把CDN的IP段全部排除，这样GA会忽略CDN的IP，只记录真实用户的IP（前提是你已经配置了X-Forwarded-For的传递）
   • 如果是“排除特定IP”，则需要把CDN IP段加入“包含”过滤器，再结合真实IP的过滤逻辑

解决办法3：用GA自定义维度追踪真实IP #

另一种思路是把真实IP作为GA的自定义维度发送，然后基于这个维度设置过滤器：

1. 按照解决办法1的步骤，通过CDN注入真实IP到全局变量
2. 在GA后台创建一个自定义维度（比如命名为“真实用户IP”）
3. 修改GA代码，把这个变量作为自定义维度发送：

   // GA4示例
   gtag('set', {'dimension1': window.realUserIp});
   gtag('config', '你的GA测量ID');
   
   // UA示例
   ga('set', 'dimension1', window.realUserIp);
   ga('send', 'pageview');
   

4. 然后在GA的过滤器中，选择基于这个自定义维度来设置过滤规则

关键验证点 #

• 确认Azure CDN的X-Forwarded-For头已经启用：在CDN资源的“设置 > 优化 > 高级”里，确保“转发客户端IP”选项是开启的（默认是开启的）
• 测试时可以用浏览器的开发者工具查看页面是否成功注入了window.realUserIp变量，以及GA请求中是否包含了真实IP参数

内容的提问来源于stack exchange，提问作者Frank Sandqvist