atvloadly：Apple TV 应用侧载工具

项目简介

atvloadly 是一个支持给 Apple TV 侧载（sideload）应用的 Web 服务。它以 Impactor 作为底层侧载技术，并会自动刷新应用，保证长期可用。它既能以 Docker 服务的形式运行在 Linux / OpenWrt 上，也提供 macOS 与 Windows 的原生桌面应用。

主要功能

• 以 Docker 运行（Linux/OpenWrt），或使用原生桌面应用（macOS / Windows）
• 支持 Apple TV 配对
• 支持应用自动刷新
• 支持跟踪 GitHub releases / AltStore 源，手动或自动更新应用
• 支持多个 Apple ID 账号
• 支持用自有证书（P12 + 描述文件）签名，无需 Apple ID
• 支持多语言（i18n）
• 支持以自定义 bundle identifier 安装应用，与原应用并存

安装与使用

Docker（Linux / OpenWrt）

宿主机需要先安装 avahi-daemon：

opkg install avahi-dbus-daemon        # OpenWrt
sudo apt-get -y install avahi-daemon  # Ubuntu

然后运行容器，注意修改挂载目录，并把宿主机的 /var/run/dbus、/var/run/avahi-daemon 共享给容器：

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

使用 host 网络并修改监听端口时，可给容器添加环境变量 SERVICE_PORT=5533。也可以下载 docker-compose.yml 后执行 docker compose up -d。

桌面应用（macOS / Windows）

macOS 15+（Homebrew）：

brew install --cask bitxeno/tap/atvloadly

Windows 10/11（x64 / arm64）：从 Releases 下载 .exe 安装包运行。

使用流程

1. 在 Apple TV 设置中进入 遥控器与设备 -> 遥控器 App 与设备，进入配对模式。
2. 打开 Web 管理页面，通常会显示可配对的 AppleTV。
3. 点击该设备进入配对页面，完成配对。
4. 回到首页，会显示已连接的 AppleTV。
5. 点击已连接的设备进入侧载页面，选择 IPA 文件，点击安装。

外部证书（P12）签名

已自有签名证书时，可导入 .p12（含密码）和匹配的 tvOS .mobileprovision 描述文件，在安装页选择「外部证书」，全程不需要 Apple ID。此类应用不会自动刷新，到期时间取证书与描述文件两者中较早者；用同样的证书与描述文件重装也不会延长期限。私钥由部署密钥文件加密保存（signing.key_file，默认 /data/keys/signing-identity.key），请与数据库一起备份。

注意事项

• 建议准备一个专用（一次性）Apple ID 用于安装，免费账号或开发者账号均可；为安全起见不要使用常用账号。
• 需要一个能接收两步验证码的手机号；登录时 atvloadly 会被虚拟为一台 MacBook，需要及时完成信任与验证。
• 每个免费 Apple ID 最多注册 10 个应用、同时激活 3 个，超过后先前安装的应用会不可用。免费账号证书数量有限，证书占满时 atvloadly 不会自行吊销，而会在安装页询问是否吊销。
• 找不到 Apple TV 时：关闭 VPN、重启 Apple TV 后重新进入配对模式；重启 avahi-daemon；或改用 privileged: true / --privileged；桌面应用则检查是否同网段、防火墙是否放行 mDNS。
• 系统升级后需要重新配对，通常新系统暂不被支持，建议关闭自动更新。
• 部分依赖 CloudKit 等权限的 IPA 只有付费开发者账号才能签名启用；侧载会修改 Bundle Identifier，个别 IPA 可能因此崩溃。
• 目前不支持 App 专用密码登录。
• 服务本身没有身份验证，请部署在可信网络中；本软件仅供学习交流使用，使用风险由使用者自行承担。

本作品整理自 GitHub 开源项目 bitxeno/atvloadly，原作者 @bitxeno，许可证 AGPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。