CI/CD / DevOps

fastlane match 共享 Mac 怎么部署:2026 企业签名隔离指南

先看结论:按信任域拆分,发布节点独立

fastlane 官方文档明确说明,match 可以把证书与 Provisioning Profile 存放在 Git、对象存储中,并支持按 Apple 团队区分;setup_ci 还会创建临时 Keychain,并让 CI 进入 readonly 模式。(fastlane match 官方文档)

因此,fastlane match 共享 Mac 部署的获胜方案不是“所有项目共用一份配置”,而是按 Apple 团队、项目可信度和任务权限拆分签名资产:普通 CI 只读同步,任务期间使用临时 Keychain,正式发布进入独立 Mac 节点或专用发布池。不要让所有项目共用同一套存储权限、常驻 Keychain 和可写发布凭据。

这篇文章适合三类人:

  • 管理多个 iOS 应用的技术负责人,用来避免共享构建机上的证书误用与责任不清。
  • 负责 CI/CD 平台的工程负责人,用来建立只读同步、临时 Keychain 和发布节点隔离基线。
  • 负责安全审计、人员离职交接的企业 IT,用来设计撤权、凭据轮换和事件响应流程。

先划清边界:match 同步资产,不等于完成隔离

很多团队把 match 仓库拆开后,就认为签名环境已经安全。这个判断并不成立。

match 主要解决的是证书、私钥和 Provisioning Profile 的同步,以及在不同 Mac 和 CI 节点上的一致安装。官方文档同时说明,Git 存储中的签名文件会经过加密,多个 Apple 团队可以使用不同分支,云对象存储则可以按 Team ID 组织目录。(fastlane match 官方文档)

但它不会自动替团队完成以下隔离:

  1. 主机隔离:共享 Mac 上已有的 login.keychain 可能残留其他项目的私钥。
  2. 仓库隔离:拥有同一签名仓库读取权限的任务,可能拿到超出自身项目范围的资产。
  3. 账号隔离:Apple Developer 账号、App Store Connect API Key 和 CI 服务账号属于不同权限面。
  4. 任务隔离:普通测试、合并请求验证和正式发布不应拥有同等的签名能力。
  5. 责任隔离:如果多个项目都能改写证书仓库,出现证书替换、Profile 重建或发布失败时,很难还原责任链。
  6. 生命周期隔离:证书、Profile、仓库解密密码和 API Key 的失效时间及轮换动作并不相同。

Apple 官方资料显示,证书被撤销后,包含该证书的 Provisioning Profile 会失效;因此,不能把“撤销证书”当作没有后果的单点补救动作。(Apple 证书撤销说明)

⚠️ 注意:match 仓库即使采用加密存储,也不能抵消错误的读取权限。能够读取仓库、获得解密密码并访问共享 Mac 的任务,仍可能组合出完整签名能力。

单应用试点:先做最小可用的签名边界

如果团队只有一个可信应用,适合先建立单应用试点,而不是一开始就把所有业务线塞进同一个签名池。

资产范围

为该应用明确记录:

  • Apple Developer Team ID;
  • 应用的 Bundle ID;
  • 使用的证书类型,例如开发或发布证书;
  • 对应的 Provisioning Profile;
  • 签名仓库路径、分支或对象存储前缀;
  • 负责初始化和更新签名资产的人员;
  • 负责日常 CI 构建的服务主体。

match 支持多个 Bundle Identifier,也允许同一 Apple 团队的多个应用复用签名身份,同时为每个应用创建不同的 Provisioning Profile。(fastlane match 官方文档)

但“可以复用”不代表“应该复用”。如果应用的发布权限、数据敏感度或责任人不同,就应优先拆开 CI 任务和发布凭据。

管理任务与日常 CI

签名流程至少应拆成两类:

  • 管理任务:初始化证书、更新 Profile、处理设备变化、证书到期和权限变更。该任务可以写入签名存储,但必须由受控账号执行。
  • 日常 CI:只拉取已存在的证书和 Profile,不创建新资产、不修改仓库、不调用高权限 Apple API。

