第 1 章 · 02 快速上手

第 1 章 · 02 快速上手

本节摘要:本节带你从零到第一次扫描完成。流程是:确认前置依赖(Docker 运行中 + 一个 LLM API key)→ 用 curl 或 pipx 安装 Strix → 配置 LLM provider 与 API key → 给一个目标跑第一次扫描。Strix 接受多种目标类型(本地代码库、GitHub 仓库、在线 Web 应用、目标列表文件),首跑会自动拉取 Docker 沙箱镜像,结果保存到 strix_runs/<run-name>。

内容来源:原项目文档 docs/quickstart.mdx,汉化并套用体系化模板。

⚠️ 仅限授权测试:只测试你自己的应用或有书面授权的目标。未经授权测试他人系统是非法的。

学习目标

阅读完本节,你应当能够:

1. 列出 Strix 的 前置依赖 并确认本机满足。
2. 用 curl 或 pipx 安装 Strix。
3. 配置 LLM provider 与 API key(环境变量)。
4. 跑通 第一次扫描 并知道结果在哪。
5. 区分 Strix 接受的 5 种目标类型。
6. 知道首跑时 Docker 沙箱镜像 会自动拉取。

一、前置依赖

跑 Strix 之前,确认两件事:

• Docker(运行中):Strix 的安全工具与执行原语跑在 Docker 沙箱里,所以本机必须有 Docker 守护进程在运行。docker info 能正常返回即满足。
• 一个 LLM API key:来自任一支持的 provider(OpenAI、Anthropic、Google 等)。完整的 9 大 provider 配置见第 3 章。

⚠️ 没有 Docker 运行,Strix 起不来;没有 LLM API key,代理无法思考。这两项是硬前置。

二、安装 Strix

两种安装方式,任选其一:

方式一:curl(官方安装脚本)

curl -sSL https://strix.ai/install | bash
​

方式二:pipx(Python 包管理器)

pipx install strix-agent
​

💡 pipx 适合已有 Python 工具链的开发者;curl 脚本会处理更多环境细节。两者装出来的 strix 命令等价。

三、配置 LLM Provider

设两个环境变量,告诉 Strix 用哪个模型、用什么 key:

export STRIX_LLM="openai/gpt-5.4"
export LLM_API_KEY="your-api-key"
​

STRIX_LLM 的格式是 provider/model,经 LiteLLM 路由(第 3 章详讲)。

💡 为获得最佳效果,推荐用 openai/gpt-5.4、anthropic/claude-opus-4-6 或 openai/gpt-5.2。模型越强,代理的推理与漏洞发现能力越好——这直接影响扫描质量。

四、跑第一次扫描

strix --target ./your-app
​

就这么简单。Strix 会自己接管:启动沙箱、调度代理、发现并验证漏洞。

⚠️ 首跑注意:第一次运行会自动拉取 Docker 沙箱镜像,可能较慢(取决于网络)。结果保存到 strix_runs/<run-name> 目录,后续可在那里查看报告。

五、目标类型

Strix 接受多种目标类型,灵活适配不同测试场景:

# 本地代码库(白盒)
strix --target ./app-directory

# GitHub 仓库
strix --target https://github.com/org/repo

# 在线 Web 应用(黑盒)
strix --target https://your-app.com

# 多目标(白盒测试,可重复 -t)
strix -t https://github.com/org/repo -t https://your-app.com

# 从文件读目标(每行一个非空、非注释行)
strix --target-list ./targets.txt
​

💡 「白盒」指 Strix 能看到源码(本地目录或仓库),可做源码感知的静态分流;「黑盒」指只能从外部访问,靠动态测试。两者在 standard 与 deep 扫描模式下行为不同(第 2 章详讲)。

六、下一步

跑通第一次扫描后,值得接着看:

• CLI 全参数:--scan-mode、--instruction、--max-budget、--mount 等(第 2 章 01 节)
• 扫描模式:quick / standard / deep 的深度与耗时权衡(第 2 章 02 节)
• 自定义指令:给 Strix 凭据、范围、排除项(第 2 章 03 节)

本节要点回顾

1. 前置依赖:Docker 运行中 + 一个 LLM API key,两者缺一不可。
2. 两种安装:curl -sSL https://strix.ai/install | bash(脚本)或 pipx install strix-agent(Python 包管理器)。
3. 两个环境变量:STRIX_LLM(provider/model 格式,经 LiteLLM 路由)与 LLM_API_KEY;推荐 openai/gpt-5.4 等强模型。
4. 第一次扫描:strix --target ./your-app;首跑自动拉 Docker 沙箱镜像,结果在 strix_runs/<run-name>。
5. 五种目标类型:本地代码库、GitHub 仓库、在线 Web 应用、多目标(-t 重复)、目标列表文件(--target-list)。
6. 白盒 vs 黑盒:有源码(本地/仓库)可做源码感知分流;无源码(在线应用)靠动态测试;standard/deep 下行为不同。

下一章,我们深入 CLI 的全部参数、三种扫描模式的深度对比,以及如何用自定义指令引导 Strix 关注特定攻击面。