iloader 完整使用指南：免费一键把 SideStore 装进 iPhone
【免费下载链接】iloaderUser friendly sideloader项目地址: https://gitcode.com/GitHub_Trending/iloa/iloader
iloader 是一款免费的 iOS 侧载工具（sideloading，把 App Store 之外的应用装到 iPhone 上）。登录 Apple ID、签名、安装、放置配对文件，全流程图形界面完成，不用碰一行命令行。它内置了 SideStore 与 LiveContainer 的一键安装，支持导入任意 IPA 文件，还能管理证书、App ID 和配对文件，界面内置 28 种语言，适合第一次做侧载的新手。
环境怎么准备：先接上设备再打开 iloader
这一节解决"打不开、识别不到 iPhone"的问题。装好 iloader 只是起点，通信链路必须先通。
iloader 通过 usbmuxd 与 iPhone 通信（usbmuxd 是负责在电脑和 iOS 设备之间转接 USB 连接的守护进程，iOS 设备通信都靠它）。三个平台的前置条件不一样：
| 平台 | 通信组件怎么来 |
|---|---|
| Windows | 安装 iTunes 提供；若 iTunes 下设备识别有问题，按 iloader 的建议卸载 iTunes 与 Apple Mobile Device Support，改装 Microsoft Store 里的 "Apple Devices" |
| macOS | 系统自带，不用动 |
| Linux | 通常发行版已内置，缺了用包管理器装 usbmuxd |
然后：
- 用数据线把 iPhone 连上电脑，插紧，插错线是后面大部分"设备通信失败"的根源；
- 手机上弹出"要信任此电脑吗"就点信任；
- 打开 iloader，左侧"设备"区出现你的 iPhone 才算链路通了。
登录与选设备：两件事都不对，后面全卡住
这一节解决"点了安装按钮却没反应"的问题——iloader 在动手前会先检查登录状态和设备选择，缺哪个都会直接弹窗拦住你，这其实是好事。
- 左侧"账户"区输入 Apple ID 登录。开启双重认证的账号会额外要验证码，按提示填。凭据存进系统 keyring（系统的加密凭证保险柜），以后自动登录。Linux 上如果 keyring 不可用，设置里勾选 "Don't use keyring" 可降级为明文落盘（安全性更低，报错提示里也会这么建议）；
- "设备"区点选目标 iPhone，旁边会标出设备名与系统版本，确认选对了再继续。
三步把 SideStore 装进 iPhone
这一节是主菜：跑完这一节，你手里就有了 iOS 侧载圈最常用的入口。
- 在右侧"安装器"区点SideStore 稳定版（另有"每夜构建版"给尝鲜党）。点击后进度面板依次点亮三步：下载 → 签名并安装 → 放置配对文件。
- 三步全绿，进度面板会给出成功提示。这时在 iPhone 上打开 SideStore 按引导走完信任步骤即可收尾 ⚡
- 中途某一步变红，点进去看建议，直接跳到下面"报错看不懂"一节按图索骥。
"安装器"区一共有五个按钮：SideStore 稳定版 / 每夜构建版、LiveContainer + SideStore（稳定版与每夜构建版各一个）、导入 IPA。后两者是给想在容器里跑应用的人准备的组合。
核心侧载逻辑（下载、签名、安装、放文件）都在这份 Rust 模块里：src-tauri/src/sideload.rs。
日常使用：导入任意 IPA，配对文件一键投放
这一节解决"SideStore 之外我还想装点别的"的问题。
- 导入 IPA：IPA 就是 iOS 应用的安装包格式。点按钮、选本地文件，签名和安装自动完成，进度面板只有一步（安装），因为文件已经在手上了；
- 配对文件管理（快捷键 Ctrl+P / macOS 上 ⌘P）：iloader 内置了 SideStore、LiveContainer、Feather、StikDebug、Protokolle、StikTest、ByeTunes、Reynard 等十余款 App 的文件路径映射，选中目标 App 后一键生成 rppairing 与 lockdown 两份配对文件并写入对应目录，实现见 配对文件管理。SideStore 装好时这一步是自动做的，手动管理是给其他 App 用的；
- 常用快捷键：Ctrl+P / ⌘P 配对文件管理，Ctrl+Shift+C / ⌘⇧C 证书管理，Ctrl+Shift+A / ⌘⇧A App ID 管理，Ctrl+R / ⌘R 刷新设备。
免费账号额度不够怎么办
这一节解决"装到一半提示额度用完"的问题。先摆清免费 Apple ID 的两个固定限制：
- 同一账号同时最多装3 个侧载 App，注意：过期没删的 App 也占额度；
- 装完约7 天签名到期，要重新签名安装，这也是大家都要装 SideStore 的原因——装好它之后，很多 App 可以放进 SideStore 里跑，绕开额度。
用满额度后新安装会失败，iloader 的处理是：自动弹出现有开发证书列表，勾选要撤销的旧证书，它随即撤销并生成新证书，逻辑在 登录与证书处理。
左侧"管理"区还有两个入口供主动清理：
| 按钮 | 能做什么 |
|---|---|
| 证书 | 列出账号下全部开发证书，逐个撤销 |
| App ID | 列出已用的 App ID，逐个删除 |
App ID 用完而证书没满时，等 7 天让旧 App ID 自动过期（这期间不能手动删）；官方提示里还有一条捷径——尽量从 SideStore 内部再装 App，那样消耗的 App ID 更少。
常见报错及处理：照着弹窗抄就行
这一节解决"红字一堆看不懂"的问题。iloader 把常见错误归成十几种类型，每种挂一组可操作的建议，映射关系见 智能错误建议：
| 错误场景 | iloader 给的建议（节选） |
|---|---|
| 未登录 / 未选设备 | 先登录 Apple ID；先点选设备 |
| 设备通信失败 | 重插设备，换 USB 口和线 |
| usbmuxd 问题 | Windows 装 iTunes（不行就改装 "Apple Devices"）；Linux 确认 usbmuxd 在跑 |
| anisette 网络问题 | 确认电脑能上网，换一个 anisette 服务器多试几个 |
| keyring / 权限 | 设置里勾选 "Don't use keyring"（安全性降低）；或用管理员/root 权限运行 |
| 证书上限 / 3 个 App 上限 | 弹证书列表撤销旧的；删掉不用的侧载 App |
弹窗里内置Copy to clipboard按钮，完整错误一键复制，贴给社区或 issue 求助最省事。
日志排查路线：
- 应用内"查看日志"；什么都没输出，就把日志级别调到 Debug 再看；
- 本地日志文件按平台固定存放：
- Windows：
%APPDATA%\me.nabdev.iloader\logs - macOS：
~/Library/Application Support/me.nabdev.iloader/logs - Linux：
~/.local/share/me.nabdev.iloader/logs/
- Windows：
从源码构建与多语言生态（进阶）
这一节给想折腾或想贡献的人。iloader 用 Tauri 构建：界面是 React + TypeScript（主界面见 src/App.tsx），后端是 Rust。构建需要 bun（或 Node.js）加 Rust 工具链，clone 后跑这几条命令：
git clone https://gitcode.com/GitHub_Trending/iloa/iloader cd iloader bun i bun tauri dev # 开发模式，热重载；加 build 子命令出正式安装包几点周边信息：
- 应用内置自动更新，启动时检查新版本，确认提示后自动下载并重启，当前仓库版本 2.4.1；
- 官方渠道提供 Windows / macOS / Linux 安装包，NixOS 走 flake；社区另外维护 Homebrew cask、AUR 包和 Fedora COPR 仓库；
- 界面内置 28 种语言，简体中文语言包在 src/locales/zh_cn.json。想补翻译，直接改对应的 locale JSON；加新语言则在
src/i18next.ts注册并复制en.json改文案； - 源码是 MIT 协议；品牌素材（logo、"iloader" 名称）受独立协议约束，引用时需保留指向官方仓库的链接。
只有一台电脑、一台 iPhone，又想装 App Store 之外的东西：iloader 把登录、签名、安装、放文件这些最容易踩坑的环节全换成了按钮和进度条，报错时它直接把下一步建议写进弹窗——从打开应用到 SideStore 跑起来，全程零命令行 🛠️
【免费下载链接】iloaderUser friendly sideloader项目地址: https://gitcode.com/GitHub_Trending/iloa/iloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
