Melarka

在这个音乐被“租”而非“拥有”的时代，你是否也有过这样的瞬间：

• 收藏多年的歌单突然灰了一片，版权到期说没就没；
• Spotify/Apple Music 家庭组又涨价了，还得跟家人抢设备；
• 辛辛苦苦整理的本地无损音乐，在手机上播放体验却像上个世纪的产品；
• 想在车里无缝续播家里的歌单，却被各种蓝牙断连和App切换折磨到崩溃。

如果你也渴望一个完全属于自己、全家共享、且体验媲美主流流媒体的音乐方案，今天必须给你安利这款堪称 “自托管音乐服务器天花板” 的开源项目——Melarka。

它不是又一个笨重的 Plex/Jellyfin 插件，而是一个从底层为“听歌”这件事重新设计的现代音乐服务器。一条 Docker 命令安装，iOS/Android/Web 三端原生体验，你的音乐文件永远属于你。

• 官网：https://melarka.zexa.se
• GitHub：https://github.com/aaronsuns/melarka
• 网盘：https://pan.quark.cn/s/0146e40d7d1b 提取码：gvDY

1. 核心哲学：只读你的文件，元数据独立管理

很多音乐服务器最让人头疼的是“扫库即改文件”——标签被重写、文件名被篡改、精心整理的目录结构一片狼藉。

Melarka 采取了完全不同的策略：你的音乐文件夹是只读的。

• 标题、艺术家、专辑、年份的修改作为“覆盖层”存在 Melarka 自己的数据库中，绝不触碰原始文件。
• 歌词、播放列表、收藏、历史记录全部独立存储。
• 即使你删掉 Melarka，你的音乐文件依然完好如初。

这意味着你可以放心地把几十年积累的无损收藏指向它，而不必担心任何“意外损坏”。

2. 三层音质 + 即时转码：兼顾发烧与省流

Melarka 内置了智能音质分层策略：

• 🎵 无损模式：播放器支持时直接串流原始文件（FLAC/WAV/APE）。
• 🔊 高质量模式：AAC 最高 256 kbps，日常聆听绰绰有余。
• 💾 节省模式：AAC 最高 128 kbps，隧道、地铁、漫游时的救命稻草。

所有转码即时完成并缓存，同一首歌不会重复转码。配合 Web 端和移动端的离线缓存功能，收藏的歌曲会以高质量留在手机上，在无网络环境下继续播放。

3. 全平台原生体验：不是网页套壳

这是 Melarka 区别于大多数自托管音乐项目的最大优势：

• 📱 iPhone 应用：原生播放引擎，后台播放、锁屏控制、车载 CarPlay 续播、离线缓存一应俱全。不在 App Store，通过 SideStore 或 Xcode 自签安装（免费 Apple ID 即可）。
• 🤖 Android 应用：签名 APK 直接安装，支持后台播放、无缝过渡、蓝牙车载自动播放、启动器快捷方式。
• 🌐 Web 应用：可添加到手机主屏幕全屏运行，带锁屏控制，桌面浏览器同样完美适配。

每个客户端都实现了手动队列编辑（拖拽排序、滑动移除）、渐出睡眠定时器和音量归一化，体验细节对标商业产品。

4. 歌词同步 + YouTube 集成：补齐最后一块拼图

• 🎤 智能歌词：支持内嵌歌词、.lrc 文件和在线歌词源（网易云、QQ音乐、酷狗等非官方API可选）。每个人都可以手动调整歌词偏移或对齐到当前演唱行，修正后全局生效。错误歌词可举报，自动切换到下一个最佳版本。
• 📺 YouTube 深度集成：搜索、下载单曲或整个播放列表（最多200条），下载的播放列表自动成为 Melarka 播放列表。支持预览后再保留，避免下载后悔。频道订阅后新剧集自动下载，带续播和倍速控制。
• 🧠 “为你推荐”：每晚根据你播放和收藏最多的内容，智能推荐你还没有的 YouTube 歌曲。

5. 一条命令安装：极简部署体验

在装有 Docker 的 Linux 服务器上，只需一行：

curl -fsSL https://raw.githubusercontent.com/aaronsuns/melarka/main/deploy/install.sh | sh

安装程序会自动创建 docker-compose.yml、生成管理员密码、设置目录权限并启动服务。已有音乐文件夹？追加路径即可：

curl -fsSL https://raw.githubusercontent.com/aaronsuns/melarka/main/deploy/install.sh | sh -s -- /path/to/your/music

升级时再次运行相同命令，配置和数据完整保留。

6. 反向代理与 HTTPS：手机访问必备

Melarka 默认仅监听 127.0.0.1:4600。要从手机访问（iPhone 应用强制要求 HTTPS），需在前面加一层反向代理。

Caddy 用户（推荐，自动证书）：

music.example.com {
    reverse_proxy 127.0.0.1:4600 {
        flush_interval -1
    }
}

Nginx 用户需注意流媒体接口的特殊配置（关闭缓冲、延长超时），并用 certbot 获取证书。文档中有完整 nginx 配置示例。

7. 备份与安全提醒

• 备份重点：data/lark.db（数据库）、channels/、youtube/、配置文件。
• 音乐目录无需备份：Melarka 从不修改它。
• 数据库备份：WAL 模式下不要在运行时直接复制 .db 文件，使用 sqlite3 .backup 或先停容器。
• ⚠️ 免责声明：YouTube 功能基于 yt-dlp，请遵守 YouTube TOS 和当地版权法，仅下载你有权使用的内容。Melarka 不附带任何音乐、歌词或视频内容。

Melarka解决了自托管音乐长久以来的三大痛点：文件安全、移动端体验、以及流媒体功能的完整性。无论你是想给全家人搭建一个私有的“Spotify”，还是想让珍藏的无损收藏在手机和车上焕发新生，Melarka 都值得你花 10 分钟部署一试。