SCA Audit 把「审计一个代码仓库」拆成可并行的意图,交给多个 LLM Agent 分工静态读完源码,把结果写成两张可回溯的图:资产图(这个系统对外暴露了什么)与探索图(我们是怎么一步步查到结论的)。
它和扫描器的区别在于产出物:
| 扫描器 / SAST 规则 | SCA Audit | |
|---|---|---|
| 输入 | 代码 | 代码(只读) |
| 产出 | 规则命中列表 | 接口清单 + 每条接口所需权限、缺陷结论(带 文件:行号 + 代码片段)、依赖可达性判定 |
| 判断依据 | 模式匹配 | 读完整条数据流:参数从哪来 → 过没过校验 → 到没到 Sink |
| 误报处理 | 人工逐条看 | 独立会话复核,结论三态回写漏洞状态 |
| 过程 | 黑盒 | 探索图 + 每次工具调用留痕,可复算 |
只做静态分析。 平台不发起任何网络请求、不执行任何系统命令、不做任何运行时验证——结论必须由源码证据支撑。这不是靠提示词约束,而是在工具装配层物理删除(见下节)。
agent/codeaudit_tools.go 是「Agent 能调用什么」的唯一真源。工具来源侧是三层防线,缺一不可;写入侧另有拦截规则兜底:
① Agent 的通用工具集只从 7 个本地文件工具构造
Read · Write · Edit · MultiEdit · LS · Glob · Grep
没有 Bash。没有 WebFetch / WebSearch。其余全是平台自己的领域工具(登记资产、写回图、登记漏洞、依赖查询、复核结论)。
② 装配层不再注入危险来源
server/hostTools() 不返回流量工具、自定义工具与 MCP;server/assembly.go 不再展开 MCP 服务器——所以连 mcp__* 工具都不会出现在 Agent 的工具列表里。系统设置里的「MCP」「自定义工具」入口只保留历史数据查看。
③ 兜底黑名单:配置也绕不过去
即使有人往 DB 的 tools 表、可见性配置或宿主工具里塞进危险工具,也会在 AugmentTools 的最后一步按名字剔除:
var codeAuditDeniedTools = []string{
"bash", "shell", "shell_session", "sleep", "monitor",
"webfetch", "websearch", "web_search", "fetch", "curl", "wget", "http", "http_request",
"command", "script", // 自定义工具的 command / script kind(http kind 的 key 就是 "http",已在上行)
"task", "taskoutput", "taskstop", "tasklist", // 子代理会把上述能力递归带进去
"mcp__*", "traffic_*",
"intercept_execute", "intercept_approve",
"browser*", "playwright*", "selenium*",
"nmap*", "nuclei*", "sqlmap*", "ffuf*", "dirsearch*", "hydra*", "metasploit*",
"create_custom_tool", "update_custom_tool", "create_mcp", "update_mcp", "test_custom_tool",
}④ 写入侧还有拦截规则
被测源码是审计证据,任何改动都会让结论不可复现。拦截规则按优先级匹配工具输入,首条命中即生效:
| 优先级 | 规则 | 匹配 | 动作 |
|---|---|---|---|
| 30 | 被测源码只读 | \.\./source/ |
拒绝 |
| 20 | 工作区外写入需审批 | \.\./ |
转人工 |
| 10 | 平台不出网 | https?:// |
拒绝 |
拦截范围只覆盖写入类工具(Write / Edit / MultiEdit)——读工具的常规路径本来就是 ../source、../deps。被拦下的调用会挂在任务详情的「拦截审批」里等人工裁决。
以下截图取自
NEXT_PUBLIC_MOCK=1的离线 Demo(无后端、内置acme-mall演示数据)。完整交互见在线 Demo。
| 仪表盘(总览 / Token 消耗 / 活动流) | 任务列表 |
|---|---|
![]() |
![]() |
| 任务 · 执行过程(会话 / 工具调用) | 探索链路(意图 · 事实 · 漏洞血缘) |
|---|---|
![]() |
![]() |
| 发现(跨任务漏洞汇总 · 按严重度 / 任务分组) | 漏洞复核(三态结论 + 逐条核对依据) |
|---|---|
![]() |
![]() |
| 测试资产 · 接口与所需权限 | 资产覆盖图(力导向 · 已测高亮 · 节点折叠) |
|---|---|
![]() |
![]() |
| 第三方依赖(清单 / 类名索引 / 按需反编译) | 人在环路对话 |
|---|---|
![]() |
![]() |
| Agent 管理(提示词 / 工具 / 技能可见性) | LLM 配置(多档位 · 轮询与退避) |
|---|---|
![]() |
![]() |
| 后端日志(工具调用 / 拦截 / 依赖索引) |
|---|
![]() |
引擎是事件驱动的闭环:图一变就唤醒 planner,planner 派意图,worker 领意图执行并写回,写回又触发下一轮——直到目标被证明(prove_goal)。
sequenceDiagram
autonumber
participant EV as 图变更 debounce
participant P as planner
participant FR as frontier 意图队列
participant W as worker
participant PX as 源码 / 依赖目录
participant DB as 双图 + activity
EV-->>P: 唤醒
P->>DB: 读态势(graph_overview 预取 + coverage/scope)
P->>FR: 派 0..N 个意图(带 asset_ids)
Note over P,FR: 大多数唤醒派 0 个——无新方向即结束
W->>FR: claimNext 领一条意图
W->>DB: 取意图 asset_ids 的原始资产作为初始信息
W->>PX: 本地读取源码(Read / Grep / Glob)
PX-->>W: 文件内容(全程留痕)
W->>DB: 写回 fact / asset / finding + 每步 activity
DB-->>EV: 图变更
EV-->>P: 再次唤醒(闭环)
worker 的工作目录是意图目录
tasks/<taskID>/i<intentID>,因此代码在../source、第三方依赖在../deps。
系统把「要查什么」和「查到了什么程度」拆成两张相互独立、又通过锚点相连的图:
flowchart LR
subgraph EG["探索图(每任务独立 · 推进链)"]
direction TB
G["goal 目标"]
I1["intent 意图 A"]
F1["fact 事实"]
I2["intent 意图 B"]
FD["finding 缺陷"]
G -->|spawns| I1
I1 -->|yields| F1
F1 -->|derived_from| I2
I2 -->|proves| FD
end
subgraph AG["资产图(全局共享 · 真值库)"]
direction TB
APP["app 应用"]
EP["endpoint 接口<br/>(带所需权限)"]
LEG["root_domain / subdomain / ip / service<br/>(保留既有数据类型)"]
APP --> EP
end
I1 -. anchor .-> APP
F1 -. anchor .-> EP
I2 -. anchor .-> EP
FD -. anchor .-> EP
- 资产图(全局共享):跨任务同一份的资产真值库,
exploration_anchors(node_id, asset_id)把探索节点锚定到具体资产。代码审计主要产出app(应用) 与endpoint(接口) 两类节点;接口节点带url / method / params / permission / file / line。父子关系与去重 key 全部由程序计算,Agent 只提交原始信息。 - 探索图(每任务独立):节点为
goal / intent / fact / finding / hint,靠spawns / derived_from / yields / proves连成血缘链,回答「哪个方向派生自哪些事实、产出了什么缺陷」。 - 两图相连后,既能从「探索方向」看它查的是哪些接口,也能从「某个接口」反查它在本任务被哪些意图读过、得出过哪些事实——这支撑了资产测试覆盖度与资产覆盖图(范围内资产 + 已测高亮)。
每个接口都要判定「谁能调」,取值六档:
公开 / 注册用户 / 登录用户 / 管理员权限 / 内部接口 / 其他
判定依据按优先级:① 网关白名单(最外层,命中即「公开」)② 类/方法级鉴权注解(@PreAuthorize、@Secured 等)③ 自研鉴权工具类与拦截器 ④ 路由分组与中间件注册范围。
两条容易判错的规则,平台按代码实际生效的边界记:
- 中间件兜底会骗人:网关只验 token 有效性的路径,后端如果没注解,实际权限是「登录用户」而不是「管理员权限」——这类「标注权限 ≠ 实际权限」的接口会单独报出来。
- 没看到任何鉴权校验、且不在白名单豁免清单里的接口,一律按「内部接口」处理——未鉴权、内网专用、调试/管理接口是最重要的发现。
任务目录下的 deps/ 是清单 + 按需反编译产物,和 ../source 是两回事:默认一个 jar 都没被反编译,里面通常只有 ../deps/INDEX.md(依赖清单)和 ../deps/index/classes.txt(类名索引)。
看依赖源码的正确顺序是三步,而不是盲扫:
- 先
Grep ../deps/index/classes.txt定位「这个类在哪个依赖里」(很便宜); list_dependencies看坐标、版本与源码状态;- 只对确有必要的那一个依赖调
ensure_dependency_source(gav="group:artifact:version"),它把该 jar 变成可读源码并返回落盘路径(不会把整包代码倒进上下文),拿到路径后自己Read/Grep。
实测一个 1.7 MB 的 jar 反编译要 40~60 秒,所以平台不提供「全部反编译」。反编译产物不是原始源码(行号、结构、变量名都可能不同),引用时必须注明。
可达性三步(缺一步都不算缺陷):
| 步骤 | 怎么做 | 判不通过的典型情形 |
|---|---|---|
| ① 版本命中 | pom.xml / build.gradle 的坐标与版本落在已知漏洞区间 |
这一步只是候选,不是结论 |
| ② 调用点可达 | Grep 该组件的类是否被业务代码 import / 调用 |
没有 import → 直接排除 |
| ③ 入参可控 | 命中的那处调用,参数是否来自请求或外部数据 | 参数是常量 / 内部可信值 / 已被白名单约束 |
只有三步全过才登记为漏洞。仅凭版本命中 CVE、或「用了字符串拼接」就上报是被明令禁止的——嫌疑项只能记为「存疑/待核实」。
从漏洞详情或列表手动发起,平台会拉一个独立的复核 Agent 会话,它只复核这一个漏洞:重新核对触发路径是否可达、危险输入是否可控、关键校验是否真的缺失、原证据(文件:行号 + 代码片段)是否真实存在且没断章取义。主动证伪优先——存在有效校验、路径不可达、仅测试/死代码、只靠版本推断,都算复核通过(方向相反)。
结论三态,会话成功结束且结论为 confirmed 时,系统自动把漏洞状态改为「已确认」;refuted 改为「误报」;inconclusive(缺源码、反编译不可读)保留原状态:
| verdict | 含义 | 联动 |
|---|---|---|
confirmed |
漏洞真实:触发路径、可控输入、危险操作三者闭合 | 状态 → 已确认 |
refuted |
漏洞不成立:证据被证伪或不足以支撑结论 | 状态 → 误报 |
inconclusive |
缺源码或证据,无法判定(需写清缺什么) | 状态不变 |
原证据与报告始终保留,复核只新增独立结论。同一漏洞正在复核时复用已有会话。
一次深入的审计里,很多有价值的观察(某个入口没走鉴权、某个参数一路没被校验、某个配置被另一个 profile 覆盖)出现在一个 worker 的执行过程中,却未必被写成正式 fact。为避免重复劳动,worker 可以跨 work 检索过程:
flowchart LR
WA["worker A(意图 #12)"] -->|"每步 activity"| ACT[("探索图 · activity 过程库")]
WB["worker B(意图 #34)"] -->|"每步 activity"| ACT
WC["worker C(意图 #56)"] ==>|"1) search_all_worker_traces(q)"| ACT
ACT ==>|"2) 命中 A/B 的步骤(排除自己)"| WC
WC ==>|"3) get_worker_trace(id, step_ids)"| ACT
ACT ==>|"4) 返回完整过程内容"| WC
这样即便探索图上还没有对应的 fact,后续 worker 也能复用他人过程中的观察——信息以「执行过程」为粒度在 worker 之间流动,而边界不变(每个 worker 仍只做自己领到的那条意图)。
真实审计链往往有前后依赖(如:确认入口未鉴权 → 追踪该入口的参数是否可控 → 沿调用链走到 Sink → 判定缺陷成立),一次性并行派下去只会乱套。planner 因此持有一份按任务保留、跨唤醒共享的规划待办:
flowchart TB
subgraph TODO["共享 todolist(按任务保留 · 跨唤醒常驻)"]
direction LR
T1["1 入口与鉴权面 [已完成]"]
T2["2 参数可控性 [进行中]"]
T3["3 数据流到 Sink [待前置]"]
T4["4 缺陷归因与定级 [待前置]"]
T1 -.前置满足.-> T2 -.-> T3 -.-> T4
end
R1["第 1 轮唤醒 派意图①"] --> T1
R2["第 2 轮(①产出 fact) 派意图②"] --> T2
R3["第 3 轮(②产出 fact) 派意图③"] --> T3
每轮只对「前置步骤已完成、其依赖的 fact 已存在」的下一步派意图,并随进展更新清单。于是审计链在「事件驱动 + 每次唤醒是全新会话」的环境下依然稳定推进、不重复、不错序。
flowchart TB
subgraph FE["前端 Next.js(go:embed 内嵌单二进制)"]
UI["仪表盘 · 任务 · 发现 · 测试资产 · 覆盖图 · 对话 · 系统配置"]
end
subgraph SRV["server(Go net/http)"]
API["REST /api/* JWT 鉴权 SSE"]
ENG["engine 调度循环"]
MGR["Manager 任务 / 引擎 / store 生命周期"]
end
subgraph AG["agent(norma SDK)"]
GO["goals 目标拆解 + 识别审计范围"]
PL["planner 规划(唯一意图生成者)"]
WK["worker 执行者 ×N"]
MA["mainagent 人在环路"]
PT["独立审计 一人走完整条链"]
RT["漏洞复核 独立会话三态结论"]
end
subgraph DB["PostgreSQL"]
AGRAPH["资产图 assets / companies / task_scope"]
EGRAPH["探索图 exploration_nodes / anchors / activity"]
end
subgraph SUB["支撑子系统"]
WS["源码包解压 / 任务工作目录"]
DEPS["依赖清单 / 类名索引 / 按需反编译"]
GUARD["拦截规则 工具输入匹配门"]
ENR["asset / finding 资产与缺陷落库"]
EXT["skills · memory · report"]
end
UI -->|HTTP| API
API --> MGR --> ENG
ENG --> PL
ENG --> WK
API --> MA
API --> GO
API --> PT
API --> RT
PL --> DB
WK --> DB
MA --> DB
GO --> DB
WK -->|"Read / Grep / Glob 全程留痕"| WS
WK --> DEPS
WK --> GUARD
WK --> ENR
PL -.-> EXT
WK -.-> EXT
MA -.-> EXT
| 层 | 职责 |
|---|---|
| 前端 | Next.js 静态导出,go:embed 内嵌进单二进制;可视化任务 / 资产 / 探索链路 / 覆盖图,人在环路对话 |
| server | net/http 路由 + JWT 鉴权 + SSE;Manager 托管任务、引擎、DB store 的生命周期 |
| engine | 每任务一个 plannerLoop + N 个 worker goroutine;意图领取、超时 / 暂停 / drain |
| agent | goals / planner / worker / mainagent 的编排循环,外加两个单脑 Agent:独立审计、漏洞复核 |
| db | 双图的 Postgres 落地(pgx);schema 随 go:embed 每次启动幂等建表 |
| 支撑 | 源码包解压与工作目录、依赖索引与按需反编译、拦截门、技能 / 记忆 / 报告 |
依赖数据库 PostgreSQL;需配置 LLM(
ANTHROPIC_API_KEY或OPENAI_API_KEY,也可在 UI 里配)。
git clone https://github.com/Autumn-27/ARTEX.git
cd ARTEX
./install.sh脚本会:检测 / 自动安装 Docker → 让你选 ① 全部 Docker 或 ② 本地编译运行:
- ① 全部 Docker:填一个 Postgres 密码(可回车随机)→ 自动写
.env→docker compose up -d。 - ② 本地运行:选数据库(连已有 / 用 Docker 起一个)→ 生成
config.json→go编译内嵌单二进制 → 启动。
装好后打开 **http://localhost:7878**(首次进入 /setup 设置管理员密码)。
git clone https://github.com/Autumn-27/ARTEX.git
cd ARTEX
cp .env.example .env # 填 POSTGRES_PASSWORD、可选 ANTHROPIC_API_KEY
docker compose up -d # 拉取 autumn27/artex 镜像 + postgres
# → http://localhost:7878镜像已含常用工具(ripgrep / vim / npm…);./skills 与 ./data 以绑定挂载持久化。
代码审计平台的 Agent 只保留本地文件读写 / 检索工具(Read / Write / Edit / MultiEdit / LS / Glob / Grep), 没有任何出网或执行外部命令的能力:流量抓取 / 回放、自定义命令与脚本、MCP 工具在装配层就不注入, 详见上面的 安全边界。
到 Releases 下载对应平台的 zip,解压后得到 artex + start.sh(Windows 为 start.bat)+ skills/ + config.example.json:
cp config.example.json config.json # 填好 database 连接
./start.sh # → http://localhost:7878请用
start.sh/start.bat启动,而不是直接跑./artex。它是个守护脚本:程序退出后按退出码决定是否重新拉起,页面上的一键更新靠它完成换装。直接运行./artex时更新完就不会被拉起了。 后台常驻:nohup ./start.sh >artex.log 2>&1 &。
# 1) 前端静态导出
cd web && npm ci && npm run build:static && cd ..
# 2) 拷进内嵌目录
cp -r web/out server/webui/dist
# 3) 编译(-tags embedui 才内嵌前端)
CGO_ENABLED=0 go build -tags embedui -o artex ./cmd/artex
./start.shbuild.sh 会先构建并嵌入前端,再使用 Go linker 去除调试信息,并将发布文件压缩为 zip。Release 模式默认生成 Linux amd64/arm64、macOS amd64/arm64 和 Windows amd64 的 zip 包:
./build.sh --release
# 产物:dist/artex-0.3.3-*.zipUPX 自解压二进制可能与部分 Linux 内核、虚拟化环境或安全策略不兼容,因此默认不启用。可用 ARTEX_TARGETS 自定义目标;确认目标运行环境兼容时,可显式传入 --upx 进一步缩小二进制:
ARTEX_TARGETS=linux/amd64,windows/amd64 ./build.sh --release
./build.sh --target linux/amd64 --upx平台是多用户的:账号存在 users 表(is_admin 区分管理员/普通用户),任务按部门隔离。
- 管理员:账号管理(建号、改密、停用、提升/取消管理员)、部门管理(建部门、分配成员的部门与角色)、可查看全部任务。
- 普通用户:只能看到自己创建的、以及自己所属部门下的任务。
- 部门角色:
owner(部门所有者)可对话、创建/暂停/删除任务;visitor(部门访客)只读——不能对话、不能创建任务、不能暂停/删除。 - 首次部署访问
/setup创建管理员;之后账号的密码忘记时用仓库里的重置脚本(连库直接改 bcrypt 哈希,无需重启):
./reset-password.sh # 默认重置 admin,交互输入新密码
./reset-password.sh -u someone -p 'NewPass!' # 重置指定账号
./reset-password.sh -m docker # docker 部署(在 postgres 容器内执行)升级只换程序、不动数据:Postgres 数据卷
pgdata、./data(jwt.key / SQLite 等)、./skills都会保留。数据库迁移无需手动执行——artex每次启动会幂等重跑schema.sql(含ADD COLUMN/CREATE INDEX IF NOT EXISTS),即“重启即迁移”。升级前仍建议先备份./data与数据库。
在 系统配置 页(侧边栏「系统配置」→ /system/settings)的版本与更新卡片里,可以直接检查并安装新版本,无需登录服务器。
点「更新」后:下载当前平台的发布包 → 比对 Release 的 SHA256SUMS → 用 -h 冒烟测试新二进制 → 暂存为 artex.new → 程序退出,由 start.sh / start.bat 重新拉起并完成换装。页面会自动等到新版本上线后刷新。
- 失败不会留下坏程序:校验或冒烟不通过就丢弃暂存件、继续跑当前版本;换装后的新版若连续 3 次启动失败,会自动回滚到
artex.old(失败的那个留作artex.failed供排查)。 - 随时可回退:上一版本保留为
artex.old,卡片上有「回滚到上一版本」。注意数据库结构不会回退。 - 更新会中断正在运行的任务——更新即重启,请在空闲时进行。
- 开发构建不给更新:版本号是
dev或git describe带后缀时禁用,避免正式版覆盖掉本地调试的二进制。 - Docker 下只换程序、不换镜像:镜像里的反编译工具链(JDK / cfr)不会跟着升级,且
docker compose up -d重建容器后会退回镜像自带的版本。要连镜像一起升级仍请用docker compose pull artex && docker compose up -d artex。 - 访问 GitHub 需要代理时,在同一页面配置全局代理即可,更新链路会走它。更新只从 GitHub 域名下载并强制 HTTPS。
cd ARTEX
./update.sh脚本先可选 git pull 拉取最新代码,再让你选 ① Docker 更新 或 ② 本地编译更新(与 install.sh 对应):
- ① Docker:可指定目标镜像 tag(回车沿用
.env的ARTEX_TAG,缺省latest)→docker compose pull→docker compose up -d(换新镜像重启即自动迁移)。 - ② 本地:重建前端静态产物 → 重新编译
./artex(完成后重启进程生效)。
cd ARTEX
git pull # 更新 compose / 脚本(可选)
# 指定版本:在 .env 设 ARTEX_TAG=v0.2.0;不设则用 latest
docker compose pull artex
docker compose up -d artex # 换新镜像重启 → 自动迁移 schema
docker image prune -f # 清理旧镜像(可选)到 Releases 下载新版本 zip,停掉旧进程后覆盖 artex 与 skills/(保留你的 config.json 与 data/),重启即可:
cp -r <解压目录>/skills ./ && cp <解压目录>/artex ./
./start.shgit pull
cd web && npm ci && npm run build:static && cd ..
cp -r web/out server/webui/dist
CGO_ENABLED=0 go build -tags embedui -o artex ./cmd/artex
# 重启 ./start.sh数据库(config.json,或用环境变量 ARTEX_PG_DSN 覆盖):
{
"database": {
"host": "127.0.0.1", "port": 5432,
"user": "artex", "password": "yourpass",
"dbname": "artex", "sslmode": "disable"
}
}LLM:export ANTHROPIC_API_KEY=sk-...(或 OPENAI_API_KEY),也可在 UI 的「LLM 配置」页填写。
可选:ARTEX_LLM_PROVIDER / ARTEX_LLM_MODEL / ARTEX_LLM_BASE_URL / ARTEX_LLM_PROXY。
并发:每个任务的 work agent 数在「系统设置」里配置(默认 3)。
常用环境变量:
| 变量 | 作用 |
|---|---|
ARTEX_PG_DSN |
直接给出 Postgres 连接串,优先于 config.json |
ARTEX_SKILL_DIR |
技能根目录(默认可执行文件旁的 skills/) |
ARTEX_LLM_PROVIDER / ARTEX_LLM_MODEL / ARTEX_LLM_BASE_URL |
覆盖 LLM 供应商 / 模型 / 端点 |
常用启动参数:./start.sh -addr :7878(-addr 前端 + API,默认 :7878)。启动脚本会把参数原样透传给 artex。
-proxy是早期版本用于流量录制的代理端口,代码审计平台默认空(关闭),一般不需要设置。
平台读第三方 jar 需要 java + 一个反编译 jar。不配也能用——依赖清单 INDEX.md 与类名索引 index/classes.txt 始终可用,list_dependencies 正常返回坐标、版本与源码状态,只是「按需反编译」会报不可用。
探测顺序:显式配置 / 环境变量 → <data>/tools/ 下的 jar → PATH 里的 java。
config.json(java.*) |
环境变量 | 说明 |
|---|---|---|
java_path |
ARTEX_JAVA_PATH |
java 可执行文件;留空则搜 PATH |
vineflower_jar |
ARTEX_VINEFLOWER_JAR |
Vineflower(需 JRE 17+,多线程、对新版 Java 支持更好,优先) |
cfr_jar |
ARTEX_CFR_JAR |
CFR(JRE 6+ 即可运行,兜底) |
timeout_seconds |
ARTEX_DECOMPILE_TIMEOUT |
单个 jar 的反编译上限,默认 180 秒 |
max_heap |
ARTEX_DECOMPILE_MAX_HEAP |
反编译 JVM 堆上限,默认 2g |
local_repo |
ARTEX_JAVA_LOCAL_REPO |
本地 Maven 仓库(通常 ~/.m2/repository),只读 |
{
"java": {
"java_path": "/usr/bin/java",
"cfr_jar": "/app/data/tools/cfr-0.152.jar",
"local_repo": "/root/.m2/repository",
"timeout_seconds": 180,
"max_heap": "2g"
}
}配好 local_repo 后,任务可以按 group:artifact:version 直接从本地仓库取 jar(硬链接进任务自己的 deps/jars,从不写入仓库),不必每次手工上传——这才是「配一次、每个任务都受益」。仓库路径写错会降级为「只能上传」,不会让依赖处理整体坏掉。
前端和 API/SSE 都由同一个后端端口(默认 :7878)提供,实时活动流默认走同源地址,因此无需配置 NEXT_PUBLIC_SSE_BASE,公网只开放 443、把 7878 留在内网即可。
SSE 是长连接 + 持续推送,反代必须关闭缓冲,否则浏览器能连上却收不到事件(表现为活动流一直转圈)。Nginx 示例:
server {
listen 443 ssl;
server_name your.domain.com;
# ssl_certificate / ssl_certificate_key ...
location / {
proxy_pass http://127.0.0.1:7878;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
# SSE 关键项:关缓冲、长超时、HTTP/1.1
proxy_buffering off;
proxy_cache off;
proxy_read_timeout 3600s;
proxy_http_version 1.1;
proxy_set_header Connection "";
}
}仅当 SSE 需要走与页面不同的来源(如独立子域)时,才在构建期设置
NEXT_PUBLIC_SSE_BASE(该变量在next build时固化进静态包,容器运行时再设无效)。
./dev.sh # 后端(:7878) + 前端 next dev(:5173) → http://localhost:5173- 后端:
go run ./cmd/artex(不带-tags embedui则不内嵌前端) - 前端:
cd web && npm run dev(/api反代到后端,带热更新) - 测试:
go test ./... - Mock 预览(无后端):
cd web && NEXT_PUBLIC_MOCK=1 npm run dev—— 整站用内置演示数据跑通,README 里的截图就是这么出的。
Agent 分两类,都在「Agent 管理」页配置(提示词版本、绑定 LLM、运行预算、工具与技能可见性):
- 编排循环:
goals(目标拆解)/planner(规划,唯一意图生成者)/worker(执行者 ×N)/mainagent(人在环路)。它们的默认提示词在agent/{goals,planner,worker,mainagent}.go。 - 单脑 Agent:
独立审计(一人从代码结构 → 接口清单 → 权限判定 → 数据流追踪 → 缺陷确认 → 报告收尾走完整条链)与漏洞复核(三态结论)。提示词分别在agent/promptcatalog.go与agent/retester.go。
预置提示词只在首次创建时写入,之后你在 UI 里的编辑不会被升级覆盖;需要恢复默认时用提示词版本历史回退。
NEXT_PUBLIC_MOCK=1 会短路 web/src/lib/mock/ 里的路由与数据,不需要后端与数据库,适合:
- 给 README / 文档出截图;
- 前端改动时验证各种空态、错误态与长列表;
- 部署一个纯静态的在线 Demo(Vercel 等)。
演示数据是一套完整的 acme-mall(Java / Spring Boot 多模块)审计剧本:3 个应用 + 17 个接口、14 条缺陷、8 个第三方依赖、12 条探索意图、3 段人机对话,外加一条已完成的漏洞复核记录。所有时间戳会在加载时整体平移到「当前时间」,所以 Demo 永远看起来是刚发生的、仪表盘的 7 天 / 30 天窗口也不会空。
扫码关注微信公众号 SecSentry,在公众号后台私信即可入群交流。
https://github.com/oritera/Cairn
本项目采用 GNU Affero General Public License v3.0(AGPL-3.0) 授权,完整条款见仓库根目录的 LICENSE 文件。
这意味着任何人都可以自由使用、修改和分发本项目,但衍生作品必须同样以 AGPL-3.0 开源;特别地,若你修改本项目并通过网络(如部署为在线服务)向用户提供,也必须向这些用户公开对应的完整源码。
⚠️ 重要提示:开源协议本身不限制软件的使用用途。以下的「使用限制」与「免责声明」是作者对使用者的额外约定与郑重声明,请务必遵守。
SCA Audit 只做静态源码分析:它不发起任何网络请求、不执行任何系统命令、不接触任何运行中的系统。
- 审计你自己拥有的代码,或已获得权利人明确书面授权的代码;
- 阅读、学习与研究本项目源码,以及在本地隔离环境中进行技术原理验证;
- 个人学习、学术研究、内部代码审阅与安全自查。
- 严禁审计你无所有权、也未获授权的代码——包括但不限于通过非正当途径取得的商业软件、他人私有的源代码仓库;
- 严禁将本项目的产出用于攻击、入侵、勒索或任何破坏性、犯罪性活动,或将缺陷信息用于未授权披露、勒索与敲诈;
- 严禁将本工具用于任何实际的渗透测试、攻防对抗或对生产环境的变更;
- 严禁利用本工具从事违反所在国家/地区法律法规的行为。
使用者须自行遵守所在国家/地区关于网络安全、数据保护与计算机犯罪的全部法律法规(在中国大陆包括但不限于《网络安全法》《数据安全法》《个人信息保护法》及相关司法解释)。因使用本工具产生的一切法律责任与后果,均由使用者自行承担。
本项目按“现状(AS IS)”提供,不附带任何明示或默示的担保。本工具基于 LLM 生成审计结论,可能存在漏报与误报,不构成任何形式的安全保证或合规背书——请务必人工复核后再据以决策。作者及贡献者不对使用本工具(无论使用方式是否得当)所导致的任何直接或间接损失、数据丢失、系统损坏或法律纠纷承担责任。下载、安装或使用本项目,即表示你已阅读、理解并同意上述全部条款。













