# 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 版

---
## 使用教程
### 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,右边点 **一键安装**。

### 4. 登录 Apple ID
第一次安装要登录 Apple ID,之后会记住,不用每次输入。

- 账号密码只发给苹果官方,不经过我们,也不保存密码。
- **建议用 Apple ID 小号**:免费签名会在账号里生成开发证书,用小号不影响主号的 iCloud 和购买记录。
### 5. 输入验证码
开了双重认证的账号会要验证码。苹果会推送到**登录着这个 Apple ID 的 iPhone / iPad / Mac**,在那台设备上点「允许」后会显示 6 位数字。

- 没弹出来:点 **重新发送到设备**。
- 小号没有登录在任何设备上:点 **改用短信发到尾号 xx**。
### 6. 等它装完
下载、签名、安装都是自动的,一般十几秒到一分钟。装的时候保持手机解锁,别拔线。

### 7. 在手机上信任
装完后第一次打开 App 前,在手机上:
1. **设置 → 通用 → VPN 与设备管理**,点你的 Apple ID,点 **信任**。
2. 如果提示需要开发者模式:**设置 → 隐私与安全性 → 开发者模式**,打开后按提示重启。

### 8. 自动续签、自动更新
免费 Apple ID 签的 App 只能用 **7 天**。一键签会记住你装过什么,在「我的手机」里显示每个 App 还剩几天。

- **到期前 2 天自动重新签名**,App 里的数据不会丢。
- **有新版本自动装上**,也可以点「检查更新」马上查。
- **不用插线**:用数据线装过一次后,一键签会自动打开手机的「通过 Wi‑Fi 连接」。之后手机和电脑在同一个 Wi‑Fi 下就能续签。
- **开机自动启动**(安装时默认勾选):电脑开着它就在后台挂着,续签不会漏。
### 9. 装自己的 IPA
不在列表里的 App,可以点左下角 **+ 添加自己的 IPA**,或者直接把 `.ipa` 文件拖进窗口,然后同样点一键安装。

---
### 10. 添加软件源
和全能签的「软件源」用法一样。打开 **软件源与证书**,把源地址粘进去点 **添加**,源里的 App 就会出现在「装 App」列表里(按源分组,可以搜索),点一键安装自动下载、签名、装上。


- 支持全能签 / ESign / AltStore / SideStore 的软件源格式。
- 「一键签官方源」(DouDuo)是默认源,固定在第一位,不能删除。
- 装过的 App 有新版本,会和官方 App 一样在后台自动更新。
- 需要解锁码的 App、网盘链接的 App 会显示「不支持」,不能直接装。
### 11. 用证书签名(全能签模式)
有证书的话(证书提供方给的 **.p12 证书 + 密码 + .mobileprovision 描述文件**),可以不用 Apple ID:
1. **软件源与证书 → 签名方式 → + 导入证书**,选 .p12、填密码、选描述文件,点 **导入**。

2. 一键签会检查证书和描述文件是否配套、有没有过期,导入后自动切到这张证书。可以随时在免费 Apple ID 和证书之间切换。

3. 之后点一键安装就用证书签名(不用登录 Apple ID)。证书签的 App 跟着证书到期(一般一年),没有 7 天和同时 3 个的限制;有新版本照样自动更新。

注意:
- 描述文件里要有你的手机。页面底部会显示当前手机的 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 协议),感谢原作者。