mac下国内安装Homebrew教程

mac下国内安装Homebrew教程

Homebrew是一款包管理工具，目前支持macOS和linux系统。主要有四个部分组成: brew、homebrew-core 、homebrew-cask、homebrew-bottles。

名称	说明
brew	Homebrew 源代码仓库
homebrew-core	Homebrew 核心源
homebrew-cask	提供 macOS 应用和大型二进制文件的安装
homebrew-bottles	预编译二进制软件包

本文主要介绍Homebrew安装方式以及如何加速访问，顺便普及一些必要的知识。

1. 脚本说明

Homebrew默认安装脚本：

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

如果你等待一段时间之后遇到下面提示，就说明无法访问官方脚本地址：

curl: (7) Failed to connect to raw.githubusercontent.com port 443: Operation timed out

请使用下面的脚本:

/usr/bin/ruby -e "$(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/install)"

2. 执行命令

/usr/bin/ruby -e "$(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/install)"

如果命令执行中卡在下面信息：

==> Tapping homebrew/core
Cloning into '/usr/local/Homebrew/Library/Taps/homebrew/homebrew-core'...

请Command + C中断脚本执行如下命令：

cd "$(brew --repo)/Library/Taps/"
mkdir homebrew && cd homebrew
git clone git://mirrors.ustc.edu.cn/homebrew-core.git

成功执行之后继续执行前文的安装命令。
最后看到 ==> Installation successful! 就说明安装成功了。
最最后执行：brew update

cask同样也有首次下载缓慢的问题，解决方法大致同上：

cd "$(brew --repo)/Library/Taps/"
cd homebrew
git clone https://mirrors.ustc.edu.cn/homebrew-cask.git

3. 卸载Homebrew

使用官方脚本同样会遇到uninstall地址无法访问问题，可以替换为下面脚本：

/usr/bin/ruby -e "$(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/homebrew-install/uninstall)"

4. 设置镜像

brew、homebrew/core是必备项目，homebrew/cask、homebrew/bottles按需设置。

通过 brew config命令查看配置信息。

4.1 中科大源

git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git

git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git

git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git

brew update

# 长期替换homebrew-bottles
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles' >> ~/.bash_profile
source ~/.bash_profile

注意bottles可以临时设置，在终端执行下面命令：

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

4.2 清华大学源

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

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

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

brew update

# 长期替换homebrew-bottles
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles' >> ~/.bash_profile
source ~/.bash_profile

4.3 恢复

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

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

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

brew update

homebrew-bottles配置只能手动删除，将 ~/.bash_profile文件中的 HOMEBREW_BOTTLE_DOMAIN=https://mirrors.xxx.com内容删除，并执行 source ~/.bash_profile。

5. 其他

5.1 cask

目前cask是从GitHub上读取软件源，而GitHub Api对匿名访问有限制，如果使用比较频繁的话，可以申请Api Token，然后在环境变量中配置到HOMEBREW_GITHUB_API_TOKEN。

在.bash_profile中追加:

export HOMEBREW_GITHUB_API_TOKEN=yourtoken

注意：因为cask是基于GitHub下载软件，所以目前是无法加速的。

6. 总结

在前面的过程中我们把brew和homebrew-core的地址都指向到中科大镜像。

原理是通过修改install脚本，在里面预设镜像地址来做到的。

#!/usr/bin/ruby
# This script installs to /usr/local only. To install elsewhere (which is
# unsupported) you can untar https://github.com/Homebrew/brew/tarball/master
# anywhere you like.
HOMEBREW_PREFIX = "/usr/local".freeze
HOMEBREW_REPOSITORY = "/usr/local/Homebrew".freeze
HOMEBREW_CACHE = "#{ENV["HOME"]}/Library/Caches/Homebrew".freeze
# 这里替换了BREW_REPO
BREW_REPO = "https://mirrors.ustc.edu.cn/brew.git".freeze

最后不完美的地方是我们只能预设brew镜像，没找到比较好的办法预设homebrew-core、homebrew-cask的git地址。