
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
AirConnect的Docker镜像,基于https://github.com/philippe44/AirConnect%E9%A1%B9%E7%9B%AE%E3%80%82%E6%9C%80%E6%96%B0%E9%95%9C%E5%83%8F%E5%8C%85%E5%90%AB%E7%89%88%E6%9C%AChttps://github.com/philippe44/AirConnect/releases/tag/1.9.2%E3%80%82
本镜像基于https://github.com/philippe44%E7%9A%84https://github.com/philippe44/AirConnect%E3%80%82%E5%AE%83%E5%85%81%E8%AE%B8%E5%B0%86UPnP%E6%B8%B2%E6%9F%93%E5%99%A8%EF%BC%88%E5%8C%85%E6%8B%AC%E9%80%9A%E8%BF%87https://github.com/GioF71/upmpdcli-docker%E5%92%8Chttps://github.com/giof71/mpd-alsa-docker%E5%88%9B%E5%BB%BA%E7%9A%84%E6%B8%B2%E6%9F%93%E5%99%A8%EF%BC%89%E5%92%8CChromecast%E8%AE%BE%E5%A4%87%E7%94%A8%E4%BD%9CAirPlay%E8%AE%BE%E5%A4%87%E3%80%82
| 仓库类型 | 描述 |
|---|---|
| 源代码 | https://github.com/GioF71/airconnect-docker |
| Docker镜像 | https://hub.docker.com/r/giof71/airconnect |
使用以下命令构建:
textdocker build . -t giof71/airconnect:latest
可通过一组环境变量进行配置。目前可用的变量较少,但会尽快添加更多。
| 变量 | 描述 |
|---|---|
| USER_MODE | 允许使用PUID/PGID运行,默认yes |
| USE_CONFIG_VOLUME | 使用/config作为配置目录,默认yes |
| PUID | 运行应用的用户ID,默认1000 |
| PGID | 运行应用的组ID,默认1000 |
| PREFER_STATIC | 优先使用静态版本可执行文件,默认no |
| AIRCONNECT_MODE | AirConnect模式:upnp或cast,默认upnp |
| CODEC | 发送HTTP音频的格式,参考AirConnecthttps://github.com/philippe44/AirConnect |
| LATENCY | -l参数的值,Sonos和Heos播放器建议设为1000:2000 |
| CONFIG_FILE_PREFIX | 配置文件前缀,默认空 |
| LOG_LEVEL_ALL | 使用提供的值启用all类型日志 |
| LOG_LEVEL_MAIN | 使用提供的值启用main类型日志 |
| LOG_LEVEL_UTIL | 使用提供的值启用util类型日志 |
| LOG_LEVEL_UPNP | 使用提供的值启用upnp类型日志 |
| LOG_LEVEL_RAOP | 使用提供的值启用raop类型日志 |
| ENABLE_AUTO_NETWORK | 允许自动设置NETWORK_SELECT,默认yes(但不会覆盖显式设置的NETWORK_SELECT) |
| NETWORK_SELECT | 设置网络接口或IP(可选端口) |
| AUTO_NETWORK_URL | 用于选择网络的URL,默认1.1.1.1 |
| NETWORK_USE_IP | 对-b参数使用IP而非网卡,默认yes |
请注意,以LOG_LEVEL_开头的变量可能的值如下:error、warn、info、debug、sdebug。
可使用以下命令生成upnp版本的配置文件:
textdocker run -it \ --user 1000:1000 \ --network host \ --rm \ -v ${PWD}:/config \ --entrypoint /app/bin/airupnp-linux \ giof71/airconnect \ -i /config/airconnect-upnp-new.xml
如果当前目录归用户所有,则需要--user 1000:1000选项(如果uid/gid不是1000,请使用正确的uid/gid)。执行后会在当前目录生成名为airconnect-upnp-new.xml的新文件。
类似地,生成cast版本配置文件的命令如下:
textdocker run -it \ --user 1000:1000 \ --network host \ --rm \ -v ${PWD}:/config \ --entrypoint /app/bin/aircast-linux \ giof71/airconnect \ -i /config/airconnect-cast-new.xml
生成的文件名为airconnect-cast-new.xml。可根据需要修改配置文件,然后通过将其放入/config卷在compose文件中使用。
以下是简单的docker-compose文件示例。
yaml--- version: "3" volumes: config: services: airconnect: image: giof71/airconnect:latest container_name: airconnect-upnp network_mode: host environment: - PUID=1000 - PGID=1000 - AIRCONNECT_MODE=upnp volumes: - config:/config restart: unless-stopped
yaml--- version: "3" volumes: config: services: airconnect: image: giof71/airconnect:latest container_name: airconnect-cast network_mode: host environment: - PUID=1000 - PGID=1000 - AIRCONNECT_MODE=cast volumes: - config:/config restart: unless-stopped
上游项目的变更日志可在https://github.com/philippe44/AirConnect/blob/master/CHANGELOG%E6%9F%A5%E7%9C%8B%E3%80%82
| 日期 | 描述 |
|---|---|
| 2025-10-24 | 升级到版本https://github.com/philippe44/AirConnect/releases/tag/1.9.2 |
| 2025-10-19 | 修复构建,添加libatomic1(见https://github.com/GioF71/airconnect-docker/issues/14%EF%BC%89 |
| 2025-10-11 | 构建目标改为arm/v5(原arm/v6) |
| 2025-10-11 | 升级到版本https://github.com/philippe44/AirConnect/releases/tag/1.9.1 |
| 2025-06-16 | 添加对linux/arm/v6的支持(见https://github.com/GioF71/airconnect-docker/issues/8%EF%BC%89 |
| 2024-10-16 | 添加USER_MODE和USE_CONFIG_VOLUME变量 |
| 2024-03-15 | 升级到版本https://github.com/philippe44/AirConnect/releases/tag/1.8.3 |
| 2024-03-11 | 优先使用IP而非网卡选择网络接口 |
| 2024-03-09 | 自动选择网络接口(见https://github.com/GioF71/airconnect-docker/issues/3%EF%BC%89 |
| 2024-01-26 | 添加日志级别支持 |
| 2024-01-15 | 升级到版本https://github.com/philippe44/AirConnect/releases/tag/1.7.0 |
| 2024-01-09 | 升级到版本https://github.com/philippe44/AirConnect/releases/tag/1.6.3 |
| 2023-12-27 | 升级到版本https://github.com/philippe44/AirConnect/releases/tag/1.6.2 |
| 2023-12-26 | 升级到版本https://github.com/philippe44/AirConnect/releases/tag/1.6.1 |
| 2023-12-18 | 升级到版本https://github.com/philippe44/AirConnect/releases/tag/1.6.0 |
| 2023-12-05 | 添加LATENCY支持(见https://github.com/GioF71/airconnect-docker/issues/1%EF%BC%89 |
| 2023-12-05 | 升级到版本https://github.com/philippe44/AirConnect/releases/tag/1.5.4 |
| 2023-12-02 | 升级到版本https://github.com/philippe44/AirConnect/releases/tag/1.5.3 |
| 2023-11-28 | 升级到版本https://github.com/philippe44/AirConnect/releases/tag/1.5.0 |
| 2023-11-22 | 首个可用版本 |
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务