博客跑了那么久,只知道"有人在看",但每天多少人、从哪来、看什么、待多久,一概不知。这篇记录我从 51.LA 到自建 Umami 的完整过程——包括在一台 CentOS 7 老服务器上用 Docker 部署现代应用踩到的八个坑,以及"统计数字为什么和服务器日志对不上"这个绕不开的认知。
一、起因:只有浏览量,没有访问量
主题自带文章浏览量(每篇文章的 views 字段),热门文章排行榜也是基于它。但那只是"文章级"的计数,站点级的指标一个都没有:
- 今天有多少人访问、看了多少页
- 访客从哪来(搜索引擎 / 直接访问 / 外链)
- 哪些页面最受欢迎、平均停留多久
- 一周、一月的趋势
要补上这块,有三条路:
| 方案 | 优点 | 缺点 |
|---|---|---|
| 第三方 JS 统计(51.LA / 百度统计) | 五分钟接入,功能齐全 | 数据在别人手上,有广告,可能被墙/限流 |
| 宝塔/Nginx 日志分析 | 零改动、无需装东西 | 只能看原始日志,趋势和来源不直观 |
| 自建(Umami) | 数据完全归自己、无广告、无外域请求 | 需要自己部署维护 |
本着"先跑起来再优化"的原则,我先接了 51.LA。
二、51.LA:五分钟接入,以及一个 PJAX 坑
注册、建站点、拿到代码:
<script charset="UTF-8" id="LA_COLLECT" src="//sdk.51.la/js-sdk-pro.min.js"></script>
<script>LA.init({id:"你的ID",ck:"你的ID"})</script>但我的主题"自定义 JS"输入框本身就在 <script> 标签内部,所以不能直接贴这两段,得改写成动态插入:
(function () {
if (window.LA) return;
var s = document.createElement('script');
s.id = 'LA_COLLECT';
s.charset = 'UTF-8';
s.src = '//sdk.51.la/js-sdk-pro.min.js';
s.onload = function () {
LA.init({ id: '你的ID', ck: '你的ID' });
};
document.head.appendChild(s);
})();装完很快就看到数据了。但用了一阵发现问题:点击站内链接翻页,PV 不涨。
原因是主题开启了 PJAX——点击链接只替换内容区,不整页刷新,统计脚本自然只在首次加载时上报一次。
查 51.LA 的 SDK 源码才找到开关:
autoTrack: !0x1 // 默认 false!0x1 就是 false,也就是说 SPA/PJAX 的自动上报默认是关的。补上参数即可:
LA.init({ id: '你的ID', ck: '你的ID', autoTrack: true });三、数字对不上:一个必须搞清楚的认知
接入之后,拿 51.LA 的 PV 和服务器日志一比,发现差得很远:日志动辄几万请求,统计后台只有几十。
一开始以为是统计不准,后来翻了日志才明白——两者统计的根本不是一回事:
| 服务器日志 | JS 统计 | |
|---|---|---|
| 统计对象 | 所有 HTTP 请求 | 执行了 JS 的真实浏览器 |
| 爬虫/扫描器 | 全算 | 不算(不执行 JS) |
| 广告拦截插件用户 | 算 | 漏掉 |
| 静态资源 | 算(图片/CSS/JS) | 不算 |
我实际统计了某一天的访问日志:3.3 万条请求里,有 91% 来自 4 个机房 IP 的爬虫,真实访客不到 10%。所以 JS 统计的数字小,恰恰是"更接近真实",而不是不准。
这个认知很关键:日志量 ≠ 访问量,日志大不代表有人看。
四、转向自建 Umami
搞清楚口径之后,剩下的问题就是"数据归谁"。51.LA 的免费版有广告标识,数据存在第三方,而且它的 SDK 依赖外部域名加载——一旦被墙或限流,统计就断了。
Umami 是开源的自托管方案:Node + 数据库,资源占用小,对 PJAX/SPA 天然支持,界面现代,数据存在自己库里。
于是动手,然后踩了一路坑。
五、部署八道坎
环境:CentOS 7.9、Docker 26 + Compose v2、宝塔面板、内核 3.10(后面这个很关键)。
坑 1:宝塔应用商店安装直接失败
dial tcp: lookup docker.umami.dev on 183.60.83.19:53: no such host以为是 DNS 污染,换了阿里 DNS、腾讯 DNS 再试:
nslookup docker.umami.dev 223.5.5.5
# NXDOMAINdocker.umami.dev 这个域名从任何 DNS 都解析不到,不是污染,是域名本身不可达。只能手动部署。
坑 2:国内镜像源全军覆没
手动写 docker-compose.yml,然后挨个试镜像加速:
| 镜像源 | 结果 |
|---|---|
| docker.m.daocloud.io | 拉取失败(该源有白名单,umami 不在内) |
| docker.1ms.run | 失败 |
| hub.rat.dev | 失败 |
| docker.1panel.live | 失败 |
| docker.xuanyuan.me | 失败 |
| ghcr.m.daocloud.io | 成功 |
最后这个源是 daocloud 对 GitHub Container Registry 的代理,Umami 的镜像正好发布在 GHCR 上。
坑 3:PostgreSQL 在 3.10 内核上起不来
镜像拉下来了,数据库容器却不停重启:
initdb: could not write to file "pg_wal/xlogtemp.xxx": Operation not permittedOperation not permitted 一般是 SELinux 或文件权限,但检查之后:SELinux 没开、文件系统 ext4 正常、目录权限 777、普通 alpine 容器往同一个命名卷写文件完全正常。
换成 PostgreSQL 15 也一样报错——说明不是版本问题,而是 postgres 镜像在这台老内核上的特有问题(3.10 内核 + 新版容器的已知兼容性问题)。
坑 4:MariaDB 与 Prisma 协议不兼容
既然 postgres 不行,换 MariaDB(Umami 也支持 MySQL 协议):
Error: P1001 ... received invalid response: 62MariaDB 容器本身启动正常,但 Umami 用的 Prisma 在握手阶段就挂了,返回一坨随机十六进制——典型的协议不匹配。
坑 5:latest 标签是 PostgreSQL 专用构建
改用 MySQL 8 容器,还是同样的错。查了半天才意识到:Umami 的镜像按数据库分了不同标签,latest 是在编译期固定了 PostgreSQL provider 的版本,连 MySQL 必然握手失败。
正确的标签是:
image: ghcr.m.daocloud.io/umami-software/umami:mysql-latest换上去,容器立刻正常启动。
坑 6:BASE_PATH 不生效
原本想省一个域名,用路径反代:https://blog.example.com/analytics/ → 容器 3000。
设了环境变量 BASE_PATH=/analytics,容器里 env 能看到这个变量,但访问 /analytics/login 依旧 404、/login 才是 200。
因为 Umami 是 Next.js 应用,路由前缀在编译期就固定了,运行时改环境变量无效(这个镜像不支持运行时 basePath)。
只能走独立子域名。
坑 7:子域名 + 免费证书
加一条 A 记录 analytics.example.com → 服务器 IP,然后:
# 用 webroot 方式签发(Nginx 已在跑,不中断服务)
acme.sh --issue -d analytics.example.com -w /www/wwwroot/analytics --server letsencrypt
# 安装证书并配置自动重载
acme.sh --install-cert -d analytics.example.com --ecc \
--key-file /path/cert/privkey.pem \
--fullchain-file /path/cert/fullchain.pem \
--reloadcmd 'nginx -s reload'Nginx 反代(关键是这几个转发头,否则 Umami 拿到的是容器内网 IP):
location / {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}坑 8:Umami 里看不到访客 IP
部署完第一件事就是想看"谁在访问",结果后台只有国家:
DESC session;
-- 字段:session_id, website_id, browser, os, device,
-- screen, language, country, region, city, distinct_id没有 ip 字段。这是 Umami 的设计取向——隐私优先,不存 IP,只用 IP 换算出地理信息后立即丢弃。而且这版内置的地理库只到国家级,region、city 都是空的。
想看具体 IP,只能回到 Nginx 日志:
awk -v d=$(date +%d/%b/%Y) '$4 ~ d {print $1}' access.log \
| sort | uniq -c | sort -rn | head -20六、最终形态
services:
umami:
image: ghcr.m.daocloud.io/umami-software/umami:mysql-latest
container_name: umami
restart: always
ports:
- "127.0.0.1:3000:3000"
environment:
DATABASE_TYPE: mysql
DATABASE_URL: mysql://umami:密码@umami-db:3306/umami
APP_SECRET: 随机字符串
depends_on:
- umami-db
umami-db:
image: docker.m.daocloud.io/library/mysql:8.0
container_name: umami-db
restart: always
environment:
MYSQL_ROOT_PASSWORD: 密码
MYSQL_DATABASE: umami
MYSQL_USER: umami
MYSQL_PASSWORD: 密码
volumes:
- umami-db-data:/var/lib/mysql
volumes:
umami-db-data:接入博客同样要注意"自定义 JS 框内不能带 script 标签":
/* Umami 访问统计 */
(function () {
if (document.querySelector('script[data-website-id]')) return;
var s = document.createElement('script');
s.defer = true;
s.src = 'https://analytics.example.com/script.js';
s.setAttribute('data-website-id', '你的-website-id');
document.head.appendChild(s);
})();七、51.LA vs Umami
| 51.LA | Umami(自建) | |
|---|---|---|
| 部署成本 | 5 分钟 | 1 小时(含踩坑) |
| 数据归属 | 第三方 | 自己的数据库 |
| 广告 | 免费版有标识 | 无 |
| 外部请求 | 依赖 51.LA 域名 | 只请求自己的域名 |
| PJAX 支持 | 需要 autoTrack: true | 内置支持 |
| 数据保留 | 受套餐限制 | 永久,可导出 |
| 具体 IP | 不提供 | 不提供(隐私设计) |
两个都装其实不冲突,但我最后只留了 Umami——一个数据源就够,多装一套只会让数字互相打架。
八、小结
- 先搞清楚"统计什么"再选工具。 日志量、PV、UV 是三个完全不同的东西,混为一谈只会得出"统计不准"的错误结论。
- 老内核跑新容器是隐藏地雷。 CentOS 7 的 3.10 内核上,PostgreSQL 官方镜像连 initdb 都过不去,这不是配置问题,是兼容性问题——遇到这类报错要先怀疑内核,而不是继续折腾权限。
- 注意镜像的"变体标签"。 同一个应用可能按数据库类型发布不同标签(
latest/mysql-latest),用错了会得到完全看不懂的协议错误。 - Next.js 应用的 BASE_PATH 基本不可运行时修改。 想省钱用路径反代往往行不通,老老实实开子域名更快。
- 隐私优先的统计工具不存 IP。 这是特性不是缺陷。真要追 IP,去看 Nginx 日志——那才是这类需求的正确工具。
- 自建的真正价值是"数据主权"。 装好之后所有数据都在自己的 MySQL 里,随时能导出、能分析、能迁移,不用再担心服务商停服、涨价或者数据被清。
评论 (0)