steefdebruijn/docker-roonserver

docker-roonserver 介绍

项目简介

docker-roonserver 是一个用于运行 RoonServer 的 Docker 镜像配置项目。首次启动时，若外部卷中未找到 RoonServer，镜像会自动下载并部署。

基本启动示例

通过以下命令可直接启动容器：

bash
docker run -d \
  --net=host \
  -e TZ="Europe/Amsterdam" \
  -v roon-app:/app \
  -v roon-data:/data \
  -v roon-music:/music \
  -v roon-backups:/backup \
  steefdebruijn/docker-roonserver:latest

注意事项：

• 需将 TZ 设置为你的时区（如 Asia/Shanghai）。
• 卷映射可改为本地文件系统路径（如 -v /path/to/local/app:/app）。
• 必须为 /app 和 /data 指定不同的文件夹或卷，若指向主机同一位置，服务无法启动。
• 首次运行时，需将媒体库根目录配置为 /music，备份路径配置为 /backup。

Systemd 部署

若主机使用 systemd，建议通过 systemd 服务管理 Roon 服务。

示例配置（需根据实际环境调整）：

创建服务文件（如 /etc/systemd/system/roon.service），内容如下：

ini
[Unit]
Description=Roon
After=docker.service
Requires=docker.service

[Service]
TimeoutStartSec=0
TimeoutStopSec=180
ExecStartPre=-/usr/bin/docker kill %n
ExecStartPre=-/usr/bin/docker rm -f %n
ExecStartPre=/usr/bin/docker pull steefdebruijn/docker-roonserver
ExecStart=/usr/bin/docker \
  run --name %n \
  --net=host \
  -e TZ="Europe/Amsterdam" \
  -v roon-app:/app \
  -v roon-data:/data \
  -v roon-music:/music \
  -v roon-backups:/backup \
  steefdebruijn/docker-roonserver
ExecStop=/usr/bin/docker stop %n
Restart=always
RestartSec=10s

[Install]
WantedBy=multi-user.target

Docker-compose 部署

若使用 docker-compose 环境，创建 docker-compose.yaml 文件后，通过 docker-compose up -d 启动服务。

示例配置（需根据实际环境调整）：

yaml
version: "3.7"
services:
  docker-roonserver:
    image: steefdebruijn/docker-roonserver:latest
    container_name: docker-roonserver
    hostname: docker-roonserver
    network_mode: host
    environment:
      TZ: "Europe/Amsterdam"
    volumes:
      - roon-app:/app
      - roon-data:/data
      - roon-music:/music
      - roon-backups:/backup
    restart: always
volumes:
  roon-app:
  roon-data:
  roon-music:
  roon-backups:

网络共享问题

若访问远程 SMB/CIFS 共享时遇到问题，需为容器添加额外权限，有两种解决方式（参考 issue #15）：

方式一：特权模式运行

• 独立运行或 systemd 服务中：

  bash
  docker run --privileged --name roonserver ...  # 其他参数不变
  

• docker-compose 配置（服务部分添加）：

  yaml
  privileged: true
  

方式二：添加特定权限

根据主机系统和安全设置，可能需要添加以下权限：

• 独立运行或 systemd 服务中：

  bash
  docker run --cap-add SYS_ADMIN --cap-add DAC_READ_SEARCH --security-opt apparmor:unconfined ...  # 其他参数不变
  

• docker-compose 配置（服务部分添加）：

  yaml
  cap_add:
    - SYS_ADMIN
    - DAC_READ_SEARCH
  security_opt:
    - apparmor:unconfined
  

网络问题

若主机连接多个网络，且 Roon 核心无法发现音频端点/设备，可尝试创建 macvlan 网络（参考 issue #1）：

bash
docker network create -d macvlan \
  --subnet 192.168.1.0/24 --gateway 192.168.1.1 \
  --ip-range 192.168.1.240/28 -o parent=enp4s0 roon-lan
docker run --network roon-lan --name roonserver ...  # 其他参数不变

需将子网、网关调整为音频设备所在网络的配置；IP 范围需避免与网络中其他设备冲突，且若子网启用 DHCP，需确保 IP 范围在 DHCP 分配之外。

扩展功能

若需使用 Roon 扩展，建议单独部署扩展管理器容器，例如 theappgineer/roon-extension-manager。（注：作者未测试过扩展功能，本人不使用 Roon 扩展。）

备份说明

请务必备份 roon-backups 卷中的数据，建议进行异地备份。

祝使用愉快！—— Steef

版本历史

• 2023-11-03：更新基础镜像为 debian:12-slim，依赖更新为 libicu72
• 2022-04-12：更新基础镜像为 debian:11-slim
• 2022-03-19：修复下载 URL，支持下载重定向；README 中补充特定使用场景说明
• 2021-05-24：更新基础镜像为 debian:10.9-slim；新增 /app 和 /data 卷路径冲突检查
• 2019-03-18：修复启动示例（感谢 @heapxor）；新增 systemd 示例配置
• 2019-01-23：更新基础镜像为 debian-9.6
• 2017-08-08：基于 RoonLabs 论坛讨论创建初始镜像