API key 泄露了怎么办?被盗刷怎么止损、怎么自查、以后怎么防(2026)
API key 泄露后第一步是吊销,不是删提交、不是把仓库设成私有。按止损顺序处理、用三条标准自查有没有泄露,再用分 key 和预付余额把下一次的损失封在最小范围。
1. 泄露的后果为什么来得这么快
按量计费的 API key 不是一个普通密码,它本身就是付款凭证:请求里带着它,服务商就从这把 key 所属的账户扣费,不需要你的登录密码,也不需要你的确认。有人专门用程序持续扫描公开的代码仓库、公开的软件包和网页,寻找形如 key 的字符串;拿到之后会尽快用掉,因为他们知道你迟早会吊销。所以一次泄露的损失只取决于两件事:从泄露到吊销隔了多久,以及这把 key 背后最多能花掉多少钱。前者靠发现得早,后者靠事前设好天花板。风险最高的是后付费、绑定信用卡自动扣款的账户:没有余额这道墙,损失要等到账单出来或触发服务商的消费上限才会停。
2. key 是从哪几条路漏出去的
① 提交进 Git:.env 没写进 .gitignore、测试脚本里临时写死了 key、配置示例文件里填的是真值。② 打进前端或客户端:浏览器加载的 JS、App 安装包、浏览器插件,任何发到用户设备上的东西都能被看到,混淆只是让人多花几分钟。③ 贴进公开渠道:提问时贴了完整的 curl 命令、截图里带着终端、把含请求头的报错日志原样贴进 issue 或群聊。④ 交给第三方工具:各种要你填 key 的在线工具、插件和共享配置,这把 key 的安全从此取决于对方的安全。前两条可以用工具在提交前拦住,后两条只能靠习惯 —— 所以下面第 7 节既给工具,也给习惯。
3. 为什么「删掉提交」「设成私有」都不算处理
Git 的历史是追加的:你在下一次提交里删掉 key,它仍然躺在之前的提交里,任何 clone 过仓库的人都能翻出来。仓库公开过哪怕几分钟,内容也可能已经被抓取、被 fork、被缓存。把仓库设成私有、甚至删掉仓库,只能挡住以后的人,挡不住已经拿到的人。唯一能让泄露失效的动作,是在服务商后台让这把 key 作废。重写 Git 历史(用 git filter-repo 这类工具)是第二步的事,目的是防止以后的人再捡到;而且要通知所有协作者重新 clone,否则他们本地的旧历史一推,key 又回来了。
没有海外卡也能调大模型:cocodot 的 OpenAI 兼容 API,改 base_url 就能调在售型号。
支付宝 / 微信支付(人民币)、USDT / USDC 充值 · 按 token 计费 · 改 base_url 即可接入
4. 泄露之后的止损顺序(不要颠倒)
① 吊销:在后台把这把 key 作废,越快越好,哪怕你还不确定是否真的泄露。以 Anthropic 的控制台为例,它把「禁用」和「删除」分成两个动作:禁用可以恢复,删除是永久的;怀疑泄露时先禁用就能立刻止血,确认无用再删除。② 换新 key:新建一把,替换所有读它的地方 —— 环境变量、部署平台的密钥设置、CI 配置、同事本地的 .env。③ 划损失范围:按时间段看用量和账单,找出第一笔你不认识的调用,记下时间、金额和涉及的模型。④ 清理源头:重写 Git 历史、删帖、撤截图、下架带 key 的安装包。⑤ 复盘补防护:搞清楚是第 2 节的哪条路漏的,在那条路上加一道拦截。很多人先花一小时清理 Git 历史,那一小时里 key 还在被用,这就是顺序颠倒的代价。如果出现了你不认识的扣费,通过服务商的支持渠道提交异常时间段和 key 名称;能不能退、退多少以服务商的处理为准,别把它当成兜底。
5. 自查:三条标准判断 key 有没有泄露
不需要等到出事才查。三条你自己就能核对的判断标准:① 用量和你的作息对不上 —— 深夜、周末、你明明没跑任务的时段出现调用,或某一天的用量突然翻了几倍,或出现了你从没用过的模型;② 「最近使用时间」不对 —— 一把你以为已经闲置的 key,最近被用过;③ 本地扫描有命中 —— 用 gitleaks、trufflehog 这类开源工具扫一遍仓库的完整历史,而不是只看当前文件,CI 的日志和打包产物也一起扫。有一件事千万别做:把 key 或它的一段粘贴到搜索引擎、在线检测网站里「查查有没有泄露」—— 这一步本身就是一次泄露。任何一条命中,都先吊销,再慢慢查原因。
6. 分 key:让一次泄露只断一条线
只有一把 key 的时候,吊销的代价是所有服务一起断,于是人会犹豫要不要立刻吊销 —— 损失往往就是在这段犹豫里扩大的。按「泄露半径」来分:生产服务一把、CI 和测试一把、每个项目或每个成员各一把,名字写清楚用途。可以参考 Anthropic 官方文档的做法:它把 key 分成个人 key 和服务账号 key,个人 key 跟着人走,人离开组织 key 就失效;共享或自动化的工作负载(CI、生产服务)建议用服务账号的 key。建 key 时还可以选过期时间,预设有 3 小时、1 天、7 天、30 天,也能自定义或选永不过期;过期之后的请求返回 401 authentication_error,而且过期的 key 不能重新启用。这套思路在任何平台都能借用:谁在用、用多久,建 key 的时候就定下来,临时给外包或演示用的 key 用短期限,项目结束就作废。
7. 让 key 不进代码、不进日志:几条能直接抄的做法
key 放在环境变量或部署平台的密钥设置里,代码只读变量名;.env 写进 .gitignore,仓库里只放不含真值的 .env.example;装一个提交前扫描,把带 key 的提交挡在本地。前端永远不放 key:改成前端调你自己的后端,由后端带着 key 去请求模型,后端还能顺便做限流和鉴权。排错时最容易顺手泄露:判断程序有没有读到 key,看它是否为空、长度对不对就够了,不要 echo 或 print 出来,也不要把带 key 的完整命令贴给别人;需要别人帮忙时,把 key 换成 YOUR_KEY 这样的占位符。日志框架如果会记录请求头,记得把 Authorization 和 x-api-key 这两个字段过滤掉。
# .gitignore:真值文件全部忽略,只放行不含真值的示例
.env
.env.*
!.env.example
# 只判断变量是否为空、长度多少,不输出 key 本身
if [ -n "$OPENAI_API_KEY" ]; then
printf '已读到,长度 %s\n' "$(printf '%s' "$OPENAI_API_KEY" | wc -c)"
else
echo '没读到 OPENAI_API_KEY'
fi
# 提交前 / 定期:用 gitleaks、trufflehog 这类工具扫描完整 Git 历史
# 具体命令以各工具官方文档为准8. 在 cocodot 上怎么管 key
cocodot 的 key 在生成时只显示一次,平台只存哈希、无法找回 —— 所以丢了就吊销旧的、重新生成一把,不存在「找回」这回事;生成后请直接存进你的环境变量或密钥管理工具。生成时可以填一个备注名区分用途(比如 proj-a、ci、staging),key 列表里能看到每把 key 的前缀、创建日期和最近使用时间,正好用来做第 5 节的自查:一把闲置的 key 出现了最近使用时间,就该吊销。吊销后这把 key 立即失效,正在用它的程序会断,所以先按第 6 节分好 key,吊销时就不会误伤别的服务。余额是预付的,按 token 计费,账户没有可用额度时新请求会被拒绝,但进行中的请求仍可能计费;小额充值能降低资金暴露,不能代替应用侧的步数、并发与预算限制。换了新 key 还报 401 的排查见 /hub/api-401-invalid-api-key-fix,agent 循环的预算护栏见 /hub/agent-api-cost-runaway。
症状 → 多半的原因 → 先做什么
| 症状 | 多半的原因 | 先做什么 |
|---|---|---|
| 你没跑任务的时段出现调用,或某天用量突然翻几倍 | key 已经在别人手里 | 立刻吊销,再按时间段核对用量 |
| 公开仓库里提交过 .env 或带 key 的配置 | Git 历史里仍有这把 key | 先吊销,再重写历史;只删文件不算处理 |
| 前端代码或客户端安装包里写了 key | 打开开发者工具或解包就能拿到 | 吊销后改成前端调你自己的后端 |
| 截图、issue、群聊里贴过带 key 的命令 | 公开内容会被抓取和转发 | 吊销;以后排错一律用占位符 |
| 换了新 key,程序还报 401 | 某处仍在读旧 key 或旧配置 | 逐个检查环境变量、.env、部署平台和 CI 的密钥设置 |
| 只有一把 key,吊销后所有服务一起断 | 没有按用途分 key | 按用途拆开,下次只断一条线 |