Skip to content
hulatuPublic

About

让 macOS 发现不了更新:可完全还原的 shell 脚本。

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pin-macos

让 Mac 停在当前大版本,但不再错过本版本的小更新和 Safari 补丁。

一个可完全还原的纯 shell 脚本:系统原生更新提示保持关闭,由脚本每周检查一次,只放行当前大版本内的更新。

License macOS Shell

快速开始 · 两种模式 · 它做了什么 · Safari 27 是怎么回事 · 还原 · 常见问题 · 中文说明页 →


Warning

它仍然不会自动安装安全补丁。 系统原生更新提示是关闭的,安全更新需要你自己运行 pin-macos.sh update(只装当前大版本内的更新)或临时 revert。

如果你长期停留在一个大版本,请至少每隔一两个月运行一次 update。macOS 15 的官方安全支持大约到 2027 年前后,之后停留在这个版本的风险会明显上升。这是你自己的选择,脚本作者不承担系统不安全带来的后果。


它解决什么问题

每次打开「系统设置」,Dock 上的红点就在;点进去是「macOS XX 可用」,点「以后提醒我」,过几天它又来。更烦的是,明明只想留在 15.x,系统却把 Safari 27、macOS 26/27 一起端上来。

pin-macos 现在做两件事:

  1. 系统原生更新提示全部关掉——没有红点,没有「新版本可用」弹窗,也没有 Safari 27 的提示。
  2. 由脚本按版本白名单检查——每周一次,只告诉你当前大版本内(例如 15.8.4)和同代 Safari(15.x 对应 Safari 18.x)的更新;macOS 26/27、Safari 27 会被过滤掉。

English TL;DR — A reversible script that keeps the Mac on its current major version. Native update prompts are disabled; a weekly LaunchDaemon scans with a version whitelist and notifies only for same-major updates (e.g. 15.8.4) and matching Safari (18.x on macOS 15). Major upgrades and cross-generation Safari builds are filtered out. It still blocks automatic security updates — run update to install the whitelisted ones.

为什么不能直接让系统「只提示小版本」

macOS 没有面向零售机(非 MDM 监管)的「只显示当前大版本更新」开关:

方法 结论
sudo softwareupdate --ignore "macOS 27" macOS 15 已移除该参数
forceDelayedMajorSoftwareUpdates / 延迟描述文件 只在受监管 + MDM 下发的设备上生效;零售机手动安装会被忽略,而且最多只延迟 90 天
只关「自动更新」开关 关的是「自动安装」,不是「自动发现」;后台仍会检查并弹通知
只屏蔽 gdmf.apple.com 能压掉大版本升级横幅,但也会让系统看不到 macOS 小版本,而且不挡 Safari
只屏蔽 swscan.apple.com 所有更新都看不到,包括 Safari 和本版本小更新

系统 UI 拿到的是同一份目录,没有「按产品忽略」的入口。所以要做到「15.8.4 可以、26/27 和 Safari 27 不行」,只能不让系统自己去提示,由脚本接管检查和过滤。

两种模式

模式 系统原生提示 每周检查 适用
minor(默认) 全关 有,只通知当前大版本内的更新 想留在 15.x,但仍要知道 15.8.4 / Safari 18.x
strict 全关 无 完全不想被任何更新打扰(旧行为)

minor 模式的过滤规则:

产品 规则 例子(系统为 15.8.3)
macOS 只放行与当前大版本相同的小版本 15.8.4 ✓,15.8.5 ✓,26.7 ✗,27.1 ✗
Safari 只放行与当前系统同代的版本 Safari 18.6 ✓,Safari 27.2 ✗
其他(Xcode CLT、XProtect 等) 放行 Command Line Tools ✓

Safari 的同代映射写在脚本的 safari_max_major() 里:macOS 13/14/15 对应 Safari 18.x,macOS 26/27 对应 Safari 26.x/27.x。想放宽或收紧,改这一个函数即可。

