Skip to content

Homebrew切换镜像

约 527 字大约 2 分钟

MacOSHomebrew

2025-01-07

介绍

当使用Homebrew安装软件时,默认会从GitHub下载,速度较慢,可以切换国内镜像来提高下载速度。

默认仓库地址

Homebrew 核心代码仓库:

Homebrew 的核心代码托管在 GitHub 上。默认仓库地址为:

https://github.com/Homebrew/brew.git

公式(Formulae)仓库:

Homebrew 的包(Formulae)主要在以下两个仓库中:

  1. Homebrew 核心包:
https://github.com/Homebrew/homebrew-core.git
  1. Homebrew Cask 包(主要是 macOS GUI 应用):
https://github.com/Homebrew/homebrew-cask.git

Bottles下载源:

BottlesHomebrew 用于快速安装的二进制包,默认托管在 GitHub Packages 上。默认地址类似于:

https://ghcr.io/v2/homebrew/core/<package-name>

设置国内镜像

在国内使用 Homebrew 的默认地址可能较慢。可以切换到国内镜像。

切换Bottles

编辑~/.zshrc文件,添加HOMEBREW_BOTTLE_DOMAIN环境变量,指向国内镜像地址。

$ cd ~
$ vim .zshrc

添加HOMEBREW_BOTTLE_DOMAIN

export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles

移除HOMEBREW_BOTTLE_DOMAIN,也可以手动编辑删除。

$ unset HOMEBREW_BOTTLE_DOMAIN

注意 这里使用中科大bottles源镜像,也可以使用其他的国内镜像,如清华镜像、阿里云镜像等。

核心代码和公式仓库源

切换为指定源:

# 替换 Homebrew 核心
git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git

# 替换 Homebrew-core
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git

# 替换 Homebrew-cask
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git

恢复为默认源:

# 恢复 Homebrew 核心
git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew.git

# 恢复 Homebrew-core
git -C "$(brew --repo homebrew/core)" remote set-url origin https://github.com/Homebrew/homebrew-core.git

# 恢复 Homebrew-cask
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://github.com/Homebrew/homebrew-cask.git

Homebrew国内镜像

清华开源镜像

核心代码:

https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git

Formulae 仓库:

https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git

Cask 仓库:

https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git

bottles源:

https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles

中科大镜像站

核心代码:

https://mirrors.ustc.edu.cn/homebrew-brew.git

Formulae 仓库:

https://mirrors.ustc.edu.cn/homebrew-core.git

bottles源:

https://mirrors.ustc.edu.cn/homebrew-bottles

参考

清华大学开源软件镜像站

阿里云Homebrew镜像

Github Homebrew