homebrew 镜像源和代理一般不建议同时使用，二者目标冲突：镜像源是为绕过境外网络限制而设的本地化替代路径，代理则是将流量导向境外节点。
homebrew 镜像源和代理一般不建议同时使用，二者目标冲突：镜像源是为绕过境外网络限制而设的本地化替代路径，代理则是将流量导向境外节点。混用不仅无增益，反而容易导致失败、重复跳转或配置冲突。
为什么镜像源通常不需要代理
国内主流镜像（如清华 TUNA、中科大 USTC）本身已完整同步 Homebrew 的所有核心仓库（brew.git、homebrew-core.git、homebrew-bottles），包括源码、二进制包（bottles）和 API 接口。所有请求都走国内 HTTP/HTTPS 服务器，天然免代理、低延迟、高稳定。只要镜像源配置正确，brew install 和 brew update 就不会访问 GitHub 或 raw.githubusercontent.com。
什么情况下才可能需要代理
极少数例外场景下，你可能仍需代理，但必须明确前提：
-
你正在使用未镜像的第三方 Tap：比如
brew tap homebrew-ffmpeg/ffmpeg，其仓库不在清华或中科大镜像列表中，此时若该 Tap 托管在 GitHub，且国内无法直连，就可能需要代理 -
你手动执行了绕过镜像的命令：例如用
git clone https://github.com/someuser/some-tap直接拉取，或临时清空了HOMEBREW_*_GIT_REMOTE环境变量 - 镜像站自身短暂不可用（极罕见）：可临时切回代理应急，但应优先检查镜像状态页（如 清华镜像状态）
如果真要搭配代理，关键注意事项
若确需在启用镜像源的同时让部分流量走代理，请严格按以下方式操作，避免全局污染：
-
只对 Git 设置代理，不对 brew 命令本身设：Homebrew 依赖 Git 拉取元数据，但二进制下载（bottles）走的是
HOMEBREW_BOTTLE_DOMAIN指定的 HTTP 地址，不受 Git 代理影响 -
用 Git 的局部配置，而非系统级 proxy：
git -C "$(brew --repo)" config --local http.proxy http://127.0.0.1:7890
git -C "$(brew --repo homebrew/core)" config --local http.proxy http://127.0.0.1:7890
这样仅影响 Homebrew 自身仓库，不影响其他 Git 项目 -
务必关闭 brew 的自动代理检测：Homebrew 会读取
http_proxy环境变量并尝试自动应用，这会导致 bottle 下载也走代理，反而变慢。请确保终端中未设置：
unset http_proxy HTTPS_PROXY
推荐做法：优先排查镜像是否生效
如果你发现用了镜像后仍有连接超时，大概率不是缺代理，而是镜像没配全或没生效。请运行以下命令确认：
-
brew config | grep -E "(remote|domain)"—— 检查四个关键变量是否都指向镜像地址（HOMEBREW_BREW_GIT_REMOTE、HOMEBREW_CORE_GIT_REMOTE、HOMEBREW_BOTTLE_DOMAIN、HOMEBREW_API_DOMAIN） -
git -C "$(brew --repo)" remote get-url origin—— 应返回类似https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git -
curl -I https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/bottles/openssl@3-3.3.2.arm64_monterey.bottle.tar.gz—— 直接测试 bottle 域名是否可通（返回 200 或 404 均正常，403/timeout 则异常）
