README_cn.md

English | 中文

atvloadly 是一个支持在 AppleTV 上侧载应用的 web 服务。底层通过使用 Sideloader 实现侧载，并会自动刷新 App 以保证其长期可用性。

主要功能

• docker 运行 (只支持 Linux/OpenWrt 平台)
• 支持 AppleTV 配对
• 支持自动刷新 app
• 支持同时使用多个 Apple ID 帐号
• i18n 多语言支持

截图

安装

😔 只支持 Linux/OpenWrt 系统，不支持 Mac/Windows 系统

1. 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
   

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

   docker run --privileged	-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 容器使用

使用方法

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

1. 专用的 Apple ID 安装帐号

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

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

atvloadly 需要授权才能正常使用（会虚拟为一台 MacBook），安装时苹果会向你安装帐号的注册手机号或已登陆了安装帐号的设备发送授权验证码，请及时授权验证。（超时不验证授权验证码，会导致帐号被临时冻结！需要重置密码才能恢复）

操作流程

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

常见问题

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

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

2、升级系统后安装失败

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

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

目前不支持

推荐开源 App

>> wiki

如何开发编译

>> wiki

赞助

如果觉得项目对您有帮助，欢迎赞助一杯咖啡 ❤️

免责声明

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