
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 | 首个可用版本 |
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。



探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务