CMSZ Blog

使用 Umami 搭建网站统计工具

Sun, 12 Apr 2026 03:00:00 GMT

::github{repo="umami-software/umami"}

准备的东西

一台能运行Docker Compose的服务器
良好的网络环境

安装 Docker

运行

bash <(curl -sSL https://linuxmirrors.cn/docker.sh)

并按照指示安装 Docker

部署 Umami

创建运行文件夹

mkdir /path/to/umami/ && cd /path/to/umami/

创建 Docker Compose 文件

touch compose.yml

然后使用文本编辑器nano或 vim将下方代码填入 compose.yml

services:
  umami:
    image: ghcr.nju.edu.cn/umami-software/umami:latest
    container_name: umami
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: postgresql://umami:umami@db:5432/umami
      APP_SECRET: replace-me-with-a-random-string
    depends_on:
      db:
        condition: service_healthy
    init: true
    restart: always
    healthcheck:
      test: ["CMD-SHELL", "curl http://127.0.0.1:23000/api/heartbeat"]
      interval: 5s
      timeout: 5s
      retries: 5
  db:
    image: postgres:15-alpine
    container_name: umami-db
    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:

其中的APP_SECRET可以使用Credentials Generator | LibreChat生成后的JWT_SECRET里的内容或使用以下命令生成一个：

openssl rand -hex 32

🚀启动

docker compose up -d

登录后台

访问127.0.0.1:3000并使用默认的账户信息登录：

账号：admin
密码：umami 登录后，点击侧边导航栏中的个人资料按钮，然后点击Settings。接着导航至Profile并点击 Change password 按钮。

添加站点

访问/websites
点击添加网站的按钮，然后填写名字和域名
点击编辑，将跟踪代码填写到网站的<head>内

配置

通过在/path/to/umami/创建.env文件或修改compose.yml中的environment去修改配置，参考Environment variables，下方是一些配置

APP_SECRET v1.0.0

用于保护身份验证令牌的随机字符串。每个安装实例都应有一个唯一值。你可以使用以下命令生成一个：
openssl rand -hex 32
APP_SECRET = "random string"
CLIENT_IP_HEADER v1.24.0

用于检查客户端 IP 地址的 HTTP 头。当你位于使用非标准头的代理之后时，此变量很有用。
CLIENT_IP_HEADER = "header name"
COLLECT_API_ENDPOINT v1.34.0

允许你将指标发送到与默认 /api/send 不同的位置。这有助于规避某些广告拦截器。
COLLECT_API_ENDPOINT = "/my-custom-route"
CORS_MAX_AGE v2.0.0

CORS 预检请求的缓存时间（秒）。默认为 24 小时。
CORS_MAX_AGE = 86400
DATABASE_URL v1.0.0
DATABASE_URL = "connection string"
数据库的连接字符串。这是唯一必需的变量。

DEBUG v2.0.0

针对应用程序特定区域的日志输出。可选值包括 umami:auth、umami:clickhouse、umami:kafka、umami:middleware 和 umami:prisma。
DEBUG = "umami:*"
DISABLE_BOT_CHECK v2.0.0

默认情况下，机器人流量会被排除在统计之外。此变量用于禁用机器人检测。
DISABLE_BOT_CHECK = 1
DISABLE_LOGIN v1.26.0

禁用应用程序的登录页面。
DISABLE_LOGIN = 1
DISABLE_UPDATES v1.33.0

禁用对 Umami 新版本的检查。
DISABLE_UPDATES = 1
DISABLE_TELEMETRY v2.0.0

Umami 会收集完全匿名的遥测数据以帮助改进应用程序。如果你不想参与，可以选择禁用此功能。
DISABLE_TELEMETRY = 1
ENABLE_TEST_CONSOLE v2.0.0

启用内部测试页面 {host}/console。需要管理员权限。用户可以在该页面向其网站手动触发页面浏览和事件。
ENABLE_TEST_CONSOLE = 1
FAVICON_URL v2.18.0

用于显示网站图标的服务 URL。
FAVICON_URL = "service URL"
默认为 icons.duckduckgo.com：

https://icons.duckduckgo.com/ip3/{{domain}}.ico（中国大陆访问不佳）

你可以使用以下备选方案：

https://www.google.com/s2/favicons?domain={{domain}}

https://logo.clearbit.com/{{domain}}

https://favicon.im/{{domain}}

GEO_DATABASE_URL v2.0.0

用于下载 MaxMind 兼容的 MMDB 格式 GeoIP 数据库的 URL。当来自 CDN 的位置头不可用时，用于基于 IP 的位置检测。
GEO_DATABASE_URL = "https://example.com/GeoLite2-City.mmdb"
HOSTNAME / PORT v1.0.0

如果你运行的环境要求绑定到特定的主机名或端口（例如 Heroku），你可以添加这些变量，并使用 npm run start-env 而非 npm start 来启动应用。
HOSTNAME = "my.hostname.com"
PORT = 3000
IGNORE_IP v1.0.0

你可以提供一个以逗号分隔的 IP 地址和 CIDR 范围列表，以将其排除在数据收集之外。
IGNORE_IP = "192.168.0.1, 10.0.0.0/24, 2001:db8::/32"
LOG_QUERY v2.0.0

如果你在开发模式下运行，此变量会将数据库查询记录到控制台以供调试。
LOG_QUERY = 1
PRIVATE_MODE v2.11.0

禁用所有外部网络调用。请注意，由于网站图标来自 duckduckgo.com，此操作也会禁用所有网站图标。
PRIVATE_MODE = 1
REMOVE_TRAILING_SLASH v1.26.0

移除所有传入 URL 末尾的斜杠。
REMOVE_TRAILING_SLASH = 1
TRACKER_SCRIPT_NAME v1.26.0

允许你为跟踪脚本指定一个自定义名称，以区别于默认的 script.js。这有助于规避某些广告拦截器。

不需要 .js 扩展名。该值也可以是你选择的任何路径，例如 /path/to/tracker。
TRACKER_SCRIPT_NAME = "custom-script-name.js"
SKIP_LOCATION_HEADERS v2.15.0

跳过使用已知的位置头进行国家/地区/城市检测，强制使用本地 Geo 数据库。

这在代理或 CDN 仅设置了国家（不含地区或城市）头的环境中很有用（例如当 Cloudflare 的 Network > IP Geolocation 开关打开时，仅提供 CF-IPCountry 头）。
SKIP_LOCATION_HEADERS = 1
ALLOWED_FRAME_URLS v2.3.0

一个以空格分隔的 URL 列表，允许其在 iframe 中托管该应用程序。
ALLOWED_FRAME_URLS = "URLs"
BASE_PATH v1.9.0

如果你想将 Umami 托管在子目录下，请设置此变量。你可能需要更新反向代理设置以正确处理 BASE_PATH 前缀。
BASE_PATH = "/custom"
DATABASE_TYPE v2.0.0
DATABASE_TYPE = "postgresql"
要使用的数据库类型。仅 Docker 构建时需要。

FORCE_SSL v1.0.0

此设置将在所有请求的响应头中添加 HTTP Strict-Transport-Security。请参阅 MDN 文档。
FORCE_SSL = 1
SKIP_DB_CHECK v2.0.0

在构建过程中跳过 check-db 步骤。用于 Docker 构建。
SKIP_DB_CHECK = 1
SKIP_DB_MIGRATION v2.0.0

在构建过程中跳过 Prisma 迁移步骤。设置 SKIP_DB_CHECK 也会跳过此步骤。
SKIP_DB_MIGRATION = 1

更新 Umami

当有新版本发布时，可以按照以下步骤进行更新：

cd /path/to/umami/

拉取最新镜像并重新启动服务：

docker compose down
docker compose pull
docker compose up -d

参考资料

Astro+Fuwari博客部署教程

Tue, 05 Aug 2025 04:30:00 GMT

::github{repo="saicaca/fuwari"}

准备的东西

聪明的脑子，不会的先搜索，搜索不到就~~去和AI调情~~。
版本控制系统（Git），也可以使用Github Desktop。
Fuwari的初始化和预览需要Node.js — Run JavaScript Everywhere。
Markdown编辑器，例如Visual Studio Code、marktext等。
一个Git远程仓库，例如Github、GitLab等（可选）
PaaS平台，例如Netlify、Vercel等（可选）

让我们开始吧

🚀 使用方法 1

使用 create-fuwari 在本地初始化项目。

# npm
npm create fuwari@latest

# yarn
yarn create fuwari

# pnpm
pnpm create fuwari@latest

# bun
bun create fuwari@latest

# deno
deno run -A npm:create-fuwari@latest

通过配置文件 src/config.ts 自定义博客
执行 pnpm new-post <filename> 创建新文章，并在 src/content/posts/ 目录中编辑
参考官方指南将博客部署至 Vercel, Netlify, GitHub Pages 等；部署前需编辑 astro.config.mjs 中的站点设置。

🚀 使用方法 2

使用此模板生成新仓库或 Fork 此仓库
进行本地开发，Clone 新的仓库，执行 pnpm install 和 pnpm add sharp 以安装依赖
- 若未安装 pnpm，执行 npm install -g pnpm
通过配置文件 src/config.ts 自定义博客
执行 pnpm new-post <filename> 创建新文章，并在 src/content/posts/ 目录中编辑
参考官方指南将博客部署至 Vercel, Netlify, GitHub Pages 等；部署前需编辑 astro.config.mjs 中的站点设置。

修改配置文件

astro.config.mjs

请自行阅读Astro 配置文件
src\config.ts（其他的请自行翻译注释）
- title：博客主标题
- subtitle：博客副标题，会显示为title - subtitle
- lang：博客的语言，支持'en', 'zh-CN', 'zh_TW', 'ja', 'ko', 'es', 'th', 'vi'等
- themeColor
  - hue：博客主题色主题颜色的默认色调，范围从 0 到 360。例如，红色：0，青色：200，青蓝色：250，粉色：345
  - fixed：是否隐藏主题颜色选择器给访客

引用自 Fuwari静态博客搭建教程 - AcoFork Blog

banner：src：即banner图片，支持http/https URL

favicon：src：即网站图标，支持http/https URL

links：即友情链接，这些链接在导航栏上

avatar：即你的头像

name：即你的名字

bio：即个性签名，会显示在头像和名字下面

NavBarConfig 为导航栏设置的超链接。ProfileConfig 为你的用户的超链接

icon：你需要前往icones.js.org去搜索你想要的图标，比如QQ，则填写 fa6-brands:qq ，如图。Fuwari默认支持这几种类型：fa6-brands, fa6-regular, fa6-solid, material-symbols。可以在 astro.config.mjs 中搜索关键字进行配置

部署到PaaS平台

部署的前提已推送到远程仓库

Vercel

可参考部署你的 Astro 站点至 Vercel | Docs

向Astro 项目中添加 Vercel 适配器以开启按需渲染。
打开Vercel并创建项目

构建静态页面

🎉 恭喜你，你的Astro+Fuwari博客已部署完成

记录

Fri, 01 Jan 1999 00:00:00 GMT

记录

仅记录**~~奇怪的~~**

图片压缩 Squoosh

squoosh.app

Termux-zsh

::github{repo="Sohil876/Termux-zsh"}

CMSZ Blog

使用 Umami 搭建网站统计工具

准备的东西

安装 Docker

部署 Umami

登录后台

添加站点

配置

APP_SECRET v1.0.0

CLIENT_IP_HEADER v1.24.0

COLLECT_API_ENDPOINT v1.34.0

CORS_MAX_AGE v2.0.0

DATABASE_URL v1.0.0

DEBUG v2.0.0

DISABLE_BOT_CHECK v2.0.0

DISABLE_LOGIN v1.26.0

DISABLE_UPDATES v1.33.0

DISABLE_TELEMETRY v2.0.0

ENABLE_TEST_CONSOLE v2.0.0

FAVICON_URL v2.18.0

GEO_DATABASE_URL v2.0.0

HOSTNAME / PORT v1.0.0

IGNORE_IP v1.0.0

LOG_QUERY v2.0.0

PRIVATE_MODE v2.11.0

REMOVE_TRAILING_SLASH v1.26.0

TRACKER_SCRIPT_NAME v1.26.0

SKIP_LOCATION_HEADERS v2.15.0

ALLOWED_FRAME_URLS v2.3.0

BASE_PATH v1.9.0

DATABASE_TYPE v2.0.0

FORCE_SSL v1.0.0

SKIP_DB_CHECK v2.0.0

SKIP_DB_MIGRATION v2.0.0

更新 Umami

参考资料

Astro+Fuwari博客部署教程

准备的东西

让我们开始吧

🚀 使用方法 1

🚀 使用方法 2

修改配置文件

部署到PaaS平台

Vercel

记录

记录

图片压缩 Squoosh

Termux-zsh

APP_SECRET `v1.0.0`

CLIENT_IP_HEADER `v1.24.0`

COLLECT_API_ENDPOINT `v1.34.0`

CORS_MAX_AGE `v2.0.0`

DATABASE_URL `v1.0.0`

DEBUG `v2.0.0`

DISABLE_BOT_CHECK `v2.0.0`

DISABLE_LOGIN `v1.26.0`

DISABLE_UPDATES `v1.33.0`

DISABLE_TELEMETRY `v2.0.0`

ENABLE_TEST_CONSOLE `v2.0.0`

FAVICON_URL `v2.18.0`

GEO_DATABASE_URL `v2.0.0`

HOSTNAME / PORT `v1.0.0`

IGNORE_IP `v1.0.0`

LOG_QUERY `v2.0.0`

PRIVATE_MODE `v2.11.0`

REMOVE_TRAILING_SLASH `v1.26.0`

TRACKER_SCRIPT_NAME `v1.26.0`

SKIP_LOCATION_HEADERS `v2.15.0`

ALLOWED_FRAME_URLS `v2.3.0`

BASE_PATH `v1.9.0`

DATABASE_TYPE `v2.0.0`

FORCE_SSL `v1.0.0`

SKIP_DB_CHECK `v2.0.0`

SKIP_DB_MIGRATION `v2.0.0`