如何用Docker 5分钟部署Koito:最简单自托管听歌统计工具快速上手教程
发布时间:2026/10/15 22:03:30 锦皓数字建站

【免费下载链接】KoitoKoito is a modern, themeable scrobbler that you can use with any program that scrobbles to a custom ListenBrainz URL项目地址https://gitcode.com/gh_mirrors/ko/Koito点击查看免费下载Koito 是一款现代、可换肤的自托管听歌统计工具scrobbler兼容所有支持自定义 ListenBrainz 地址的客户端。它比同类软件更快UI 更精致还能把数据中转到你现有的 ListenBrainz 服务让你可以放心试用。下面这份 Koito Docker 部署教程带你 5 分钟跑起自己的听歌统计面板。一、Koito 能做什么部署完成后Koito 首页会展示你的全部听歌数据全时段统计总收听时长、播放次数、曲库规模活动热力图按星期/时段展示听歌活跃程度Top 榜单热门歌手、专辑、歌曲排行榜️Rewind 月度回顾每月自动生成你的年度盘点数据导入支持从 Spotify、Maloja、LastFM、ListenBrainz 一键导入历史数据二、一键部署最小化 Docker Compose 配置只要你的机器上装好了 Docker含 Compose 插件整个部署就是一条命令的事。新建compose.yaml粘贴官方推荐的最小配置来源installation.mdservices: koito: image: gabehf/koito:latest container_name: koito ports: - 4110:4110 volumes: - ./koito:/etc/koito restart: unless-stopped然后执行docker compose up -d等镜像拉取完成打开浏览器访问http://你的服务器地址:4110就能看到登录界面了。 所有数据都通过 SQLite 存储在挂载的./koito目录中备份时只需要备份这一个文件夹非常省心。三、首次登录与账号设置首次启动会默认创建一个用户用户名admin密码changeme登录后请务必修改密码。之后可以随时修改默认账号、端口、主题等参数完整配置项参考 configuration.md最常用的是这几个环境变量默认值说明KOITO_DEFAULT_USERNAMEadmin首次启动创建的用户名KOITO_DEFAULT_PASSWORDchangeme首次启动创建的密码KOITO_LISTEN_PORT4110服务监听端口KOITO_DEFAULT_THEMEyuu默认主题KOITO_LOGIN_GATEfalse设为true后未登录不可查看统计KOITO_SKIP_IMPORTfalse设为true跳过启动时自动导入修改后执行docker compose up -d重新加载即可。四、配置 Scrobble让播放器自动上报想让听歌行为自动记录只需两步1️⃣ 获取 API Key登录 Koito按\打开设置面板进入API Keys标签页复制自动生成的 API Key这一步在 scrobbler.md 中有详细说明。2️⃣ 在播放器中指向 Koito以 Navidrome 为例将 scrobble 地址设为{你的Koito地址}/apis/listenbrainz/1Token 填刚才复制的 API Key。以 Navidrome 为例还需在 Navidrome 的环境变量中加上ND_LISTENBRAINZ_ENABLEDtrue ND_LISTENBRAINZ_BASEURL你的Koito地址/apis/listenbrainz/1随后在 Navidrome 个人设置里打开Scrobble to ListenBrainz开关保存后你每听一首歌数据就会实时进入 Koito。 小技巧如果暂时不想完全替换现有 scrobbler可以开启KOITO_ENABLE_LBZ_RELAYKOITO_LBZ_RELAY_URLKOITO_LBZ_RELAY_TOKEN三个环境变量把 Koito 收到的数据同步转发到你原来的 ListenBrainz 服务双保险零风险。五、导入历史听歌数据从零开始积累有点慢Koito 支持从 Spotify、Maloja、LastFM、ListenBrainz 导入历史数据。以 Spotify 为例详见 importing.md在 Spotify 账号隐私页申请Extended streaming history数据导出拿到.json文件后放入配置目录的import文件夹即宿主机./koito/import/文件名需包含Streaming_History_Audio字样执行docker compose restart koito导入自动开始其他来源同样丢文件进import文件夹 重启即可文件名需包含对应关键词maloja/recenttracks/listenbrainz。⏱️ 大数据量导入时MusicBrainz 匹配按每秒 1 次限速可能需要较长时间耐心等待即可。六、看看效果Rewind 月度回顾等数据积累一些后侧边栏的 Rewind 页面会按月生成漂亮的听歌回顾包括当月 Top 歌手、Top 专辑、Top 歌曲和各项统计非常值得每月截一张图留念七、常见问题速查问题解决办法容器启动后立即退出多为 Subsonic 参数错误执行docker logs koito查看日志想换端口修改 compose 中的4110:4110映射或设置KOITO_LISTEN_PORT想公开分享设置KOITO_LOGIN_GATEfalse默认即公开完整构建说明后端/前端多阶段构建见 Dockerfile整体介绍见 README.md至此你的自托管听歌统计站已经完整上线了 更多高级玩法别名合并、图片替换、编辑管理可继续探索 docs/src/content/docs/guides/ 下的官方指南。赞分享【免费下载链接】KoitoKoito is a modern, themeable scrobbler that you can use with any program that scrobbles to a custom ListenBrainz URL项目地址https://gitcode.com/gh_mirrors/ko/Koito点击查看免费下载相关推荐如何用Docker Compose快速部署TaskView5分钟搭建自托管项目服务器的新手教程如何用Docker Compose快速部署TaskView5分钟搭建自托管项目服务器的新手教程 TaskView 是一款开源的自托管项目与任务管理平台提供看5分钟快速上手Sentry自托管Docker Compose一键部署终极指南5分钟快速上手Sentry自托管Docker Compose一键部署终极指南 想要 快速搭建 功能完整的Sentry监控系统吗gh_mirrors/se/s运维云原生可观测性如何快速部署Aurora博客系统5分钟上手教程如何快速部署Aurora博客系统5分钟上手教程 想要快速搭建一个功能完整的个人博客系统吗Aurora博客系统基于SpringBootVue开发提供了现代后端前端CMS创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
锦
锦皓数字建站
深耕本土企业品牌数字化升级,专注原创端正雅致商务官网,从视觉设计到稳定运维全程保驾护航。