LyraNest 品牌 LogoLyraNest
官网已启用新域名 lyranest.top,请更新你的书签。旧域名 lyranest.cc.cd 继续作为备用站保留并可正常访问,功能与内容完全一致,也会同步更新。
LyraNest Local Output 0.1.0

让服务器,自己出声

让跑着律巢的那台机器自己出声:3.5mm 耳机孔、USB DAC 或 HDMI 直出。

What it is

把曲库送到本机声卡

把 LyraNest 正在播放的音乐直接送到服务端本机的声卡上 —— 板载 3.5mm 耳机孔、内建扬声器、USB DAC 或 HDMI。播放语义交给 MPD 内核,平台特有的 Auto-Mute 静音坑由我们自己的外壳处理。

它是一个独立伴生子项目:独立镜像、独立 compose、独立生命周期,属于用户选装能力。 没部署的时候,律巢主服务与插件中心对它零感知 —— 不显示灰项、不报错、不重试。

3.5mm

板载耳机孔 / 内建扬声器

MPD

队列 · 无缝 · 精确 seek

8091

控制端口(可改)

Features

已经能做到什么

当前版本(0.1.0)的能力清单。

服务端本机出声:3.5mm 耳机孔 / 内建扬声器 / USB DAC / HDMI 均可

MPD 播放内核:队列、无缝播放、精确 seek、采样率自动切换

ALSA 独占输出,绕过 dmix,避免一次多余的重采样

开机 Auto-Mute 自检与修复 —— 这是该机型最常见的「有进程没声音」原因

声卡与 mixer 状态通过 /healthz 透出给插件中心,测试失败能区分「地址不可达」和「声卡未就绪」

插件中心一键接入:填地址 → 整体测试 → 启用;未部署时主服务与插件中心零感知

Deploy

怎么装起来

两条路:飞牛 fnOS 直接装原生包,或者任何支持 Docker 的机器上跑一个独立容器。

D

Docker

任何装了 Docker 的机器都能跑。注意:容器只做控制面,音频路径与网络要求见右侧的使用前提。

docker run -d --name lyranest-local-output \
  --device /dev/snd:/dev/snd \
  -p 8091:8091 \
  -v /vol1/1000/lyranest/music:/music:ro \
  lyranest-local-output:latest

镜像随插件仓库发布;镜像还没拉到时,可以在仓库里用docker build 自行构建。

飞

飞牛 fnOS

下载 FPK 原生包,在飞牛的应用中心安装即可,端口与目录都在向导里配置。

  1. 1下载并安装 LyraNest-Local-Output-0.1.0-fnos-x86.fpk。
  2. 2在飞牛应用里设置 HTTP 端口(默认 8091)与音乐目录。
  3. 3回到律巢「插件中心 → 本机音频输出」,填入 http://宿主机IP:8091 并点击整体测试。
  4. 4测试通过后启用,播放任意曲目即可从服务端声卡出声。
前往下载页

Requirements

使用前提

这几条踩过坑,先看一遍能省不少时间。

  • 宿主必须有可用声卡:容器要映射 /dev/snd,宿主没有声卡时容器会直接启动失败(这是预期行为,不是 bug)。
  • 群晖、威联通等多数 NAS 机型没有板载声卡,装上也出不了声 —— 这类机器请用客户端播放或 AirPlay 桥接器。
  • ALSA 以独占方式占用设备(不走 dmix),同一块声卡不能再同时给别的程序用。
  • 镜像内置 MPD 与 ALSA 驱动,约 90MB;容器内存上限 64MB。
  • 插件中心填地址时,主服务在 Docker bridge 网络里的话要填宿主机 IP,填 127.0.0.1 连不上。

给你的 NAS 接一对音箱

装好之后,律巢里点播放,声音就从服务器那台机器出来。