宝塔面板 – 部署开源网站统计工具umami及相关设置教程

点击右上角第二个地球图标，选择中文

3.3 配置跟踪代码

首先在设置 -> 网站，添加你需要跟踪的网站，添加完成之后，点击编辑，然后可以在跟踪代码中找到跟踪代码。

然后将这段js添加到你的网站footer下，类似于百度统计的方式即可。等待一段时间，然后就可以在仪表盘中看到相关统计了。

进阶配置——排除特定页面统计

如果你不希望统计某些页面（如管理后台、特定目录），可以在跟踪代码中添加 data-exclude 属性。

修改后的跟踪代码示例：（如需排除所有以 /movie_list_ 开头的路径，或单独排除某个文件及其后面所带参数的访问，如forum.php,或home.php?xmhl=35352）

<script async defer src=”https://umami.example.com/script.js” data-website-id=”你的网站ID” data-exclude=”/admin/*,/movie_list_*,/forum.php*,/home.php*”></script>

通配符 * 表示匹配所有以该前缀开头的路径。

更高阶玩法——

• 访问 /movie_list_123、/forum.php、/home.php 时，控制台显示命中规则，不发送统计请求。

<script defer src=”https://stats.91talk.com/random-string.js”
data-website-id=”530a4898-6063-4adc-9574-a9c7e318a0ba”
data-auto-track=”false”></script>
<script>
(function() {
var currentPath = window.location.pathname;
console.log(‘[Umami排除] 原始路径:’, currentPath);

// 规则1：以 /movie_list_ 开头
if (currentPath.toLowerCase().startsWith(‘/movie_list_’)) {
console.log(‘[Umami排除] ✅ 命中规则1 (movie_list_) → 不统计’);
return;
}

// 提取文件名（去除尾部斜杠，取最后一段）
var cleanPath = currentPath.replace(/\/$/, ”);
var fileName = cleanPath.substring(cleanPath.lastIndexOf(‘/’) + 1).toLowerCase();
console.log(‘[Umami排除] 提取的文件名:’, fileName);
console.log(‘[Umami排除] 文件名长度:’, fileName.length);
console.log(‘[Umami排除] 是否为 forum.php:’, fileName === ‘forum.php’);
console.log(‘[Umami排除] 是否为 home.php:’, fileName === ‘home.php’);

// 规则2：精确匹配 forum.php 或 home.php（改用正则，更可靠）
var isExcludedFile = /^(forum|home)\.php$/.test(fileName);
console.log(‘[Umami排除] 是否命中规则2 (forum.php/home.php):’, isExcludedFile);

if (isExcludedFile) {
console.log(‘[Umami排除] ✅ 命中规则2 → 不统计’);
return;
}

console.log(‘[Umami排除] ❌ 未命中任何规则，准备发送统计’);

// 发送统计（等待 Umami 就绪）
function sendPageView() {
if (window.umami && typeof window.umami.track === ‘function’) {
window.umami.track();
console.log(‘[Umami排除] 已发送统计’);
} else if (window.umami && typeof window.umami.trackPageView === ‘function’) {
window.umami.trackPageView();
console.log(‘[Umami排除] 已发送统计（旧版API）’);
} else {
console.log(‘[Umami排除] umami 未就绪，重试…’);
setTimeout(sendPageView, 200);
}
}

if (window.umami) {
sendPageView();
} else {
document.addEventListener(‘umami:ready’, sendPageView);
setTimeout(function() {
if (window.umami) sendPageView();
}, 2000);
}
})();
</script>

常见问题 FAQ

Q1：访问域名显示 502 Bad Gateway

原因：反向代理配置错误，或 Umami 容器未正常运行。
解决：

• 检查 Docker 容器是否都处于“运行中”状态（Docker → 容器）。

• 检查反向代理的目标 URL 是否为 http://127.0.0.1:3000。

Q2：登录时提示密码错误

原因：默认账号密码被修改过，或数据库初始化异常。
解决：

• 在 Docker 容器列表中，重启 umami-db-1 和 umami-umami-1 容器。

• 如果仍无法登录，可查看容器日志获取更多信息。

Q3：跟踪后看不到数据

原因：跟踪代码未正确部署，或域名配置错误。
解决：

• 在网站页面右键“查看源代码”，确认跟踪代码是否存在。

• 检查跟踪代码中的域名是否与 Umami 访问域名一致。

• 等待 5-10 分钟，数据非实时更新。

Q4：安装卡住不动怎么办？

原因：镜像拉取速度受网络影响。
解决：耐心等待即可，通常 5 分钟内会完成。如果长时间无响应，可在 Docker 设置中更换镜像加速源。