homebrew | 镜像站使用帮助 | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror

注：该镜像是 Homebrew / Linuxbrew 源程序以及 formula / cask 索引的镜像（即 brew update 时所更新内容）。本镜像站同时提供相应的二进制预编译包的镜像，请参考 Homebrew bottles 镜像使用帮助

本站提供了 https://github.com/Homebrew 组织下的以下 repo：brew, homebrew-core, homebrew-cask, homebrew-cask-fonts, homebrew-cask-versions, homebrew-command-not-found, homebrew-services, install。

注：自brew 3.3.0 (2021 年 10 月 25日) 起，Linuxbrew 核心仓库 linuxbrew-core 已被弃用。Linuxbrew 用户应迁移至 homebrew-core，并请依本镜像使用帮助重新设置镜像。具体请参阅本帮助 Linuxbrew 镜像迁移说明 章节。

注：自brew 4.0.0 (2023 年 2 月 16日) 起，HOMEBREW_INSTALL_FROM_API 会成为默认行为，无需设置。大部分用户无需再克隆 homebrew-core 仓库，故无需设置 HOMEBREW_CORE_GIT_REMOTE 环境变量；但若需要运行 brew 的开发命令或者 brew 安装在非官方支持的默认 prefix 位置，则仍需设置 HOMEBREW_CORE_GIT_REMOTE 环境变量。如果不想通过 API 安装，可以设置 HOMEBREW_NO_INSTALL_FROM_API=1。

注：自brew 4.0.22 (2023 年 6 月 12 日) 起，homebrew-cask-drivers 已被弃用，所有 cask 合并至 homebrew-cask 仓库。本帮助内已移除克隆 homebrew-cask-drivers 仓库的命令。已克隆用户可选择运行 brew untap homebrew/cask-drivers 命令移除此仓库。

日常使用

可设置如下环境变量使用本站提供的 Homebrew 镜像：

export HOMEBREW_API_DOMAIN="<https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api>"
export HOMEBREW_BOTTLE_DOMAIN="<https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles>"
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_PIP_INDEX_URL="<https://pypi.tuna.tsinghua.edu.cn/simple>"

首次安装 Homebrew / Linuxbrew

首先，需要确保系统中安装了 bash、git 和 curl，对于 macOS 用户需额外要求安装 Command Line Tools (CLT) for Xcode。

对于 macOS 用户，系统自带 bash、git 和 curl，在命令行输入 xcode-select --install 安装 CLT for Xcode 即可。
对于 Linux 用户，系统自带 bash，仅需额外安装 git 和 curl。

接着，在终端输入以下几行命令设置环境变量：

export HOMEBREW_INSTALL_FROM_API=1
export HOMEBREW_API_DOMAIN="<https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api>"
export HOMEBREW_BOTTLE_DOMAIN="<https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles>"
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>"

注：自 brew 4.0 起，HOMEBREW_INSTALL_FROM_API 会成为默认行为，无需设置；大部分用户无需再克隆 homebrew/core 仓库，故无需设置 HOMEBREW_CORE_GIT_REMOTE 环境变量。但若需要运行 brew 的开发命令或者 brew 安装在非官方支持的默认 prefix 位置，则仍需设置 HOMEBREW_CORE_GIT_REMOTE 环境变量；如果不想通过 API 安装，可以设置 HOMEBREW_NO_INSTALL_FROM_API=1。

最后，在终端运行以下命令以安装 Homebrew / Linuxbrew：

# 从本镜像下载安装脚本并安装 Homebrew / Linuxbrew
git clone --depth=1 <https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.git> brew-install
/bin/bash brew-install/install.sh
rm -rf brew-install

# 也可从 GitHub 获取官方安装脚本安装 Homebrew / Linuxbrew
/bin/bash -c "$(curl -fsSL <https://github.com/Homebrew/install/raw/master/install.sh>)"

这样在首次安装的时候也可以使用镜像。更多信息请参考 Homebrew 官方安装文档。

安装成功后需将 brew 程序的相关路径加入到环境变量中：