fastlane 官方建议在 CI 中使用 readonly,以避免流水线自动创建新的证书或 Profile;如果 CI 没有 Apple Developer Portal 的管理权限,也应使用该模式。

试点验收

单应用上线前,至少保留以下证据:

  • 签名存储的读取和写入记录;
  • 同一提交在干净节点上的可重复构建结果;
  • 临时 Keychain 创建、使用和清理记录;
  • 错误 Bundle ID 或错误 Team ID 下的失败日志;
  • 证书仓库不可用时的回退路径;
  • 发布失败后是否能在不扩大权限的前提下重试。

多应用共享:同一团队也要按敏感度拆分

多个 iOS 项目属于同一个 Apple 团队时,可以共享某些签名身份,但必须先确认三个条件:

  1. 应用是否由同一可信研发组织维护;
  2. 发布频率和发布责任人是否接近;
  3. 所有能读取签名资产的仓库和 CI 任务是否处于同一信任域。

如果只是 Bundle ID 不同,却让所有项目读取同一个可解密仓库,那么低信任项目仍可能接触高敏感应用的签名私钥。应用—证书—Profile—CI 任务映射表,比只展示一份 Matchfile 更能证明权限边界。

场景 签名存储建议 CI 权限 发布权限 验收证据
单一可信应用 独立仓库或独立路径 只读 受控发布任务 Bundle ID 与 Team ID 匹配
同团队低敏感应用 可复用证书,但分 Profile 与任务 只读 仅指定负责人 应用—Profile 映射
同团队高敏感应用 独立分支或独立存储 单独只读凭据 独立发布节点 错误项目无法调用发布任务
外部贡献或低信任仓库 不接触发布私钥 无发布签名或受限签名 禁止直接发布 权限拒绝日志

match 官方文档给出的多团队 Git 方案是“一团队一分支”;如果使用对象存储,顶层目录可以按 Team ID 区分。但逻辑分支和目录只能解决资产组织问题,不能替代 CI 服务账号、Mac 主机和发布触发器的隔离。

多 Apple 团队:分支、路径与主体必须同时区分

管理多个 Apple 团队时,不能只在文件名中写上团队名称。正式方案至少需要同时绑定:

  • Team ID;
  • app_identifier;
  • git_branch 或对象存储路径;
  • CI 服务账号;
  • Apple API Key;
  • 发布节点;
  • 业务负责人。

fastlane match 支持为不同团队指定不同 git_branch,也支持通过 team_id 和 team_name 区分开发者团队。

逻辑隔离与物理隔离

逻辑隔离适合可信度接近、发布流程相近的业务线,例如同一平台团队维护的多个内部应用。物理隔离则更适合金融、医疗、核心客户应用,或由不同法人、不同外包团队维护的项目。

判断依据不是“仓库数量越多越安全”,而是错误发生后的影响范围:

  • 错误分支:可能导致拉取失败或拿到错误资产;
  • 错误 Team ID:可能造成签名不匹配;
  • 错误发布节点:可能让不应发布的任务接触私钥;
  • 错误 API Key:可能扩大 App Store Connect 操作范围。

Apple 的账号角色决定了用户可以访问哪些 App Store Connect 和开发者资源,组织账号还可以添加团队成员;因此,Apple 角色、CI 权限和签名仓库权限应分别审计,不能用一个“管理员账号”覆盖全部流程。(Apple 账号角色说明)

经验判断:高敏感业务不能只依赖“团队名称命名规范”阻止误用。上线验收必须主动注入错误的 Team ID、Bundle ID 或分支,并确认流水线直接拒绝,而不是自动寻找其他可用身份。

普通 CI 与正式发布:把只读和可写彻底分开

