vulnhuntr

让LLM自动帮你扫代码找漏洞,零样本开箱即用

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 331 🐛 待处理 18 👀 关注 32
GitHub ↗
GitHub 星标 ★ 2820
维护状态 低维护
是否开源 开源
定价模式 🏷️完全免费 开源项目,AGPL-3.0许可,可自行部署使用,无付费版本。

项目预览

vulnhuntr 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类开源模型
开发团队protectai
定价模式🏷️完全免费
价格说明开源项目,AGPL-3.0许可,可自行部署使用,无付费版本。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议AGPL-3.0
主要语言Python
技术栈/模型ai,llm,security,static-analysis,vulnerability-detection
GitHub 星标★ 2820
上线时间2024-10-15 00:00:00
代码更新2025-02-06
仓库体积122 KB
本站数据更新2026-11-09
维护状态低维护
收录时间2026-08-09
浏览次数3

项目介绍

vulnhuntr 是一个利用大型语言模型进行零样本漏洞发现的开源工具。它解决的是传统静态分析工具依赖规则和模式匹配、难以发现未知漏洞的问题。核心能力是直接对代码仓库进行语义理解,通过LLM的推理能力识别潜在的漏洞模式,如SQL注入、命令注入、路径遍历等。它支持多种语言(如Python、JavaScript等),并提供命令行接口,可集成到CI/CD流程中。项目处于成长阶段,星标数增长迅速,表明社区关注度高。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2820

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 10 分钟 部署方式:命令行工具 6 步

环境要求

  • Python 3.10(严格必须,其他版本会因 Jedi 的 bug 而不可靠)
  • pipx、Docker 或 poetry 三者之一用于安装
  • LLM 服务的 API Key(用于调用大模型分析代码)
  • 待扫描 GitHub 仓库的本地路径

安装与启动步骤

  1. 1确认 Python 版本

    安装前先确认本机有 Python 3.10,README 明确要求只用 3.10,其他版本会因 Jedi 解析问题不稳定。

    python3.10 --version
  2. 2Docker 方式构建

    直接从 GitHub 仓库构建镜像,适合不想改本地 Python 环境的用户。

    docker build -t vulnhuntr https://github.com/protectai/vulnhuntr.git#main
  3. 3pipx 方式安装

    README 推荐的轻量安装方式,通过 --python 参数强制绑定 Python 3.10。

    pipx install git+https://github.com/protectai/vulnhuntr.git --python python3.10
  4. 4源码 poetry 安装

    先克隆仓库,再在仓库目录内用 poetry 安装依赖,适合需要改代码调试的用户。

    git clone https://github.com/protectai/vulnhuntr
    cd vulnhuntr && poetry install
  5. 5准备 API Key

    运行前必须提供 LLM 服务商的 API Key,README 未给出具体变量名,请按官方最新说明设置。

  6. 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

下一篇:evaluation-guidebook

同类项目推荐

Anti-Autoresearch 开源

一键给自动科研论文做取证,揪出编造与不自洽

Don't trust an autoresearch paper at face value. Reviewer-side integrity forensics (···

★ 180 2026-09-29
tensor-trust 开源

玩游戏,收集提示注入数据,助力AI安全研究

A prompt injection game to collect data for robust ML research

★ 81 2026-08-09
power-pwn 开源

给 AI 助手做安全体检,防黑客钻空子

An offensive/defense security toolset for discovery, recon and ethical assessment of···

★ 1267 2026-08-09
PyRIT 开源

像红队一样自动攻击自家大模型,提前挖出安全漏洞

Open-source AI red teaming toolkit from Microsoft. Test generative AI systems with a···

★ 4777 2026-10-20
AwesomeLLM4APR 开源

一页看尽大模型修Bug研究全景,快速入门与选题

[TOSEM 2026]A Systematic Literature Review on Large Language Models for Automated Pr···

★ 250 2026-08-09
langtest 开源

给大模型做全面体检,上线前揪出安全漏洞

Deliver safe & effective language models

★ 561 2026-08-09
llm-eval 开源

一站式跑分,快速对比大模型与 RAG 效果

大语言模型评估平台,支持多种评估基准、自定义数据集和性能测试。支持基于自定义数据集的···

★ 100 2026-08-09
primitive-bench 开源

声明任务先定价,AI 干完验证,不成退款

The marketplace for verifiable AI outcomes: state a task, get a fixed price upfront,···

★ 122 2026-09-30