MIRROR HANDBOOK

Homebrew 镜像

分别配置 Homebrew API 与 bottles,避免混淆源码仓库。

配置前请确认服务与版本适用性,并备份原有软件源配置。

镜像范围

homebrew-bottles 提供预编译包与 API 数据。Homebrew 4 及之后的普通安装主要使用 API,不需要为了换源额外克隆全部 homebrew/core 与 homebrew/cask。

当前终端使用

在 Bash/Zsh 中执行:

export HOMEBREW_API_DOMAIN=https://mirrors.cernet.edu.cn/homebrew-bottles/api
export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.cernet.edu.cn/homebrew-bottles
brew update
brew config

持续使用时,将两行 export 合并进自己的 shell 启动文件,例如 Zsh 的 ~/.zprofile,重新打开终端。不要重复追加多组冲突定义。

验证

brew info wget
brew fetch --bottle wget

brew fetch 只下载用于检查,不安装软件。如果该平台或版本没有 bottle,Homebrew 可能需要源码构建;源码 URL 由 formula 定义,不一定通过本镜像。

brew 本身与 Git 仓库

上面两项不替换 brew 程序本身的 Git 更新。CERNET 另有 homebrew 等目录,但不同站点的 Git 路径约定可能不同。本指南保留 brew 官方 Git remote,不把普通目录 URL 当作 Git 仓库地址。

恢复

删除启动文件中的两项定义,并在当前终端执行:

unset HOMEBREW_API_DOMAIN HOMEBREW_BOTTLE_DOMAIN
brew update

如果此前改过 Git remote,还需按当时记录单独恢复。API 或 bottle 同步不一致时可暂时恢复官方地址,不要关闭校验和检查。

参考资料

← 全部指南反馈文档问题 ↗