趁着备案完成，终于有时间来折腾 Umami 统计了。

这款轻量级的网站统计工具真是清新脱俗，界面简洁干净，完全符合我的胃口。

关于 Umami ​

Umami 是一款开源、轻量级的网站访问统计工具，相比 Google Analytics 更加注重隐私保护，并且界面简洁直观。官网地址：Umami

安装方式 ​

官方提供了三种安装方式：

1. 拉取 Git 代码库，使用 Node 环境执行安装（默认端口 3000）
2. 使用 docker-compose 一键部署
3. 单独拉取 Docker 镜像，自行配置参数

Node 环境安装步骤 ​

git clone https://github.com/umami-software/umami.git
cd umami
yarn install

在根目录创建 .env 文件，配置数据库连接：

DATABASE_URL=postgresql://username:mypassword@localhost:5432/mydb
# 或使用 MySQL
DATABASE_URL=mysql://username:mypassword@localhost:3306/mydb

第一次运行构建时，系统会在数据库中创建所有必需的表，并生成初始登录账户（用户名：admin，密码：umami）：

yarn build
yarn start

Docker Compose 安装 ​

如果使用 Docker Compose，直接在项目根目录执行命令即可：

docker-compose up -d

单独拉取 Docker 镜像 ​

也可以单独拉取镜像并自行配置：

docker pull docker.umami.is/umami-software/umami:postgresql-latest
# 或使用 MySQL 版本
docker pull docker.umami.is/umami-software/umami:mysql-latest

使用宝塔 Docker 管理部署 ​

我服务器上已经部署了数据库 Docker，所以选择使用宝塔的 Docker 管理器进行部署，而非直接使用官方的 yaml 文件。

首先，从官网拉取镜像：

然后给ChatGPT要份 docker-compose 配置文件：

注意：在宝塔面板中使用时遇到一个小问题，配置文件无法被识别，并报错：【检测失败: time="2025-09-09T18:10:00+08:00" level=warning msg="path/docker-compose.yaml: version is obsolete"】。解决方法很简单，直接删除配置文件中的 version 字段即可。

关键配置说明 ​

为了避免统计脚本被广告拦截器误杀，有两个重要配置需要特别注意：

TRACKER_SCRIPT_NAME=umami.js  # 脚本文件名
COLLECT_API_ENDPOINT=/umami   # 数据收集API路径

这两个配置可以有效降低被广告拦截插件误判的概率。

网站设置与使用 ​

部署完成后，新建网站并在设置中编辑，复制追踪代码到需要统计的网站中即可。