Halo 博客折腾音乐播放器避坑全记录

踩坑总结

1. 不要随意使用网上陌生公共 Meting API，大量域名已无法解析

2. 不要轻易服务器部署自建接口，容易占用端口、打乱原有网站配置

3. 侧边栏不显示播放器，90% 是 widget 部件列表未添加 music 项

4. 能显示不能播放，一律是接口失效，不是主题与网站故障

5. 中途终止服务器部署命令，不会残留垃圾，网站不会受到任何影响

最佳实践

1. Fuwari 主题优先使用原生侧边音乐组件，不用悬浮播放器

2. 平台优先选择网易云，播放稳定无版权拦截

3. 不擅自修改 Nginx、域名反向代理，避免博客无法访问

4. 主题修改后务必重新打包构建，覆盖部署完整主题包

5. 配置修改完成后重启 Halo 服务，确保配置完全生效

最终成品效果

侧边栏高颜值音乐播放器正常展示、正常播放、样式贴合主题，博客整体美观整洁，无报错、无兼容问题，长期稳定运行。