..

mac下镜像飞速安装Homebrew教程

mac下镜像飞速安装Homebrew教程

mac下镜像飞速安装Homebrew教程

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

img

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

如果你是在M1芯片的Mac上安装Homebrew，可以先阅读下这篇文章：

如果安装过程中遇到问题，请遵循下面的沟通方式：

你可以点此 homebrew-install 创建issue，这也是最及时、最标准的反馈方式。

本教程拥有自己的主页啦，你可以获得更好的阅读体验，速度点击下面卡片查看：

1. 写在前面

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

使用官方脚本遇到上面的错误提示：请按照下面「安装步骤」步骤执行。

官方脚本无法使用的原因是raw.githubusercontent.com访问很不稳定，也可以采用写入hosts的方式，可以一定程度解决GitHub资源无法访问的问题，我也写了一篇操作文章，有需要可以阅读下。

2. 安装步骤

如果有更换镜像源的想法，强烈推荐使用镜像助手获取执行脚本。

/bin/bash -c "$(curl -fsSL https://gitee.com/ineo6/homebrew-install/raw/master/install.sh)"

如果命令执行中卡在下面信息（如提示有差异，请反馈给我）：

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

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

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

cask 同样也有安装失败或者卡住的问题，解决方法也是一样：

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

成功执行之后继续执行前文的安装命令:

/bin/bash -c "$(curl -fsSL https://gitee.com/ineo6/homebrew-install/raw/master/install.sh)"

最后看到==> Installation successful!就说明安装成功了。

最最后更新下：

3. 设置镜像

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

通过 brew config 命令可以查看相关配置信息。

3.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

3.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

更多可选源请访问 镜像助手。

3.3 设置bottles镜像

设置环境变量需要注意终端Shell的类型，请看下面说明：

镜像以中科大源为例。

从macOS Catalina(10.15.x) 版开始，Mac使用zsh作为默认Shell，对应文件是.zprofile，所以命令为：

echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles/bottles' >> ~/.zprofile
source ~/.zprofile

如果是macOS Mojave 及更低版本，并且没有自己配置过zsh，对应文件则是.bash_profile：

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

注意：上述区别仅仅是.zprofile和.bash_profile不同，文章如有再次提及编辑.zprofile，均按此方法替换。

如果想使用清华源：

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

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

至此，安装和设置操作都完成了。

3.4 恢复默认源

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配置只能手动删除，将 ~/.zprofile 文件中的 HOMEBREW_BOTTLE_DOMAIN=https://mirrors.xxx.com内容删除，并执行 source ~/.zprofile。

4. 其他相关

4.1 cask

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

在.zprofile中追加，注意替换yourtoken:

echo 'export HOMEBREW_GITHUB_API_TOKEN=yourtoken' >> ~/.zprofile
source ~/.zprofile

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

4.2 如何卸载Homebrew

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

/bin/bash -c "$(curl -fsSL https://gitee.com/ineo6/homebrew-install/raw/master/uninstall.sh)"

4.3 反馈问题

你可以点此 homebrew-install 创建issue，这也是最及时、最标准的反馈方式。

5. 总结

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

原理是通过修改install.sh脚本，在里面预设镜像地址。

STAT="stat --printf"
  CHOWN="/bin/chown"
  CHGRP="/bin/chgrp"
  GROUP="$(id -gn)"
  TOUCH="/bin/touch"
fi
# 这里替换了BREW_REPO
BREW_REPO="https://mirrors.ustc.edu.cn/brew.git"

如果对您有帮助

点赞、分享、收藏，能让更多人能发现文章，这也是对我的认可和鼓励，谢谢。

参考文章

广告插播

GitMaster可以树形展示git项目代码。

  • 代码树支持GitHub、GitLab、Gitee
  • ️ 支持私有部署页面，一键标记
  • ️ 文件提交历史可视化 git history
  • GitHub通知提醒功能
  • ⬇️ 支持GitHub文件、目录下载

img

安装

商店安装

FAQ

大部分问题都是资源不稳定导致的，如果可以的话尽量通过代理加速。

代理使用可以参考以下文章：

最新版问题排查内容请访问FAQ，以便获得强有力的支持。

No.1 的小秘籍

遇到解决不了的问题，先删除homebrew目录再重新运行脚本安装。

  • x86 上安装目录： /usr/local/Homebrew/
  • arm 上安装目录： /opt/homebrew

fatal: unable to access xxx

HEAD is now at 028e733e7 Merge pull request #10260 from reitermarkus/audit-livecheck

fatal: unable to access 'https://github.com/Homebrew/homebrew-core/': transfer closed with outstanding read data remaining
fatal: ambiguous argument 'refs/remotes/origin/master': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'

