
vulnhuntr
让LLM自动帮你扫代码找漏洞,零样本开箱即用
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2820
技术标签
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Python 3.10(严格必须,其他版本会因 Jedi 的 bug 而不可靠)
- pipx、Docker 或 poetry 三者之一用于安装
- LLM 服务的 API Key(用于调用大模型分析代码)
- 待扫描 GitHub 仓库的本地路径
安装与启动步骤
-
1确认 Python 版本
安装前先确认本机有 Python 3.10,README 明确要求只用 3.10,其他版本会因 Jedi 解析问题不稳定。
python3.10 --version -
2Docker 方式构建
直接从 GitHub 仓库构建镜像,适合不想改本地 Python 环境的用户。
docker build -t vulnhuntr https://github.com/protectai/vulnhuntr.git#main -
3pipx 方式安装
README 推荐的轻量安装方式,通过 --python 参数强制绑定 Python 3.10。
pipx install git+https://github.com/protectai/vulnhuntr.git --python python3.10 -
4源码 poetry 安装
先克隆仓库,再在仓库目录内用 poetry 安装依赖,适合需要改代码调试的用户。
git clone https://github.com/protectai/vulnhuntr cd vulnhuntr && poetry install -
5准备 API Key
运行前必须提供 LLM 服务商的 API Key,README 未给出具体变量名,请按官方最新说明设置。
-
6准备目标仓库路径
把要检测的 GitHub 仓库克隆到本地,运行时需要传入该仓库的本地路径。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
LLM API Key | 是 | 调用大模型服务所需的密钥,README 要求运行时必须提供 | sk-xxxxxxxx |
自定义 LLM endpoint | 否 | 可选,用于指定自定义的 LLM 服务地址 | https://api.anthropic.com |
如何确认成功
README 未给出运行命令与成功提示;安装过程无报错即表示环境就绪,Docker 方式可用 docker images 看到 vulnhuntr 镜像。
常见问题
Q:为什么必须锁定 Python 3.10?
A:README 明确说明工具依赖 Jedi 解析 Python 代码,而 Jedi 存在多个 bug,用其他 Python 版本会导致运行不可靠。
Q:推荐用哪个大模型?
A:README 建议使用 Claude,官方测试中其效果优于 GPT。
Q:扫描成本会很高吗?
A:会。工具会尽可能把代码塞进上下文窗口,可能产生高额账单,务必设置支出上限并密切关注费用。
Q:三种安装方式怎么选?
A:README 推荐 pipx 或 Docker;需要修改源码时可选 git clone 后 poetry install。
注意事项
- 必须使用 Python 3.10,其他版本无法可靠运行
- 务必为 LLM 服务商设置消费上限,避免扫描产生高额费用
- README 未给出具体运行命令与参数,实际执行请以官方仓库最新文档为准
- 建议优先使用 Claude 模型以获得更好的检测效果
核心亮点
- 利用LLM语义理解,能发现传统规则引擎漏掉的复杂逻辑漏洞
- 零样本设计,无需预定义漏洞规则库,适应新代码库能力强
- 支持多种编程语言,易于集成到现有开发流程
不足之处
- 依赖LLM推理,可能产生误报或漏报,需人工复核
- 文档/社区待观察
适用场景
- 安全团队快速审计第三方开源代码库
- 开发者在CI/CD中自动扫描新提交代码
- 安全研究人员批量分析多个项目寻找潜在漏洞
替代项目
Semgrep、CodeQL、gosec
上一篇:OSWorld
同类项目推荐
Anti-Autoresearch
开源
一键给自动科研论文做取证,揪出编造与不自洽
Don't trust an autoresearch paper at face value. Reviewer-side integrity forensics (···
tensor-trust
开源
玩游戏,收集提示注入数据,助力AI安全研究
A prompt injection game to collect data for robust ML research
power-pwn
开源
给 AI 助手做安全体检,防黑客钻空子
An offensive/defense security toolset for discovery, recon and ethical assessment of···
PyRIT
开源
像红队一样自动攻击自家大模型,提前挖出安全漏洞
Open-source AI red teaming toolkit from Microsoft. Test generative AI systems with a···
AwesomeLLM4APR
开源
一页看尽大模型修Bug研究全景,快速入门与选题
[TOSEM 2026]A Systematic Literature Review on Large Language Models for Automated Pr···
langtest
开源
给大模型做全面体检,上线前揪出安全漏洞
Deliver safe & effective language models
Stable-Diffusion-Pickle-Scanner-···
开源
扫描模型文件,防止恶意代码入侵你的电脑
Pickle Scanner GUI
llm-eval
开源
一站式跑分,快速对比大模型与 RAG 效果
大语言模型评估平台,支持多种评估基准、自定义数据集和性能测试。支持基于自定义数据集的···
primitive-bench
开源
声明任务先定价,AI 干完验证,不成退款
The marketplace for verifiable AI outcomes: state a task, get a fixed price upfront,···