
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
| 仓库 | URL |
|---|---|
| 源代码 | https://github.com/GioF71/roon-bridge-docker |
| Docker镜像 | https://hub.docker.com/r/giof71/roon-bridge |
上,可使用以下命令安装必要软件包:
textsudo apt-get update sudo apt-get install -y docker.io docker-compose sudo usermod -a -G docker $USER
最后一条命令将当前用户添加到docker用户组。这不是必须的;如果选择跳过此步骤,可能需要在docker-compose命令前添加sudo执行。
请注意,这不一定是在您的机器上安装docker的最佳方式。首先,建议的方法是从发行版仓库安装软件包。您可能更倾向于从docker仓库安装以获取更新的版本。
您也可以将此解决方案与Podman一起使用。参见https://github.com/GioF71/roon-bridge-docker/discussions/30%E3%80%82
使用包含的脚本构建镜像:
./build.sh
| 变量 | 描述 |
|---|---|
| BASE_URL | 若设置,文件将从此URL下载而非Roon服务器 |
| FORCE_ARCH | 若设置,选择要使用/下载的二进制文件时将使用该值而非uname -m。例如,在Pi4上的LibreElec或OSMC系统中,内核为64位(aarch64)但Docker版本为32位:此时容器启动但二进制文件无法运行。将此变量设置为armv7l可解决此问题。可能的值为aarch64、armv7l和x86_64。 |
| 卷 | 描述 |
|---|---|
| /files | 若设置,将尝试从该卷查找原本需要下载的文件。设置此卷可略微加快启动过程。 |
您可以使用已发布的镜像或自行构建的镜像。参见https://hub.docker.com/r/giof71/roon-bridge%E3%80%82
textdocker run \ -d \ --name roon-bridge \ --restart always \ --network host \ --device /dev/snd \ --label com.centurylinklabs.watchtower.enable=false \ giof71/roon-bridge:latest
text--- version: "3" services: roon-bridge: container_name: roon-bridge image: giof71/roon-bridge:latest network_mode: host devices: - /dev/snd:/dev/snd labels: - com.centurylinklabs.watchtower.enable=false restart: always
Watchtower是一款优秀的工具,但如果镜像更新触发容器重建,可能会中断您的聆听体验。
因此,我的示例中默认禁用Watchtower。
此解决方案可用于在Moode Audio和Volumio上轻松安装Roon Bridge。
需要通过SSH连接到Moode/Volumio音频设备。要在Volumio上启用SSH,请参考此页面。
这两个平台默认未预装Docker(不足为奇),因此需要安装Docker。参见前文的Docker安装部分。
| 日期 | 描述 |
|---|---|
| 2025-02-16 | Dockerfile清理 |
| 2025-02-12 | 升级到Debian稳定版(此次为正式升级) |
| 2023-09-28 | 默认切换到Debian稳定版(参见https://github.com/GioF71/roon-bridge-docker/issues/20%EF%BC%89 |
| 2023-03-29 | 允许使用BASE_URL作为替代下载源 |
| 2023-03-29 | 移除/roon挂载点以简化使用 |
| 2023-03-29 | 添加/files卷用于提供必要的二进制文件(避免下载) |
| 2023-03-27 | 添加FORCE_ARCH变量 |
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

来自真实用户的反馈,见证轩辕镜像的优质服务