Note

Safari 27 包含安全修复。如果你更看重浏览器安全而不是「只用同代 Safari」,把 safari_max_major() 里 macOS 15 的返回值从 18 改成 27,下一次检查就会把 Safari 27 列为可安装。

Safari 27 是怎么回事

它不是从 macOS 27「漏」进来的。 Apple 在 2026-09-14 发布 macOS Sequoia 15.8 时,同时给 Sequoia 发布了 Safari 27.0;2026-10-27 又发布了 Safari 27.2。Safari 的版本号现在跟随新的发布代际,但会下放到旧系统,所以 macOS 15.8.x 上出现 Safari 27 的更新是正常的。

旧版 pin-macos 是「全有或全无」:它把所有更新服务器都掐断,因此不区分「15.8.4」和「Safari 27」。只要有一层失效——比如代理绕过 /etc/hosts、系统更新后偏好被重置、或者通知来自之前已下载的缓存——你看到的就会是 Safari 27 或 macOS 27 的提示。

新版做了三件事来堵住它:

  1. install 会清理 /Library/Updates 和系统记住的推荐更新,去掉「网络已断但提示还在」的缓存;
  2. 增加 CatalogURL 指向本地空端口的兜底层,代理/DNS 绕过 hosts 时仍然拿不到更新目录;
  3. minor 模式的检查结果按版本过滤,Safari 27 只会出现在「已屏蔽」列表里,不会触发通知。

它做了什么

七层,从软到硬:

层 做法 效果
1. 偏好设置 6 个自动更新开关置 false 停掉后台定期检查,这是弹窗的源头
2. 通知 禁用 com.apple.SoftwareUpdateNotificationManager,提醒日期推到 2099 不再弹「新版本可用」
3. 网络 11 个 Apple 更新域名指向 0.0.0.0 即使有进程去查,也连不上服务器
4. 应用层兜底 CatalogURL 指向 http://127.0.0.1:9/ 代理/DNS 绕过 hosts 时仍拿不到目录
5. 缓存 清理 /Library/Updates 与 LastRecommended* 去掉已下载/已记住的更新提示
6. 角标 清掉「系统设置」Dock 图标上的红点 视觉上安静
7. 白名单检查 每周一 10:00 临时放行,扫描后立即恢复 只通知白名单内的更新

前六层是「不想让它查 / 查了也白查」;第七层是 minor 模式唯一的「放行通道」,每次只开约 1 分钟,扫描完立刻恢复屏蔽。

CatalogURL 是 Apple 已标记弃用的旧键,在 macOS 15.7.3 上仍有用户验证它能阻断检测。这里把它当第 4 层兜底,而不是唯一依赖;即使某天系统忽略它,hosts、禁用的通知任务和缓存清理仍在。

精确改动清单

