Writing
2026年最新教程:用Docker给博客部署Umami统计的完整踩坑实录
手把手教你用Docker快速部署Umami网站统计工具,包含2026年最新数据库配置、Nginx反代设置和常见错误排查方案,相比Google Analytics更轻量隐私友好。
上周给博客换主题时突然发现:用了三年的老统计工具竟然停止服务了!紧急调研了一圈,最终选定开源的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
启动服务前记得:
- 替换
YOUR_DB_PASSWORD为之前设置的密码 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%)。