Melarka

自建音乐服务器:给全家用,一条命令装好

自建音乐服务器的好处是音乐留在自己手里,不用订阅,也不会下架。Melarka 把服务器和手机 App 一起做好了:装好之后,全家人各自用自己的账号听歌。

需要什么

一条命令安装

在服务器上运行下面的命令,最后换成你的音乐文件夹路径;不加路径,音乐就放在 ~/melarka/music。安装脚本会配好 Docker Compose 服务(普通用户装在 ~/melarka,root 装在 /srv/melarka)、启动,并打印地址和管理员密码。

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

然后:

  1. 在服务器上打开 http://127.0.0.1:4600,用 admin 和打印出来的密码登录。
  2. 在 管理 → 用户 里给家人建账号。
  3. 手机上用之前,配好 HTTPS(README 有 Caddy 和 nginx 示例),再装 App。

全家每人一个账号

每个人有自己的收藏、歌单、播放历史、私人电台和每晚的「为你推荐」,界面语言也各自选(English、简体中文、繁體中文、svenska)。曲库是共享的:谁下载的好歌,全家都能听到。

同步歌词、离线缓存、车载播放

在中国大陆使用

你自己的音乐、歌词和 App 不需要任何代理。YouTube 搜索、下载和频道被屏蔽,需要在服务器上配置代理,手机不需要。网易云、QQ 音乐、酷狗是非官方接口,可能随时失效,可以在 lyrics.providers 里去掉。详见 docs/install.md。

备份和升级

备份 data/lark.db(运行中请用 sqlite3 data/lark.db ".backup 文件名.db")、channels/、youtube/、config.yaml 和 .env。你自己的音乐目录从不会被改动。升级:重新运行安装命令,或 docker compose pull && docker compose up -d。

英文完整指南:install a self-hosted music server with Docker。想先比较:Spotify 替代。

一条命令安装

需要装了 Docker 的 Linux 电脑或 NAS。

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

一条命令安装 ★ GitHub 项目

分步安装和配置见 docs/install.md.

常见问题

自建音乐服务器需要什么设备?

一台一直开着、装了 Docker 的 Linux 电脑或 NAS(amd64 或 arm64)。一台小型家用服务器就够一个家庭用。

会改动我的音乐文件吗?

不会,Melarka 只读取。改过的歌名、标签和歌词存在它自己的数据库里。

手机上怎么用?

有 iPhone、安卓原生 App 和网页版。手机在外面使用需要给服务器配 HTTPS 地址。

要钱吗?

不要,开源免费,也不需要在我们这里注册。