请注意，本文编写于 102 天前，最后修改于 102 天前，其中某些信息可能已经过时。
一、Roon 是什么？
Roon 是一款面向音乐发烧友的高端音乐管理和播放软件，核心功能包括：
智能音乐库管理：自动整理音乐元数据（专辑封面、艺术家信息、歌词等）。无损音质优化：支持高分辨率音频（如DSD、FLAC、MQA）和专业的DSP处理。多设备同步：跨设备无缝播放，支持多房间音频系统。个性化推荐：基于听歌习惯生成推荐歌单。二、准备工作
设备要求
已安装Docker服务（需管理员权限）。本地网络环境稳定（建议千兆局域网）。资源获取
RoonServer_linuxx64.tar.bz2（需自行搜索，你用什么版本看你自己）。Roon客户端（需自行搜索，你用什么版本看你自己）。音乐文件预先存入目录（推荐目录：/music）。Dockerfile文件下载地址 。三、Docker镜像构建步骤
1. 构建镜像
到github链接下载，准备RoonServer_linuxx64.tar.bz2文件(需自行搜索，你用什么版本看你自己)，并将其放置在与dockerfile和run.sh相同的目录中，然后使用docker build -t roonserver:latest .来构建镜像。
docker build-t cyril2007/roonserver:latest .
2. 创建目录
创建以下目录（路径仅供参考）：
/mnt/Disk1/Roon/ ├── data/ # 核心数据库 ├── app/ # 应用配置 ├── backup/ # 自动备份 └── music/ # 音乐文件（可指向已有目录）
3. 配置容器
网络模式：Host（直接使用宿主机网络）存储映射：容器路径宿主机路径/data/mnt/Disk1/Roon/data/app/mnt/Disk1/Roon/app/backup/mnt/Disk1/Roon/backup/music/mnt/Disk1/MyMusic权限设置：所有目录赋予 读写 权限。4. 启动容器
勾选「创建后启动容器」。
docker run \ --name roon-server \ --network host \ # 使用宿主机网络模式 -v /mnt/Disk1/Roon/data:/data \ # 挂载数据目录 -v /mnt/Disk1/Roon/app:/app \ # 挂载配置目录 -v /mnt/Disk1/Roon/backup:/backup \ # 挂载备份目录 -v /mnt/Disk1/MyMusic:/music \ # 挂载音乐文件目录 cyril2007/roonserver:latest
检查容器日志：
docker logs -f roon-server
四、客户端连接
安装Roon客户端（Windows/macOS/Android/iOS）。客户端与极空间需处于同一局域网。打开客户端自动发现服务器，或手动输入IP：
192.168.1.100:9330
五、注意事项
数据安全：定期备份 /data 和 /backup 目录。稳定性：避免升级服务器版本，可能引发破解失效。性能优化：若音乐库较大（>10TB），建议分配4GB以上内存。六、常见问题
Q：客户端无法连接服务器？
检查极空间防火墙是否放行端口：
TCP 9330UDP 9100-9200Q：音乐文件未识别？
确认 /music 目录映射正确，且文件格式为 FLAC/WAV/DSD 等无损格式。技术声明
本教程基于steefdebruijn/docker-roonserver项目进行改写，改写后构建Dockerfile地址见Github。
本文作者：Cyril2007
本文链接：http://120.24.178.77/archives/2025/05/03/13/13/
版权声明：转载时须注明出处及本声明
