iloader 上手指南：3 分钟装好 iOS 侧载工具｜Windows / macOS / Linux 全平台
【免费下载链接】iloaderUser friendly sideloader项目地址: https://gitcode.com/GitHub_Trending/iloa/iloader
iloader 是一款免费开源的 iOS 侧载工具：你把 iPhone 连上电脑、登录 Apple ID，它就能帮你装 SideStore、导 IPA、摆好配对文件，全程不用碰命令行。最短路径就四件事：下载对应平台的安装包 → 确认 usbmuxd 就绪 → 打开应用 → 登录 Apple ID，3 分钟能跑起来。
快速跑起来：按平台三步装好
⚠️ 三个平台都要注意一件事：iloader 靠usbmuxd服务跟 iPhone 通信，缺了它设备根本连不上，下面每步已把对应处理写进去了。
Windows 安装：先装 iTunes，再装 iloader
- 安装 iTunes（随包附带 usbmuxd 驱动）
- 到项目官方 Release 发布页下载 Windows 安装包，按向导装完
- 双击桌面图标启动 iloader
macOS 安装：拖进应用程序文件夹就行
- 下载 macOS 应用包，拖入「应用程序」文件夹（也可用社区维护的 cask：
brew install --cask iloader） - 打开应用即可，macOS 系统自带 usbmuxd，没有额外步骤
Linux 安装：先确认 usbmuxd 在不在
- 若系统没有 usbmuxd，用包管理器装：
sudo apt install libusbmuxd-tools - 下载 Linux 压缩包，解压运行
- 打开后登录 Apple ID，就可以开始侧载了
能力速览：iloader 能帮你做哪些事
- 一键安装 SideStore（或 LiveContainer + SideStore），自动导入开发证书并把 rppairing/lockdown 配对文件摆到正确位置
- 导入任意 IPA 文件，装到你的 iPhone / iPad
- 管理 SideStore、StikDebug、Protokolle 等应用里的配对文件
- 查看并吊销你名下的开发证书和 App ID
- 出错时给出针对具体原因的建议，帮你定位常见坑
安装 SideStore 的「下载 → 安装 → 配对」三步流程定义在 src/components/operations.ts 里，想看进度条每步对应什么逻辑可以直接翻这个文件。界面支持简体中文在内的 28 种语言，中文文案在 src/locales/zh_cn.json。
平台差异对比：各平台前置条件一张表
| 平台 | 前置条件 | 获取方式 / 命令 |
|---|---|---|
| Windows | usbmuxd 驱动 | 安装 iTunes（随包附带 usbmuxd） |
| macOS | 无，usbmuxd 系统自带 | 直接打开应用；或brew install --cask iloader |
| Linux | usbmuxd 服务（部分发行版不带） | sudo apt install libusbmuxd-tools（或对应发行版包管理器） |
特殊发行版补充：
- NixOS：用仓库里的 flake 构建安装，打包配置见 flake.nix
- Arch Linux：装社区维护的 AUR 包
iloader-bin - Fedora：可用官方 Release 里的 .RPM，或社区 COPR 源
进阶：从源码编译 iloader（折腾向）
技术栈一句话：前端是 React + Vite（TypeScript），后端是 Rust，两者通过 Tauri 框架拼成一个桌面应用。跟 iOS 设备打交道的idevice、isideload等 Rust 依赖都声明在 src-tauri/Cargo.toml。
- 装好 bun（或 Node.js）和 Rust 工具链
- 克隆仓库、进入目录、装依赖：
git clone https://gitcode.com/GitHub_Trending/iloa/iloader cd iloader bun i # 等价 npm i- 开发模式（支持热更新）：
bun tauri dev（等价npm run tauri dev） - 生产构建：
bun tauri build（等价npm run tauri build）
装完后的第一个任务：把 SideStore 装到手机上
- 连接设备：用数据线把 iPhone / iPad 插上电脑
- 登录账号：在 iloader 里登录你的 Apple ID
- 选操作：点「安装 SideStore」，应用会自动走完下载、安装、配对文件放置三步，进度分步展示
- 等进度：全程不用切窗口，跑完手机上就多一个 SideStore 图标
💡 搞定，手机解锁状态放桌上就能用了。
出了问题看这里：日志在哪找
- 先在应用里点View Logs看日志；什么都没有的话，去设置页把日志级别切到
Debug，再操作一次 - 要更详细的日志，去下面对应路径找：
- Windows：
%APPDATA%\me.nabdev.iloader\logs - macOS：
~/Library/Application Support/me.nabdev.iloader/logs - Linux：
~/.local/share/me.nabdev.iloader/logs/
- Windows：
- 还解决不了，把完整报错原文复制去社区问（idevice Discord 服务器）或直接开 issue —— 贴完整报错比描述"我点哪一下坏了"有效 10 倍
窗口尺寸、自动更新这类行为配置在 src-tauri/tauri.conf.json，想确认某个版本的默认行为可以顺手看一眼。
延伸阅读
- README.md：官方说明，排错一节比这篇文章更详细
- CONTRIBUTING.md：贡献规范，想参与开发先看这个
- 社区支持：idevice Discord 服务器，搜索 "idevice" 即可找到
【免费下载链接】iloaderUser friendly sideloader项目地址: https://gitcode.com/GitHub_Trending/iloa/iloader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
