AppPorts代码签名管理深挖如何不碰开发者私钥备份并还原应用原始签名【免费下载链接】AppPorts A macOS utility to seamlessly migrate applications to external storage and reclaim local disk space.【一款 macOS 工具无缝迁移应用到外部存储并自动建立链接释放宝贵的本地空间】项目地址: https://gitcode.com/gh_mirrors/ap/AppPorts把应用迁移到外置盘后macOS 有时会弹出「应用已损坏」。AppPorts 的做法是迁移前给应用做一次Ad-hoc 重签名而重签名会抹掉开发者的原始签名。问题来了——开发者私钥在你我手里都没有签名丢了怎么还回来本文带你深挖 AppPorts 的代码签名管理方案它通过完整备份原始应用快照来实现签名备份与还原全程不需要开发者私钥也不会覆盖你的新版应用。一、为什么迁移应用要动代码签名macOS 用代码签名校验应用包的完整性。把应用本体搬到外置盘、本地只留一个轻量启动壳Stub Portal后某些应用会被系统认为「被改过」拒绝启动。这时对外置盘上的真实应用做一次 Ad-hoc 重签名codesign --force --sign -就能让它通过校验。但 Ad-hoc 重签名有代价它会抹掉原始开发者签名、沙盒授权、钥匙串授权等。旧版本只备份了一个「签名身份名称」字符串——这其实不能还原签名因为签名数据嵌在应用文件本身里光有名字没用。这就是 AppPorts 签名管理要解决的核心矛盾备份必须完整到能还原而私钥又根本拿不到。二、签名备份保存的是完整原始应用不是私钥答案在 SignatureSnapshot.swift 的开头注释里一句话点破签名包含 Mach-O 内嵌数据、嵌套代码和扩展属性必须保存完整应用不能只保存证书名称。AppPorts 的备份落在~/Library/Application Support/AppPorts/signature-backups/目录包含两部分文件作用BundleID.plist备份记录schema v2应用标识、原始签名身份、原始副本名、内容摘要original-UUID.app原始应用的完整快照主程序、嵌套帮助程序、框架、签名资源、原有授权一个字节不少关键设计有两点快照优先用写时复制APFS clone秒级完成且几乎不占额外空间不支持 clone 的文件系统会自动退回普通复制空间不足或复制失败会直接中止签名绝不带病执行。内容指纹防篡改SignatureSnapshot.fingerprint(of:)对快照内每个文件的内容、符号链接目标、以及com.apple.cs.*签名扩展属性做 SHA-256 摘要。指纹与路径无关——应用移到哪都不失效但只要内容被更新、文件丢失或签名属性变了指纹就会变恢复操作立即停止。备份完成后plist 记录里保存「原始指纹」之后每次重签名重签后的指纹也会追加进restorableFingerprints列表。这样系统随时知道当前应用是「原始版」还是「已重签版」两种状态都允许恢复。三、重签名流程工作副本 原子交换失败不伤原件重签名逻辑集中在 CodeSigner.swift 的sign(appURL:bundleIdentifier:)方法整个流程像一笔「银行转账」中间任何一步失败两边都保持原样解析真实应用本地启动壳软链 / Stub / 旧版 bash 启动器会先被 resolveAppURL(at:) 解析到外置盘上的真实.app签名永远作用于真实应用绝不签启动壳脚本也只解析不执行完整备份先保存原始应用快照并双重校验指纹一致工作副本签名在同一卷上复制一份工作副本在副本里解开嵌套项的uchg锁定 → 清理 Finder 杂项属性 → Ad-hoc 深度签名 →codesign --verify --deep --strict严格校验先持久化再交换把「原始指纹 重签指纹」写入备份记录后才用renameatx_np(RENAME_SWAP)把工作副本与当前应用原子互换恢复锁定状态应用原有的不可变文件锁在交换后逐条还原。两个容易忽视的安全细节沙盒应用默认拒绝com.apple.security.app-sandbox为 true 的应用直接抛sandboxedApplication错误只有经典数据迁移模式经用户二次确认后才放行因为重签会拆掉沙盒身份容器数据应改用挂载迁移不支持原子交换的存储直接报错而不是降级成「先删后复制」——删了复制失败就是真丢了。对应的回归测试见 CodeSignerTests.swift 与 MigrationSigningIntegrationTests.swift覆盖真实签名包的备份/重签/恢复往返。四、还原原始签名不重新签名只换回原文件这是整套方案最优雅的地方原始签名本来就保存在应用文件里所以还原签名 用备份的原始应用换回当前应用全程不执行任何签名操作自然也不需要开发者私钥。restoreSignature(appURL:bundleIdentifier:originalApplication:) 的验证链条读备份记录取出original-UUID.app快照并重新校验指纹——快照损坏或已被改动就直接停止现有应用和备份都保留核对当前应用的指纹必须在「可恢复指纹」列表里——如果你之后从官方渠道更新了应用旧备份绝不会覆盖新版报applicationChanged并给出明确指引再做一次工作副本 codesign --verify --deep --strict严格验证原始签名有效原子交换替换当前应用连 ACL、Finder 元数据这些不进摘要的属性也一并还原交换成功后才清理备份清理失败只记日志、不谎报恢复失败。恢复入口有三处应用列表右键「恢复原始签名」、数据页工具栏、以及修复面板 SignatureRepairSheet.swift——它按「还原容器数据 → 恢复签名或重装 → 可选挂载迁移」三步引导且任何一步都不会删除你的数据。五、旧备份和「签名已替换」提示怎么办旧版只有身份名称的记录无法凭空还原。AppPorts 会保留记录并提供「选择原版应用…」你从官方渠道取到同应用同版本的原版.app工具会核对 Bundle ID、版本号、开发者身份和严格签名校验全部通过才替换选错版本会被originalApplicationMismatch拦下。「签名已替换」红色徽标扫描时 AppScanner 会读备份里的原始签名身份发现「备份是开发者签名 当前是 Ad-hoc」就标记signatureReplaced首次启动弹一次提醒关闭状态持久化不会反复打扰扫描过程也永不删除恢复材料。官方更新后的新恢复点更新后的应用若开发者身份与旧记录一致且严格校验通过再次重签会为新版本建立新快照旧记录归档到signature-backups/retired/、旧副本保留绝不把新旧摘要混在一个恢复点里。六、开机自动重签名脚本的「克制」AppPorts-ReSign.sh 是登录时运行的 LaunchAgent用来重签那些 Ad-hoc 签名可能被 Gatekeeper 在重启后失效的应用。值得注意的是它跳过所有 schema v2 的完整快照记录第 63–69 行——这类备份必须由主程序走「指纹校验 事务替换」的完整流程脚本绕过去是不安全的同时它也跳过启动壳、非 Ad-hoc 应用和沙盒应用。总结AppPorts 的代码签名管理可以浓缩成三句话备份不备份私钥备份应用本身——签名数据在文件里完整快照就是完整签名一切改动先在工作副本完成并验证再原子交换——失败时原件和备份都原封不动指纹贯穿始终——快照损坏、应用更新、内容被改恢复都会安全停止并保留现场。想进一步了解的读者可以继续读官方文档重签名与崩溃防护、容器数据、沙盒与签名身份核心源码CodeSigner.swift、SignatureSnapshot.swift、DataMigrationWorkflow.swift【免费下载链接】AppPorts A macOS utility to seamlessly migrate applications to external storage and reclaim local disk space.【一款 macOS 工具无缝迁移应用到外部存储并自动建立链接释放宝贵的本地空间】项目地址: https://gitcode.com/gh_mirrors/ap/AppPorts创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考