[教程]从源码安装Umami
关于Umami
什么是Umami?
Umami 是一个简单、快速、注重隐私的开源分析解决方案,是 Google Analytics 的替代品。可轻松收集、分析和了解您的网络数据,同时维护访客隐私和数据所有权。不收集个人身份信息,不使用 Cookie,所有数据都经过匿名处理,符合 GDPR。与许多传统分析平台不同,Umami 不收集或存储个人数据,从而避免了对 cookie 的需求, 并且符合 GDPR 和 PECR 标准。Umami 设计为轻量级且易于设置,可以自托管,让用户可以完全控制他们的数据。
为什么要使用Umami?
它是一个网站统计工具,可以帮助你分析网站的访问情况,比如访问量、访问来源、访问时间等等。这对于静态网站来说是非常有用的,因为静态网站无法像动态网站一样通过后端代码来统计访问情况。
如何使用Umami
Umami支持本地部署与使用Umami Cloud两种方式,本篇文章主要是写本地部署-从源码安装。
开始
要求
从源码安装需要用到以下程序
- Git
- Node.js >= 18.18
- MySQL (最低v8.0)or Postgresql (最低v12.14)
这里请自行寻找教程安装以上程序。
安装 Yarn
1 | npm install -g yarn |
获取源代码并安装依赖
1 | git clone https://github.com/umami-software/umami.git |
配置Umami
创建一个 .env 文件,内容如下: DATABASE_URL={connection url} 其中{connection-url} 为数据库连接地址,使用不同的数据库有不同的地址
- 使用MySQL
1 | DATABASE_URL=mysql://username:password@localhost:3306/dbname |
- 使用Postgresql
1 | DATABASE_URL=postgresql://username:password@localhost:5432/dbname |
构建Umami
1 | yarn build |
启动Umami
1 | yarn start |
一般情况下,您的Umami程序将会运行在 http://localhost:3000 上。
修改Umami账号密码
安装好后访问 http://localhost:3000进入登入界面,登录你的Umami。 在构建Umami时会自动创建一个用户名为admin密码为umami的账户。
Tips:登录后在右上角可以修改语言
在右上角人像图标–>个人资料中修改密码。
添加网站
点击 设置 -> 网站 -> 添加网站,输入你的网站地址,点击 添加 ,然后填写相关信息即可。
添加完成后,单击 编辑 按钮
再点击 跟踪代码,复制代码到你的网站代码 <head> 标签中即可。

localhost 也被统计了,可以添加 data-domains 属性标签,只统计你的域名
Tips:
如果你要遵循访客的 Do Not Track 设置,可以添加 data-do-not-track 属性标签
更多的使用方法请参考官方文档:https://umami.is/docs/tracker-configuration
结束语
到这里本文就正式结束了。感谢您的阅读,如果您觉得有什么不好或不正确的地方请在文章下方评论,我会及时修正。







![[教程]从源码安装Umami](https://qn.cdn.yll14.cn/umami/umami_0.webp)
![[分享]关于阿里云盘下载速率](https://qn.cdn.yll14.cn/alipan/alipan_0.webp)

![[分享]关于四层转发](https://qn.cdn.yll14.cn/layer4forward/layer4forward_0.webp)