macOS安装包下载源路径由Apple官方SUCatalog动态提供,本质是解析https://swscan.apple.com/...索引后获取的updates.cdn-apple.com上带年份、构建ID和InstallAssistant.pkg等命名的临时URL,具时效性且不可硬编码。
macos 环境下安装包的下载源路径,本质上不是用户手动指定的“本地路径”,而是由 apple 官方软件更新服务器(software update catalog)动态提供的一组远程 url。这些 url 指向苹果 cdn 上的真实 .pkg 或 .dmg 文件,工具(如 softwareupdate、download full installer、gibmacos)通过解析 apple 的 sucatalog(软件更新目录)获取它们。
真正的“源路径”结构如下:
基础目录入口:
https://swscan.apple.com/content/catalogs/others/index-<version>.sucatalog.gz</version>
例如:https://swscan.apple.com/content/catalogs/others/index-14-13-12-11-10.sucatalog.gz(覆盖 macOS 10–14)解析后的真实安装包地址示例(以 macOS Sequoia 15.0 为例):
https://updates.cdn-apple.com/2026/macos/041-XXXXX/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/InstallAssistant.pkg
或更完整的完整安装器:https://updates.cdn-apple.com/2026/macos/041-XXXXX/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/InstallAssistantAuto.pkg-
关键特征:
- 域名固定为
updates.cdn-apple.com或swcdn.apple.com(历史旧链) - 路径含年份(如
2026)、产品代号(macos)、唯一构建标识符(UUID 风格字符串) - 文件名通常为
InstallAssistant.pkg(轻量版)或InstallAssistantAuto.pkg(含全部组件的完整安装器)
- 域名固定为
-
如何查看当前生效的源:
终端中执行:softwareupdate --dump-state
或直接读取系统配置:
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac下载让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
defaults read /Library/Preferences/com.apple.SoftwareUpdate CatalogURL
若未自定义,系统默认使用
https://swscan.apple.com/...对应的最新索引。 -
注意:
- 这些 URL 有有效期(通常数天到数周),过期后会返回 404;不能长期保存复用
- Apple 不公开维护静态下载列表,所有合法工具都依赖实时解析
.sucatalog文件 - 手动拼接 URL 极易失败,推荐使用 Download Full Installer(图形化)或 gibMacOS(跨平台脚本)自动抓取并验证
你不需要也不应该硬编码这些路径。可靠的做法是让工具自动拉取、解压、解析 .sucatalog.gz,再提取匹配 InstallAssistant 或 SharedSupport 关键字的 <url></url> 字段——这才是 macOS 官方认可的下载源路径获取逻辑。

















