351 字
1 分钟
在Mizuki上使用自托管Umami
2026-02-08
统计加载中...

前言#

前段时间把博客从 Hexo 换成了 Astro,然后发现我用的 Mizuki 主题的统计总是用不了
进了交流群才发现原来只是默认适配了Umami Cloud,并没有适配自托管Umami
后来在群友的帮助下还是找到了解决方法😋

  • 自托管Umami没有API Key这一说,用的是Bearer Token,而 Mizuki 默认只支持使用API Key,想要使用自托管我们得更改文件

准备#

先获取token

打开Hoppscotch

  • 将原先的GET改成POST,后方填

    https://<yours>/api/auth/login
    NOTE

    <yours>自托管Umami绑定的域名,后面出现请自行替换

  • Body页,Content Typeapplication/jsonRaw Request Body

    {
    "username": "Umami用户名",
    "password": "Umami密码"
    }
  • 点蓝色按钮Send,稍等片刻,下方就会出现tokene.g. 完整地复制token,并将其暂时储存在某个地方

开始#

编辑umami-share.js#

位于./public/js/

  • 将27、68行 statsUrl 后面的/v1去除
  • 将31、72行改为
    public/js/umami-share.js
    Authorization: `Bearer ${apiKey}`

编辑config.ts#

位于./src/

将最后 umamiConfig

  • apiKey填前面复制的token
    或者使用环境变量
  • baseUrl
    https://<yours>/api

结束#

  • 若对文章部分步骤有疑惑,可以打开博客源代码,对照着进行操作
  • 获取token的时候最好是用一个仅查看权限的账户,不要用管理员账户,以备有心之人
    (但是拿到token其实也干不了啥)

已知问题#

1. 文章访问量与站点访问量一致

分享

如果这篇文章对你有帮助,欢迎分享给更多人!

在Mizuki上使用自托管Umami
https://b.oxue.de/posts/selfhost-umami-on-mizuki/
作者
Kentural
发布于
2026-02-08
许可协议
CC BY-NC-SA 4.0
封面
Sample Song
Sample Artist
封面
Sample Song
Sample Artist
0:00 / 0:00