共享 Mac 最容易出现的问题,是普通 CI 任务长期使用常驻 Keychain,并且拥有可写签名存储权限。这样一来,任何能触发构建的分支,都可能间接接触发布私钥。

普通 CI 的基线

普通验证任务应遵循以下边界:

  • 从指定仓库或路径只读拉取;
  • match 使用 readonly;
  • 不创建新证书和 Profile;
  • 使用任务专用临时 Keychain;
  • 构建结束后删除导入的签名材料;
  • 不保存解密密码、私钥或 API Key 到工作区;
  • 日志中不得输出秘密变量和完整签名路径。

setup_ci 的官方行为包括创建临时 Keychain、切换 match 到 readonly,并设置适合 CI 收集的日志和测试结果路径;其默认临时 Keychain 超时时间为 3600 秒,也可以通过参数调整。(fastlane setup_ci 官方文档)

临时 Keychain 的创建与清理

可以把流程设计为以下 6 步:

  1. 任务启动时创建唯一的临时 Keychain,名称包含任务标识,避免不同并发任务共用。
  2. 设置密码并将其作为短生命周期秘密注入,不写入代码仓库。
  3. 调用 setup_ci,让 match 指向该 Keychain,并启用 readonly。
  4. 使用明确的 Bundle ID 和 Team ID 拉取已存在资产。
  5. 执行构建、测试或签名验证,避免让普通分支进入发布上传步骤。
  6. 无论成功或失败,都在清理阶段锁定并删除临时 Keychain、Profile 和导出的证书文件。

临时 Keychain 不是“自动安全擦除”的同义词。若流水线在清理前被强制终止,平台仍需要通过任务回收、节点重置或下一次启动检查,确认残留文件和 Keychain 不会继续可用。

正式发布节点

正式发布任务应进入独立 Mac 节点或专用发布池,并同时满足:

  • 只有受控分支、标签或人工审批可以触发;
  • 发布仓库和普通构建仓库分开;
  • 发布私钥不进入普通验证任务;
  • 发布节点不接受任意贡献分支的脚本修改;
  • API Key 按实际 App Store Connect 角色配置;
  • 失败后可切换到备用节点,但不自动扩大权限。

Apple 说明,App Store Connect API Key 可以按角色授权;团队 Key 适用于账号内所有应用,不能限制到单个应用,而个人 Key 则由具体用户管理。丢失或泄露的 Key 应立即撤销,且撤销后不能恢复。(Apple App Store Connect API 说明)

方案决策:满足条件才共享,否则回退到独立节点

在确定共享 Mac 上的 fastlane match 部署方式前,可按下面的条件分支执行:

  • 若所有项目属于同一 Apple 团队、同一平台团队维护、仓库可信度相近,则可以采用同一存储系统下的分支或路径隔离。
  • 若项目 Bundle ID 不同但发布责任人和敏感度差异明显,则至少拆分 CI 凭据、临时 Keychain 和发布任务。
  • 若存在外部贡献代码、低信任脚本或不受控分支,则普通 CI 不应接触发布私钥,必要时回退到无发布签名的验证节点。
  • 若多个业务线属于不同 Apple 团队,则使用独立分支或独立存储路径,并绑定不同 Team ID 和访问主体。
  • 若审计要求证明“错误配置必然失败”,则必须执行错误团队配置测试;无法提供拒绝日志时,回退到物理独立的 Mac 节点。
  • 若正式发布频率高、失败影响大,则发布节点与普通构建节点分离;不要为了节省一台机器而共享常驻发布 Keychain。
控制项 可接受状态 不合格状态
存储权限 普通 CI 只读,管理任务可写 所有任务都可写
Keychain 每个任务临时创建并清理 长期使用共享 login.keychain
Apple 团队 Team ID 明确绑定 依赖账号自动选择
发布触发 受控分支、审批或标签 任意分支可触发
凭据范围 仓库、API Key、节点分别授权 一个管理员秘密覆盖全部流程
审计 有读取、写入、失败和清理日志 只有构建成功日志

