steefdebruijn/docker-roonserver Docker Image Overview

steefdebruijn/docker-roonserver

自动构建

RoonServer是Roon音乐系统的核心服务器组件，其关键特性之一是在首次运行时，会依据当前系统环境与配置需求自动检测，如有必要便拉取所需的Roon软件资源，以确保用户无需手动干预软件安装或更新流程，即可顺利启动并使用Roon的音乐库管理、高保真音频播放及多设备流媒体服务等功能，从而有效简化操作步骤，提升整体使用体验。

38 收藏0 次下载activesteefdebruijn镜像

🚀专业版镜像服务，面向生产环境设计

中文简介版本下载

🚀专业版镜像服务，面向生产环境设计

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 ...  # 其他参数不变