Umami免费开源网站分析方案使用指南

Umami是一个开源的、强调隐私保护的Google Analytics替代工具。umami可以提供强大的网络分析解决方案，不会侵犯用户的隐私。

注：如果官方网站无法显示，请检查浏览器是否启用了广告拦截或其他相关插件。

开始安装Umami

Umami提供了好几种安装方式：

• 从源代码安装
• Docker compose构建
• Docker镜像安装

笔者建议选择后面两种方式安装，如果服务器已经安装Docker，那么可以跳过Docker安装部分。

Docker安装

curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo systemctl start docker&&systemctl enable docker.service

# 国内用户在拉取镜像时可能会遇到网络问题，建议修改镜像源，操作如下：
vim /etc/docker/daemon.json

# 在此文件中添加：
{
  "registry-mirrors": [
    "https://docker.hpcloud.cloud",
    "https://docker.m.daocloud.io",
    "https://docker.unsee.tech",
    "https://docker.1panel.live",
    "http://mirrors.ustc.edu.cn",
    "https://docker.chenby.cn",
    "http://mirror.azure.cn",
    "https://dockerpull.org",
    "https://dockerhub.icu",
    "https://hub.rat.dev"
  ]
}

# 使用 :wq 命令保存并退出vim编辑器。若对vim不熟悉，请自行查阅相关资料。
sudo systemctl restart docker

安装Docker后，Docker Compose也会随之安装。

Umami Docker安装

Docker的安装非常便捷：

docker pull ghcr.io/umami-software/umami:mysql-latest

默认使用的是3000端口，您只需确保3000端口已开放。

Umami Docker compose安装

Docker Compose的安装主要是通过修改yml文件来进行多种配置：

# 从GitHub下载所需文件
git clone https://github.com/umami-software/umami.git
cd umami

# 如果您选择使用默认配置
docker compose up -d

若要进行自定义配置，请修改docker-compose.yml文件，以下为文件示例内容：

version: '3'
services:
  umami:
    image: ghcr.io/umami-software/umami:postgresql-latest
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: postgresql://umami:umami@db:5432/umami
      DATABASE_TYPE: postgresql
      APP_SECRET: replace-me-with-a-random-string
    depends_on:
      db:
        condition: service_healthy
    restart: always
  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: umami
      POSTGRES_USER: umami
      POSTGRES_PASSWORD: umami
    volumes:
      - umami-db-data:/var/lib/postgresql/data
    restart: always
    healthcheck:
      test: [CMD-SHELL, "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      retries: 5
volumes:
  umami-db-data:

使用 docker compose up -d 等待片刻，umami就会安装成功。

至此，基础的内容已经完成，更多详细的参数点击跳转

Umami 源码安装

源码安装也很方便：

# 首先安装yarn
npm install -g yarn

# 克隆项目
git clone https://github.com/umami-software/umami.git
cd umami

# 安装依赖
yarn install

# 编写环境文件.env
vim .env

示例环境配置：

DATABASE_URL=mysql://username:mypassword@localhost:3306/umami
PORT=3006

说明：

• DATABASE_URL 参数格式：mysql://用户名:密码@数据库地址:端口/数据库名
• PORT 为服务运行端口（默认3000，冲突时需修改）
• 使用PostgreSQL需将协议改为 postgresql

编译与启动：

yarn build
yarn start

建议使用pm2管理进程：

sudo yarn global add pm2
pm2 start yarn --name umami -- start-env
pm2 startup
pm2 save

总结：

• Docker安装最简单但对性能要求较高
• 源码安装更灵活且资源占用更低
• 可根据实际需求选择部署方式