解决方案：

设置镜像无效，安装还是很慢

这里说的安装很慢主要是指brew本身安装速度慢（镜像地址没有设置成功）。

可以执行命令echo $SHELL，先查看终端类型。

  • bash: /bin/bash
  • zsh: /bin/zsh

然后根据终端类型设置镜像，参考"设置镜像"。

command not found: brew

一般是环境变量无效，请使用echo $SHELL确认终端类型，参考上节。

如果是m1芯片Mac需要手动设置环境变量：

zsh

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

bash

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.bash_profile
eval "$(/opt/homebrew/bin/brew shellenv)"

非m1芯片，可以尝试手动加入环境变量：

zsh

echo 'eval "$(/usr/local/Homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/Homebrew/bin/brew shellenv)"

bash

echo 'eval "$(/usr/local/Homebrew/bin/brew shellenv)"' >> ~/.bash_profile
eval "$(/usr/local/Homebrew/bin/brew shellenv)"

SHA256 mismatch

Error: An exception occurred within a child process:
  ChecksumMismatchError: SHA256 mismatch
Expected: 01059532335fefc5e0e7a23cc79eeb1dc6fea477606981b89f259aa0e0f9abc1
  Actual: 641ba394c891cee16dfa45873906edab12edfc9befaa121649bb18e7b7d574bf
 Archive: /Users/XXX/Library/Caches/Homebrew/downloads/1124b500fc261f6d9be6193eca8c120f4dfb7ecd3470ac7d8edc1d04ecc5b345--jdk13u-jdk-13.0.2+8.tar.bz2
To retry an incomplete download, remove the file above.

遇到该问题时请尝试该方案：https://blog.csdn.net/lemostic/article/details/107101219

本文首发:

home brew 常用命令

  • 查看brew的帮助
brew –help
  • 安装软件
brew install git
  • 卸载软件
brew uninstall git
  • 搜索软件
brew search git
  • 显示已经安装软件列表
brew list
  • 更新软件，把所有的Formula目录更新，并且会对本机已经安装并有更新的软件用*标明。
brew update
  • 更新某具体软件
brew upgrade git
  • 显示软件内容信息
brew info git
  • 用浏览器打开
brew home
  • 显示包依赖
brew deps
  • 显示包的依赖树
brew deps --installed --tree
  • 启动web服务器，可以通过浏览器访问http://localhost:4567/ 来同网页来管理包
brew server
  • 删除程序，和upgrade一样，单个软件删除和所有程序老版删除。
brew cleanup git 
brew cleanup
  • 查看那些已安装的程序需要更新
brew outdated

brew update               自动升级homebrew（从github下载最新版本） 
brew outdated             检测已经过时的软件 
brew upgrade              升级所有已过时的软件，即列出的以过时软件 
brew upgrade <formula>    升级指定的软件 
brew pin <formula>        禁止指定软件升级 
brew unpin <formula>      解锁禁止升级 
brew upgrade --all        升级所有的软件包，包括未清理干净的旧版本的包 
brew cleanup -n           列出需要清理的内容 
brew cleanup <formula>    清理指定的软件过时包 
brew cleanup              清理所有的过时软件 
brew uninstall <formula>    卸载指定软件 
brew uninstall <fromula> --force 彻底卸载指定软件，包括旧版本 
brew list                 显示所有的已安装的软件 
brew search text          搜索本地远程仓库的软件，已安装会显示绿色的勾 
brew search /text/        使用正则表达式搜软件

Homebrew国内如何自动安装（国内地址）（Mac & Linux）

Homebrew国内如何自动安装（国内地址）（Mac & Linux）

如果你是提示来这个页面查看错误，说明你用的脚本太老了，用下面脚本安装。

自动脚本(全部国内地址)（复制下面一句脚本到终端中粘贴回车)

苹果电脑 常规安装脚本（推荐 完全体 几分钟安装完成）：

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

苹果电脑 极速安装脚本（精简版 几秒钟安装完成）：

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)" speed

-> Mac电脑如何打开终端：command+空格 在聚焦搜索中输入terminal回车。

苹果电脑 卸载脚本：

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/HomebrewUninstall.sh)"

常见错误去下方地址查看

https://gitee.com/cunkai/HomebrewCN/blob/master/error.md

Linux电脑 安装脚本：

rm Homebrew.sh ; wget https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh ; bash Homebrew.sh

Linux电脑 卸载脚本：

rm HomebrewUninstall.sh ; wget https://gitee.com/cunkai/HomebrewCN/raw/master/HomebrewUninstall.sh ; bash HomebrewUninstall.sh