Writing

2026年最新教程:用Docker给博客部署Umami统计的完整踩坑实录

手把手教你用Docker快速部署Umami网站统计工具,包含2026年最新数据库配置、Nginx反代设置和常见错误排查方案,相比Google Analytics更轻量隐私友好。

· 12 分钟阅读
目录
  1. 先看硬件要求
  2. 1. 数据库准备
  3. 2. docker-compose部署主服务
  4. 3. Nginx反向代理配置
  5. 4. 防火墙关键配置
  6. 总结

上周给博客换主题时突然发现:用了三年的老统计工具竟然停止服务了!紧急调研了一圈,最终选定开源的Umami——不仅完全自托管,数据存在自己服务器,而且界面清爽得像Notion。

📌 本文摘要:从零开始演示2026年最新版Umami的Docker部署流程,包含① PostgreSQL数据库初始化避坑、② 用docker-compose一键启动服务、③ Nginx反向代理配置模板,以及④ 解决Collector 403错误的实战经验。相比Google Analytics的15KB,Umami的统计脚本仅2KB,对小型博客尤其友好。

下面是我在雨云香港服务器(优惠码aabh享85折)上实测通过的完整步骤。

先看硬件要求

Umami官方推荐配置不高,但实测2026年的PostgreSQL 15对内存有点需求:

项目 最低配置 推荐配置
CPU核心 1核 2核
内存 512MB 2GB
磁盘空间 5GB 20GB

重要提示:如果和我一样用雨云的共享型主机(2核2G),记得先在控制台升级SWAP空间,否则编译时可能OOM崩溃:

# 查看当前swap大小
free -h
# 新增2GB交换空间(注意:重启会失效)
sudo fallocate -l 2G /swapfile && 
sudo chmod 600 /swapfile && 
sudo mkswap /swapfile && 
sudo swapon /swapfile

1. 数据库准备

Umami支持PostgreSQL和MySQL,但2026版已强制要求PG 14+。先用Docker启动数据库容器:

# 创建数据存储目录
mkdir -p ~/umami_data/postgres && cd ~/umami_data

# 启动PostgreSQL 15容器(自动创建用户和数据库)
docker run -d \
  --name umami_db \
  -e POSTGRES_DB=umami \
  -e POSTGRES_USER=umami \
  -e POSTGRES_PASSWORD=YOUR_DB_PASSWORD \
  -v $PWD/postgres:/var/lib/postgresql/data \
  -p 5432:5432 \
  postgres:15-alpine

提示:如果用云数据库服务,需在控制台放行5432端口(IP白名单更安全)。

2. docker-compose部署主服务

新建docker-compose.yml文件,注意2026年镜像已改为ghcr.io/umami-software/umami:postgresql-latest:

version: '3'
services:
  umami:
    image: ghcr.io/umami-software/umami:postgresql-latest
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: postgresql://umami:YOUR_DB_PASSWORD@umami_db:5432/umami
      DATABASE_TYPE: postgresql
      HASH_SALT: YOUR_RANDOM_STRING
    depends_on:
      - umami_db
    restart: always

启动服务前记得:

  1. 替换YOUR_DB_PASSWORD为之前设置的密码
  2. HASH_SALT建议用32位随机字符串(可用openssl rand -hex 16生成)

一键启动:

docker-compose up -d

3. Nginx反向代理配置

直接暴露3000端口不安全,建议用Nginx反代。2026年新版配置需特别注意X-Forwarded-Proto头:

server {
    listen 80;
    server_name stats.YOUR_DOMAIN.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

测试并重载配置:

sudo nginx -t && sudo systemctl reload nginx

4. 防火墙关键配置

如果访问遇到403错误,可能是UFW没放行:

# 放行PostgreSQL和Umami端口
sudo ufw allow 5432/tcp comment 'Umami DB'
sudo ufw allow 3000/tcp comment 'Umami App'

# 查看规则是否生效
sudo ufw status numbered

总结

Umami在2026年仍是自建统计的最佳选择之一,实测单日10万PV下2GB内存服务器毫无压力。部署时重点关注:① PostgreSQL版本≥14、② HASH_SALT必须设置、③ Nginx需要正确传递代理头。如果流量突然增长,建议升级到雨云的独享型套餐(输入优惠码aabh省15%)。

相关文章