Skip to content

解决 Umami 被 AdBlock 屏蔽问题

Published: at 11:49

之前重写了下个人主页,使用了 Umami 做访问统计,还是老问题:用户会安装 AdBlock 导致访问统计失效。

AdBlock 原理相关的点可以查看解决 Vercel Analytics 被 AdBlock 屏蔽问题,Umami 被屏蔽的规则是 ||umami.is^$3p,脚本地址和数据上报地址都被屏蔽了,所以我们得使用 Cloudflare Workers 来反代一下 Umami。

||umami.is^$3p

方案

在 Cloudflare Workers 创建一个 Worker,贴入下面的 JS 代码,如果你使用的官方服务,不需要修改代码 (三方服务记得 UMAMI_HOST 修改为服务地址),如果是自建服务,可以使用 TRACKER_SCRIPT_NAMECOLLECT_API_ENDPOINT 环境变量定义脚本地址和数据上报地址,无需反代。

const UMAMI_HOST = "https://eu.umami.is";

export default {
  async fetch(request, env, ctx) {
    const { pathname, search } = new URL(request.url);
    if (pathname.endsWith(".js")) {
      let response = await caches.default.match(request);
      if (!response) {
        response = await fetch(`${UMAMI_HOST}/script.js`, request);
        ctx.waitUntil(caches.default.put(request, response.clone()));
      }
      return response;
    }
    const req = new Request(request);
    req.headers.delete("cookie");
    req.headers.append("x-client-ip", req.headers.get("cf-connecting-ip"));
    return fetch(`${UMAMI_HOST}${pathname}${search}`, req);
  },
};

创建好 Worker 后,配置好域名,测试脚本地址是否可以正常访问,我的是 https://ums.miantiao.me/mt-demo.js。其中 mt-demo 可以替换为任意伪装地址,上面的脚本已经适配。

然后将脚本注入到你的网站项目,官方文档在 https://umami.is/docs/tracker-configuration,也可以参考我的代码:

<script
  defer
  src="https://ums.miantiao.me/mt-demo.js"
  data-host-url="https://ums.miantiao.me"
  data-website-id="0a10de75-03be-4fec-a521-4c62b91650ac"
></script>

src 是脚本地址,data-host-url 是数据上报地址,data-website-id 是站点 ID,注意站点 ID 不要写错,否则无法上报数据。

可以在面条实验室或者本站验证。