Repolode
提交项目
krateng

krateng/maloja

自托管的音乐 scrobble 数据库，记录听歌历史并生成个人听歌统计与排行榜。

可替代:Last.fm

在 GitHub 查看官网
Star
1,858
Fork
101
未关闭 Issue
135
最近提交
21小时前

这是什么？

Maloja 是一个自托管服务器，用来收集音乐 scrobble（即音乐播放器上报的播放记录），并将其整理成个人听歌统计和排行榜。音乐库保存在本地，不与公共音乐数据库同步，因此可以按自己的标签习惯整理数据。

它兼容标准 API，现有的 scrobbler 应用和扩展可以直接向它上报播放记录；代理转发功能还能把记录同步到其他服务。对于没有接入设备的播放场景（如黑胶或背景音乐），可以在网页界面手动添加记录。数据可从 Last.fm、Spotify、ListenBrainz 导出文件或另一个 Maloja 实例导入。

项目推荐通过 Docker 或 Podman 运行，不建议直接在裸机上安装。它支持关联艺人、多艺人曲目、自定义图片和自定义规则，刻意不包含社交、电台和推荐等功能。

核心功能

  • 01将播放记录以易于解析的格式保存在本地
  • 02可关联艺人的子组合、合作项目和个人单飞作品，且修改关联不丢失信息
  • 03多艺人和 featuring 曲目中，每位艺人单独参与排行统计
  • 04通过代理转发功能将 scrobble 同步到其他服务
  • 05兼容支持自定义 Listenbrainz 或 GNUFM 服务器的播放客户端
  • 06支持上传自定义艺人和曲目图片

适用场景

  • 长期私密记录自己的听歌习惯
  • 记录黑胶唱片或背景音乐等无法通过应用上报的播放
  • 从 Last.fm 或 Spotify 导出文件导入多年历史数据
  • 在家庭服务器上搭建个人听歌统计页面

快速上手

  1. 1

    使用挂载的数据文件夹运行 Docker 容器

    docker run -p 42010:42010 -v $PWD/malojadata:/mljdata -e MALOJA_DATA_DIRECTORY=/mljdata krateng/maloja
  2. 2

    在浏览器中打开 localhost:42010 访问网页界面

使用前须知

  • 项目目前仅接收安全更新，作者正在开发后继项目 maloja-rs。
  • README 不建议裸机安装，且不提供此类安装的支持；请使用 Docker 或 Podman。
  • 显示艺人图片需要免费的 Last.fm 和 Spotify API 密钥。

收录于专题

自托管应用数据科学课程与工具

标签

#music#scrobble#self-hosted#statistics#listening-habits#charts#docker

常见问题

maloja 是什么？
自托管的音乐 scrobble 数据库，记录听歌历史并生成个人听歌统计与排行榜。 Maloja 是一个自托管服务器，用来收集音乐 scrobble（即音乐播放器上报的播放记录），并将其整理成个人听歌统计和排行榜。音乐库保存在本地，不与公共音乐数据库同步，因此可以按自己的标签习惯整理数据。
maloja 可以免费使用吗？用的什么许可证？
maloja 以 GPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。
maloja 还在维护吗？
活跃维护中。maloja 最近一次提交是在 2026年11月6日。
maloja 适合用来做什么？
长期私密记录自己的听歌习惯 记录黑胶唱片或背景音乐等无法通过应用上报的播放 从 Last.fm 或 Spotify 导出文件导入多年历史数据 在家庭服务器上搭建个人听歌统计页面
maloja 怎么安装和运行？
使用挂载的数据文件夹运行 Docker 容器: docker run -p 42010:42010 -v $PWD/malojadata:/mljdata -e MALOJA_DATA_DIRECTORY=/mljdata krateng/maloja 在浏览器中打开 localhost:42010 访问网页界面
在哪里获取 maloja？
源代码和安装说明在 GitHub 上：https://github.com/krateng/maloja

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目