首页
壁纸墙
直播
语录
留言
友链
搜索
1
微信小程序 Skyline 渲染引擎实战:worklet 动画从原理到落地
361 阅读
2
微信小程序支付全链路实战:JSAPI 下单、调起支付、回调验签与退款
336 阅读
3
小程序接口安全攻防:签名、防重放、防刷与数据加密实战
294 阅读
4
微信小程序分包进阶:独立分包、预下载与分包异步化实战
289 阅读
5
微信小程序云开发实战:云函数、云数据库与云存储的正确使用姿势
287 阅读
服务器运维
后端技术
前端技术
梯子
数据库
小程序
AI
资源分享
登录
搜索
标签搜索
fastadmin
Redis
微信小程序
前端开发
Nginx
Docker
RabbitMQ
Go
Golang
宝塔
AI
服务器
codex
buildadmin
小程序
mysql
Vue3
Node.js
MySQL优化
Linux
沿途的风景
累计撰写
93
篇文章
累计收到
12
条评论
首页
栏目
服务器运维
后端技术
前端技术
梯子
数据库
小程序
AI
资源分享
页面
壁纸墙
直播
语录
留言
友链
搜索到
1
篇与
» 访问统计
的结果
2026-11-18
从 51.LA 到自建 Umami:一台 CentOS 7 老服务器上的访问统计踩坑记
博客跑了那么久,只知道"有人在看",但每天多少人、从哪来、看什么、待多久,一概不知。这篇记录我从 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.LAUmami(自建)部署成本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 里,随时能导出、能分析、能迁移,不用再担心服务商停服、涨价或者数据被清。
2026年11月18日
3 阅读
0 评论
0 点赞
0:00