Mac 剪贴板历史会泄露 API Key 吗?
常常会,而且是设计使然:剪贴板工具会记录你复制的内容,而 API Key 恰恰是会被复制的。下面讲清楚它存了什么、macOS 提供了什么标记,以及 ClipVigil 怎么处理密钥。
先说结论
可能会。凡是“复制什么就记录什么”的剪贴板工具,都会把你从控制台或终端复制的 API Key 一并记下来,并保留到历史被清理为止。
这算不算问题,取决于四件事:工具会不会跳过密码管理器标记为敏感的内容;历史存在哪里、有没有加密;密钥会保留多久;以及谁、什么东西能看到面板,比如屏幕共享。
剪贴板工具会存什么
典型的剪贴板工具会保存你复制的内容(文本、图片、文件引用)、复制来源的 App、时间,以及方便你再找到它的搜索索引。多数把这些存在本机磁盘的数据库里,有的还带云同步。
每一份都是密钥的一个副本,比你粘贴的那一刻活得更久。风险就在这里,而且很安静:直到历史被投屏、被别的进程读取、或从备份里恢复,才会发现问题。
macOS 如何标记敏感内容
macOS 自己不会给密钥打标记。业界有一个社区约定,发布在 nspasteboard.org:往剪贴板放敏感数据的 App,会在旁边额外加上一种类型。
org.nspasteboard.ConcealedType:用于密码等机密内容org.nspasteboard.TransientType:用于不应被保留的短时数据org.nspasteboard.AutoGeneratedType:用于 App 自动生成的值,例如一次性验证码
设置这些类型的主要是密码管理器。它们只是“请求”,不是“强制”:剪贴板工具必须主动遵守,并且应当先看类型,再决定读不读内容。较新的 macOS 还会在 App 于后台读取剪贴板之前询问(系统设置 → 隐私与安全性 → 从其他 App 粘贴)。
历史里的密钥是怎么泄露的
- 面板是可见的:在屏幕共享或录屏时打开它,里面的全部内容都被看到了。
- 数据库是可读的:历史如果没有加密,同一用户下运行的其他软件或备份都能读到。
- 搜索会翻出旧内容:索引里有密钥,上个月的 Key 就很容易被找出来,无论是你,还是坐在你键盘前的任何人。
- 保留得太久:很多配置会把历史保留几天甚至永久,远比一个 Token 需要待在剪贴板里的时间长。
ClipVigil 怎么处理密钥
每一次复制都会按同样的顺序经过下面的检查,全部在你的 Mac 上完成。
- 先看类型. ClipVigil 先读剪贴板类型,再决定读不读内容。被标记为 Concealed、Transient 或 AutoGenerated 的内容,不读取也不记录。
- 排除的 App. 从排除列表里的 App 复制的内容不记录,默认包含 1Password、Bitwarden 和钥匙串访问。
- 密钥扫描器. 内置规则匹配 AWS、GitHub、OpenAI、Anthropic、Stripe、Slack、Google 的 Key,JWT,私钥,以及带密码的数据库 URL。普通 UUID 和 Git SHA 不会被误伤。
- 涂黑、不进搜索、销毁. 命中后只显示前缀和末 4 位,不写入搜索索引,默认 30 秒后销毁,也可以干脆不记录;删除后的数据会被覆写。
- 落盘即加密. 历史数据库使用 SQLCipher,密钥保存在你的钥匙串里。可以用 Touch ID 给面板上锁,面板也不会出现在录屏和屏幕共享中。
这条路径上没有任何网络请求:负责采集、存储和扫描剪贴板的代码里完全没有网络调用。
任何剪贴板工具都解决不了的事
识别是尽力而为。规则不认识的格式,或者你自己编的一个密码,看起来就是普通文本,可能会被当作普通文本保存。而且密钥待在系统剪贴板期间,任何有权读取剪贴板的 App 都能读到它。ClipVigil 保护的是它自己的历史,而不是系统剪贴板本身。
挑选剪贴板工具的检查清单
- 它会检查 Concealed 和 Transient 类型吗?:把密码交给它之前先问清楚。
- 历史在磁盘上加密吗?:密钥又放在哪里?
- 密钥能不进搜索吗?:或者过一小会儿就销毁?
- 面板会避开屏幕共享吗?:在测试通话里试一下。
- 它会通过网络发送什么?:应该有一份清单。
ClipVigil 对这份清单的回答,都写在隐私页和文档里。