阿喵前言
家里的音乐文件散在硬盘里，家人又想各听各的，难道只能继续依赖流媒体会员？Melarka 把音乐库、个人收藏和手机播放放回自家服务器，适合已有本地曲库、愿意维护一台 Docker 主机的家庭。它是免费 AGPL-3.0 开源项目；歌曲文件只读，个人资料和播放选择另存于服务端数据库。
资源介绍
Melarka 是一套面向家庭的自托管音乐服务器，服务端以 Docker 运行，家人各自拥有账号、收藏、歌单、播放记录与个人电台；可用浏览器、手机网页以及原生 iPhone、Android 客户端收听。项目也提供同步歌词、离线缓存、车载播放控制等功能。音乐可来自已有曲库；YouTube 搜索、下载和频道功能则需自行确认平台条款与内容版权。
截图
特色
- 每位家庭成员有独立的收藏、歌单、历史和语言设置。
- 歌曲标签、歌词与曲目信息可在 Melarka 内管理，不覆盖原音频文件及其标签。
- 网页和原生手机端支持后台播放、锁屏控制与收藏离线缓存；手机端还提供车载相关控制。
- 支持原音质播放或按网络情况转码，并提供私人电台、睡眠定时和歌词同步。
注意
- 需要自备 Linux 主机、Docker Compose v2 和有权使用的音乐文件；项目不附带音乐内容。
- 服务默认只监听 127.0.0.1；手机远程访问应按官方说明配置 HTTPS 反向代理，并设置强管理员密码。
- YouTube 下载使用 yt-dlp；请遵守 YouTube 条款及所在地版权法规，仅处理获准使用的内容。歌词与部分封面来源也可能使用非官方接口。
- 项目无分析与追踪；匿名安装数为可选上报，默认关闭。使用 YouTube、歌词服务或配置 Last.fm 时，服务器会连接相应服务。
使用教程
- 准备运行 Docker Compose v2 的 Linux 主机，并整理好自己拥有或获准使用的音乐目录。
- 按官方安装说明部署容器，首次登录后立即修改管理员密码，并在管理页为家人分别创建账号。
- 添加音乐目录，等待扫描完成；然后在网页或手机客户端登录，分别创建收藏和歌单。
- 如需在家庭网络外通过手机连接，先配置 HTTPS 反向代理，再访问服务地址；不要把未加密的管理端口直接暴露到公网。
项目介绍页的截图和演示使用虚构歌曲、测试音与生成封面，不代表用户自己的曲库内容。