上线验收:不要只看构建成功

企业正式启用前,建议由平台工程、安全和应用负责人共同完成以下清单:

资产边界

  • [ ] 每个应用已有 Bundle ID、Team ID、证书和 Profile 映射。
  • [ ] 已标记哪些资产可以复用,哪些必须独立。
  • [ ] 签名仓库的写入者不超过实际管理人员范围。
  • [ ] 普通 CI 没有创建证书、修改 Profile 的权限。
  • [ ] 发布 API Key 没有被注入普通验证任务。

失败验证

  • [ ] 使用错误 Team ID,流水线明确失败。
  • [ ] 使用错误 Bundle ID,流水线不会自动切换到其他 Profile。
  • [ ] 暂时阻断签名存储,任务进入可识别的失败状态。
  • [ ] 强制终止任务后,残留 Keychain 不会被下一任务复用。
  • [ ] 发布任务被普通分支触发时,审批或策略会拒绝执行。

凭据生命周期

  • [ ] 入职人员只有岗位所需的读取或管理权限。
  • [ ] 岗位变更会触发仓库、Apple 账号和 Mac 访问权限复核。
  • [ ] 离职时先撤销访问,再轮换仓库解密凭据。
  • [ ] API Key 遗失或疑似泄露时立即撤销并重新生成。
  • [ ] 证书被撤销后,相关 Profile 的重建和重新签名路径已验证。

match nuke 可以撤销证书和 Provisioning Profile,但 Ad Hoc 或 Enterprise 分发构建可能因此失效,需要重新上传构建,因此不应把它当作未经评估的日常轮换命令。(fastlane match nuke 官方文档)

泄露响应:先判断泄露对象,再决定轮换范围

“签名仓库泄露”不是单一事件,需要区分至少三种情况:

  1. 只有仓库副本泄露:先确认加密密码是否同时泄露,立即限制仓库访问并轮换解密凭据。
  2. 解密密码也泄露:按私钥已暴露处理,评估证书撤销、Profile 重建和重新发布。
  3. App Store Connect API Key 泄露:立即撤销 Key,再生成新 Key,并检查相关操作日志。

Apple 对 API Key 的要求是:私钥只能下载一次,丢失或遭到泄露时应立即撤销;撤销后的 Key 不能重新启用。

证书轮换则应保留业务影响评估。因为证书撤销会连带使相关 Profile 失效,所以正确顺序通常是:冻结可疑任务、保存日志、限制存储访问、判断影响范围、准备新证书和 Profile、在隔离节点验证构建,最后再执行撤销和生产切换。

如果现有共享 Mac 还没有独立节点、长期在线能力、完整管理权限和故障替换证据,那么仅靠 match 配置文件无法补齐基础设施缺口。自购 Mac 适合长期稳定且需要物理接口的重负载场景,但会承担采购、折旧、维护和备用机管理;临时云资源适合试点和弹性扩容,却必须核对数据边界、节点独占与权限模型。若需要比较专用发布节点与备用资源池,可先查看 企业远程 Mac 安全验收帮助,再结合 KuzCloud 的企业 Mac 方案核对独立节点、root 权限、交付方式和替换条件。

对需要临时发布能力、隔离测试环境或弹性备用节点的团队,租赁 Mac 的价值不在于把所有项目都搬到远程主机,而在于可以把正式发布任务放入独立、可替换的 Mac 节点;前提是上线前完成账号隔离、临时 Keychain 清理、重连恢复和错误配置拒绝测试。长期固定重负载、必须连接实体设备或受内部合规要求限制的团队,则应继续评估自购 Mac 或混合资源池,而不是为了租赁而租赁。

为签名构建池准备独立远程 Mac

使用 KuzCloud 按团队与项目分配远程 Mac,降低共享环境中的签名资产交叉风险。

按需租用 Mac 云主机,获得稳定的独立构建环境,减少本地设备采购与维护成本。