LyraNest 品牌 LogoLyraNest
由于飞牛的 1.2.0602 及以上版本使用了更加严格的统一网关认证,使用最新飞牛版本的用户,在使用 LyraNest 0.2.6 之前的版本时会出现一系列恶性 bug,请使用飞牛新版本并且 fpk 安装 LyraNest 的用户尽快更新到 官网下载页0.2.7 版本(此前的 0.2.6.091002 热修包已由它取代;也可在 QQ 群 700454910 的群文件中获取),以适配最新版的统一网关。使用 Docker 部署、使用 LyraNest 兼容版、飞牛版本低于 1.2.0602、其他系统的原生应用的用户均不受影响,无需更新。
Plugins · 插件部署

第三方插件,自己部署

LyraNest 的下载、歌单、有声书能力依赖自部署的上游服务。这里汇总所有配套插件,点击进入各自的部署教程。

通用前置条件

LyraNest 的下载、歌单、有声书能力来自自部署的上游服务。以下为部署前需要准备的内容。

1. 安装 Docker Desktop 或 Linux Docker Engine,确认 docker compose version 可用。

2. 为每个服务单独建立目录;不要把数据库目录放在临时目录或云同步目录中。

3. 修改 Compose 中标记为「必须修改」的密码、密钥、宿主机路径和对外端口。

4. 在 Compose 文件所在目录执行:

bash
docker compose config
docker compose pull
docker compose up -d
docker compose ps
docker compose logs -f --tail=100

停止但保留数据用 docker compose down;升级前先备份挂载卷,再 docker compose pulldocker compose up -d

插件一览

每个插件都有独立的部署与配置教程,点击进入:

LyraNest 音乐插件填写规则

进入 LyraNest Web 管理端的「插件中心 → 音乐插件」,安装对应插件后填写:

· Solara:服务地址填 Solara 容器地址,如 http://192.168.1.20:3333;音源通常填 kuwo

· SQMusic:服务地址填后端 API 地址(不要填前端网页地址),默认映射 http://192.168.1.20:8099;音源填 kw;若启用 Token 则填写。

· GoMusic:服务地址填后端 API 地址(不要填网页端地址),默认 http://192.168.1.20:8080;用于歌单解析,不需要音源或凭据。

LyraNest 只保存 base_url、settings.sources 和凭据字段;凭据由服务端加密保存。保存后使用「整体测试」或「连接测试」确认状态。

LyraNest 有声书插件填写规则

进入「插件中心 → 有声书插件」:

· Abs-Ximalaya:服务地址填 http://服务器IP:7814(末尾不要加 /);API Key 必须与实例配置一致;adapter 选 ximalaya

· calibre-douban:页面选豆瓣适配器,服务地址留空;如需登录态在「请求 Cookie」填浏览器 Cookie;请求间隔默认 1000 毫秒。

豆瓣适配器只需把 adapter 改为 douban,base_url 置空,credentials.cookie 填可选请求 Cookie。

局域网地址注意事项

  • · 容器之间互访使用 Compose 服务名和容器端口,例如 http://solara:3000;LyraNest 在宿主机运行时,使用宿主机 IP 和映射端口。
  • · LyraNest 在另一个容器中运行时,优先把相关服务加入同一个 Docker 网络,并使用服务名,不要使用 127.0.0.1。
  • · 127.0.0.1 在容器内部指向当前容器,不指向宿主机或另一个服务。

⚠️ 请确认你有权访问和保存第三方服务返回的内容,并遵守所在地法律、上游项目许可和各内容平台条款。生产环境建议把镜像 latest 改成已验证的固定版本。

阅读 点赞

把音乐,
放回你自己家里

现在开始建立属于自己的音乐库。

Android APKWindows x64Android TV飞牛 fnOS FPK群晖 Synology SPK威联通 QNAP QPKG绿联 UGREEN UPK铁威马 TerraMaster DEBDocker