使用 Vercel 部署 Umami 网站统计服务 2025最新教程

飔梦2025-02-142025-06-28

Image description

引言

Umami 是一个开源的自托管网站分析工具，主要用于提供简洁、隐私友好的网站访问数据统计。它是 Google Analytics 的替代方案，特别适用于希望保护用户隐私、不依赖第三方服务的个人和企业网站。

Umami 的主要特点

✅ 隐私保护：不使用 Cookie，不收集个人数据，符合 GDPR、CCPA 等隐私法规。
✅ 开源自托管：基于 MIT 许可，可自行部署在服务器上，无需依赖外部服务。
✅ 轻量高效：数据存储优化，不影响网站性能，支持 PostgreSQL 和 MySQL。
✅ 实时分析：提供实时访问数据，包括页面浏览量、来源、设备类型、操作系统等。
✅ 多网站管理：支持多个网站的访问数据分析，适合个人开发者和企业使用。
✅ 简单易用：提供直观的仪表盘，可轻松查看访客流量、流量来源、热门页面等。
✅ API 支持：可通过 API 获取数据，方便与其他系统集成。

Umami 部署方式

你可以使用 Docker 进行快速部署，例如：

docker run -d --name umami -p 3000:3000 \
  -e DATABASE_URL=mysql://user:password@host:port/dbname \
  ghcr.io/umami-software/umami:latest

或者使用 Vercel、Railway 进行无服务器部署（本教程使用Vercel部署）。

适用场景

个人博客：获取访问数据，优化内容策略。
企业官网：监测用户行为，提高转化率。
SaaS 平台：分析用户交互，优化产品体验。
开发者项目：轻量级网站流量统计工具，替代 Google Analytics。

准备工作

Github 账号
Vercel 账号
数据库
自己的域名（可选）

部署完成之后默认会给你的项目分配一个 vercel.app 的三级域名，但是在 2021 年 vercel.app 域名被墙，大陆地区无法访问，因此强烈建议自己准备域名

开始

Fork 官方 GitHub 仓库
打开 Vercel 然后通过 GitHub 快捷登录
打开 Storage 选项卡创建 PostgreSQL
不一定要在此处创建，可以在 Supabase 或 Neon（Vercel PostgreSQL 服务供应商）等平台免费创建
打开 Dashboard，点击 Add new - Project
Import Git Repository 选择 Continue With GitHub
此时会跳转到 GitHub 批准 Vercel 访问，建议选择允许访问全部仓库，当然你也可以设置仅可访问部分仓库。

6.选择你复刻的仓库

7.设置部署参数和环境变量：

变量名：HASH_SALT 值：自定义字符串
变量名：DATABASE_URL 值：数据库链接
例：postgresql://username:mypassword@localhost:5432/mydb mysql://username:mypassword@localhost:3306/mydb
变量名：TRACKER_SCRIPT_NAME 值：自定义统计脚本名