从 51.LA 到自建 Umami:一台 CentOS 7 老服务器上的访问统计踩坑记

从 51.LA 到自建 Umami:一台 CentOS 7 老服务器上的访问统计踩坑记

admin
2026-11-18 / 0 评论 / 3 阅读
博客跑了那么久,只知道"有人在看",但每天多少人、从哪来、看什么、待多久,一概不知。这篇记录我从 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
# NXDOMAIN

docker.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 permitted

Operation not permitted 一般是 SELinux 或文件权限,但检查之后:SELinux 没开、文件系统 ext4 正常、目录权限 777、普通 alpine 容器往同一个命名卷写文件完全正常。

换成 PostgreSQL 15 也一样报错——说明不是版本问题,而是 postgres 镜像在这台老内核上的特有问题(3.10 内核 + 新版容器的已知兼容性问题)。

坑 4:MariaDB 与 Prisma 协议不兼容

既然 postgres 不行,换 MariaDB(Umami 也支持 MySQL 协议):

Error: P1001 ... received invalid response: 62

MariaDB 容器本身启动正常,但 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.LAUmami(自建)
部署成本5 分钟1 小时(含踩坑)
数据归属第三方自己的数据库
广告免费版有标识无
外部请求依赖 51.LA 域名只请求自己的域名
PJAX 支持需要 autoTrack: true内置支持
数据保留受套餐限制永久,可导出
具体 IP不提供不提供(隐私设计)

两个都装其实不冲突,但我最后只留了 Umami——一个数据源就够,多装一套只会让数字互相打架。

八、小结

  1. 先搞清楚"统计什么"再选工具。 日志量、PV、UV 是三个完全不同的东西,混为一谈只会得出"统计不准"的错误结论。
  2. 老内核跑新容器是隐藏地雷。 CentOS 7 的 3.10 内核上,PostgreSQL 官方镜像连 initdb 都过不去,这不是配置问题,是兼容性问题——遇到这类报错要先怀疑内核,而不是继续折腾权限。
  3. 注意镜像的"变体标签"。 同一个应用可能按数据库类型发布不同标签(latest / mysql-latest),用错了会得到完全看不懂的协议错误。
  4. Next.js 应用的 BASE_PATH 基本不可运行时修改。 想省钱用路径反代往往行不通,老老实实开子域名更快。
  5. 隐私优先的统计工具不存 IP。 这是特性不是缺陷。真要追 IP,去看 Nginx 日志——那才是这类需求的正确工具。
  6. 自建的真正价值是"数据主权"。 装好之后所有数据都在自己的 MySQL 里,随时能导出、能分析、能迁移,不用再担心服务商停服、涨价或者数据被清。
0

评论 (0)

取消
0:00