软路由音乐折腾记：为“音流”打造专属歌词服务器 (LrcApi 部署指南)

如果你和我一样，在软路由（ImmortalWrt/iStoreOS）上搭建了 Navidrome 或 Jellyfin 听歌，那么 LrcApi 绝对是提升体验的“神兵利器”。它能让你的“音流 (MusicFlow)” App 具备自动抓取网易云、QQ 音乐歌词的能力。

核心要点总结

• 服务端口：28883。
• 部署路径：Docker 根目录设在 /opt/docker。
• 验证方式：API_AUTH 留空（适合家庭内网使用）。
• 适用客户端：音流 (MusicFlow)。

一、 环境准备

为了保证数据在软路由重启或升级后不丢失，我们将配置文件持久化到已经扩容好的物理分区中。

在 SSH 终端输入以下命令创建目录：

Bash

mkdir -p /opt/docker/lrcapi

二、 Docker 部署 (SSH 方式)

执行以下命令直接拉取镜像并启动容器。这里我们将 API_AUTH 设为空，简化内网连接步骤。

Bash

docker run -d \
  --name lrcapi \
  --restart always \
  -p 28883:28883 \
  -v /opt/docker/lrcapi:/app/data \
  -e API_AUTH="" \
  hisatri/lrcapi:latest

参数详解：

• -p 28883:28883：将容器内的歌词服务端口映射到软路由。
• -v /opt/docker/lrcapi:/app/data：将配置和缓存映射到 20GB 的 Docker 专用分区。
• -e API_AUTH=""：禁用身份验证，方便 App 端直接连接。

三、 验证与排错

安装完成后，建议通过日志观察服务状态：

Bash

docker logs -f lrcapi

看到以下信息即代表成功：

INFO:waitress:Serving on http://0.0.0.0:28883

INFO:mod.check_update:当前已是最新版本

四、 客户端对接 (音流 App)

最后一步，在手机端的“音流” App 中完成“握手”：

1. 打开设置：进入“歌词设置”选项卡。
2. 自定义服务器：在“自定义歌词服务器”中输入：
   • 地址：http://[你的软路由IP]:28883
   • Token / Auth：留空（因为我们在 Docker 中设置了空值）。
3. 保存测试：播放一首无词歌曲，稍等片刻，歌词便会自动浮现。

结语

通过 Docker 部署 LrcApi，我们不仅解决了音乐库歌词缺失的痛点，还充分利用了软路由扩容后的存储空间。