.env 与配置
配置项总表
1. LLM 与模型提供方
| 变量 | 作用 | 默认值 / 典型值 |
|---|---|---|
DEFAULT_LLM_PROVIDER | 指定默认 LLM 提供方，决定主流程优先使用 OpenAI 还是 Anthropic 配置。 | openai |
OPENAI_API_KEY | OpenAI 兼容接口的 API Key。 | 无默认值 |
OPENAI_MODEL | OpenAI 兼容模型名。 | gpt-4-turbo-preview |
OPENAI_BASE_URL | OpenAI 兼容接口 Base URL，适合自建网关或兼容服务。 | https://api.openai.com/v1 |
ANTHROPIC_API_KEY | Anthropic API Key。 | 无默认值 |
ANTHROPIC_MODEL | Anthropic 模型名。 | claude-3-5-sonnet-20241022 |
ANTHROPIC_BASE_URL | Anthropic 兼容接口 Base URL。 | 无默认值 |
2. 浏览器与 Puppeteer
| 变量 | 作用 | 默认值 / 典型值 |
|---|---|---|
PUPPETEER_HEADLESS | 是否以无头模式启动浏览器。 | 代码默认 false；.env.example 示例为 true |
PUPPETEER_TIMEOUT | Puppeteer 默认超时（毫秒）。 | 30000 |
PUPPETEER_EXECUTABLE_PATH | 显式指定浏览器可执行文件路径。 | 无默认值 |
CHROME_PATH | 作为浏览器路径的备用变量。 | 无默认值 |
BROWSER_EXECUTABLE_PATH | 再一个浏览器路径备用变量。 | 无默认值 |
CAPTCHA_SCREENSHOT_DIR | CAPTCHA 识别失败时的截图落盘目录。 | ./screenshots |
MCP_SCREENSHOT_DIR | 常规截图输出根目录（仍受项目根路径约束）。 | 常见示例：./screenshots/manual |
CAPTCHA_PROVIDER | 自动验证码求解的默认 provider。 | manual |
CAPTCHA_API_KEY | 自动验证码求解 provider 的 API Key。 | 无默认值 |
CAPTCHA_SOLVER_BASE_URL | 外部验证码求解服务基址。 | 无默认值 |
CAPTCHA_DEFAULT_TIMEOUT_MS | CAPTCHA 默认等待超时。 | 180000 |
3. 主程序身份与日志
| 变量 | 作用 | 默认值 / 典型值 |
|---|---|---|
MCP_SERVER_NAME | 进程对外公布的服务名。 | jshookmcp |
MCP_SERVER_VERSION | 进程对外公布的服务版本。 | 0.1.8（示例值） |
LOG_LEVEL | 日志级别。 | info |
RUNTIME_ERROR_WINDOW_MS | 运行时错误恢复窗口长度（毫秒）。 | 60000 |
RUNTIME_ERROR_THRESHOLD | 恢复窗口内允许的可恢复错误阈值。 | 5 |
4. 档位、搜索与工具选择
| 变量 | 作用 | 默认值 / 典型值 |
|---|---|---|
MCP_TOOL_PROFILE | 选择工具档位：search / workflow / full。 | 默认：search |
MCP_TOOL_DOMAINS | 手动指定启用域；设置后优先级高于 MCP_TOOL_PROFILE。 | 无默认值 |
SEARCH_WORKFLOW_BOOST_TIERS | 哪些档位启用 workflow 结果加权。 | 常见示例：workflow,full |
SEARCH_WORKFLOW_DOMAIN_BOOST_MULTIPLIER | search_tools 中 workflow 域结果的排序倍率。 | 常见示例：1.5 |
SEARCH_INTENT_TOOL_BOOST_RULES_JSON | 用 JSON 自定义”意图 -> 工具”加权规则。 | 无默认值 |
DYNAMIC_BOOST_ENABLED | 启用无感自动升级：搜索时自动 boost 到最小满足层级。 | 默认：true |
MCP_DEFAULT_PLUGIN_BOOST_TIER | plugin 在 boost 时自动注册的默认档位。 | full |
5. 传输、HTTP 与安全
| 变量 | 作用 | 默认值 / 典型值 |
|---|---|---|
MCP_TRANSPORT | 选择传输模式：stdio 或 http。 | stdio |
MCP_HOST | HTTP 模式监听地址。 | 127.0.0.1 |
MCP_PORT | HTTP 模式监听端口。 | 3000 |
MCP_AUTH_TOKEN | 开启 Bearer Token 认证。 | 无默认值 |
MCP_ALLOW_INSECURE | 当绑定非 localhost 时，是否允许无 token 的不安全模式。 | 默认关闭 |
MCP_MAX_BODY_BYTES | HTTP JSON 请求体大小上限。 | 10 * 1024 * 1024 |
MCP_RATE_LIMIT_WINDOW_MS | HTTP 限流窗口时长。 | 60000 |
MCP_RATE_LIMIT_MAX | HTTP 限流窗口内最大请求数。 | 60 |
MCP_HTTP_REQUEST_TIMEOUT_MS | HTTP 请求超时。 | 30000 |
MCP_HTTP_HEADERS_TIMEOUT_MS | HTTP headers 超时。 | 10000 |
MCP_HTTP_KEEPALIVE_TIMEOUT_MS | HTTP keep-alive 超时。 | 60000 |
MCP_HTTP_FORCE_CLOSE_TIMEOUT_MS | 连接强制关闭前的等待时间。 | 5000 |
6. 扩展目录、签名与 registry
| 变量 | 作用 | 默认值 / 典型值 |
|---|---|---|
MCP_PLUGIN_ROOTS | 逗号分隔的 plugin 根目录列表。 | 常见示例：./plugins,./dist/plugins |
MCP_WORKFLOW_ROOTS | 逗号分隔的 workflow 根目录列表。 | 常见示例：./workflows |
MCP_PLUGIN_ALLOWED_DIGESTS | plugin 预导入 SHA-256 allowlist。 | 无默认值 |
MCP_PLUGIN_SIGNATURE_REQUIRED | 是否强制要求 plugin 签名。 | 生产环境默认趋严 |
MCP_PLUGIN_SIGNATURE_SECRET | plugin 签名校验用的 HMAC 密钥。 | 无默认值 |
MCP_PLUGIN_STRICT_LOAD | 是否启用严格扩展加载策略。 | 生产环境默认趋严 |
EXTENSION_REGISTRY_BASE_URL | browse_extension_registry / install_extension 用的扩展 registry 基址。 | https://raw.githubusercontent.com/vmoranv/jshookmcpextension/master/registry |
7. 插件专用开关与 boost 档位
| 变量 | 作用 | 默认值 / 典型值 |
|---|---|---|
PLUGIN_BURP_OFFICIAL_MCP_SSE_ENABLED | 打开 / 关闭 Burp 官方 MCP SSE 插件。 | 无默认值 |
PLUGIN_ZAP_REST_BRIDGE_ENABLED | 打开 / 关闭 ZAP REST bridge 插件。 | 无默认值 |
PLUGIN_PLATFORM_BRIDGE_ENABLED | 打开 / 关闭平台 bridge 插件。 | 无默认值 |
PLUGIN_NATIVE_BRIDGE_ENABLED | 打开 / 关闭 Native bridge 插件。 | 无默认值 |
PLUGIN_BURP_OFFICIAL_MCP_SSE_BOOST_DOMAIN | 为 Burp 插件单独指定 boost 档位。 | 典型值：workflow |
PLUGIN_ZAP_REST_BRIDGE_BOOST_DOMAIN | 为 ZAP 插件单独指定 boost 档位。 | 典型值：workflow |
PLUGIN_PLATFORM_BRIDGE_BOOST_DOMAIN | 为平台 bridge 单独指定 boost 档位。 | 典型值：full |
PLUGIN_NATIVE_BRIDGE_BOOST_DOMAIN | 为 Native bridge 单独指定 boost 档位。 | 典型值：full |
8. 外部桥接与平台端点
| 变量 | 作用 | 默认值 / 典型值 |
|---|---|---|
BURP_MCP_SSE_URL | Burp 官方 MCP SSE bridge 地址。 | 典型值：http://127.0.0.1:9876/sse |
BURP_MCP_AUTH_TOKEN | Burp bridge 可选认证令牌。 | 无默认值 |
ZAP_API_URL | ZAP REST API 地址。 | 典型值：http://127.0.0.1:8080 |
ZAP_API_KEY | ZAP API Key。 | 无默认值 |
GHIDRA_BRIDGE_URL | Ghidra bridge 地址。 | http://127.0.0.1:18080 |
IDA_BRIDGE_URL | IDA bridge 地址。 | http://127.0.0.1:18081 |
DEBUG_PORT_CANDIDATES | 扫描 CDP / Node 调试端口时的候选列表。 | 9222,9229,9333,2039 |
DEFAULT_DEBUG_PORT | 默认调试端口。 | 9222 |
9. 缓存、Token 预算与性能
| 变量 | 作用 | 默认值 / 典型值 |
|---|---|---|
ENABLE_CACHE | 是否启用磁盘缓存。 | true（示例） / 代码默认 false |
CACHE_DIR | 缓存目录。 | .cache |
CACHE_TTL | 缓存 TTL（秒）。 | 3600 |
CACHE_GLOBAL_MAX_SIZE_BYTES | 全局缓存大小上限。 | 524288000 |
CACHE_LOW_HIT_RATE_THRESHOLD | 低命中率阈值。 | 0.3 |
TOKEN_BUDGET_MAX_TOKENS | Token 预算总上限。 | 200000 |
DETAILED_DATA_DEFAULT_TTL_MS | 详细数据默认 TTL。 | 1800000 |
DETAILED_DATA_MAX_TTL_MS | 详细数据最大 TTL。 | 3600000 |
DETAILED_DATA_SMART_THRESHOLD_BYTES | 详细数据自动摘要阈值。 | 51200 |
MAX_CONCURRENT_ANALYSIS | 最大并发分析数。 | 3 |
MAX_CODE_SIZE_MB | 分析阶段允许的最大代码体积。 | 10 |
jshook_IO_CONCURRENCY | I/O 并发上限。 | 4 |
jshook_CPU_CONCURRENCY | CPU 并发上限。 | 2 |
jshook_CDP_CONCURRENCY | CDP 并发上限。 | 2 |
10. Worker 池与并发调度
| 变量 | 作用 | 默认值 / 典型值 |
|---|---|---|
WORKER_POOL_MIN_WORKERS | Worker 池最小 worker 数。 | 2 |
WORKER_POOL_MAX_WORKERS | Worker 池最大 worker 数。 | 4 |
WORKER_POOL_IDLE_TIMEOUT_MS | Worker 空闲回收超时。 | 30000 |
WORKER_POOL_JOB_TIMEOUT_MS | Worker 单任务超时。 | 15000 |
PARALLEL_DEFAULT_CONCURRENCY | 默认并发执行数量。 | 3 |
PARALLEL_DEFAULT_TIMEOUT_MS | 默认并发任务超时。 | 60000 |
PARALLEL_DEFAULT_MAX_RETRIES | 默认并发重试次数。 | 2 |
PARALLEL_RETRY_BACKOFF_BASE_MS | 默认并发重试退避基数。 | 1000 |
11. 外部工具 / 沙箱 / 符号执行
| 变量 | 作用 | 默认值 / 典型值 |
|---|---|---|
EXTERNAL_TOOL_TIMEOUT_MS | 外部工具执行总超时。 | 30000 |
EXTERNAL_TOOL_PROBE_TIMEOUT_MS | 外部工具探测超时。 | 5000 |
EXTERNAL_TOOL_PROBE_CACHE_TTL_MS | 外部工具探测缓存 TTL。 | 60000 |
EXTERNAL_TOOL_FORCE_KILL_GRACE_MS | 外部工具强杀前的 grace 时间。 | 2000 |
EXTERNAL_TOOL_MAX_STDOUT_BYTES | 外部工具 stdout 最大字节数。 | 10485760 |
EXTERNAL_TOOL_MAX_STDERR_BYTES | 外部工具 stderr 最大字节数。 | 1048576 |
SANDBOX_EXEC_TIMEOUT_MS | 沙箱执行超时。 | 5000 |
SANDBOX_MEMORY_LIMIT_MB | 沙箱内存上限。 | 128 |
SANDBOX_STACK_SIZE_MB | 沙箱栈大小。 | 4 |
SANDBOX_TERMINATE_GRACE_MS | 沙箱终止前的 grace 时间。 | 2000 |
SYMBOLIC_EXEC_MAX_PATHS | 符号执行最大路径数。 | 100 |
SYMBOLIC_EXEC_MAX_DEPTH | 符号执行最大深度。 | 50 |
SYMBOLIC_EXEC_TIMEOUT_MS | 符号执行超时。 | 30000 |
PACKER_SANDBOX_TIMEOUT_MS | Packer 沙箱超时。 | 3000 |
12. LLM token 与反混淆调优
| 变量 | 作用 | 默认值 / 典型值 |
|---|---|---|
ADV_DEOBF_LLM_MAX_TOKENS | 高级反混淆 LLM token 上限。 | 3000 |
VM_DEOBF_LLM_MAX_TOKENS | VM 反混淆 LLM token 上限。 | 4000 |
DEOBF_LLM_MAX_TOKENS | 通用反混淆 LLM token 上限。 | 2000 |
CRYPTO_DETECT_LLM_MAX_TOKENS | 加密检测 LLM token 上限。 | 2000 |
13. Workflow 批处理与 bundle 缓存
| 变量 | 作用 | 默认值 / 典型值 |
|---|---|---|
WORKFLOW_BATCH_MAX_RETRIES | workflow 批处理默认最大重试次数。 | 3 |
WORKFLOW_BATCH_MAX_TIMEOUT_MS | workflow 批处理默认最大超时。 | 300000 |
WORKFLOW_BUNDLE_CACHE_TTL_MS | workflow bundle 缓存 TTL。 | 300000 |
WORKFLOW_BUNDLE_CACHE_MAX_BYTES | workflow bundle 缓存大小上限。 | 104857600 |
14. 内存操作
| 变量 | 作用 | 默认值 / 典型值 |
|---|---|---|
MEMORY_READ_TIMEOUT_MS | 内存读取超时。 | 10000 |
MEMORY_MAX_READ_BYTES | 单次内存读取最大字节数。 | 16777216 |
MEMORY_WRITE_TIMEOUT_MS | 内存写入超时。 | 10000 |
MEMORY_MAX_WRITE_BYTES | 单次内存写入最大字节数。 | 16384 |
MEMORY_DUMP_TIMEOUT_MS | 内存 dump 超时。 | 60000 |
MEMORY_SCAN_TIMEOUT_MS | 内存扫描超时。 | 120000 |
MEMORY_SCAN_MAX_BUFFER_BYTES | 内存扫描时允许的最大缓冲区。 | 52428800 |
MEMORY_SCAN_MAX_RESULTS | 内存扫描最大结果数。 | 10000 |
MEMORY_SCAN_MAX_REGIONS | 内存扫描最大 region 数。 | 50000 |
MEMORY_SCAN_REGION_MAX_BYTES | 单个扫描 region 最大字节数。 | 16777216 |
MEMORY_INJECT_TIMEOUT_MS | 注入操作超时。 | 30000 |
MEMORY_MONITOR_INTERVAL_MS | 内存监控轮询间隔。 | 1000 |
MEMORY_VMMAP_TIMEOUT_MS | 内存映射查询超时。 | 15000 |
MEMORY_PROTECTION_QUERY_TIMEOUT_MS | 内存保护属性查询超时。 | 15000 |
MEMORY_PROTECTION_PWSH_TIMEOUT_MS | PowerShell 保护属性查询超时。 | 30000 |
NATIVE_ADMIN_CHECK_TIMEOUT_MS | 管理员权限检查超时。 | 5000 |
NATIVE_SCAN_MAX_RESULTS | Native 扫描最大结果数。 | 10000 |
PROCESS_LAUNCH_WAIT_MS | 启动调试进程后的等待时间。 | 2000 |
WIN_DEBUG_PORT_POLL_ATTEMPTS | Windows 调试端口轮询次数。 | 20 |
WIN_DEBUG_PORT_POLL_INTERVAL_MS | Windows 调试端口轮询间隔。 | 500 |