CI/CD / DevOps

GitLab Runner macOS 怎么隔离:2026 企业部署指南

GitLab 官方将 Runner 分为 实例级、群组级和项目级 3 种范围。这意味着,GitLab Runner macOS 隔离的胜负点不在于是否设置了一个标签,而在于项目是否处于同一信任域:低敏感、同信任域项目可以共享 Mac Runner;正式签名和发布任务应使用受保护的专用节点;多团队企业则应采用共享构建池加独立发布池的混合方案。(GitLab Runner 范围官方文档)

这篇文章适合三类决策者:正在管理多个 iOS 项目、准备建立共享 GitLab macOS 构建池的平台团队;需要保护证书、Keychain 和发布凭据的安全负责人;以及正在评估购买、租赁或混合配置 Mac Runner 容量的企业 IT 与采购负责人。

先划分信任域,再决定哪些项目能够共享

很多团队一开始会按部门、业务线或仓库数量划分 Runner,但这些维度并不能直接说明项目之间是否可以互相暴露。更可靠的做法,是把以下四项放进项目—任务—资产矩阵:

  • 源码敏感度:是否包含未发布功能、核心算法或客户数据。
  • 提交权限:是否允许外部贡献者、临时成员或低权限开发者触发流水线。
  • 发布权限:流水线是否能够访问生产环境、App Store Connect 或正式签名资产。
  • 构建产物:是否会生成可复用的二进制、调试符号、日志或中间文件。

多个项目共用 GitLab macOS Runner 是否安全?

可以,但只能在“同一信任域、相近任务风险、没有长期发布凭据残留”的前提下共享。GitLab 官方明确说明,Shell executor 的隔离能力有限,任务以 Runner 用户权限在本机执行,并可能读取同一主机上其他项目的代码;因此,跨不可信项目共享并不是安全默认值。(GitLab Shell executor 安全说明)

可以采用下面的条件式判断:

  • ✅ 同一组织、相近权限、仅执行普通编译和测试:可进入共享构建池。
  • ⚠️ 不同业务团队,但代码和成员权限存在交集:应先拆分群组级 Runner,再通过负向测试验证。
  • ❌ 含正式签名、生产发布或外部贡献代码:不应进入普通共享节点,应使用专用 Mac Runner。
  • ❌ 项目之间存在明确的客户隔离、合规隔离或竞争关系:不建议仅依靠标签实现隔离。

用项目—任务—资产矩阵定位越权风险

任务类型 代码信任度 可接触资产 建议节点
普通单元测试 同一信任域 源码、依赖缓存 共享构建池
普通 App 编译 同一信任域 源码、DerivedData、构建产物 共享构建池,任务后清理
跨团队合并请求验证 不完全可信 源码、临时变量 独立测试节点或受限共享池
TestFlight / App Store 发布 高敏感 证书、Provisioning Profile、Keychain、发布凭据 受保护专用节点
生产签名与正式发布 极高敏感 正式签名资产和生产权限 单独发布节点,严格审批

这里的关键不是把所有项目都拆成单台主机,而是先回答“某个任务成功后,下一任务最多能读到什么”。如果答案包括其他项目源码、长期存在的 Keychain 或正式证书,那么现有隔离边界就不够。

第一步:用 Runner 范围和标签限制执行入口

GitLab Runner 的范围决定管理责任和可见项目,标签则决定任务路由,两者不能混为一谈。官方文档将实例级 Runner 定义为可供实例内项目使用,群组级 Runner 面向群组及其项目,项目级 Runner 通常只服务一个项目。(GitLab Runner 范围与管理责任文档)

建议按以下顺序配置:

  1. 普通构建节点优先采用群组级 Runner,而不是直接开放实例级 Runner。
  2. 高敏感发布节点采用项目级 Runner,或只绑定到明确的发布群组。
  3. 所有 Mac Runner 使用明确标签,例如 macos-xcode27-build、macos-ios-release。
  4. 关闭敏感节点接收无标签任务的能力。
  5. 将发布 Runner 设置为 Protected,只允许受保护分支或受保护标签触发。
  6. 对每类节点记录所有者、适用项目、可访问资产和故障接管人。

GitLab 的标签配置文档说明,标签可以控制 Runner 接收哪些任务,Protected Runner 则可限制任务只能来自受保护分支或受保护标签。(GitLab Runner 标签与 Protected Runner 配置) 但标签只是调度条件,不是主机级安全边界。

标签与受保护分支能否单独承担主机隔离?

不能。标签和受保护分支可以降低误路由概率,并限制正式任务的触发入口,却不能阻止已经进入同一 Shell 主机的恶意或错误脚本读取其他目录、进程环境、缓存和残留凭据。对于正式签名任务,标签应当与专用节点、受保护变量、独立 Keychain 和任务后清理同时使用。

上线前至少应做两组测试:

  • 正向测试:发布分支能够进入 macos-ios-release,并成功完成签名与归档。
  • 越权负向测试:普通分支、未授权项目和无标签任务无法进入发布节点,也无法获取发布变量。

⚠️ 保护分支只保护“谁能触发某类流水线”,不等于保护“任务进入主机后能读取什么”。如果发布 Runner 同时接收普通项目任务,隔离设计仍然存在缺口。

第二步:把签名凭据从普通构建环境中移出

GitLab Runner 的认证令牌、仓库凭据、Apple 签名证书、Provisioning Profile、临时 Keychain 和 App Store Connect 凭据,应该被视为不同资产,而不是统一放入一个“CI 密钥”目录。

GitLab 官方支持将变量设置为 Masked、Protected,并按环境范围限制可见任务;Protected 变量只会传递给受保护分支或受保护标签触发的流水线。(GitLab CI/CD 变量保护机制) 对生产发布凭据,还应结合受保护环境和允许发布人员配置,避免仅依靠变量隐藏。(GitLab 受保护环境文档)

推荐的凭据—节点映射如下:

  • 普通构建节点:只提供读取代码、下载依赖和生成测试包所需的短期凭据。
  • 测试发布节点:提供测试团队对应的签名资产,使用临时 Keychain,任务结束后销毁。
  • 正式发布节点:只接收受保护流水线,正式证书和发布凭据不下发到普通项目。
  • Runner 认证令牌:存放在受限配置或秘密管理系统中,不写入仓库和可下载的构建产物。

GitLab 文档特别提醒,泄露 Runner authentication token 可能让攻击者添加自定义 Runner,并获得该 Runner 被授予的资源访问能力。(GitLab Runner 认证令牌风险说明) 因此,令牌轮换记录应和证书轮换记录分开审计,不能因为“同一台机器”就放在同一权限层。

正式 iOS 签名是否应使用独立 Runner?

当任务使用正式证书、正式 Provisioning Profile、生产 App Store Connect 权限或长期存在的 Keychain 时,应使用独立且受保护的 GitLab Runner。只有在签名资产本身是短期生成、任务结束后能够可靠销毁,并且所有项目处于同一信任域时,才可以考虑有限度共享。

验收时需要保留以下证据:

  • 变量是否设置为 Protected、Masked 或按环境限定。
  • 普通分支是否能看到发布变量名称和值。
  • 临时 Keychain 是否在任务结束后被删除。
  • Runner authentication token 是否有轮换和吊销记录。
  • 未授权任务访问签名目录时是否被拒绝。

第三步:检查 Shell 工作目录和环境残留

macOS Shell executor 的任务直接在 Runner 主机本地执行,官方明确指出它提供的任务隔离能力有限。任务结束并不自动代表主机恢复干净,尤其要关注以下残留位置:

  • $CI_PROJECT_DIR 中的源代码、配置文件和下载依赖。
  • DerivedData、Swift Package Manager 缓存和 CocoaPods 缓存。
  • .ipa、.app、符号文件和测试报告。
  • 临时 Keychain、证书导入目录和签名日志。
  • shell 环境变量、后台进程、监听端口和挂载目录。
  • GitLab Runner 用户目录下的认证文件与工具配置。

怎样降低 Shell executor 跨项目读取文件的风险?

首先要区分“降低读取概率”和“形成主机级隔离”。固定工作目录加任务后清理,只能减少普通残留;它无法等同于虚拟机、专用主机或独立账号隔离,因为恶意脚本仍可能读取 Runner 用户可访问的其他路径、进程信息或缓存。

建议按项目风险选择四级措施:

  1. 固定目录 + 任务后清理:仅适合同信任域普通构建。
  2. 独立账号 + 独立工作目录:适合权限差异较大的内部项目。
  3. 专用 Mac 主机:适合跨团队、高敏感或外部贡献任务。
  4. 专用发布节点 + 临时环境重置:适合正式签名和生产发布。

清理脚本应覆盖源码目录、DerivedData、临时 Keychain、构建产物和敏感日志,但不能把脚本成功执行当作隔离完成。上线验收要做残留扫描:先运行项目 A,再运行项目 B,检查 B 是否能够发现 A 的文件名、源码片段、证书标识、缓存内容和进程。

第四步:用 Xcode 27 回放验证容量与恢复

隔离粒度越细,可共享的空闲容量越少。平台团队不能只看“节点数量”,还应记录队列等待、任务持续时间、失败重试、发布窗口和备用节点恢复时间。

Apple 官方系统要求显示,Xcode 27 需要 macOS Tahoe 26.6 或更高版本,并面向 iOS 27 等 SDK 进行开发;因此,企业在采购或租赁 Mac Runner 时,需要先确认 macOS 版本、Apple Silicon 条件和现有项目的部署目标是否匹配。(Apple Xcode 系统要求)

不要直接套用脱离项目的固定并发数字,而应使用真实项目回放:

  • 用代表性仓库执行完整 checkout、依赖安装、编译、测试和归档。
  • 分别回放普通构建、合并请求验证和正式发布。
  • 记录队列时间、持续时间、失败原因和重试结果。
  • 模拟节点重启、Keychain 销毁、缓存失效和 Runner 重新注册。
  • 为发布窗口预留备用节点,避免一台专用 Runner 成为交付单点。

GitLab 的 Runner fleet 规划文档也建议从 Runner 范围、任务类型、资源需求和组织隔离要求出发设计 Runner 池,而不是先购买一批规格相同的节点。(GitLab Runner fleet 规划指南)

第五步:用联合放行评分卡决定共享、专用或混合

最终放行不应由某一个标签配置决定,而应由六类指标共同决定:信任边界、任务路由、凭据保护、环境清理、构建正确性和故障恢复。

上线前可勾选验收清单

  • [ ] 已为每个项目标注源码敏感度、提交权限和发布权限。
  • [ ] 已明确哪些项目属于同一信任域,哪些项目必须拆分。
  • [ ] 普通构建、测试发布和正式发布使用了不同任务标签。
  • [ ] 敏感 Runner 已禁止无标签任务,并设置为 Protected。
  • [ ] 普通分支无法进入正式发布 Runner。
  • [ ] 正式证书、Provisioning Profile 和 App Store Connect 凭据未进入普通节点。
  • [ ] 发布变量已设置 Protected、Masked,并限制环境范围。
  • [ ] 临时 Keychain 在成功、失败和取消三种路径下都会销毁。
  • [ ] 已扫描源码目录、DerivedData、缓存、日志和构建产物残留。
  • [ ] 已完成项目 A 到项目 B 的跨任务读取负向测试。
  • [ ] 已用真实项目回放 Xcode 27、依赖安装和归档流程。
  • [ ] 已记录节点故障后的切换、重置和重新注册步骤。
  • [ ] 已确认专用发布节点故障时不会阻断所有发布窗口。

两类部署决策工具

验收结果 适合的部署方式 采购或租赁建议
同信任域,普通构建,无长期敏感凭据 共享 Mac Runner 先配置共享构建池,按真实队列扩容
同群组但项目权限差异明显 分组共享 Runner 按业务群组拆分,限制 Runner 可见范围
外部贡献、跨组织代码或高敏感源码 专用构建节点 不与普通项目共用工作目录和账号
正式签名、生产发布、长期证书 受保护专用发布 Runner 单独配置凭据、审批和备用节点
多团队、多工具链、发布窗口固定 混合 Runner 池 共享构建池承载常态任务,专用池承载发布
指标 通过条件 不通过后的处理
信任域 项目成员、源码和提交来源可解释 拆分群组或改用专用节点
路由 未授权任务无法进入敏感 Runner 收紧标签、Protected 设置和项目范围
凭据 普通任务无法读取正式签名资产 移出节点或改用临时 Keychain
清理 任务结束后无跨项目残留 增加重置流程,必要时更换专用主机
构建 Xcode 27 和真实项目回放稳定完成 调整工具链、缓存和节点规格
恢复 节点故障后有可验证的备用路径 增加备用节点或临时扩容容量

GitLab 官方还指出,敏感变量默认可能对所有任务可见,因此应尽量缩小环境范围;环境范围为 * 时,任何匹配任务都可能获得变量,只有设置为特定环境后才能进一步减少暴露面。(GitLab 环境变量范围文档)

企业采购与远程 Mac Runner 的落地方式

如果团队已经完成信任域和任务路由矩阵,下一步不应立刻为每个项目购买一台 Mac。更稳妥的方式,是先准备一台与目标工具链匹配的隔离 Mac,验证 GitLab Runner、Xcode 27、签名流程、残留清理和故障恢复,再根据真实队列和发布数据扩展节点池。

自购 Mac 的优势是长期重负载下可控性更高,也便于接入企业内部网络和物理设备;但硬件折旧、资产管理、系统升级、远程运维和备用机成本需要纳入企业 Mac 基础设施 TCO。远程租赁则更适合临时容量、跨地区团队、试点环境和发布窗口扩容,但需要提前确认 root 权限、重置方式、网络访问、审计要求和数据留存策略。

KuzCloud 的远程 Mac 方案适合被放在“验证和扩容”这一层:先用隔离节点验证实际构建闭环,再决定哪些任务进入共享池、哪些任务保留在专用发布池。团队可先查看 远程 Mac 使用与连接帮助,并结合 Mac 租赁方案页面 核对租赁周期与交付条件。

对于当前已经存在的单台共享 Mac 方案,常见缺点通常是:普通构建和正式发布共用工作目录,正式证书长期留在主机上;项目之间只能靠标签区分,缺少越权负向测试;节点故障后没有可复现的环境重置和备用路径。相比之下,按信任域拆分远程 Mac,并把专用发布节点作为独立容量,可以先用较小投入验证隔离设计,再按照队列和发布窗口逐步扩展,而不是一次性承担整套硬件采购与维护成本。

建议的行动顺序是:先建立项目—任务—资产矩阵,再租用或配置一台隔离 Mac 完成 2026 年工具链回放;只有当签名凭据、残留扫描、负向测试和故障恢复全部通过后,才将方案扩展为共享构建池加专用发布池。

用独立 Mac 节点,构建清晰的企业隔离边界

KuzCloud 提供物理独占的 Mac 节点,让不同团队和项目拥有彼此分离的构建环境与资源。

每台节点支持独立公网 IPv4、SSH 与网页 VNC 接入,方便按信任域快速部署和集中管理。