biu-cli

name	biu-cli
description	biuasm 攻击面梳理平台biu-cli使用指南

biu-cli

何时使用

用户在使用 biu-cli（连接 Biu 服务做资产查询、项目管理、批量加目标）时，按本文档执行biu-cli；

安装

远程安装：go install github.com/0xbug/biu-cli/cmd/biu-cli@latest（模块 github.com/0xbug/biu-cli），默认可执行文件名为 biu-cli。

首次认证与配置

1. 在 Biu 个人中心 → 安全设置 https://asm.biu.life/account/setting?tab=security 生成 API 密钥。
2. 首次初始化（将写入 ~/.biu.env）：

biu-cli -ak API密钥 -host biu地址(https://x.x.x.x)

BIU_AK="API密钥"
BIU_HOST="biu地址"
BIU_PORTS="新建项目使用的端口范围"

• BIU_PORTS：新建项目（-pnew）时提交的默认端口范围字符串；与 CLI 内置默认端口列表一致时可不设置。
• 配置文件路径：~/.biu.env。

命令行选项速查

Flag	作用
-ak	API 密钥；与 -host 一起用于首次写入配置
-host	Biu 服务根 URL，例如 https://x.x.x.x
-json	输出 JSON，便于脚本解析（列表/查询/查看项目资产等支持处会生效）
-ip	查询目标：单个 IP 或 CIDR；非 CIDR 形式会在代码中按 /32 处理并用 mapcidr 展开
-s	搜索模式：从 stdin 按行读取 IP/域名并查询；无管道时等价交互式多行输入
-pnew	新建项目名称（无 -pid 时走创建项目逻辑）
-pid	项目 ID；与 -pv 组合为查看该项目资产；与 -pvul 组合为查看该项目漏洞列表；否则从 stdin 每行读入一个目标并加入该项目
-pv	查看指定 -pid 的项目资产配置
-pvul	查看指定 -pid 的项目漏洞列表（调用 /api/scan/report）
-vmd5	漏洞 ID（md5），查看单条漏洞详情（GET /api/scan/report?md5=）
-plugin	漏洞标题/插件名称，查看插件详情（GET /api/plugin?filters={"name":"..."}）
-v	更详细的辅助输出
-l	列出项目 / 漏洞列表时的分页大小（limit），默认 20
-from	漏洞列表页码（from），从 1 开始，默认 1

主流程简述：未指定 -ip 且未指定 -s 时，若既无 -pnew 也无 -pid，则执行 列出已有项目；-pid + -pvul 查看漏洞列表；-pid + -pv 查看资产；-pid 且无 -pv / -pvul 时从 stdin 读行添加目标（宜配合管道）。-pv 与 -pvul 不可同时使用。

请求头：HTTP 客户端会带 Biu-Api-Key（值为 BIU_AK）。

典型用法

JSON 输出

默认表格/文本；加 -json 得到结构化 JSON。

biu-cli -json
biu-cli -ip 1.1.1.1 -json
biu-cli -ip 1.1.1.1/24 -json
biu-cli -pid 项目ID -pv -json
biu-cli -pid 项目ID -pvul -json
cat ip.txt|biu-cli -s -json

查询 IP / 网段

biu-cli -ip 1.1.1.1
biu-cli -ip 1.1.1.1/24

批量查询（管道或交互）

cat ip.txt|biu-cli -s
biu-cli -s

查看已有项目

biu-cli

创建项目

biu-cli -pnew 项目名称

向已有项目添加目标

cat ip.txt|biu-cli -pid 项目ID
cat domain.txt|biu-cli -pid 项目ID

查看项目漏洞列表

biu-cli -pid 项目ID -pvul
biu-cli -pid 项目ID -pvul -json
biu-cli -pid 项目ID -pvul -l 50 -v
biu-cli -pid 项目ID -pvul -from 2

查看漏洞详情

列表输出含「漏洞ID」列，或从平台复制 md5 后：

biu-cli -vmd5 漏洞md5
biu-cli -vmd5 漏洞md5 -json
biu-cli -vmd5 漏洞md5 -v

查看插件详情（按漏洞标题）

漏洞列表「插件」列或详情中的 plugin 字段即为插件名称：

biu-cli -plugin "Sentry 服务端请求伪造漏洞"
biu-cli -plugin "Sentry 服务端请求伪造漏洞" -json

代理提示

• 用户报错联不通或 401/403 时：优先核对 ~/.biu.env 中的 BIU_AK、BIU_HOST 及网络可达性。
• 不要要求用户「启动 biu-cli 验证应用是否能正常跑起来」作为常规排错步骤（除非用户明确要求）。