macOS Homebrew 镜像源怎么备份恢复

陌伟大大_9029

陌伟大大_9029

2026-10-21

478人浏览

原创

homebrew 镜像源是 git 仓库的 remote url,备份与恢复即记录和还原 brew、homebrew-core、homebrew-cask 的 origin 地址及 homebrew_bottle_domain 环境变量;可通过命令导出为文本文件,再用 git remote set-url 和 echo export 命令恢复。

homebrew 镜像源本身不是独立配置文件,而是 git 仓库的远程地址(remote url),分别存于 brew、homebrew-core、homebrew-cask 这几个本地 git 仓库中。因此,“备份”和“恢复”本质上是记录和还原这些仓库当前使用的 remote 地址。


查看当前镜像源设置

执行以下命令,可分别查出三处关键源的当前 remote 地址:

git -C "$(brew --repo)" remote get-url origin
git -C "$(brew --repo homebrew/core)" remote get-url origin
git -C "$(brew --repo homebrew/cask)" remote get-url origin

⚠️ 注意:homebrew-cask 需已安装过(如运行过 brew install --cask xxx)才能查到;未安装时该目录不存在。

你还可以顺带检查二进制瓶(bottles)的域名设置:

echo $HOMEBREW_BOTTLE_DOMAIN

备份当前镜像源(推荐做法)

把上面四条信息保存为纯文本,例如存为 brew-sources-backup.txt:

brew repo: https://mirrors.ustc.edu.cn/brew.git
core repo: https://mirrors.ustc.edu.cn/homebrew-core.git
cask repo: https://mirrors.ustc.edu.cn/homebrew-cask.git
bottle domain: https://mirrors.ustc.edu.cn/homebrew-bottles/bottles

也可以用一行命令快速导出(复制粘贴即可):

{
  echo "# brew repo"; git -C "$(brew --repo)" remote get-url origin
  echo "# core repo"; git -C "$(brew --repo homebrew/core)" remote get-url origin
  echo "# cask repo"; git -C "$(brew --repo homebrew/cask)" remote get-url origin 2>/dev/null || echo "(not installed)"
  echo "# bottle domain"; echo "${HOMEBREW_BOTTLE_DOMAIN:-[not set]}"
} > ~/Desktop/brew-sources-backup-$(date +%Y%m%d).txt

生成的文件可存桌面或 iCloud 同步目录,便于后续找回。

macOS Notes
macOS Notes

通过 AppleScript 创建、读取、搜索及管理 macOS 备忘录。适用于用户要求记笔记、记录事项、保存想法、创建会议记录等场景。

下载

恢复镜像源(按备份内容重设)

假设你备份的是中科大源(USTC),恢复只需依次执行:

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
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles/bottles' >> ~/.zprofile
source ~/.zprofile

✅ 若用的是清华源,把 URL 中 mirrors.ustc.edu.cn 替换为 mirrors.tuna.tsinghua.edu.cn/git/homebrew/(注意路径差异)。

执行完后,运行 brew update 测试是否生效——成功则看到更新日志,无报错即表示恢复完成。


一键还原为官方源(应急用)

如果想彻底退回默认,运行以下三行:

git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew
git -C "$(brew --repo homebrew/core)" remote set-url origin https://github.com/Homebrew/homebrew-core
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://github.com/Homebrew/homebrew-cask
unset HOMEBREW_BOTTLE_DOMAIN
sed -i '' '/HOMEBREW_BOTTLE_DOMAIN/d' ~/.zprofile 2>/dev/null
source ~/.zprofile

再执行 brew update 即可同步回 GitHub 官方源。

不复杂但容易忽略

相关专题

更多
macOS怎么切换用户账户
macOS怎么切换用户账户

在 macOS 系统中,可通过多种方式切换用户账户。如点击苹果图标选择 “系统偏好设置”,打开 “用户与群组” 进行切换;或启用快速用户切换功能,通过菜单栏或控制中心的账户名称切换;还能使用快捷键 “Control+Command+Q” 锁定屏幕后切换。

2025.05.09

4684

14

PHP 命令行脚本与自动化任务开发
PHP 命令行脚本与自动化任务开发

本专题系统讲解 PHP 在命令行环境(CLI)下的开发与应用,内容涵盖 PHP CLI 基础、参数解析、文件与目录操作、日志输出、异常处理,以及与 Linux 定时任务(Cron)的结合使用。通过实战示例,帮助开发者掌握使用 PHP 构建 自动化脚本、批处理工具与后台任务程序 的能力。

2025.12.13

486

14

Figma AI自动化智能数据填充与交互生成实战
Figma AI自动化智能数据填充与交互生成实战

告别机械重复,详细演示如何用 AI 填充业务真实数据,并自动为页面添加交互连线,将静态设计稿快速转变为动态原型。

2026.05.13

325

17

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

2026.10.16

100

10

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

2026.10.16

60

10

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

2026.10.16

40

10

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

2026.10.16

40

15

Revel框架MVC路由与控制器
Revel框架MVC路由与控制器

本专题聚焦Revel框架MVC核心机制,讲解路由定义、控制器Action、参数绑定、请求响应和反向路由,并结合常见场景梳理接口请求处理流程。

2026.10.16

20

15

Revel框架入门与安装配置
Revel框架入门与安装配置

本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

2026.10.16

40

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Miniconda官方安装文档
Miniconda官方安装文档

共0课时 | 0人学习