关于 Umami
Umami 是基于 MIT 许可证发布的开源网站分析工具。它在一个页面上回答大多数站长真正关心的问题——有多少人访问、他们看了哪些页面、从哪里来、使用什么设备——而不是几十份报表。
跟踪脚本体积小,不设置 Cookie,也不收集个人数据,因此许多网站在使用 Umami 时不显示 Cookie 同意横幅;这是否适用于您,取决于您所在的司法管辖区。它还支持自定义事件、UTM 推广活动、可分享的公开仪表盘,以及在一次安装中管理多个网站。
许多人选择自行部署 Umami,因为它足够轻量,小型服务器即可运行,而且访问数据保存在自己的数据库中,而不是交给广告公司。开发者常将它用于个人项目和客户网站,因为对这些网站来说,完整的营销套件过于繁重。
常见用途
为多个小网站做分析
将所有项目或客户网站添加到同一个 Umami 实例中,在仪表盘上随时切换。
跟踪按钮点击和注册
从页面发送自定义事件,了解有多少访客完成了关键操作。
公开统计页面
与客户或社区分享只读仪表盘链接,无需为他们创建账号。
下单之后
服务器首次启动后,Umami 即安装完成,可通过 http://your-server-address:3000/ 访问(防火墙已放行 3000 端口)。使用 Rivervo 控制面板中显示的用户名和密码登录,添加您的网站,然后将生成的跟踪代码复制到网站页面中。
为 Umami 配置自有域名和 HTTPS
默认情况下,Umami 通过服务器 IP 地址以普通 HTTP 提供访问。如需为它配置 stats.example.com 这样的名称并启用证书,请在您的 DNS 中为该名称创建一条指向服务器 IPv4 地址的 A 记录,然后在其前面部署 Caddy:Caddy 会自动申请并续期免费的 Let's Encrypt 证书。以下命令适用于我们应用服务器所用的 Ubuntu 24.04。
在控制面板中,为服务器防火墙开放 TCP 80 和 443 端口:Caddy 需要通过它们获取 Let's Encrypt 证书并提供网站服务。
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
stats.example.com {
reverse_proxy 127.0.0.1:3000
}
EOF
systemctl reload caddy这一点对 Umami 比对大多数应用更重要:跟踪脚本由您的网站加载,而 HTTPS 网站不会加载来自普通 HTTP 地址的脚本。域名生效后,请在 Umami 的网站设置中重新获取跟踪代码——此时它指向 https://stats.example.com/script.js——并替换您网站上的旧代码。
域名生效后,就不再需要直接使用 3000 端口:在 /opt/umami/compose.yml 中将 "3000:…" 改为 "127.0.0.1:3000:…",运行 docker compose up -d,并从防火墙中移除 3000 端口。此后 Umami 只能通过 HTTPS 访问。
更新 Umami
/opt/umami/compose.yml 中的镜像固定为具体版本,因此直接运行 docker compose pull 只会再次拉取相同版本。如需更新,请将 image: 行中的版本改为目标版本(请先阅读发布说明),然后拉取镜像并重新创建容器。数据保存在 Docker 卷中,不会丢失。
cd /opt/umami
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -d备份 Umami
在控制面板中,您可以开启整台服务器的每日备份(套餐价格的 +20%,保留最近 7 份),并可从其中任意一份恢复服务器。不过,仍建议将应用自身的数据另存为文件:这样可以迁移到其他服务器,或在不回滚其他内容的情况下单独恢复。
Umami 的所有数据——网站、用户和每一条访问记录——都保存在其 PostgreSQL 数据库中,因此导出数据库即可完成完整备份:
cd /opt/umami
docker compose exec -T db pg_dump -U umami umami > /root/umami-$(date +%F).sql如何运作
- 在服务器订购页面选择 Umami,并选一个内存足够的套餐。
- 服务器首次启动时会自动安装应用,通常几分钟内完成。
- 在控制面板中打开服务器:访问地址和登录信息都在那里。