第三方插件,自己部署
LyraNest 的下载、歌单、有声书能力依赖自部署的上游服务。这里汇总所有配套插件,点击进入各自的部署教程。
通用前置条件
LyraNest 的下载、歌单、有声书能力来自自部署的上游服务。以下为部署前需要准备的内容。
1. 安装 Docker Desktop 或 Linux Docker Engine,确认 docker compose version 可用。
2. 为每个服务单独建立目录;不要把数据库目录放在临时目录或云同步目录中。
3. 修改 Compose 中标记为「必须修改」的密码、密钥、宿主机路径和对外端口。
4. 在 Compose 文件所在目录执行:
docker compose config
docker compose pull
docker compose up -d
docker compose ps
docker compose logs -f --tail=100停止但保留数据用 docker compose down;升级前先备份挂载卷,再 docker compose pull 和 docker 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 改成已验证的固定版本。
把音乐,
放回你自己家里
现在开始建立属于自己的音乐库。
