个人学习小站 SIGNAL DESK 2026
LIVE --:--:--
资讯 人工智能 tin.computer《Fake AI Crawler Secrets Scanners》一手观测 (2026-11-18)

AI 编码工具的密钥文件都在哪:gitignore 清单与泄露自查

Claude Code、Codex、Cursor、Gemini CLI 都会把登录凭据和 MCP 密钥写在项目目录下的隐藏文件里。本文整理被扫描器盯上的文件清单,给出可直接复制的 gitignore 模板、五分钟自查命令和泄露后的处置步骤。

2026年11月19日 20 分钟前 作者 站长 约 4 分钟 4 阅读

结论先行:Claude Code、Codex、Cursor、Gemini CLI 这类 AI 编码工具,会把登录凭据和 MCP 服务密钥写成项目目录下的隐藏文件。2026 年 9 月以来,针对这些文件路径的定向扫描在持续增加——据 tin.computer 的 90 天观测记录,一个代号 Gecko 的扫描器清单里的 AI 工具路径,从 10 月中旬的 4 条涨到了 11 月 17 日的 26 条,新增的正是 /.claude/.credentials.json、/.codex/auth.json、/.gemini/settings.json 这一批。这些文件一旦被提交进仓库或随构建产物部署上线,密钥可能在数秒内被扫走。本文给一份可直接复制的 gitignore 清单和自查流程。

这些文件里存的是什么

先弄清楚风险在哪个文件。各家工具的落盘位置不同,内容敏感度也不同:

工具文件路径存的内容
Claude Code/.claude/.credentials.jsonLinux 下的登录凭据
Claude Code/.claude/settings.local.json本地个性化配置,可能含环境变量
Codex CLI/.codex/auth.json登录凭据
Cursor/.cursor/mcp.jsonMCP 服务配置,常含各服务 API 密钥
Gemini CLI/.gemini/settings.json配置,可能含鉴权信息
Hugging Face/.huggingface/token访问令牌

其中最容易被忽视的是 mcp.json:很多团队把数据库连接串、内部服务密钥直接写进 MCP 配置,然后连目录一起提交到 Git。tin.computer 观测到的另一个扫描器 Octopus,完整目标清单有 457 条路径,其中就包括这些 MCP 配置文件。

第一步:把清单写进 .gitignore

把下面这段直接追加到项目的 .gitignore(注意 .env* 会连 .env.anthropic、.env.openai 这类变体一起拦掉):

# AI 工具凭据与配置
.claude/settings.local.json
.claude/.credentials.json
.codex/
.cursor/mcp.json
.gemini/settings.json
.continue/config.json
.codeium/windsurf/mcp_config.json
.huggingface/token
.cache/huggingface/token
.config/llm/keys.json
.openai/credentials.json
.config/anthropic/config.json
.env*

# 常规密钥文件
.env
*.pem
*.key

两条原则:MCP 密钥放环境变量,而不是写死在 mcp.json 里;如果 mcp.json 必须入库,把密钥部分替换成 ${ENV_VAR} 引用。已经有仓库习惯的团队,建议再在 CI 里加一步 git ls-files | grep -E '\.(credentials|auth)' 之类的检查,防止历史目录被误提交。

第二步:五分钟自查已部署的站点

扫描器请求的就是公开 URL,自查方法一样——用 curl 逐个试。正常应该全部返回 404:

curl -s -o /dev/null -w '%{http_code}' https://你的域名/.env
curl -s -o /dev/null -w '%{http_code}' https://你的域名/.claude/settings.local.json
curl -s -o /dev/null -w '%{http_code}' https://你的域名/.cursor/mcp.json
curl -s -o /dev/null -w '%{http_code}' https://你的域名/.codex/auth.json
curl -s -o /dev/null -w '%{http_code}' https://你的域名/.aws/credentials

判断标准:返回 404/403/405 是安全的;返回 200 就要打开看内容——如果只是首页的兜底副本(SPA 路由回退),无害;如果是真实文件,立即轮换里面的所有密钥,再修部署配置。

构建产物也要查一遍。隐藏文件被 cp -r 或某些静态托管工具带进发布目录的情况不少见:

find public dist out -name '.*'

另外记得不要把本地开发服务器(Vite/Next dev)暴露到公网——观测记录里,Octopus 专为暴露的 Vite 开发服务器准备了 22 条额外路径,包括 /@fs/var/task/.env 这种读取任意文件的探针。

第三步:服务端加一道兜底

gitignore 只管「不进仓库」,管不了「已经被部署」和「别的隐藏文件」。在 Nginx 或 Cloudflare 加一条拦截所有 dotfile 的规则,一次性封掉这类扫描:

Nginx(保留 /.well-known/,证书验证要用):

location ~ /\.(?!well-known/) { return 404; }

Cloudflare WAF 自定义规则:

starts_with(http.request.uri.path, "/.") and not starts_with(http.request.uri.path, "/.well-known/")

更完整的扫描器指纹识别与封锁(包括三个扫描器各自的 UA 特征),见本站此前一篇:伪装成 AI 爬虫的密钥扫描器怎么防。

已经泄露了怎么办

  • 先轮换,再删历史。Git 历史里的密钥不会因为新提交而消失。轮换顺序:先吊销(让旧密钥立刻失效),再生成新密钥,最后清理历史(git filter-repo 或 BFG)。
  • 查用量账单。模型 API 密钥被扫走后的典型表现是异常调用量。LiteLLM、厂商控制台都有按 key 的用量页,泄露后的账单要逐日核对。
  • 检查关联服务。mcp.json 里泄露的往往不是模型密钥,而是数据库、内部服务的连接信息,影响范围按实际指向评估。

一个可以放心的数据点:tin.computer 在 2026 年 9 月 22 日至 11 月 18 日间对其 10 个站点做了全量记录,所有针对密钥路径的探测请求全部得到 404、403 或 405,没有泄露任何密钥——前提正是这些站点没有把文件暴露出来。扫描器在高速运转,防御成本却很低:一份 gitignore、五条 curl、一条 Nginx 规则。

登录后可点赞、收藏与反馈。

继续阅读 NEXT

更多 →