Umami网站统计实战：Docker部署、Typecho接入与公网访问

fruge365

发布于 2026-08-01 08:46:55

2200

文章目录

前言
1.什么是Umami？
2.安装Typecho（个人网站示例）
3.安装Umami
4.简单使用Umami
5.安装cpolar实现随时随地开发
- 5.1 什么是cpolar？
- 5.2 部署cpolar
6.为Typecho配置域名
7.配置Umami检测个人网站
8.配置Umami实现随时随地查看网站数据
9.保留固定公网地址
结尾

前言

网站上线以后，只知道页面能够正常打开还不够。哪些文章访问较多、用户从什么页面进入、主要使用手机还是电脑，这些数据都会影响后续的内容调整和网站维护。

直接使用第三方统计平台比较方便，但网站访问数据、账号体系和服务可用性也会依赖外部平台。对于已经拥有NAS或私有服务器的用户，可以考虑部署一套自己的统计系统，把相关数据保存在自己管理的环境中。

Umami是一款可以自托管的网站访问统计工具。将统计脚本加入网站页面后，可以在管理面板中查看访问量、访客数量、来源页面、热门内容、浏览器和设备类型等基础信息。

本文会使用Docker Compose部署Umami和PostgreSQL，并以Typecho博客作为测试网站，完成站点添加、跟踪代码接入和数据验证。最后再通过cpolar为Typecho和Umami分别配置公网地址，让网站能够被外部访问，也能在其他网络环境中查看统计面板。

1.什么是Umami？

Umami是一个开源、轻量、隐私优先的网站分析工具，旨在为网站所有者提供一种简单、高效且不依赖第三方的访问数据统计解决方案。

核心特点：

开源免费

Umami 的代码完全公开（托管在GitHub上），遵循MIT许可证，任何人都可以自由使用、修改和部署。

自托管（Self-hosted）

你可以将 Umami 部署在自己的服务器或云平台上（如VPS、Docker、Railway、Vercel等），所有数据都存储在你控制的环境中，无需依赖Google Analytics、Plausible等外部服务。

隐私友好

Umami不使用Cookie（默认情况下），不收集个人身份信息（PII），不进行用户行为追踪，符合 GDPR、CCPA 等隐私法规要求，避免法律风险。

界面简洁直观提供清晰的仪表盘，展示关键指标如：

实时访客数
页面浏览量（PV）与独立访客（UV）
流量来源（引荐网站、搜索引擎、直接访问等）
设备类型（桌面/移动）、浏览器、操作系统
热门页面、访问路径等

轻量高效

前端脚本体积小（通常 < 2KB），对网站性能影响极低；后端基于Node.js + PostgreSQL（或SQLite），资源占用少，适合个人博客、小型企业站甚至中型应用。

支持多站点管理

一个Umami实例可同时监控多个网站，并通过不同跟踪ID区分数据。

为什么选择Umami？

不想被Google Analytics的复杂设置和隐私政策困扰？
厌倦了Cookie同意弹窗影响用户体验？
希望真正拥有自己的访问数据，而不是“租用”第三方平台？

那么，Umami就是一个理想的选择——它用极简的设计，回归网站分析的本质：了解你的访客，而不打扰他们。

官网：https://umami.is
GitHub：https://github.com/umami-software/umami

如果你追求自主权、注重隐私、又希望获得专业级的流量洞察，不妨试试Umami——让数据分析，真正为你所控。

2.安装Typecho（个人网站示例）

为什么选择Typecho作为示例？

轻量级、简洁高效，契合Umami的理念

Typecho是一款基于PHP的轻量级博客系统，代码简洁、运行高效。
它不依赖臃肿的插件生态或复杂架构，和Umami的“轻量、隐私优先”理念高度一致。
两者都追求“极简主义”，避免过度工程化，非常适合对性能和隐私敏感的用户。

适合个人开发者或独立博主

Typecho常被用于搭建个人博客、技术笔记、作品集网站等，目标用户与Umami的典型使用者高度重合。
大多数使用Typecho的人更关注内容表达、数据自主权和网站安全，而非商业推广，因此对隐私保护有天然需求。

易于集成，无需复杂配置

Typecho支持在主题中直接插入自定义JavaScript代码（例如通过footer或header钩子）。
添加Umami的跟踪脚本只需在模板文件中添加一行代码，简单直观，不需要插件或数据库修改。
对于非技术人员来说，这种“零配置接入”非常友好。

Typecho支持docker一键部署：

docker run --name=typecho \
  --restart always \
  --mount type=tmpfs,destination=/tmp \
  -v ./typecho:/data \
  -e PHP_TZ=Asia/Shanghai \
  -e PHP_MAX_EXECUTION_TIME=600 \
  -p 90:80 \
  -d 80x86/typecho:latest

展示“从零开始”的完整流程

使用Typecho作为案例，可以完整展示一个“个人网站 + 自托管分析工具”的闭环：搭建网站 → 安装Umami → 配置追踪 → 查看数据
让读者更容易理解和复现整个过程，尤其适合新手入门。

强调“自主掌控”的价值观

Typecho本身是开源的，且不强制绑定第三方服务（不像某些CMS强推Google Analytics）。
结合Umami使用，能完美体现“从网站框架到数据分析，全部由我控制”的理念。
这种“端到端的自主性”正是本文的核心主张。

docker部署完成后，在浏览器中输入 http://IP:90 就能看到typecho的界面：

对typecho感兴趣的小伙伴，可以参考这篇文章：极空间NAS一键部署Typecho：开箱即用的私人博客搭建指南 - cpolar 极点云官网

3.安装Umami

通过Docker部署OneNav：

在开始部署之前，确保你的系统已经安装了 Docker。可以通过以下命令检查 Docker 是否已安装：

docker --version

mkdir -p /docker/umami
chmod -R 777 /umami

创建并编辑 docker-compose.yml文件：

vi docker-compose.yml

services:
  umami:
    image: ghcr.io/umami-software/umami:postgresql-latest
    ports:
      - "3001: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
    healthcheck:
      test: ["CMD-SHELL", "curl http://localhost:3010/api/heartbeat"]
      interval: 5s
      timeout: 5s
      retries: 5
  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:

启动容器：