如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
此镜像已弃用。我们将不再为此镜像提供支持,也不会进行更新。
建议切换至官方容器镜像:https://github.com/owntone/owntone-container
https://owntone.github.io/owntone-server/%EF%BC%88iTunes%EF%BC%89%E5%AA%92%E4%BD%93%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E6%94%AF%E6%8C%81AirPlay%E8%AE%BE%E5%A4%87%E3%80%81Apple Remote(及兼容设备)、Chromecast、MPD和网络收音机。
我们利用Docker manifest实现多平台支持。直接拉取 lscr.io/linuxserver/daapd:latest 即可获取对应架构的镜像,也可通过标签指定特定架构。
| 架构 | 可用 | 标签 |
|---|---|---|
| x86-64 | ✅ | amd64-<version tag> |
| arm64 | ✅ | arm64v8-<version tag> |
| armhf | ❌ |
映射音乐文件夹后,在同一局域网内打开iTunes即可看到音乐。
Web界面地址:http://<你的IP>:3689,默认凭据为 admin/changeme。
有关遥控器等更多设置选项,请参考Daapd官方网站 https://owntone.github.io/owntone-server/%E3%80%82
通过在挂载的音乐文件夹根目录创建名为“spotify”的管道文件(多数网络挂载不支持此操作)启用Spotify Connect服务器:
shmkfifo <music_folder>/spotify
Spotify Connect服务器将在Spotify应用中显示为“forked-daapd”设备。建议在forked-daapd配置中将 pipe_autostart 选项设为 true。
以下提供docker-compose和docker cli两种方式创建容器,帮助快速启动。
[!NOTE]
除非标记为“可选”,否则所有参数为必填项,需提供对应值。
yaml--- services: daapd: image: lscr.io/linuxserver/daapd:latest container_name: daapd network_mode: host environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC volumes: - /path/to/daapd/data:/config - /path/to/music:/music restart: unless-stopped
bashdocker run -d \ --name=daapd \ --net=host \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -v /path/to/daapd/data:/config \ -v /path/to/music:/music \ --restart unless-stopped \ lscr.io/linuxserver/daapd:latest
容器运行时通过参数配置,格式为 <外部>:<内部>。例如 -p 8080:80 表示将容器内80端口映射到主机8080端口。
| 参数 | 功能 |
|---|---|
--net=host | 与主机共享网络。 |
-e PUID=1000 | 用户ID,详见下文说明 |
-e PGID=1000 | 组ID,详见下文说明 |
-e TZ=Etc/UTC | 指定时区,参考时区列表。 |
-v /config | Daapd服务器存储配置和数据库文件的路径。 |
-v /music | 映射到你的音乐文件夹。 |
可通过特殊前缀 FILE__ 从文件中设置环境变量。例如:
bash-e FILE__MYVAR=/run/secrets/mysecretvariable
此命令会将环境变量 MYVAR 的值设为 /run/secrets/mysecretvariable 文件的内容。
所有镜像支持通过可选参数 -e UMASK=022 覆盖默认umask设置。注意umask是权限掩码(减法运算),而非直接设置权限,详情参考此处。
使用卷(-v 标志)时,主机与容器可能出现权限问题。通过指定 PUID(用户ID)和 PGID(组ID)可避免此问题。
确保主机卷目录的所有者与指定的 PUID/PGID 一致,权限问题即可解决。
通过 id your_user 命令获取当前用户的 PUID 和 PGID:
bashid your_user
示例输出:
textuid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=daapd&query=%24.mods%5B%27daapd%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看此容器可用的Mods") https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] "查看通用Mods")
我们提供多种https://github.com/linuxserver/docker-mods%E4%BB%A5%E6%89%A9%E5%B1%95%E5%AE%B9%E5%99%A8%E5%8A%9F%E8%83%BD%E3%80%82%E4%B8%8A%E8%BF%B0%E5%BE%BD%E7%AB%A0%E9%93%BE%E6%8E%A5%E5%8F%AF%E6%9F%A5%E7%9C%8B%E6%AD%A4%E9%95%9C%E5%83%8F%E5%8F%8A%E9%80%9A%E7%94%A8Mods%E7%9A%84%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF%E3%80%82
容器运行时的Shell访问:
bashdocker exec -it daapd /bin/bash
实时监控容器日志:
bashdocker logs -f daapd
容器版本号:
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' daapd
镜像版本号:
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/daapd:latest
多数镜像为静态版本,需更新镜像并重建容器以更新应用(部分例外见对应README)。不建议在容器内直接更新应用。
更新镜像:
所有镜像:
bashdocker-compose pull
单个镜像:
bashdocker-compose pull daapd
更新容器:
所有容器:
bashdocker-compose up -d
单个容器:
bashdocker-compose up -d daapd
清理旧镜像:
bashdocker image prune
更新镜像:
bashdocker pull lscr.io/linuxserver/daapd:latest
停止运行中的容器:
bashdocker stop daapd
删除容器:
bashdocker rm daapd
使用上述docker run参数重建容器(若卷映射正确,/config 文件夹及设置将保留)
清理旧镜像:
bashdocker image prune
[!TIP]
推荐使用Diun接收更新通知。不推荐或支持自动更新容器的工具。
如需本地修改镜像(开发或自定义逻辑):
bashgit clone https://github.com/linuxserver/docker-daapd.git cd docker-daapd docker build \ --no-cache \ --pull \ -t lscr.io/linuxserver/daapd:latest .
可使用 lscr.io/linuxserver/qemu-static 在x86_64硬件上构建ARM变体,反之亦然:
bashdocker run --rm --privileged lscr.io/linuxserver/qemu-static --reset
注册后,可通过 -f Dockerfile.aarch64 指定架构对应的Dockerfile。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

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