bitxeno/atvloadly

bitxeno/atvloadly has 1,657 GitHub stars and 100 forks. GitHot measured +4 stars in 24 hours and +28 in 7 days. Last checked 2026-11-08 11:49 UTC. Last push 2026-11-04.

这些数字如何统计

Easily sideload the IPA to AppleTV

1,657 星标 100 forks +4 24小时

可以做什么

Docker running (Linux/OpenWrt) or a native desktop app (macOS / Windows)
Supports AppleTV pairing
Supports automatic app refresh
Supports tracking GitHub releases / AltStore sources, with manual or automatic app updates

实测星标增长

24小时: +4
7天: +28
15天: 更新延迟
1个月: 更新延迟

各周期内的星标净变化，周期相互重叠，并非每日新增。缺失的测量保持空白。星标代表关注度，不代表软件质量。

docs/readme/README_cn.md

原文

atvloadly 是一个支持在 AppleTV 上侧载应用的 web 服务。底层通过使用 PlumeImpactor 实现侧载，并会自动刷新 App 以保证其长期可用性。它既可以作为 Docker 服务运行在 Linux/OpenWrt 上，也可以作为原生桌面应用运行在 macOS 与 Windows 上。

主要功能

docker 运行 (Linux/OpenWrt) 或原生桌面应用 (macOS / Windows)
支持 AppleTV 配对
支持自动刷新 app
支持跟踪 GitHub Releases / AltStore 源，手动或自动更新 app
支持同时使用多个 Apple ID 帐号
支持使用自有证书（P12 + 描述文件）签名，无需 Apple ID
i18n 多语言支持
支持使用自定义 Bundle ID 安装应用（Apple ID 或 P12 均可），可与原应用共存

截图

安装

Docker（Linux/OpenWrt）

Linux/OpenWrt 宿主机需要安装 avahi-deamon 服务

OpenWrt：

opkg install avahi-dbus-daemon
/etc/init.d/avahi-daemon start

Ubuntu:

sudo apt-get -y install avahi-daemon
sudo systemctl restart avahi-daemon

请参考下面的命令进行安装，记得修改下 mount 目录

Docker:

docker run --security-opt seccomp:unconfined -d --name=atvloadly --restart=always -p 5533:80 -v /path/to/mount/dir:/data -v /var/run/dbus:/var/run/dbus -v /var/run/avahi-daemon:/var/run/avahi-daemon bitxeno/atvloadly:latest

宿主机的 /var/run/dbus 和/var/run/avahi-daemon 需要共享给 docker 容器使用

假如你想使用 HOST 网络环境，想修改监听端口，可以给容器添加环境变量：

SERVICE_PORT=5533

Docker Compose:

wget https://raw.githubusercontent.com/bitxeno/atvloadly/refs/heads/master/docker-compose.yml
docker compose pull
docker compose up -d

桌面版（macOS / Windows）

macOS 15+（推荐，Homebrew）：

brew install --cask bitxeno/tap/atvloadly

Windows 10/11（x64 / arm64）：

从 Releases 下载并运行安装包（.exe）。

使用方法

前期准备 (非常重要‼️)

专用的 Apple ID 安装帐号

免费或开发者帐号都可以（为了安全考虑，请不要使用常用帐号安装！)

用于接收 2FA 验证码的手机

atvloadly 需要授权才能正常使用（会虚拟为一台 MacBook），登陆时苹果会向你安装帐号的注册手机号或已登陆了安装帐号的设备发送 2FA 验证码，请及时授权验证。

操作流程

打开 Apple TV 设置菜单，选择 遥控器与设备 -> 遥控器App与设备，进入配对模式
打开 Web 管理页面，正常会显示可配对的 AppleTV
点击 AppleTV 设备进入配对页面，并完成配对操作。
配对成功后返回首页，将显示已连接的 AppleTV
点击已连接的 AppleTV 进入侧载安装页面，选择需要侧载的 IPA 文件并点击安装。

外部证书（P12）签名

如果你已有代码签名证书，可以导入其 .p12 文件（及其密码，密码可以为空）和匹配的 .mobileprovision 描述文件（安装到 AppleTV 时需要包含该 AppleTV UDID 的 tvOS 描述文件），然后在安装页面选择外部证书。此模式不会要求也不会使用任何 Apple ID。以此方式签名的 App 不会自动刷新：到期时间取证书与描述文件中较早的到期时间，使用相同的证书和描述文件重新安装不会延长该日期。替换描述文件（或使用新的签名身份）后，重新安装或更新 App 即可应用新的到期时间。这些 App 同样可以从源（GitHub Releases 或 AltStore）安装并跟踪该源，其更新使用同一签名身份签名。

私钥使用部署密钥文件加密存储（配置项 signing.key_file，默认 /data/keys/signing-identity.key），请将其与数据库一起备份。atvloadly 没有登录鉴权，请只在可信网络中使用。

>> 外部证书使用说明（英文）

常见问题

1、免费帐号可以安装多少个应用

每个免费帐号最多注册 10 个 App，而且只能同时激活 3 个 App，安装超过 3 个后，会导致前面已安装的 App 变为不可用

2、找不到 AppleTV

请关闭 VPN，并重启 AppleTV，重新进入配对模式，确保在[工具]菜单中能发现 _remotepairing-manual-pairing._tcp 类型的设备，并重新配对连接

尝试重启 avahi-daemon 服务

可以尝试在 docker-compose.yml 中使用 privileged: true 或在 docker run 命令中使用 --privileged 替代 --security-opt seccomp:unconfined。

桌面版（macOS / Windows）不依赖 avahi-daemon：请确认 Apple TV 与电脑在同一网络，并允许应用通过本地防火墙使用 mDNS。

3、登陆苹果帐号失败

可能触发了苹果的风控，苹果对部分地区登录有限制。或者新建个帐号再试下。

4、IPA 安装后闪退

假如 IPA 需要 CloudKit 等权限，只有付费开发者帐号才能签名开通。atvloadly 侧载后会修改 IPA 的 Bundle Identifier，部分 IPA 也会限制导致闪退。

5、升级系统后安装失败

升级系统后需要重新配对，一般新出的系统都不支持，建议关闭系统自动更新

6、密码可以使用 App-specific password 吗，这样安全些

目前不支持

API

/healthcheck: 返回服务健康状态（200 表示运行正常，503 表示有 app 过期了）
/mcp: MCP 服务接口，Streamable HTTP传输方式，可以接入 AI Agent 安装或刷新 app

如何开发编译

>> wiki

致谢

Impactor：侧载核心

idevice：纯 Rust 实现的 libimobiledevice

usbmuxd2：Linux 上的 usbmuxd 实现

frida-core:: 远程配对连接参考

免责声明

本软件仅供学习交流使用，作者不对用户因使用本软件造成的安全风险或损失承担任何法律责任；
在使用本软件之前，你应了解并承担相应的风险，包括但不限于账号被冻结等，与本软件无关；