/Library/Preferences/com.apple.SoftwareUpdate.plist     6 个开关 -> false,CatalogURL -> 127.0.0.1:9
~/Library/Preferences/com.apple.SoftwareUpdate.plist    两个通知日期 -> 2099-12-31
/etc/hosts                                              追加一段带标记的屏蔽(可整段删除)
/Library/Updates/*                                      已下载的更新缓存(清空)
launchd (gui/<uid>)                                     disable com.apple.SoftwareUpdateNotificationManager
/Library/LaunchDaemons/com.hulatu.pin-macos.check.plist  minor 模式的每周检查(周一 10:00)
/Library/Application Support/pin-macos/pin-macos.sh     脚本副本(供 LaunchDaemon 调用)

/etc/hosts 中被写入的部分长这样,标记清晰、易于手工删除:

# === pin-macos BEGIN ===
# 由 pin-macos 添加:阻止 macOS 更新检测。删除本段即可恢复。
0.0.0.0 swscan.apple.com
...
# === pin-macos END ===

快速开始

要求:macOS 13 / 14 / 15,系统自带 bash。不需要关闭 SIP,不会让设备变成「受监管」,不安装任何描述文件。

git clone https://github.com/hulatu/Pin-MacOS.git
cd Pin-MacOS
chmod +x pin-macos.sh

sudo ./pin-macos.sh install          # 默认 minor 模式
./pin-macos.sh status                # 查看状态
sudo ./pin-macos.sh check            # 立即检查一次(只列 15.x / Safari 18.x)
sudo ./pin-macos.sh update           # 安装筛选后的更新
./pin-macos.sh doctor                # 哪一层失效了?先跑这个
命令 作用 需要 root
install [minor|strict] 应用配置,默认 minor;先备份再修改 ✅
status 逐项检查当前状态,只读 —
check [--notify] 临时放行、扫描、按版本过滤;--notify 会发系统通知 ✅
update 检查并安装白名单内的更新(会临时放行下载) ✅
doctor 检查 hosts / CatalogURL / Clash / 缓存 / 守护任务 —
verify 验证系统原生扫描确实被阻断 ✅
revert 完全还原到安装前 ✅

install 是幂等的,重复执行不会把备份覆盖成「已修改」的版本。

Note

minor 模式的 LaunchDaemon 运行的是 /Library/Application Support/pin-macos/pin-macos.sh 这个副本。改过仓库里的脚本后,请重新执行一次 sudo ./pin-macos.sh install,副本才会更新。

每周检查和通知

minor 模式会安装一个 LaunchDaemon,每周一 10:00 运行 check --notify:

  • 有 15.x / Safari 18.x 更新:弹一条「pin-macos」通知,并写入 /Library/Application Support/pin-macos/last-check.txt;
  • 没有:只写日志,不打扰;
  • 扫描失败(例如 Clash 的 REJECT 规则拦住了):日志里会有一条警告,用 doctor 定位。

检查窗口大约 10–60 秒,期间会临时移除 hosts 屏蔽并删除 CatalogURL,结束后立刻恢复。系统通知管理器始终是禁用的,所以这个窗口不会让 macOS 自己弹提示。

错过时间(比如 Mac 在睡眠)时,launchd 会在唤醒后补跑一次。

更新

sudo ./pin-macos.sh update

它会重新扫描、列出白名单内的更新、逐个用 softwareupdate --install <Label> 安装。不会安装 macOS 26/27,也不会安装 Safari 27。安装完成后会重新套用屏蔽策略;如果需要重启,脚本只提示,不会自动重启。

还原

sudo ./pin-macos.sh revert

会移除 LaunchDaemon、hosts 段落、CatalogURL,恢复系统级/用户级偏好设置和通知任务。备份保留在 /Library/Application Support/pin-macos/,确认无误后可自行删除。

代理用户请注意

Important

minor 模式和 Clash 的全量 REJECT 规则是冲突的。 每周检查需要短暂访问 Apple 更新服务器;如果你的「规则增强」里还有 11 条 REJECT,检查会被拦下来。

minor 模式(默认)

不需要 Clash 规则。CatalogURL 兜底层会在代理绕过 /etc/hosts 时继续阻断系统更新检测。如果你之前跑过:

./extras/clash-verge.sh revert    # 移除 REJECT 规则

然后重启 Clash Verge。运行 doctor 会检查是否还有残留规则。

strict 模式

建议同时启用 Clash 规则:

chmod +x extras/clash-verge.sh
./extras/clash-verge.sh install   # 写入 REJECT 规则
./extras/clash-verge.sh revert    # 还原

脚本会给所有「规则增强」文件(prepend: [] 模板)注入 REJECT 规则,改完需要重启 Clash Verge。如果你的规则增强文件里 prepend 已有内容,脚本会跳过并提示,请手动把条目加到最前面。

兼容性

  • 面向 macOS 13 / 14 / 15 编写;过滤逻辑已用模拟的 softwareupdate --list 输出做单元测试。
  • 真机环境(macOS 15.8.3 / M1 Pro)上建议先跑 install → status → check → doctor,确认列表符合预期后再用 update。macOS 26 / 27 未测试(本项目的目的正是不要升到那里)。
  • 不需要关闭 SIP,不会让设备变成「受监管」,不会安装任何描述文件。

常见问题

为什么 Safari 27 会出现在 macOS 15 上?

因为 Apple 把 Safari 27 下放给了 Sequoia 15.8。Safari 27 不是「macOS 27 专用」,它在 2026-09-14 与 15.8 同日发布,2026-10-27 又发了 27.2。旧版 pin-macos 不区分产品,所以只要有一层失效就会看到它;新版 minor 模式会把它归入「已屏蔽」。

为什么系统原生提示不显示 15.8.4?

这是有意的。系统 UI 没有「只显示小版本」的开关,一旦让它自己检查,Safari 27 和 macOS 26/27 也会一起出现。所以原生提示保持关闭,由 pin-macos 的每周检查代替;通知内容只包含白名单内的更新。

系统设置里为什么显示「无法检查更新」?

这是预期结果。CatalogURL 被指向本地空端口,系统原生的检查链路被故意切断,所以「软件更新」面板会报错或转圈。请用 sudo ./pin-macos.sh check 查看本版本更新,用 update 安装。

旧版本已经 install 过,需要先 revert 吗?

不需要。直接运行新版 sudo ./pin-macos.sh install 即可:它会保留原有备份,把 hosts 段落补成最新的 11 条域名,写入 CatalogURL,清理缓存,并安装每周检查任务。旧版留下的 strict 行为会被切换成默认的 minor。

会不会被系统更新覆盖?

重装系统、大版本升级、或某些系统更新会重置偏好设置和 launchd 状态;/etc/hosts 一般会保留。建议升级/重装后重新执行一次 install,然后跑 doctor。update 安装完也会自动重新套用策略。

为什么 status 里「自动检查更新」显示「未设置」?

macOS 在每次执行 softwareupdate --list(或后台扫描)后会重写 plist,并删掉 AutomaticCheckEnabled 这个键。这是系统行为,不影响屏蔽效果——真正兜底的是 /etc/hosts、CatalogURL 和禁用的通知任务。check / update 结束后会自动补写回去。

怎么只装安全更新?

minor 模式下运行 sudo ./pin-macos.sh update,它会安装当前大版本内的更新(包括 Safari 18.x)。如果你需要的是 macOS 26/27 的安全补丁,那只能升级大版本,和本项目目标冲突。

想临时允许 Safari 27 怎么办?

把 safari_max_major() 里 macOS 15 的返回值从 18 改成 27,或临时 revert 后用系统更新。注意 Safari 27 是跨代版本,可能带来与 15.x 的兼容性差异。

status 显示「通知管理器任务:未禁用」?

以 root 之外的普通用户运行 status 时,读取的是该用户的 launchd 域。如果安装时是用 sudo 执行的、目标用户判断正确,通常不会出现;出现的话重新 install 一次即可。

为什么不用 Little Snitch 之类的防火墙?

可以,那是另一种实现。本项目倾向于零依赖、纯脚本、可完全还原。

脚本会偷偷做别的事吗?

不会。源码是单个 shell 文件,只做上面「精确改动清单」列出的事情。除了 check / update / verify 会调用系统的 softwareupdate,没有任何网络请求。

目录结构

Pin-MacOS/
├── pin-macos.sh          # 主脚本:install / revert / status / check / update / doctor / verify
├── extras/
│   └── clash-verge.sh    # Clash Verge Rev 的规则注入(strict 模式)
├── README.md
└── LICENSE

反馈

遇到问题,或者想补充一条兼容性记录,欢迎提 Issue。

License

MIT

About

让 macOS 发现不了更新:可完全还原的 shell 脚本。

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages