Umami 网站统计中文教程（MIT 开源）：替代百度统计，数据留在自己服务器-北凯科技

你网站的访客从哪来、看了什么、在哪一步走了——这些数据，百度统计能给你，但数据存在别人服务器上。
Umami 是这套东西的自建版：装在你自己的服务器上，数据进你自己的数据库，还不依赖 Cookie 追踪。

一、它是什么

是什么	开源网站流量分析工具（自托管），看访客、来源、页面、设备、国家/地区
数据在哪	你自己的服务器 + 你自己的 PostgreSQL 数据库
隐私	官方定位是”隐私优先”，不靠 Cookie 追踪用户
部署	Docker（推荐，官方提供 compose 文件）或 Node + PostgreSQL 手动装
许可	MIT（可自由使用、修改、商用）

二、为什么不用百度统计了

数据在别人手里：报表、历史、明细都在第三方平台，规则变了你就看不到；
容易被拦：很多浏览器/插件默认拦第三方统计脚本，你的数据本身就是缺的；
敏感数据：谁来了、从哪来，这类数据放自己库更安心。

说清楚：百度统计功能更全（比如搜索词），Umami 胜在”自己的数据 + 轻”。两者不是替代关系，是取舍。

三、官方来源

github.com/umami-software/umami（3.9 万星）｜官方文档：umami.is/docs
当前最新版：v3.4.0（2026-09-17 发布）｜许可：MIT

我做的开箱验证：

包内容	2389 个文件，含官方 `LICENSE`；无 exe/dll/bat 之类可疑文件（它本来就全是代码）
我的校验值	sha256 前 16 位：`8386bf939eb12625`（下载后对一下）
重要提醒	官方没有”一键安装包”，只有源码和 Docker 镜像。所以下面给你的是源码包 + 一行 Docker 部署法

四、怎么装（推荐 Docker，官方 compose 精简版）

官方仓库里就有 docker-compose.yml，我按它整理成能直接用的版本：

services:
  umami:
    image: ghcr.io/umami-software/umami:latest
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: postgresql://umami:umami密码@db:5432/umami
      APP_SECRET: 换成一串随机字符
    depends_on:
      - db
    restart: always
  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: umami
      POSTGRES_USER: umami
      POSTGRES_PASSWORD: umami密码

存成 docker-compose.yml，然后：

docker compose up -d

打开 http://你的服务器IP:3000，用默认管理员登录：账号 admin，密码 umami（这是官方源码里写的初始值）。登录第一件事：改密码。

五、用起来就 3 步

1｜加网站：后台 → 设置 → 网站 → 添加，填域名。
2｜贴代码：把给的那段 <script> 贴到网站 </head> 前（WordPress 可以放在主题设置的自定义头部代码里）。
3｜看数据：回后台看实时访客、来源、页面排行。装完先自己点几下来验证——不验证等于没装。

六、新手最容易卡住的三个地方

现象	原因 / 解法
拉镜像卡住/超时	官方镜像在 ghcr.io（GitHub 的镜像仓库），国内经常拉不动。要给 Docker 配国内加速，或换网络环境拉取
起来就退出/报数据库错	它必须用 PostgreSQL（不是 MySQL），且版本要 12.14 以上。别拿宝塔里的 MySQL 硬接
3000 端口外网打不开	云服务器安全组要放行 3000；正式用建议配域名 + 反向代理，别长期裸用 IP