trufflesecurity/trufflehog
trufflesecurity
TruffleHog 是一款用于检测泄露凭证的工具，支持扫描 GitHub、GitLab、文件系统和 S3 等多种来源，通过 600 多种凭证检测器及 API 主动验证功能减少误报，帮助发现敏感信息泄露。
5 次收藏下载次数: 0状态：社区镜像维护者：trufflesecurity仓库类型：镜像最近更新：6 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
TruffleHog Docker 镜像文档
镜像概述和主要用途
TruffleHog 是一款专注于检测泄露凭证的安全工具，v3 版本采用 Go 语言完全重写，具备强大的凭证检测与验证能力。它能够扫描 GitHub、GitLab、文件系统、S3 等多种数据源，通过主动 API 验证机制确保检测结果的准确性，有效帮助用户发现并处理敏感凭证泄露问题。
核心功能和特性
v3 版本关键更新
- 增强的凭证检测：新增超过 600 种凭证检测器，支持对检测到的凭证进行主动 API 验证
- 多源扫描支持：原生集成 GitHub、GitLab、文件系统及 S3 存储的扫描能力
凭证验证机制
对于每个检测到的潜在凭证，TruffleHog 会通过编程方式向其所属的 API 发起验证请求（例如 AWS 凭证会调用 GetCallerIdentity API），确保凭证有效性，大幅降低误报率。
使用场景和适用范围
- 开发团队：扫描代码仓库（Git/GitHub/GitLab），防止提交过程中意外泄露 API 密钥、密码等敏感凭证
- 安全审计：检查文件系统或 S3 存储中的敏感文件，排查凭证泄露风险
- 合规检查：满足数据安全合规要求，定期执行凭证泄露扫描与报告
详细使用方法和配置说明
镜像拉取
bash# 从 GitHub Container Registry 拉取 docker pull ghcr.io/trufflesecurity/trufflehog:latest # 从 Docker Hub 拉取 docker pull trufflesecurity/trufflehog:latest
Docker 运行示例
普通用户
bashdocker run -it -v "$PWD:/pwd" ghcr.io/trufflesecurity/trufflehog:latest github --repo https://github.com/trufflesecurity/test_keys --debug
参数说明：
-it: 启用交互式终端-v "$PWD:/pwd": 挂载当前目录到容器内/pwd（用于文件系统扫描）github --repo: 指定扫描的 GitHub 仓库地址--debug: 启用调试模式
Apple M1 用户
建议指定 linux/arm64 平台以获得更好性能：
bashdocker run --platform linux/arm64 -it -v "$PWD:/pwd" ghcr.io/trufflesecurity/trufflehog:latest github --repo https://github.com/trufflesecurity/test_keys
子命令与参数说明
TruffleHog 通过子命令区分不同数据源，使用 -h 可查看具体子命令的帮助信息：
主要子命令
git: 扫描 Git 仓库github: 扫描 GitHub 仓库gitlab: 扫描 GitLab 仓库filesystem: 扫描文件系统s3: 扫描 S3 存储
常用参数
| 参数 | 说明 |
|---|---|
--debug | 启用调试模式 |
--json | 以 JSON 格式输出结果 |
--concurrency=N | 设置并发工作线程数（默认 8） |
--verification | 启用凭证验证（默认开启） |
-i, --include_paths=<文件> | 指定包含扫描文件的正则表达式列表文件 |
-x, --exclude_paths=<文件> | 指定排除扫描文件的正则表达式列表文件 |
--branch=<分支名> | 指定扫描的代码分支 |
使用示例
bash# 扫描 Git 仓库 docker run --rm ghcr.io/trufflesecurity/trufflehog:latest git https://github.com/trufflesecurity/trufflehog.git # 扫描本地文件系统 docker run --rm -v "$PWD:/scan" ghcr.io/trufflesecurity/trufflehog:latest filesystem /scan # 查看子命令帮助 docker run --rm ghcr.io/trufflesecurity/trufflehog:latest git --help
相关资源
- https://github.com/trufflesecurity/trufflehog
- https://hub.docker.com/r/trufflesecurity/trufflehog
- Slack 社区
许可协议
TruffleHog v3 采用 AGPL 3.0 许可协议，详情参见 https://github.com/trufflesecurity/trufflehog/blob/main/LICENSE%E3%80%82
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 trufflehog 镜像标签
docker pull docker.xuanyuan.run/trufflesecurity/trufflehog:<标签>
DockerHub 原生拉取命令
docker pull trufflesecurity/trufflehog:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"