前言

对于热衷网站运营的朋友而言，网站统计工具想必十分熟悉。它能够统计网站访问量、访客地域分布、来源渠道、跳出率等关键数据，帮助我们清晰把握网站运行状况。目前国内也有不少提供免费统计服务的平台，常以“免费、安全”为宣传口号。然而，这些所谓的免费服务有时也隐藏风险——你可能在某个凌晨打开自己的网站，发现页面不再是熟悉的内容，而是充斥着不良信息。这往往就是“挂码”在作祟：某些免费统计通过你嵌入的跟踪代码，随机将网站跳转至灰色或黑色产业页面，以此牟利。因此，选择统计服务时务必谨慎，避免因“免费”而付出更大代价。

面对此类安全隐患，越来越多的人开始选择更自主、更透明的统计方案。自行搭建统计平台能让你完全掌控数据与安全，避免潜在风险。在开源工具中，Umami 以其轻量、注重隐私的特性脱颖而出——它界面简洁、支持中文，易于部署，并将数据完全存储于你自己的服务器中。今天我来带你在在宝塔面板部署umami

项目预览

部署教程

我们这里使用的是宝塔面板的Docker部署，十分简单方便

1.先在宝塔面板安装好docker

2.在/wwwroot目录下（方便管理）新建一个文件夹，随便怎么命名

3.进入文件夹，新建一个名为docker-compose.yml的文件，并且填入以下代码

# Umami 网站统计工具 Docker Compose 配置
services:
  umami:
    image: ghcr.io/umami-software/umami:latest  # 建议替换为具体版本（如2.11.0）
    ports:
      - "3000:3000"  # 主机端口:容器端口，可按需修改
    environment:
      DATABASE_URL: postgresql://umami:umami@db:5432/umami  # 数据库连接信息
      APP_SECRET: replace-me-with-a-random-string  # 必须替换为随机字符串（openssl rand -hex 16生成）
    depends_on:
      db:
        condition: service_healthy  # 等待数据库健康检查通过后启动
    init: true
    restart: always
    healthcheck:  # 检测Umami服务是否正常
      test: ["CMD-SHELL", "curl http://localhost:3000/api/heartbeat"]
      interval: 5s
      timeout: 5s
      retries: 5

  db:
    image: postgres:15-alpine  # PostgreSQL 15轻量版本
    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

# 数据卷：持久化PostgreSQL数据，避免容器删除后数据丢失
volumes:
  umami-db-data:

4.点击终端文件夹上方的终端，输入命令并回车构建容器

docker-compose up -d

5.等待下载完成后，点击docker，点到容器界面，看到有两个容器正在运行，就证明已经部署成功了，这时输入你的IP加端口3000（比如127.0.0.1:3000），输入默认账号umami，密码umami，即可进入统计后台（如果打不开，多半为端口未开放，在服务器商和宝塔面板的安全都开放一下端口3000），把语言切换为中文

为了方便使用，我们使用一个闲置域名，或者解析一个二级域名，点击docker的网站那一栏，选择创建-反代容器，选择容器umami，这样即可使用域名来访问这个项目

到此，教程结束！