
強力な検索、フィルタリング、分析機能を備えた、脆弱性データを探索するためのモダンなCLI。

# 1. Get vulnx
go install github.com/projectdiscovery/vulnx/v2/cmd/vulnx@latest
# 2. Explore commands
vulnx --help
vulnx search --help
# 3. Start exploring vulnerabilities (no API key required)
vulnx filters # See all available search fields
vulnx search apache # Basic search (subject to rate limits)
# 4. Set up your API key (recommended to avoid rate limits)
vulnx auth # Get free API key at https://cloud.projectdiscovery.io
# 5. Enhanced exploration with higher limits
vulnx search apache # No rate limits
vulnx id CVE-2021-44228 # Faster responses
脆弱性を精密に検索:
vulnx search "severity:critical && is_remote:true"
vulnx search "apache || nginx" --limit 20
vulnx search "cvss_score:>8.0 && cve_created_at:2024"
脆弱性の詳細情報を取得:
vulnx id CVE-2021-44228
vulnx id CVE-2024-1234 --json
脆弱性のパターンを分析:
vulnx analyze --fields severity
vulnx analyze --fields affected_products.vendor
出力形式:
vulnx search "apache" --json # Machine-readable JSON
vulnx search "apache" --output results.json # Save to file
vulnx search "apache" --silent # Quiet output
検索の制御:
vulnx search "apache" --limit 50 # Get 50 results
vulnx search "apache" --sort-desc cvss_score # Sort by CVSS score
vulnx search "apache" --fields cve_id,severity # Specific fields only
高度な検索:
vulnx search --term-facets severity=5,tags=10 "apache"
vulnx search --range-facets numeric:cvss_score:high:8:10 "remote"
vulnx search --highlight "apache" # Enable search highlighting
vulnx search --facet-size 20 "nginx" # More facet buckets
vulnx search --detailed "xss" # Detailed output like 'id' command
検索可能な項目を探索:
vulnx filters # Show all available search fields
vulnx filters --json # Machine-readable field list
vulnx filters --output fields.json # Save field info to file
filters コマンドは、検索可能なすべてのフィールドの詳細情報を表示します。具体的には次のとおりです:
出力例:
Field: severity
Data Type: string
Description: Vulnerability severity level (e.g., critical, high, medium, low, info)
Can Sort: Yes
Facet Possible: Yes
Search Analyzer: keyword-lower
Examples: severity:critical, severity:high
Enum Values: critical, high, medium, low, info, unknown
Total: 69 filters available
このコマンドを使用して、新しい検索の可能性を見つけ、複雑なクエリを構築する前にフィールド構文を理解してください。
高リスクな脆弱性を検索:
vulnx search "severity:critical && is_remote:true && is_kev:true"
vulnx search "cvss_score:>8.0 && cve_created_at:>=2024" # High CVSS from 2024
vulnx search "is_kev:true && age_in_days:<90" # Recent KEV exploits
テクノロジーで検索:
vulnx search "apache" # Apache vulnerabilities
vulnx search "apache || nginx" # Multiple technologies
vulnx search "affected_products.vendor:microsoft" # By vendor
深刻度とスコアでフィルタリング:
vulnx search "severity:high" # High severity
vulnx search "cvss_score:>7.0" # CVSS score above 7
vulnx search "epss_score:>0.8" # High EPSS score
時間ベースの検索:
vulnx search "cve_created_at:>=2024" # Published in 2024 or later
vulnx search "cve_created_at:>=2024-01-01 && cve_created_at:<2024-07-01" # First half of 2024
vulnx search "age_in_days:<30" # Recent vulnerabilities (last 30 days)
悪用可能な脆弱性を検索:
vulnx search "is_poc:true" # Has proof of concept
vulnx search "is_kev:true" # Known exploited vulns
vulnx search "is_template:true" # Has Nuclei templates
vulnx search --detailed "log4j" # Detailed analysis of specific vuln
製品とベンダーのフィルタリング:
vulnx search --product apache,nginx # Filter by products (searches both vendor and product fields)
vulnx search --vendor microsoft,oracle # Filter by vendors only
vulnx search "NOT apache" # Exclude products using query syntax
vulnx search "NOT affected_products.vendor:microsoft" # Exclude vendors using query syntax
深刻度とスコアリング:
vulnx search --severity critical,high # Filter by severity
vulnx search "NOT severity:low" # Exclude severities using query syntax
vulnx search --cvss-score ">8.0" # Filter by CVSS score
vulnx search --epss-score ">0.8" # Filter by EPSS score
vulnx search --vuln-status confirmed # Filter by status
vulnx search --vuln-age "<30" # Recent vulnerabilities
悪用の特性:
vulnx search --kev # KEV vulnerabilities only
vulnx search --template # Has Nuclei templates
vulnx search --poc # Has proof of concept
vulnx search --hackerone # HackerOne reported
vulnx search --remote-exploit # Remotely exploitable
複数の入力方法:
# Single ID lookup
vulnx id CVE-2024-1234
# Multiple IDs (comma-separated)
vulnx id CVE-2024-1234,CVE-2024-5678,CVE-2023-9999
# Auto-detection from stdin (no 'id' command needed!)
echo "CVE-2024-1234" | vulnx
echo -e "CVE-2024-1234\nCVE-2024-5678" | vulnx
# File input
vulnx id --file ids.txt
バッチ処理:
# JSON output for automation
vulnx id --json CVE-2024-1234 CVE-2024-5678
# Save to file
vulnx id --output vulns.json --file ids.txt
# Pipeline integration
cat report.txt | grep -o 'CVE-[0-9]\{4\}-[0-9]\+' | vulnx id --json
基本的な検索:
vulnx search "apache" # Simple term
vulnx search "remote code execution" # Phrase search
vulnx search "severity:critical" # Field search
ブール論理:
vulnx search "apache && nginx" # Both terms
vulnx search "apache || nginx" # Either term
vulnx search "apache NOT tomcat" # Exclude term
vulnx search "(apache || nginx) && severity:high" # Grouped
範囲とワイルドカード:
vulnx search "cvss_score:>8.0" # Greater than
vulnx search "cvss_score:<9.0" # Less than
vulnx search "cve_created_at:>=2024-01-01" # Date comparison
vulnx search "age_in_days:<30" # Recent vulnerabilities
vulnx search "apache*" # Wildcard
重要: 日付フィールドには比較演算子(>=、>、<、<=)が必要です。
単一日付の比較:
vulnx search "cve_created_at:>=2024" # CVEs from 2024 onward
vulnx search "cve_created_at:<2024" # CVEs before 2024
vulnx search "cve_created_at:>2024-06-01" # CVEs after June 1, 2024
日付範囲:
# CVEs from January 2024 only
vulnx search "cve_created_at:>=2024-01-01 && cve_created_at:<2024-02-01"
# High CVSS CVEs from 2024
vulnx search "cvss_score:>8.0 && cve_created_at:>=2024"
# Recent vulnerabilities (age-based)
vulnx search "age_in_days:<30" # Last 30 days
vulnx search "age_in_days:>365" # Older than 1 year
対応形式:
2024(年)2024-01(年-月)2024-01-15(完全な日付)vulnx はAPIキーなしでも動作しますが、認証には大きな利点があります:
⚠️ APIキーなしの場合:
✅ APIキーありの場合:
認証の設定:
vulnx auth # Interactive setup
vulnx auth --api-key YOUR_API_KEY # Non-interactive (automation)
vulnx auth --test # Test current API key
export PDCP_API_KEY="your-key-here" # Environment variable
認証モード:
vulnx auth - プロンプトによるガイド付きセットアップvulnx auth --api-key KEY - 自動化/CI/CDに最適vulnx auth --test - 現在の設定を検証バージョン管理:
vulnx version # Show version and check for updates
vulnx version --disable-update-check # Show version without update check
vulnx update # Update to latest version
vulnx --update # Alternative update command
グローバルオプション:
vulnx --json search "apache" # JSON output
vulnx --silent search "apache" # No banner
vulnx --timeout 60s search "apache" # Custom timeout
vulnx --disable-update-check search "apache" # Disable automatic update checks
レート制限の問題:
Rate limit exceeded! API key required for higher limits.
→ Run: vulnx auth to configure API key and get higher limits
自動化/CI/CDのセットアップ:
# Docker containers
vulnx auth --api-key "$SECRET_API_KEY"
# CI/CD pipelines
vulnx auth --api-key "${PDCP_API_KEY}"
# Kubernetes init containers
vulnx auth --api-key "$(cat /secrets/api-key)"
# Test authentication in scripts
vulnx auth --test && echo "Auth OK" || echo "Auth failed"
レート制限に関する提案:
Configure API key with 'vulnx auth' to avoid rate limits
→ This appears when no API key is configured. To remove:
1. Set up API key: vulnx auth
2. Or use --silent flag to suppress informational messages
結果がない場合:
vulnx search "is_kev:true" --limit 1 # Test with known results
vulnx healthcheck # Check connectivity
大量の結果セット:
vulnx search "apache" --limit 100 # Increase limit
vulnx search "apache" --offset 100 # Pagination
vulnx search --fields cve_id,severity "apache" # Fewer fields
接続の問題:
vulnx --timeout 60s search "apache" # Increase timeout
vulnx --proxy http://localhost:8080 search "apache" # Use proxy
vulnx --debug search "apache" # Debug mode
ヘルプコマンド(APIキー不要):
vulnx --help # All commands overview
vulnx search --help # Search command help
vulnx id --help # ID command help
vulnx filters --help # Filters command help
vulnx analyze --help # Analyze command help
vulnx version # Version info with update check
vulnx version --disable-update-check # Version info without update check
データ探索(APIキーなしではレート制限の対象):
vulnx filters # Show all searchable fields
vulnx search help # Detailed search fields
vulnx analyze help # Available analyze fields
⚠️ 注記 すべてのコマンドはAPIキーなしで動作しますが、レート制限の対象となります。より高い制限とパフォーマンスを得るには、
vulnx authでAPIキーを設定してください。
vulnx search apache を実行するだけvulnx auth でAPIキーを設定--disable-update-check を使用vulnx filters を使用して、利用可能なすべての検索フィールドとその構文を確認する--json を使用するanalyze を使用する高度な使用方法と例については、USAGE.md を参照してください。
開発環境のセットアップ、コード品質チェック、コントリビューションガイドラインについては、DEVELOPMENT.md を参照してください。
vulnx は MIT License の下で配布されています。
| コマンド | 目的 | 例 |
|---|
search | 高度なフィルターで脆弱性を検索 | vulnx search "apache && severity:high" |
id | 特定のCVEの詳細を取得 | vulnx id CVE-2021-44228 |
filters | 利用可能なすべての検索フィールドとフィルターを一覧表示 | vulnx filters |
analyze | フィールドごとにデータを集計 | vulnx analyze -f severity |
auth | APIアクセスを設定 | vulnx auth |
version | バージョン情報を表示し、更新を確認 | vulnx version |
update | vulnx を最新版に更新 | vulnx update |
healthcheck | 接続をテスト | vulnx healthcheck |
| フラグ | 省略形 | 説明 | 例 |
|---|
--product | -p | 製品でフィルタリング | --product apache,nginx |
--vendor | ベンダーでフィルタリング | --vendor microsoft,oracle | |
--severity | -s | 深刻度でフィルタリング | --severity critical,high |
--tags | タグでフィルタリング | --tags rce,injection | |
--cvss-score | CVSSスコアでフィルタリング | --cvss-score ">8.0" | |
--epss-score | EPSSスコアでフィルタリング | --epss-score ">0.8" | |
--vuln-age | -a | 公開からの経過日数でフィルタリング | --vuln-age "<30" |
--vuln-type | 脆弱性の種類でフィルタリング | --vuln-type sql_injection | |
--kev | KEV脆弱性のみ | --kev | |
--template | -t | Nucleiテンプレートあり | --template |
--poc | 概念実証(PoC)あり | --poc | |
--hackerone | HackerOneで報告済み | --hackerone | |
--remote-exploit | リモートから悪用可能 | --remote-exploit | |
--vuln-status | 脆弱性ステータスでフィルタリング | --vuln-status confirmed |
| フラグ | 省略形 | 説明 | 例 |
|---|
--detailed | 'id' のような詳細出力 | --detailed | |
--highlight | 検索ハイライトを有効化 | --highlight | |
--limit | -n | 結果の件数 | --limit 50 |
--offset | ページネーションのオフセット | --offset 100 | |
--sort-asc | 昇順でソート | --sort-asc cvss_score | |
--sort-desc | 降順でソート | --sort-desc cve_created_at | |
--fields | 特定のフィールドを選択 | --fields cve_id,severity | |
--term-facets | タームファセットを計算 | --term-facets severity=5 | |
--range-facets | レンジファセットを計算 | --range-facets numeric:cvss_score:high:8:10 | |
--facet-size | ファセットのバケット数 | --facet-size 20 |
| フィールド | 説明 | 値の例 |
|---|
severity | 脆弱性の深刻度 | low, medium, high, critical |
cvss_score | CVSSスコア(0-10) | 7.5, >8.0, <9.0 |
cve_id | CVE識別子 | CVE-2021-44228 |
is_remote | リモートから悪用可能か | true, false |
is_kev | 既知の悪用済み脆弱性か | true, false |
is_poc | 概念実証(PoC)があるか | true, false |
affected_products.vendor | ベンダー名 | apache, microsoft |
affected_products.product | 製品名 | tomcat, windows |
cve_created_at | 公開日 | >=2024, >2024-01-01, <2023 |
age_in_days | 公開からの経過日数 | <30, >365, <=90 |