零遥测零上传:cleanupper隐私设计剖析,100%本地运行的Mac清理工具
零遥测零上传:cleanupper隐私设计剖析,100%本地运行的Mac清理工具
cleanupper 是一款免费开源的 macOS 磁盘清理命令行工具(Mac cleaner CLI),100% 本地运行:不发起任何网络请求、不上传任何遥测数据、从不读取你的文件内容。对于每天在终端里清理 Xcode DerivedData、npm 缓存和 node_modules 的用户来说,它是一款真正"看得见每一行"的 CleanMyMac 替代品。
下面这篇文章带你逐层剖析:它的"零遥测"承诺,到底是怎么在代码里落地的? 🔒
为什么"零遥测"是清理工具的生命线?
磁盘清理工具天然要回答两个敏感问题:
- 它能看到我什么? —— 它必然要遍历你的
~/Library和项目目录; - 它会把这些信息发到哪儿去? —— 这正是大多数闭源清理软件不敢细说的地方。
cleanupper 的答案很干脆:只在你自己的 Mac 上运行,不打电话回家。没有订阅、没有升级弹窗、没有数据回传,你可以把它的每一行代码读个遍来验证。⚡
隐私剖析一:全源码审查——找不到一行网络代码
判断一个工具是否真的"本地运行",最直接的办法是审查源码。cleanupper 的核心代码只有约 600 行 ESM Node.js 代码,全部集中在 src/ 目录下。
我们把 src/ 下所有文件的 import 语句拉出来看,用到的 Node 内置模块只有:
| 模块 | 用途 |
|---|---|
node:fs/promises |
读取目录结构、统计大小、移动到废纸篓 |
node:path / node:os |
路径拼接与家目录展开 |
node:readline |
终端确认提示(y/N) |
node:child_process |
调用本机已有的 brew、pnpm、go 命令 |
node:util / node:process |
工具函数与标准输入输出 |
注意:没有 node:net、node:http、node:https,没有 fetch,没有任何 socket 调用。 整个仓库搜不到一个网络请求。唯一会"执行外部程序"的地方,是白名单式的本机工具链集成(brew cleanup -s、pnpm store prune、go clean),实现在 src/cleaner.js 的 runNativeCleaner——它只调用你已经安装在本地的命令,用于清理各自的缓存,本身不产生任何 cleanupper 发起的网络行为。
再看第三方依赖,package.json 里只有三个"安静"的包:
chalk—— 终端文字着色commander—— 命令行参数解析ora—— 扫描时的进度转圈动画
没有埋点 SDK、没有分析库、没有上报通道。依赖面越小,隐私攻击面越小——这就是最小依赖策略的价值。
隐私剖析二:目录式清理——"不在清单上的,绝不出现在结果里"
很多清理软件靠启发式算法"猜"哪些文件是垃圾,猜错就误删。cleanupper 反其道而行之:清理目标来自一份人工审计过的固定清单(catalog),全部集中在 src/categories.js。
这份清单包含 16 个类别:应用缓存、日志与崩溃报告、浏览器缓存、Homebrew、npm/Yarn/pnpm、pip/uv、CocoaPods、Gradle、Cargo、Go、Xcode DerivedData、iOS DeviceSupport、模拟器缓存……每一条都带有安全标签(safe / review)和一段通俗的英文说明。
隐私和安全收益有两点:
- 可预测:它只可能动清单里列出的路径,不认识的路径连扫描结果里都不会出现,更谈不上被删除;
- 可审查:想搞清楚它到底会碰哪些目录?打开一个文件就能全部看完,无需逆向闭源二进制。运行
cleanupper list也能直接打印整份清单。
隐私剖析三:受保护路径黑名单——结构性保险
"不在清单上就不动"是第一道闸,cleanupper 还加了第二道:src/categories.js 中定义了 PROTECTED_PREFIXES 受保护前缀列表,包括:
- 系统级:
/、/System、/Library、/usr、/etc、/var等; - 个人数据:
Documents、Desktop、Pictures、Movies、Music; - 敏感配置:
Library/Application Support(浏览器登录态所在)、Library/Mobile Documents(iCloud 同步数据)。
扫描器在 src/scanner.js 的 isProtected 中做硬拦截:任何目标路径只要命中这些前缀,直接跳过。即使未来清单被人误改、加错了路径,这一层也会兜底——灾难性删除在这个工具里是结构上不可能的。这正是 CONTRIBUTING.md 里对贡献者强调的铁律:永远不要把个人数据位置加进清理目录。
隐私剖析四:只收集路径与大小,从不打开文件
清理工具要报"能释放 31.4 GB",就得统计体积。cleanupper 的体积统计函数 pathSize 只调用 lstat 读取文件元数据(名字、大小、时间戳),然后对目录树求和——它从不读取任何文件的实际内容。
换句话说:
- 你的照片、文档、聊天记录、SSH 密钥的内容,它一个字节都没看过;
- 符号链接直接被跳过,不会被"顺手"跟走;
- 权限不足的目录会安静跳过,而不是重试或报错上报。
配合 --json 输出(见 src/cli.js),扫描结果只会包含"路径 + 大小"这样的本地数据,完全服务于你自己在终端里的决策。
废纸篓优先:删除可逆,空间"暂缓释放"而非"立即蒸发" 🗑️
隐私不止是"不看",还有"删错了怎么办"。cleanupper 的删除引擎(src/cleaner.js)默认走"废纸篓优先"策略:
- 所有删除 = 移动到
~/.Trash,由 src/utils.js 的moveToTrash实现,并自动生成防重名后缀,避免覆盖同名文件; - 跨磁盘无法直接 rename 时,才退化为"拷贝进废纸篓再删除",且永远不会静默硬删;
- 永久删除必须显式传入
--permanent参数,默认路径里根本没有这个开关; - 每一步都有确认提示(src/prompt.js 的
confirm,默认值是N),除非你主动传--yes。
即使真删错了,只要你不手动清空废纸篓,所有文件都还躺在里面等你恢复。磁盘空间在你清空废纸篓时才真正释放——安全与空间之间,默认永远倒向安全。
如何自己验证"零遥测"?三步就够 ✅
开源工具最强大的地方在于:你不需要相信我的文章,你可以亲自验证。
第一步:看依赖。 安装后运行 npm ls,确认依赖树里只有 chalk、commander、ora 三个包,没有埋点库。
第二步:搜网络 API。 在 src/ 里搜索 http、fetch、net、socket——结果是零命中(可以对照本文第一节的模块清单)。
第三步:离线实测。 把 Mac 断开网络连接(或关掉 Wi-Fi),然后运行:
cleanupper scan
cleanupper clean
扫描、统计、清理照常完成——因为整个过程根本不需要网络。相关行为还有单元测试覆盖,见 test/utils.test.js(废纸篓移动、目录树统计、产物检测等),运行 npm test 即可复现。
小结:一套可以对照的本地隐私清单
把 cleanupper 的隐私设计浓缩成一张清单,任何一款 Mac 清理工具都可以拿来对照打分:
| 维度 | cleanupper 的做法 |
|---|---|
| 网络行为 | 零网络请求,无遥测、无分析、无崩溃上报 |
| 依赖面 | 仅 3 个无网络的第三方包 |
| 清理范围 | 固定人工审计目录,非启发式猜测 |
| 个人数据 | 受保护路径黑名单硬拦截 |
| 文件内容 | 只读路径与大小元数据,从不打开文件 |
| 删除方式 | 废纸篓优先,永久删除需显式参数 |
| 可验证性 | 约 600 行核心源码 + 单元测试,全部可审 |
如果你受够了"装完才知道它上传了什么"的清理软件,cleanupper 提供了一种思路:隐私不该是营销词,而是可以被逐行验证的代码事实。🧹