两条路径边界 · SSH/VNC 决策表 · 失败码速查 · 20 分钟验收
无自有 Mac、却在租用云端节点做 iOS 上架的独立开发者，常在「最后一公里」栽跟头：CI 或同事那边已经打出 .ipa，你 SSH 进 Mac 却发现没有可点的上传界面；或者 Archive 成功，Organizer 一直转圈，不知道是否该换 Transporter。本文先厘清两条官方上传路径各自解决什么问题，再给出仅 SSH / SSH+VNC 分段 / 全程 VNC对照决策表、Organizer 与 Transporter 的最小可复现步骤、四条可写进工单的结论，以及20 分钟 VNC 验收表；并与站内《首次 TestFlight 外测检查表》、《Xcode Cloud Plan B》、《紧急修复与上架》、《Fastlane Match 与 SSH/VNC》互链。
Apple 在 2026 年仍支持通过 Xcode Organizer 与独立应用 Transporter（Mac App Store 分发）把构建送到 App Store Connect。二者不是「新旧替代」，而是输入物与操作习惯不同：
Organizer 路径：适合你在同一台云端 Mac上完成 Archive，并在图形界面里走 Distribute App → App Store Connect。优势是与签名、描述文件、导出选项同屏核对；劣势是对 Xcode 版本、登录态、钥匙串弹窗更敏感。
Transporter 路径：适合已有合规签名的 .ipa（或 CI 产物同步到节点），用拖拽或命令行交付。优势是界面单一、对「只上传」任务更轻；劣势是不能替你修复签名或重新 Export，且登录 Apple ID / App 专用密码时常要图形会话。
隐性成本：租用节点按小时计费时，在 SSH 里反复尝试需要 GUI 的步骤，会产生零产出占机；应把「需要点按」的步骤在 Runbook 里标为 needs-vnc。
与 ASC 的关系：无论哪条路径，上传成功只表示交付开始；TestFlight 可用、处理完成、元数据审核等状态要在 App Store Connect 网页对照，详见外测检查表中的构建号核对项。
SDK 窗口：2026 年起 Apple 对「用什么 Xcode / SDK 构建」有明确时间线要求；若处理状态长期停在「无效的二进制」，先查RC 对齐清单与工具链冻结，再怪网络。
若你来自 Windows 主力机，可把云端 Mac 理解为带 Apple 官方上传客户端的「上架工作站」：编译可以在别处，但交付到 ASC 的客户端几乎总在 macOS。这也是租远程 Mac 相比「只在 Linux CI 上猜上传 API」的核心价值之一。
下表按任务 → 推荐接入 → 典型失败信号 → 常见误判排列，可直接贴进团队 wiki。若你们同时用 Xcode Cloud，可把「Cloud 失败转人工上传」与Plan B 决策表合并使用。
| 任务 | 推荐接入 | 典型失败信号 | 常见误判 |
|---|---|---|---|
| 云端 Archive + Organizer 上传 | VNC（同用户） | 上传卡住、无错误码 | 只加大 SSH 超时 |
| 已有 .ipa，仅交付 | VNC + Transporter | 登录失败、401 | 以为 ipa 坏了 |
| 首次登录 Apple ID / 2FA | VNC | SSH 里 session 无效 | 反复删 DerivedData |
| 查看 Organizer 处理日志 | VNC | CLI 无等价输出 | 只刷 ASC 网页 |
| 用 API Key + altool 上传 | SSH（密钥已配置） | JWT 过期、权限不足 | 去改描述文件 |
| Transporter 图形登录态修复 | VNC | Transporter 空白或闪退 | 重装 Xcode 全家桶 |
| 核对 Export 选项与符号表 | VNC + Organizer | ASC 缺 dSYM | 只重传 ipa 不勾选符号 |
经验法则：第一次失败若涉及账号、钥匙串或 Transporter 窗口，不要在同一 SSH 会话里第三次重试——切 VNC 通常比多付一小时租费便宜。
在 VNC 会话中，用与 SSH 相同的 macOS 用户打开 Xcode，确认菜单栏账号已登录。推荐顺序：
Window → Organizer，选中对应 Archive（注意 Scheme 与 Configuration 与发布一致）。
Distribute App → App Store Connect → 按向导选择上传（非 Ad Hoc）。
勾选上传符号（若团队依赖崩溃符号化）；与隐私清单、出口合规相关的选项按隐私清单文预先填好 ASC 元数据。
等待 Organizer 显示交付完成；立刻在 ASC 打开 TestFlight，记录处理开始时间与构建号。
若失败，展开日志：认证类（账号/密钥）、签名类（profile/certificate）、合规类（SDK/隐私）分开建档，避免混为一谈。
| 现象 / 提示 | 优先怀疑 | 建议动作 |
|---|---|---|
| 卡在「正在上传」无进度 | 企业网出口 / 代理 | 对照企业网排查；换热点试一次 |
| Invalid Signature / Profile | 签名链 | 先Match 验收与钥匙串 |
| ITMS-9xxxx 合规 | SDK / 隐私清单 | 查 ASC 邮件与处理详情 |
| 需要登录 / 会话过期 | Apple ID | VNC 重新登录 Xcode Accounts |
# 上传前在同一用户下核对工具链（SSH 或 VNC 终端均可） xcodebuild -version /usr/bin/security find-identity -v -p codesigning | head -n 15
从 Mac App Store 安装 Transporter（若镜像未预装）。在 VNC 下完成首次 Apple ID 登录后，日常可尝试 SSH 触发 CLI，但登录态维护仍建议图形确认。
确认 .ipa 的 Bundle ID、版本号、构建号与 ASC 中待测条目一致（避免传错包）。
打开 Transporter → 登录 → 将 .ipa 拖入交付区 → 开始交付。
观察交付进度；失败时导出活动日志附到工单（比截图更可检索）。
到 ASC 核对处理状态；若提示「缺少合规」，回到网页端出口合规与隐私问卷，而非盲目重传。
与 Organizer 路径一样：处理完成后走外测邀请或生产发布流程。
若 ipa 来自 Windows 侧打包脚本，上传前请在云端用 unzip -l 或 Transporter 预检确认签名存在；未签名 ipa 在 Transporter 会快速失败，此时应回云端重新 Archive，而不是反复拖拽。
提示：紧急上架场景可先读《手术室》确定最小环境，再按本节只上传；避免在租期第一小时同时装 beta Xcode 与传生产包。
| 核对项 | 操作要点 | 通过标准 |
|---|---|---|
| 用户一致 | VNC 用户 = SSH whoami | 无「桌面 A、终端 B」 |
| Xcode / Transporter 登录 | Accounts 无黄标 | 可选中正确 Team |
| 构建坐标 | 版本号 + 构建号 + Bundle ID | 与 ASC 条目一致 |
| 交付完成 | Organizer 或 Transporter 成功 | 有完成时间戳 |
| ASC 处理 | TestFlight 构建列表 | 由「处理中」→「可测试」或明确失败原因 |
| 符号与合规 | 符号上传 / 隐私清单 | 无 ITMS 合规邮件_pending |
新节点请先完成首次使用清单再执行上表，可显著降低「能连桌面却不会上传」的挫败感。
上传后的邀请与检查表。
阅读 →队列失败时转远程手动上传。
阅读 →签名链稳定后再谈上传。
阅读 →不必为编译再开 Xcode；上传仍须在 macOS 完成。已签名 .ipa 优先 Transporter；仅 .xcarchive 需 Organizer 导出。
API Key + 命令行可行，但登录态与 2FA问题仍常要 VNC。团队应统一「默认 Transporter / 默认 API」之一，避免每人一套。
上传≠处理完成。核对 Bundle ID 与构建号；处理失败常见为 SDK、隐私清单或出口合规，按 ASC 详情逐项修。
已有有效 .ipa → Transporter 通常最短；要在云端 Archive → Organizer 更顺，但需预留账号与钥匙串时间。
上传构建不是 Xcode 里的「顺便点一下」，而是账号、签名、合规与网络出口四条链路的交汇点。只在 SSH 里重试命令、却在关键时刻没人打开 Transporter 或 Organizer，租用节点的隐性成本会体现在超长占机与重复交付上；自建 Mac 则要额外承担固定硬件、睡眠策略与上传带宽的不确定性。
把 VNC 当作上传链路的标准接口而非救火通道，才能在无自有 Mac 时稳定对齐 Apple 官方客户端与 App Store Connect 的处理节奏。
若你需要按任务租用带完整桌面会话的物理 Mac，在本文第五节同款表格下完成交付验收，可通过 VNCMac 开通远程节点：主按钮进入购买页；连接方式可先查阅站点帮助页中的 SSH 与 VNC 说明。