AirConnect的Docker镜像,基于AirConnect项目。最新镜像包含版本1.9.2。
本镜像基于philippe44的该项目。它允许将UPnP渲染器(包括通过upmpdcli和mpd创建的渲染器)和Chromecast设备用作AirPlay设备。
| 仓库类型 | 描述 |
|---|---|
| 源代码 | GitHub |
| Docker镜像 | Docker Hub |
使用以下命令构建:
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音频的格式,参考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
上游项目的变更日志可在此处查看。
| 日期 | 描述 |
|---|---|
| 2025-10-24 | 升级到版本1.9.2 |
| 2025-10-19 | 修复构建,添加libatomic1(见issue #14) |
| 2025-10-11 | 构建目标改为arm/v5(原arm/v6) |
| 2025-10-11 | 升级到版本1.9.1 |
| 2025-06-16 | 添加对linux/arm/v6的支持(见issue #8) |
| 2024-10-16 | 添加USER_MODE和USE_CONFIG_VOLUME变量 |
| 2024-03-15 | 升级到版本1.8.3 |
| 2024-03-11 | 优先使用IP而非网卡选择网络接口 |
| 2024-03-09 | 自动选择网络接口(见#3) |
| 2024-01-26 | 添加日志级别支持 |
| 2024-01-15 | 升级到版本1.7.0 |
| 2024-01-09 | 升级到版本1.6.3 |
| 2023-12-27 | 升级到版本1.6.2 |
| 2023-12-26 | 升级到版本1.6.1 |
| 2023-12-18 | 升级到版本1.6.0 |
| 2023-12-05 | 添加LATENCY支持(见#1) |
| 2023-12-05 | 升级到版本1.5.4 |
| 2023-12-02 | 升级到版本1.5.3 |
| 2023-11-28 | 升级到版本1.5.0 |
| 2023-11-22 | 首个可用版本 |
来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像加速服务
在 Docker Desktop 配置镜像加速
Docker Compose 项目配置加速
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像加速
Synology 群晖 NAS 配置加速
飞牛 fnOS 系统配置镜像加速
极空间 NAS 系统配置加速服务
爱快 iKuai 路由系统配置加速
绿联 NAS 系统配置镜像加速
QNAP 威联通 NAS 配置加速
Podman 容器引擎配置加速
HPC 科学计算容器配置加速
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名加速
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429