Umami一款开源的网站统计工具！

技术社区 作者：FastSign 2025-05-03 18:34:29 阅读：24

Umami —— 一个开源的、以隐私为中心的网站分析工具，是 Google Analytics 的开源替代品，提供网站流量、用户行为分析和访问统计等功能。

 「功能特色」：

• 流量分析：获取流量洞察，以便优化增长，轻松一目了然地查看所有指标
• 访客分析：获取有关访客的详细信息，包括他们的位置和使用的设备
• 自定义事件：跟踪的不仅仅是页面浏览量，支持捕捉网站上的任何事件，例如按钮点击和表单输入
• 强大的过滤器：使用易于应用的过滤器深入挖掘网站数据，按浏览器、操作系统和国家等指标对用户进行细分
• 实时数据：获取当前网站流量的实时视图，查看访客正在访问的页面
• 趋势检测：比较日期周期以发现流量中的关键趋势

快速上手

安装

源码安装

「依赖环境」：

• Node.js 18.18+
• 数据库（PostgreSQL/MySQL）

1、获取源码并安装依赖

## 安装 Yarn npm i -g yarn ## 克隆代码 git clone https://github.com/umami-software/umami ## 安装依赖 cd umami yarn install

2、在项目根目录下创建 .env 文件配置数据库

## 内容 DATABASE_URL={连接网址} ## PostgreSQL 示例 DATABASE_URL=postgresql://用户名:密码@localhost:5432/mydb ## MySQL 示例 DATABASE_URL=mysql://用户名:密码@localhost:3306/mydb

3、构建并启动应用

## 构建 yarn build ## 运行 yarn start

4、启动成功后，浏览器访问

http://{ip/域名}:3000

5、使用 PM2 后台永久运行应用

yarn global add pm2 cd umami pm2 start yarn --name umami -- start pm2 startup pm2 save

Docker 安装

1、拉取镜像（选择其中一个镜像即可）

## PostgreSQL docker pull docker.umami.is/umami-software/umami:postgresql-latest ## MySQL docker pull docker.umami.is/umami-software/umami:mysql-latest

2、运行容器

## PostgreSQL docker run --name umami -d \      -p 3000:3000 \     -e DATABASE_URL=postgresql://用户名:密码@localhost:5432/mydb \     docker.umami.is/umami-software/umami:postgresql-latest ## MySQL docker run --name umami -d \      -p 3000:3000 \     -e DATABASE_URL=DATABASE_URL=mysql://用户名:密码@localhost:3306/mydb \     docker.umami.is/umami-software/umami:mysql-latest

「注意：运行容器启动时需指定数据库连接地址」。

3、启动成功后，浏览器访问

http://{ip/域名}:3000

Docker Compose 安装

1、一键构建 Docker 容器并启动 Postgres 数据库

## 克隆代码 git clone https://github.com/umami-software/umami ## 一键启动 cd umami docker-compose up -d

2、启动成功后，浏览器访问

http://{ip/域名}:3000

登录

1、Umami 安装将创建一个默认的管理员账户，默认用户密码： admin/umami, 需要登录并更改默认密码。

2、Umami 系统默认使用英语，登录后可点击网站右上角的图标切换为中文。

3、登录后，点击头部的「设置」，选择「个人资料」，修改密码。

添加网站

要统计网站信息，需要先在 Umami 上添加对应的网站信息。

1、点击头部的「设置」，选择「网站」，添加网站。

2、输入「网站名称和域名」并保存即可。

• 名称：任意内容
• 域名：网站的实际域名，不能是 IP 或者带端口

收集数据

收集网站数据，需要将「跟踪代码」添加到对应的网站上。

1、点击想要跟踪网站的「编辑」按钮，切换到「跟踪代码」标签

2、复制「跟踪代码」粘贴到网站的请求头

工具截图

• 「仪表盘」
• 「概览」
• 「行为类别」
• 「会话」
• 「实时」
• 「比较」
• 「设置」

Umami 可以说是一款十分优秀的开源网站统计工具，帮助我们很好地统计网站浏览量、访客信息等，而且是自托管的，以隐私为主，数据完全自己掌握！

项目地址：https://github.com/umami-software/umami

最后

推荐的开源项目已经收录到 GitHub 项目，欢迎 Star：

https://github.com/chenyl8848/great-open-source-project

或者访问网站，进行在线浏览：

https://chencoding.top:8090/#/