
jshunter 是一款命令行工具,专为分析 JavaScript 文件并提取端点而设计。该工具专注于识别敏感数据,例如 API 端点和潜在的安全漏洞,使其成为渗透测试人员和漏洞赏金猎人的必备资源。
# JSHunter
<div align="center">
[](LICENSE)
[](https://golang.org)
[](https://github.com/cc1a2b/jshunter/releases)
[](https://github.com/cc1a2b/jshunter/stargazers)
[](https://github.com/cc1a2b/jshunter/releases)
**专业 JavaScript 安全分析工具**
*面向安全专业人员的完整端点发现、敏感数据检测与高级代码分析*
</div>
## 关于
**JSHunter** 是一款用于 JavaScript 安全分析和端点发现的综合命令行工具。它专为安全专业人员、渗透测试人员和开发人员打造,提供企业级分析能力,具备高精度检测算法和专业报告功能。
https://github.com/user-attachments/assets/5a5f60fa-f8dc-4aac-bd06-2e93779f9af4
*JSHunter 实际运行 — CLI 的真实终端截图(所示所有密钥均为虚假测试数据)*
---
## 目录
- [关于](#about)
- [功能特性](#features)
- [安装](#installation)
- [快速开始](#quick-start)
- [使用示例](#usage-examples)
- [命令参考](#command-reference)
- [高级用法](#advanced-usage)
- [贡献](#contributing)
- [许可证](#license)
- [支持](#support)
---
## 功能特性
### 核心能力
- **全面的端点发现**:自动从 JavaScript 文件中提取 URL、API 端点和隐藏参数
- **高级安全分析**:以高精度识别 API 密钥、JWT 令牌、凭据和潜在漏洞
- **灵活的输入方式**:支持 URL、文件列表、本地文件、stdin 管道和递归发现
- **高性能架构**:多线程并发处理,具备智能速率限制
- **专业隐蔽特性**:代理支持、自定义请求头、User-Agent 轮换和绕过检测
### 智能检测引擎
> **企业级精度,配备高级分析算法**
- **智能 Base64 检测**:高精度过滤,消除来自媒体内容和编码数据的误报
- **专业界面**:企业级术语、文档和全面的报告格式
- **上下文感知分析**:高级算法可区分真实安全令牌与编码媒体数据
- **熵分析**:数学算法可精确识别真实的安全令牌和凭据
### 结构化检测引擎
JSHunter 会解析其扫描的 JavaScript,而不仅仅是进行模式匹配。一个
单遍 ECMAScript 扫描器会将响应的每个字节分类为字符串
字面量、模板字面量、注释、正则表达式字面量或代码,检测规则
会基于该分类进行评估。
这一点很重要,因为正则表达式并不知道它匹配到了什么。同样的四十个 base64
字符,在字符串字面量中意味着“凭据”,在压缩标识符中意味着“分块哈希”,
而当它们横跨两个相邻令牌之间的接缝时则毫无意义。知道它究竟是哪一种,
就能用结构化的答案取代一堆邻近性启发式规则:
- **区域门控**:正则表达式字面量内部的匹配是模式,而不是值。
跨越令牌边界的匹配不是单个字面量。代码中的匹配
是标识符片段。这三种情况都会被直接拒绝。
- **绑定上下文**:引擎不再扫描固定字符窗口来查找
单词 `key`,而是恢复该值实际绑定到的标识符或属性键 —
`const stripeSecret = "..."` 与 `{contentHash: "..."}` 的解读截然不同,
而仅基于形状的规则现在要求这种绑定。
- **同级键集**:Firebase Web 配置、Algolia 搜索
配置、Segment 分析配置和 Supabase 浏览器客户端的成员,
通过它们所在对象的形状来识别。
- **值形状**:摘要、UUID、散文、路径、占位符,以及解码后
为 PNG、字体、JSON 文档或英文句子的 base64,都会
按其本来面目被识别。
- **暴露分类**:签发方有意公开的值 — Stripe 可发布密钥、
Mapbox 公共令牌、从其自身 `role` 声明读取的 Supabase anon JWT、
Twilio SID — 会被分类,而不是作为泄露上报。
`--include-public` 仍会报告它们。
- **文件相对意外度**:基于正在扫描的文件构建的字符转移模型,
会为候选值打分,衡量它与该文件其余部分有多么不同。
每一次拒绝都以正文被确信为 JavaScript 或 JSON 为前提。
对于其他任何内容 — `.env` 文件、散文、原始 HTML — 引擎会提供
证据,但绝不抑制,因此被错误分类的输入永远不会隐藏密钥。
`--no-structural` 会关闭整个层并恢复 v0.7 的行为。
发现结果会在 `--json`、`--ndjson` 和
SARIF 属性包中以 `evidence` 对象的形式携带推理依据:```json
"exposure": "secret",
"evidence": {
"region": "string-literal",
"role": "assignment",
"bound_to": "awsAccessKeyId",
"shape": "opaque-token",
"charset": "alphanumeric",
"signals": [
{"name": "in-literal", "delta": 0.04, "detail": "value is a complete string-literal"},
{"name": "credential-binding", "delta": 0.12, "detail": "bound to 'awsAccessKeyId'"}
]
}
```
`--stats` 报告每个阶段丢弃了什么,因此流水线保持可审计。
### Chunk 图与路由发现
现代应用会发布一个入口 bundle 以及数百个懒加载 chunk,这些 chunk 的 URL 是在运行时根据打包器内联的 manifest 组装出来的。没有任何东西链接到它们,因此爬虫永远看不到它们。`-G` 会恢复该 manifest,并打印完整的资源列表和客户端路由表:```console
$ jshunter -u https://target.example/_next/static/chunks/main-a1b2c3.js -G
[CHUNKS] https://target.example/...: next runtime, 214 chunks, 37 routes
[CHUNK] https://target.example/... https://target.example/_next/static/chunks/settings.11aa22bb33cc.js
[ROUTE] https://target.example/... /admin/users/:id
```
支持的运行时:webpack 4 和 5(`__webpack_require__.u`、`miniCssF`、
`jsonpScriptSrc`)、Next.js 构建清单、Vite 和 Rollup(`__vite__mapDeps`、
`__vitePreload`)、普通动态 `import()`,以及来自 React Router、
Vue Router 和 Angular 的路由表。输出以制表符分隔并去重,因此可以直接
作为后续扫描的输入列表传回:```bash
jshunter -u https://target.example/main.js -G -q | awk -F'\t' '/^\[CHUNK\]/{print $3}' > chunks.txt
jshunter -l chunks.txt -s -j > findings.json
```
### 专业 HTTP 与网络套件
<details>
<summary><strong>企业级网络配置</strong></summary>
**认证与请求头:**
- **自定义请求头** (`-H`):可重复的认证请求头和自定义请求头
- **Cookie 管理** (`-c`):用于访问受保护资源的会话 Cookie
- **User-Agent 控制** (`-U`):自定义 UA 字符串或基于文件的轮换以实现隐蔽
**性能与可靠性:**
- **速率限制** (`-R`):可配置的请求延迟(毫秒)以规避检测
- **智能超时** (`-T`):针对不同网络条件的自定义超时设置
- **智能重试** (`-y`):针对失败请求的自动重试机制,采用指数退避策略
**专业集成:**
- **代理支持** (`-p`):完整的 Burp Suite 和自定义代理集成(HTTP/HTTPS/SOCKS5)
- **TLS 灵活性** (`-k`):可选的证书验证绕过,适用于测试环境
- **线程控制** (`-t`):可配置的并发请求处理以实现最佳性能
> **安全专业人员功能**:专为渗透测试和安全评估而设计
> **示例**:`jshunter -l targets.txt -p 127.0.0.1:8080 -H "Authorization: Bearer token" -R 1000`
</details>
### 高级 JavaScript 分析
<details>
<summary><strong>完整的代码分析与反混淆套件</strong></summary>
**核心分析工具:**
- **反混淆引擎** (`-d`):解包压缩和混淆的 JavaScript 以进行深度分析
- **Source Map 解析器** (`-m`):从 source map 中提取并分析原始源代码
- **混淆检测** (`-z`):识别并分类混淆技术和模式
**动态分析:**
- **Eval 分析** (`-e`):分析动态代码执行(`eval()`、`Function()`、运行时生成)
**代码智能:**
- **模式识别**:识别常见的 JavaScript 框架和库
- **代码结构分析**:映射应用程序架构和数据流
- **上下文感知检测**:理解代码上下文以减少误报
> **专业用法**:将分析工具与安全检测相结合以实现最大覆盖范围
> **示例**:`jshunter -u target.js -d -m -e -s -g`(完整反混淆 + 安全分析)
</details>
### 安全分析套件
<details>
<summary><strong>完整的安全评估工具包</strong></summary>
**核心安全检测:**
- **密钥检测** (`-s`):API 密钥、访问令牌、密码和硬编码凭据
- **JWT 令牌分析** (`-x`):认证令牌提取、验证和载荷检查
- **Firebase 安全** (`-F`):配置分析、API 密钥和数据库 URL 检测
**高级分析:**
- **参数发现** (`-P`):隐藏的表单参数、变量和配置键
- **URL 参数提取** (`-PU`):带完整 URL 上下文的高级参数分析
- **GraphQL 分析** (`-g`):Schema 检测、查询提取和端点发现
- **WAF 绕过检测** (`-B`):安全绕过模式和规避技术
**范围与上下文:**
- **内部端点过滤** (`-i`):私有/内部资源识别与分类
- **链接分析** (`-L`):全面的 URL 提取和关系映射
> **专业提示**:组合使用标志进行全面分析(例如 `jshunter -u target.js -s -x -F -g`)
</details>
### 范围与发现
<details>
<summary><strong>智能爬取与目标定位</strong></summary>
- **递归发现**:多深度 JavaScript 文件爬取
- **域名范围限定**:将分析聚焦于特定域名
- **扩展名过滤**:针对特定的 JavaScript 文件类型
</details>
### 专业报告与导出套件
<details>
<summary><strong>企业级输出与集成</strong></summary>
**核心输出格式:**
- **控制台显示**:彩色编码的终端输出,具有专业格式和清晰分类
- **文件导出** (`-o`):将综合结果保存到自定义文件位置
- **JSON 导出** (`-j`):用于自动化和程序化处理的结构化数据格式
- **CSV 导出** (`-C`):用于管理层报告和分析的电子表格兼容格式
**专业集成:**
- **Burp Suite 导出** (`-n`):与 Burp Suite Professional 直接集成以进行即时测试
- **正则过滤** (`-r`):用于定向结果过滤的自定义模式匹配
- **详细分析** (`-v`):带有调试信息和上下文的详细分析输出
**结果管理:**
- **简洁模式** (`--found-only`):隐藏空结果以生成聚焦的安全报告
- **静默模式** (`-q`):抑制横幅以用于自动化脚本和 CI/CD 集成
> **报告工作流**:使用 JSON 进行自动化,使用 CSV 生成管理报告,使用 Burp 导出进行即时测试
> **示例**:`jshunter -l targets.txt -s -j -o security-findings.json`(结构化安全报告)
</details>
---
## 安装
### Go 安装(推荐)```bash
# Install JSHunter
go install -v github.com/cc1a2b/jshunter/cmd/jshunter@latest
# Verify installation
jshunter --help
```
### 从源码构建```bash
git clone https://github.com/cc1a2b/jshunter.git
cd jshunter
go build -o jshunter ./cmd/jshunter
```
### 系统要求
- **Go 1.22.5+**(用于从源码构建)
- **Linux、macOS 或 Windows**(64 位架构)
- **网络连接**(用于远程 JavaScript 分析)
---
## 快速开始
### 基础分析```bash
# Analyze a single JavaScript file
jshunter -u "https://example.com/app.js"
# Scan multiple URLs from file
jshunter -l urls.txt
# Analyze local JavaScript file
jshunter -f app.js
```
### 完整安全分析```bash
# Find API keys, secrets, and credentials
jshunter -u "https://target.com/app.js" -s
# Full analysis with deobfuscation, GraphQL, and Firebase detection
jshunter -u "https://target.com/app.js" -d -s -g -F -x -L
# Professional security assessment with all tools
jshunter -u "https://target.com/app.js" -d -m -e -s -x -P -g -F -B -L
# Export comprehensive results for reporting
jshunter -l targets.txt -s -g -F -j -o security_findings.json
```
---
## 使用示例```bash
# Analyze single URL
jshunter -u "https://example.com/app.js"
# Analyze multiple URLs from file
jshunter -l urls.txt
# Pipe URLs from stdin
cat urls.txt | grep "\.js" | jshunter
# Complete security analysis - find secrets, API keys, and credentials
jshunter -u "https://example.com/app.js" -s -x -F
# Full analysis suite with deobfuscation and all security tools
jshunter -u "https://target.com/app.js" -d -m -e -s -x -P -g -F -B -L
# Professional assessment with source map analysis
jshunter -u "https://target.com/bundle.js" -d -m -s -g -F
# Export comprehensive results to structured formats
jshunter -l targets.txt -s -x -F -g -j -o security_findings.json
# Stealth scanning with Burp Suite integration
jshunter -l targets.txt -p 127.0.0.1:8080 -s -g -F -n -o burp_findings.txt
# Scanning through SOCKS5 proxy (Tor, SSH tunnel, etc.)
jshunter -l targets.txt -p socks5://127.0.0.1:9050 -s -x -F
# Rate-limited professional scanning with authentication
jshunter -l urls.txt -R 2000 -H "Authorization: Bearer token" -s -x -F -g -q
# Complete endpoint and parameter discovery
jshunter -l urls.txt -ep -P -PU -L -w 2
# Advanced obfuscation analysis with context detection
jshunter -f obfuscated.js -d -z -e -s -v
```
---
## 命令参考
随时使用 `jshunter --help` 获取完整帮助```
Usage:
-u, --url URL Input a URL
-l, --list FILE.txt Input a file with URLs (.txt)
-f, --file FILE.js Path to JavaScript file
--har FILE Ingest a Chrome DevTools HAR archive
Basic Options:
-t, --threads INT Number of concurrent threads (default: 5)
-c, --cookies <cookies> Authentication cookies for protected resources
-p, --proxy host:port HTTP/SOCKS5 proxy (e.g., 127.0.0.1:8080 for Burp Suite)
-q, --quiet Suppress ASCII art output
--no-color Disable ANSI color (auto-off when not a TTY)
-o, --output FILENAME Output file path
-r, --regex <pattern> RegEx for filtering results
--update, --up Update the tool to latest version
-ep, --end-point Extract endpoints from JavaScript files
-k, --skip-tls Skip TLS certificate verification
-fo, --found-only Only show results when sensitive data is found
HTTP Configuration:
-H, --header "Key: Value" Custom HTTP headers (repeatable, including Auth)
-U, --user-agent UA Custom User-Agent string or file path
-R, --rate-limit MS Request rate limiting delay (milliseconds)
-T, --timeout SEC HTTP request timeout (seconds)
-y, --retry INT Retry attempts for failed requests (default: 2)
--per-host INT Per-host outbound concurrency cap (default: 4)
--max-bytes N Cap response body read in bytes (default: 32MiB)
--allow-internal Permit localhost / RFC1918 / link-local targets
--cache-dir DIR Persist responses on disk; revalidate via ETag
JavaScript Analysis:
-d, --deobfuscate Deobfuscate minified and obfuscated JavaScript
-m, --sourcemap Fetch and parse source maps + sourcesContent[]
-e, --eval Analyze dynamic code execution (eval, Function)
-z, --obfs-detect Detect code obfuscation patterns and techniques
--inline-html Scan inline <script> tags + SRI/CSP in HTML responses
--csp-origins Emit CSP-allowed origins as candidate endpoints
Security Analysis:
-s, --secrets Detect API keys, tokens, and credentials
-x, --tokens Extract JWT and authentication tokens
-P, --params Discover hidden parameters and variables
-PU, --param-urls Advanced parameter extraction with URL context
-i, --internal Filter for internal/private endpoints
-g, --graphql Analyze GraphQL endpoints and queries
-B, --bypass Detect WAF bypass patterns and techniques
-F, --firebase Analyze Firebase configurations and keys
-L, --links Extract and analyze all embedded links
Detection Tuning:
-mc, --min-confidence FLOAT Minimum confidence (0.0-1.0) for a finding (default: 0.50)
-sc, --show-confidence Print [conf=X.XX] alongside each finding
--no-fp-filter Disable the false-positive filter (debug)
--ignore-file FILE Permanent suppressions (.jshunterignore)
--diff PREVIOUS.json Report only NEW findings vs previous JSON envelope
--rules-file FILE.json Load an external JSON rule pack
--only-rules id,glob Run only matching rules (supports * glob)
--disable-rule id,glob Disable matching rules (supports * glob)
Structural Engine:
--no-structural Disable byte-level classification (regex-only, v0.7 behaviour)
--include-public Report values published by design and non-granting identifiers
--min-severity LEVEL Report floor: info|low|medium|high|critical
-G, --chunk-graph Enumerate lazily loaded chunks and client routes
Verification:
--verify Probe findings against provider read-only endpoints
--verify-timeout SEC Timeout per verification probe (default: 10)
--verify-workers INT Concurrent verifier worker pool (default: 8)
Scope & Discovery:
-w, --crawl DEPTH Recursive JavaScript discovery depth (default: 1)
-D, --domain DOMAIN Limit analysis to specific domain
-E, --ext Filter by JavaScript file extensions
--robots Fetch /robots.txt for each input host and exit
Output Formats:
-j, --json Structured JSON output (schema_version 2)
--ndjson Newline-delimited JSON (jq / SIEM streaming)
--sarif SARIF 2.1.0 (GitHub code-scanning compatible)
-C, --csv CSV format for spreadsheet analysis
-v, --verbose Detailed analysis and debug output
-n, --burp Burp Suite compatible export format
--stats Per-stage counters on stderr at end of run
Registry:
--list-rules Print the rule registry as a table and exit
--explain RULE_ID Print full rule details and exit
--self-test Run rule registry against built-in TP/FP fixtures
-h, --help Display this help message
```
### 置信度模型
每个 secret 类匹配都会在 `[0.0, 1.0]` 范围内评分。评分从每条规则的先验值开始,并根据以下因素进行调整:
| 信号 | 影响 |
|------------------------------------------------|------------------------------|
| 源路径看起来像 vendor/chunk bundle | −0.15 |
| 周围上下文包含 fixture 措辞 | −0.30 |
| 特定 provider 的 validator 通过 | +0.10 |
| 存在必需的上下文关键词(通用规则) | +0.05 |
| Shannon 熵 ≥ 4.5 | +0.05 |
| 字符类别多样性 ≥ 3 | +0.05 |
| 匹配项位于 vendor-noise denylist 中 | 在评分前丢弃 |
| 长度/熵低于规则下限 | 在评分前丢弃 |
| 该行是 `//# sourceMappingURL=` 标记 | 在评分前丢弃 |
默认的 `--min-confidence 0.50` 会过滤掉仅基于模式匹配的长尾结果。使用 `--min-confidence 0.80` 进行高精度分诊,使用 `--no-fp-filter` 获取原始、未过滤的输出。
### Provider validators
validator 是一种按规则执行的一致性检查,在正则匹配*之后*运行。
它是抵御误报的最强防线:一个恰好符合形状的随机字符串,仍然必须通过校验和、结构化解码或长度/字符集证明,才会被报告(通过其中一项会增加 `+0.10`)。
| Provider | Validator |
|----------|--------------------------------------------------------------------------|
| AWS | 前缀族(`AKIA/ASIA/A3T…`)+ 16 字符 base32 主体 |
| Stripe | 密钥族(`sk/rk/pk_live/test_`)以及 `whsec_` webhook base62 主体 |
| GitHub | 针对随机主体验证的 CRC32 base62 校验和 |
| OpenAI | 族前缀 + 长度窗口(`sk-/sk-proj-/sk-svcacct-`) |
| Slack | 连字符分段形状(内部为数字段,尾部为字母数字) |
| JWT | base64url 解码后的 JSON 头,包含 `alg` 字段 + JSON payload |
| Twilio | 32 位十六进制主体 + 熵门限 |
| Azure | `AccountKey=` base64 主体解码后恰好为 64 字节;AD `…<digit>Q~…` |
| Telegram | `<8-10 digit id>:AA…` 拆分,base64url secret + 熵门限 |
| Intercom | base64 解码为以 `tok:` 为前缀的 payload |
| Sentry | `sntrys_` 组织 token payload 经 base64 解码为携带 `url` 声明的 JSON |
| Terraform| `<14>.atlasv1.<60-70>` 三段式结构 |
| Square | `sq0atp-/sq0csp-/sq0idp-` 族 + 精确主体长度 + 熵 |
| Braintree| `access_token$<env>$<16 base36>$<32 hex>` 四段式结构 |
| Airtable | `pat<14>.<64 hex>` 两段式拆分 |
| Postman | `PMAK-<24 hex>-<34 hex>` 段长度 + 熵 |
| Database | 如果连接 URI 密码为模板化/默认/低熵,则拒绝 |
### Provider 覆盖范围
精选注册表内置 **85+ 个检测器**,覆盖云与密钥管理器
(AWS、Azure、GCP/PKCS#8、HashiCorp Vault、Terraform、Fly.io、Tailscale)、版本
控制与 CI/CD(GitHub、GitLab、Docker Hub、Atlassian、Sentry、CircleCI、
Buildkite)、支付(Stripe、Square、Braintree、Plaid)、AI/LLM provider
(OpenAI、Anthropic、Groq、Perplexity、Replicate、OpenRouter、Fireworks、
HuggingFace)、消息(Slack、Discord、Telegram、Twilio、Intercom、SendGrid、
Mailgun)、SaaS 与数据库(Notion、Airtable、Figma、Postman、Databricks、
PlanetScale、Grafana、New Relic、Dropbox、RubyGems、Supabase),以及 PKI 材料
(RSA/EC/DSA/OpenSSH/PGP/PKCS#8 私钥、PuTTY `.ppk`、数据库连接
URI)。运行 `jshunter --list-rules` 获取权威表格,运行
`jshunter --explain <rule_id>` 查看任意单条规则的 pattern、validator 和
fixtures。无前缀的 “bare hash” 形状只有在结构化
validator 或强制上下文门限能够使其保持无误报时才会提供。
---
## 高级用法
### 专业安全评估```bash
# Complete security analysis with all tools
jshunter -l targets.txt -d -m -e -z -s -x -P -PU -g -F -B -L -j -v -o complete_assessment.json
# Advanced deobfuscation and analysis pipeline
jshunter -l targets.txt -d -m -z -e -s -g -F --found-only -o deobfuscated_findings.json
# Stealth reconnaissance with rate limiting and custom headers
jshunter -l targets.txt -R 2000 -U "Mozilla/5.0..." -H "X-Forwarded-For: 1.1.1.1" -s -x -F -q
# Professional penetration testing through proxy
jshunter -l targets.txt -p 127.0.0.1:8080 -s -x -g -F -B -n -o burp_comprehensive.txt
# Deep parameter and endpoint discovery
jshunter -l targets.txt -ep -P -PU -L -w 3 -i -j -o endpoint_discovery.json
```
### 企业与自动化集成```bash
# CI/CD Security Pipeline Integration
jshunter -f dist/bundle.js -d -s -x -F -j --found-only > security-scan.json
# Comprehensive automated security reporting
jshunter -l production-js.txt -d -s -x -P -g -F -B -C -o enterprise-security-report.csv
# Source map analysis for development security
jshunter -f app.js -m -s -x -F -v -o sourcemap-analysis.json
# Firebase and GraphQL focused assessment
jshunter -l targets.txt -g -F -L -j -o api_security_findings.json
```
---
## 贡献
我们欢迎贡献!你可以通过以下方式提供帮助:
- **报告 bug**,通过 [GitHub Issues](https://github.com/cc1a2b/jshunter/issues)
- **建议功能**或改进
- **改进文档**
- **提交 pull request**,包含增强功能
### 开发环境设置```bash
git clone https://github.com/cc1a2b/jshunter.git
cd jshunter
go mod tidy
go build -o jshunter ./cmd/jshunter
```
## 许可证
JSHunter 基于 **MIT 许可证** 发布。详情请参阅 [LICENSE](https://github.com/cc1a2b/jshunter/blob/master/LICENSE)。```
Copyright (c) 2024-2026 Hussain Alsharman
Licensed under MIT License - free for commercial and personal use
```
---
## 支持
如果 JSHunter 对您的安全研究或专业工作有所帮助:
<div align="center">
**为本仓库加星** • **关注 [@cc1a2b](https://twitter.com/cc1a2b)** • **分享给他人**
</div>
---
<div align="center">
**JSHunter - 专业 JavaScript 安全分析**
*由 [cc1a2b](https://github.com/cc1a2b) 为安全社区构建*
</div>