飞牛 NAS 使用 Docker Compose 部署 ro-music 自建音乐服务完整教程

官方仓库地址

https://github.com/leizi914599611-boop/ro

部署准备

部署目录：/vol1/@appcenter/ro-music 在该目录下创建两个文件：config.yaml 与 docker-compose.yml。

config.yaml 完整配置

server:
  host: 0.0.0.0          # 容器内监听地址；对外暴露由 compose 端口映射控制
  port: 23330

auth:
  enabled: true          # 关掉(false)则全放行——仅在完全可信的内网这么做
  apiKey: ""             # 建议留空，用 Web「生成 API Key」功能生成（见下）
  webLogin:
    username: admin
    password: "Abcd1234"         # 【必设】空密码禁止登录，首次务必设置

download:
  dir: data/downloads    # 相对项目根解析
  concurrency: 3         # 并发下载数(1-10)，改后即时生效
  defaultQuality: flac   # flac24bit | flac | 320k | 128k
  nameTemplate: "{name} - {singer}"
  embedCover: true       # 嵌入封面
  embedLyric: true       # 嵌入歌词
  coverSize: 500         # 封面尺寸(100-1000)

sources:
  dir: data/sources
  hotReload: true        # 音源目录热重载

rateLimit:
  enabled: true
  windowMs: 60000        # 限流窗口
  max: 300               # 窗口内最大请求数，仅 /api/* 生效

smokeTest:
  enabled: true
  cron: "0 6 * * *"        # 每天 06:00
  keyword: 周杰伦
  checkLyric: true
  checkPic: true
  alertThreshold: 2      # 连续失败达阈值才告警
  alert:
    bark:
      enabled: false
      serverUrl: https://api.day.app
      deviceKey: ""
    serverChan:
      enabled: false
      sendKey: ""

log:
  level: info

docker-compose.yml 完整配置

services:
  ro:
    image: a914599611/ro-music:latest   # 不再本地构建，直接拉镜像
    container_name: ro-music
    restart: unless-stopped
    ports:
      - "23330:23330"
    environment:
      TZ: Asia/Shanghai
    volumes:
      - /vol1/@appcenter/ro-music/config.yaml:/app/config.yaml
      - /vol2/1000/电影音乐/ro-music-download:/app/data/downloads
      - /vol1/@appcenter/ro-music/data/sources:/app/data/sources
      - /vol1/@appcenter/ro-music/data/db:/app/data/db
    mem_limit: 512m

启动容器

cd /vol1/@appcenter/ro-music
docker compose up -d

预期输出：

[+] Running 2/2
 ✔ Network ro-music_default  Created                                                                                                                          0.2s 
 ✔ Container ro-music        Started 

访问 Web 界面

浏览器打开 http://<NAS_IP>:23330，使用 admin / Abcd1234 登录。

配置音源（在 Web 界面「音源管理」中添加）

• 星海源：https://ghproxy.net/raw.githubusercontent.com/tfappstore/lx-music-source/main/xinghai/latest.js
• Huibq 源：https://ghproxy.net/raw.githubusercontent.com/tfappstore/lx-music-source/main/huibq/latest.js
• LX 独家源：https://ghproxy.net/raw.githubusercontent.com/tfappstore/lx-music-source/main/lx/latest.js
• 更多音源：https://github.com/pdone/lx-music-source

提示：添加后点击「检测可用性」，绿色即可用。建议定期更新音源链接。