# oneduo **Repository Path**: remon8/oneduo ## Basic Information - **Project Name**: oneduo - **Description**: 一键签:用自己的 Apple ID 免费签名,把 App 装到 iPhone / iPad,支持 Wi‑Fi 自动续签 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-20 - **Last Updated**: 2026-11-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

一键签

一键签

用自己的 Apple ID 免费签名,或导入证书签名,把 App 一键装到 iPhone / iPad。
支持添加软件源,到期前自动续签,有新版自动更新,同一个 Wi‑Fi 下不用插线。

下载 Windows 版 · 下载 Mac 版

![一键签主界面](docs/tutorial/01-home.png) --- ## 使用教程 ### 1. 下载安装 到 [发行版](https://gitee.com/remon8/oneduo/releases) 下载对应系统的安装包。 **Windows 10 / 11(64 位)**: 1. 下载 `OneDuo-x.y.z-windows-x64-setup.exe`,双击运行。 2. 弹出蓝色的「**Windows 已保护你的电脑**」:点左边的 **更多信息**,再点出现的 **仍要运行**。 > 一键签没有购买微软代码签名证书,所以 Windows 会提示一次,不是病毒。只有第一次安装会出现。 3. 弹出「你要允许此应用对你的设备进行更改吗?」:点 **是**。 4. 按安装向导点 **下一步** 到完成。建议保留「开机自动启动」,自动续签要靠它。 安装时会自动装好苹果手机驱动和 Bonjour(Wi‑Fi 找手机用),不需要另装 iTunes。 > 如果浏览器提示「不常下载」并拦住了下载:Edge 点下载列表里的 **⋯ → 保留 → 仍然保留**;Chrome 点 **保留**。 > > 如果杀毒软件(360、火绒等)拦截,选 **允许** 或把它加入信任,再重新运行安装包。 **Mac(Apple 芯片和 Intel 都支持,macOS 11 及以上)**:下载 `OneDuo-x.y.z-macos-universal.zip`,解压后把「一键签」拖进「应用程序」,双击打开。已通过苹果公证,不会被系统拦截。 ### 2. 连接手机 用数据线把 iPhone / iPad 连到电脑,解锁手机。弹出「要信任此电脑吗?」点 **信任**,输入锁屏密码。 连上后,窗口底部会显示手机名字。 ### 3. 选 App,点一键安装 左边选要装的 App,右边点 **一键安装**。 ![选择 App](docs/tutorial/02-app-selected.png) ### 4. 登录 Apple ID 第一次安装要登录 Apple ID,之后会记住,不用每次输入。 ![登录 Apple ID](docs/tutorial/03-login.png) - 账号密码只发给苹果官方,不经过我们,也不保存密码。 - **建议用 Apple ID 小号**:免费签名会在账号里生成开发证书,用小号不影响主号的 iCloud 和购买记录。 ### 5. 输入验证码 开了双重认证的账号会要验证码。苹果会推送到**登录着这个 Apple ID 的 iPhone / iPad / Mac**,在那台设备上点「允许」后会显示 6 位数字。 ![输入验证码](docs/tutorial/04-2fa.png) - 没弹出来:点 **重新发送到设备**。 - 小号没有登录在任何设备上:点 **改用短信发到尾号 xx**。 ### 6. 等它装完 下载、签名、安装都是自动的,一般十几秒到一分钟。装的时候保持手机解锁,别拔线。 ![安装中](docs/tutorial/05-installing.png) ### 7. 在手机上信任 装完后第一次打开 App 前,在手机上: 1. **设置 → 通用 → VPN 与设备管理**,点你的 Apple ID,点 **信任**。 2. 如果提示需要开发者模式:**设置 → 隐私与安全性 → 开发者模式**,打开后按提示重启。 ![安装完成](docs/tutorial/06-done.png) ### 8. 自动续签、自动更新 免费 Apple ID 签的 App 只能用 **7 天**。一键签会记住你装过什么,在「我的手机」里显示每个 App 还剩几天。 ![我的手机](docs/tutorial/07-my-phones.png) - **到期前 2 天自动重新签名**,App 里的数据不会丢。 - **有新版本自动装上**,也可以点「检查更新」马上查。 - **不用插线**:用数据线装过一次后,一键签会自动打开手机的「通过 Wi‑Fi 连接」。之后手机和电脑在同一个 Wi‑Fi 下就能续签。 - **开机自动启动**(安装时默认勾选):电脑开着它就在后台挂着,续签不会漏。 ### 9. 装自己的 IPA 不在列表里的 App,可以点左下角 **+ 添加自己的 IPA**,或者直接把 `.ipa` 文件拖进窗口,然后同样点一键安装。 ![拖入 IPA](docs/tutorial/08-drop-ipa.png) --- ### 10. 添加软件源 和全能签的「软件源」用法一样。打开 **软件源与证书**,把源地址粘进去点 **添加**,源里的 App 就会出现在「装 App」列表里(按源分组,可以搜索),点一键安装自动下载、签名、装上。 ![软件源](docs/tutorial/09-sources.png) ![添加软件源](docs/tutorial/10-add-source.png) - 支持全能签 / ESign / AltStore / SideStore 的软件源格式。 - 「一键签官方源」(DouDuo)是默认源,固定在第一位,不能删除。 - 装过的 App 有新版本,会和官方 App 一样在后台自动更新。 - 需要解锁码的 App、网盘链接的 App 会显示「不支持」,不能直接装。 ### 11. 用证书签名(全能签模式) 有证书的话(证书提供方给的 **.p12 证书 + 密码 + .mobileprovision 描述文件**),可以不用 Apple ID: 1. **软件源与证书 → 签名方式 → + 导入证书**,选 .p12、填密码、选描述文件,点 **导入**。 ![导入证书](docs/tutorial/11-import-cert.png) 2. 一键签会检查证书和描述文件是否配套、有没有过期,导入后自动切到这张证书。可以随时在免费 Apple ID 和证书之间切换。 ![选择签名方式](docs/tutorial/12-cert-selected.png) 3. 之后点一键安装就用证书签名(不用登录 Apple ID)。证书签的 App 跟着证书到期(一般一年),没有 7 天和同时 3 个的限制;有新版本照样自动更新。 ![用证书安装](docs/tutorial/13-install-with-cert.png) 注意: - 描述文件里要有你的手机。页面底部会显示当前手机的 UDID,发给证书提供方加进去。 - 描述文件绑定的是 **通配符(*)** 才能签任意 App;只绑定了某一个 App 的,只能签那一个。 - 证书被苹果吊销(掉签)后 App 会打不开,这是证书本身的问题,换一张证书重装即可。证书和密码只保存在你自己的电脑上。 ## 常见问题 **App 打开就闪退** 签名过期了。打开一键签,在「我的手机」里点 **立即全部续签**。 **提示「同时最多 3 个」/ 装不上第 4 个** 免费 Apple ID 最多同时装 3 个自签 App。先在手机上删掉一个不用的,再装。 **提示「7 天内最多 10 个 App ID」** 免费 Apple ID 每 7 天最多给 10 个不同的 App 签名。过几天再装,或换一个 Apple ID。 **签名失败 / 验证失败** 先在手机 Safari 打开 [icloud.com](https://www.icloud.com),用同一个 Apple ID 登录一次(同意条款、完成双重认证),再回来重新安装。 **找不到手机** - 换一根数据线,或换个 USB 口。 - 手机解锁,重新点一次「信任」。 - Windows:重新运行一次安装包(会修复驱动);还不行就重启电脑。 **装好的 App 跟原来的不是同一个** 免费签名时苹果要求包名加上你的团队后缀,所以会作为新 App 装上,跟别处装的原版并存。 --- ## 自己编译 需要 Rust 和 Python 3.12+。 ```bash # Mac cd py && ./build_mac.sh # Windows 版签名组件(在 Mac 上交叉编译) cargo build --release -p plumesign --target x86_64-pc-windows-gnu # 然后在 Windows 上: powershell -ExecutionPolicy Bypass -File py\packaging\build_win.ps1 ``` 应用列表在 [`catalog/apps.json`](catalog/apps.json),加一个 App 只要往里加一条,不用改程序。 ## 致谢 签名核心基于 [Impactor](https://github.com/claration/Impactor)(MIT 协议),感谢原作者。