使用Docker搭建Umami统计，显示近一年的pv、uv数据的API搭建
内容提要
百度统计使用unload导致浏览器报错和性能问题，选择自搭建umami。部署umami遇到问题，发现教程不对。提供新的docker-compose配置教程。添加反代宝塔，设置umami用户名和密码。添加网站和插入统计代码。umami支持PWA。给butterfly的小伙伴提供pug代码。基于前端调用Umami API数据，写新的api。在宝塔中部署php项目，上传umami.php文件。
延伸解读
自建统计的隐私与性能考量
文章指出百度统计使用unload事件会导致浏览器报错和性能问题，且容易被广告插件屏蔽，无法获取真实数据。自搭建umami后，访客数据不再传输给第三方，既避免了隐私风险，也提升了数据准确性。对于注重访客隐私和统计可靠性的站长，这是一个值得考虑的替代方案。
Docker部署中的镜像拉取陷阱
作者在部署umami时遇到docker镜像拉取失败的问题，更换多个加速地址仍无效，最终发现网上教程使用的镜像地址并非来自Docker Hub。文中提供的docker-compose配置使用了umamisoftware/umami:postgresql-latest镜像，并搭配PostgreSQL数据库，同时提醒可修改端口映射中的主机端口以避免冲突。
前端数据展示的API桥接方案
为了在博客前端展示近一年的PV、UV数据，作者参考林木木的前端调用方案，基于Umami API编写了新的接口。具体步骤包括通过Hoppscotch获取token，然后修改HeoPVBridge中的umami.php文件，填入地址、token和网站ID，最后部署到PHP项目中。这为需要展示统计数据的用户提供了可复用的思路。
Butterfly主题的集成与PWA支持
文章为Butterfly主题提供了pug代码示例，通过编辑analytics.pug文件并添加主题配置项即可集成umami统计代码。同时指出umami支持PWA，因此无需额外考虑pjax等因素，简化了集成过程。对于使用该主题的站长，这些代码和说明能帮助快速完成部署。
Q&A
为什么选择自搭建Umami而不是使用百度统计？
选择自搭建Umami是因为百度统计使用unload导致浏览器报错和性能问题，同时去广告插件屏蔽了百度统计，无法获取真实数据，且自搭建可以保护访客隐私。
如何解决Docker镜像拉取问题？
在部署Umami时，需使用新的docker-compose配置，确保使用正确的镜像地址，并通过SSH访问服务器执行docker-compose up -d来完成配置。
Umami的默认用户名和密码是什么？
Umami的默认用户名是admin，默认密码是umami，建议在首次登录后修改密码。
如何在Umami中添加网站并插入统计代码？
在Umami中添加网站时，进入设置并点击添加网站，设置名称和地址，然后将统计代码插入到每个页面的head中。
Umami支持哪些功能？
Umami支持PWA功能，无需考虑pjax等因素，方便用户使用。
如何在宝塔中部署PHP项目？
在宝塔中部署PHP项目时，需添加一个站点，确保PHP版本正确，然后将PHP文件上传到对应目录即可通过域名访问。
