介绍在 macOS 和 Linux 环境下使用国内镜像源高速安装与配置 Homebrew 的方法。针对网络不稳定导致的下载慢、连接重置等问题，提供了中科大和清华镜像源的配置方案。内容包括一键安装脚本的使用步骤、手动永久配置环境变量（ZSH/Bash）的详细代码、以及常见问题排查指南。适用于 Apple Silicon 及 Intel 架构的 Mac 设备，旨在提升包管理器的下载速度和稳定性。
在国内使用 Homebrew（macOS/Linuxbrew 的神器）时，常遇到以下问题：
git fetch 或 curl 56 Connection reset by peerbrew update 慢如龟速brew install 大包（如 node、python、ffmpeg）下载几十 KB/s，卡半天这些问题 99% 是因为网络对 GitHub 的访问不稳定或限速。通过国内镜像源，可以把速度提升到几 MB/s ~ 十几 MB/s，安装和更新基本秒开。
本文整理了最稳定、推荐的几种方式（实测有效），包括：
适用于 Apple Silicon (M1/M2/M3/M4 Mac mini 等) 和 Intel Mac。
| 问题类型 | 官方源表现 | 国内镜像表现 |
|---|---|---|
| git clone / fetch | 经常 early EOF / reset | 稳定，秒级完成 |
| brew update | 几分钟～十几分钟 | 几秒～几十秒 |
| brew install bottle | 几十 KB/s ~ 几百 KB/s | 5-20MB/s+（视网络） |
| API 元数据 (formula.json) | 经常超时 | 瞬间返回 |
核心配置其实就几行环境变量，Homebrew 从 4.0+ 开始默认走 API，大部分用户无需再手动 clone core 仓库了！
如果你是新手或重装，直接用这个脚本最省事。它会让你选镜像源（中科大/清华/阿里等），自动配置，基本一次过。
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
运行后：
brew --version
brew update # 应该飞快
brew doctor # 检查问题
优点：傻瓜式，自动选最优源，适合 99% 用户。 缺点：依赖 Gitee，如果 Gitee 偶尔抽风，可用下面手动方式。
中科大镜像目前同步频率最高、瓶子最全、稳定性强。
/opt/homebrew）sudo rm -rf /opt/homebrew # 如果是 Intel Mac：sudo rm -rf /usr/local/Homebrew
~/.zshrc；bash 用 ~/.bash_profile 或 ~/.bashrc）nano ~/.zshrc # 或 vim ~/.zshrc
# ===================== Homebrew 国内镜像加速（中科大 USTC） =====================
# Homebrew 核心仓库（brew.git）
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
# 如果需要开发命令（如 brew cat formula），才设置 core（大多数人可省略）
# export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"
# Cask（图形软件）镜像，可选但推荐
export HOMEBREW_CASK_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-cask.git"
# 二进制瓶子（bottles）加速 - 下载速度关键！
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
# API 元数据加速（formula.json 等，brew 4.0+ 默认用这个，超级重要）
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"
# 可选：禁止自动更新（想手动控制时加）
# export HOMEBREW_NO_AUTO_UPDATE=1
# ===================== 配置结束 =====================
保存退出（nano: Ctrl+O → 回车 → Ctrl+X）
source ~/.zshrc
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
eval "$(/opt/homebrew/bin/brew shellenv)" 到 ~/.zprofile（Apple Silicon）或 ~/.bash_profile（Intel）。brew update # 看是否走 mirrors.ustc.edu.cn
brew install gh # 测试安装一个小的，观察下载地址和速度
如果中科大偶尔不稳，换清华（瓶子下载特别友好）：
替换上面 export 中的地址为：
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
# export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git" # 大多数人可不设
export HOMEBREW_CASK_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"
export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"
然后 source ~/.zshrc，再 brew update。
git config --global http.postBuffer 524288000brew update。/opt/homebrew，命令前加 eval "$(/opt/homebrew/bin/brew shellenv)" 已自动处理。用上国内镜像后，Homebrew 真正变成了'家常便饭'工具：
brew install wget git node python ffmpeg …… 基本几十秒搞定推荐顺序：
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online