SIPVicious把 SIP 内部测试
做明白。

mkdir sipvicious-lab
cd sipvicious-lab
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install "sipvicious==0.3.8"
sipvicious_svmap --version
sipvicious_svmap --help

Linux / macOS 使用上述写法；Windows 优先使用你已有的 Linux 测试虚拟机或 WSL 环境，并核对 UDP 和 NAT 路径。激活环境后再运行后面的命令。固定版本方便同事复现。

sudo apt update
sudo apt install sipvicious
svmap --version
svmap --help

这是 Kali 官方工具页提供的安装路径；发行版命令通常是 svmap / svwar / svcrack / svreport / svcrash。当前网页仍标示 0.3.3，实际软件源版本以安装后的输出为准。[S9]

git clone https://github.com/EnableSecurity/sipvicious.git
cd sipvicious
git checkout 485d16cf47023da050ecd73ccb92637725fdd8da
python3 -m pip install .
sipvicious_svmap --version

在已激活的专用虚拟环境中执行。源码安装与 PyPI 安装二选一即可。README 已统一为带前缀的命令；python -m sipvicious.svmap 则是模块运行方式。

sipvicious_svmap -p 5060 -m OPTIONS -t 0.1 \
  -s lab-map-01 192.168.56.10

-p 指定目标 UDP 端口；-m OPTIONS 请求能力/响应；-t 是 select() 等待参数；-s 保存会话。每次实验使用一个新的会话名。

sipvicious_svwar -p 5060 -m REGISTER -e 1001-1003 \
  -t 0.1 --maximumtime 10 -s lab-war-01 192.168.56.10

-e 是 svwar 的分机范围；REGISTER 是其默认方法。--maximumtime 10 表示持续未收到响应时的发送时限，不是整次任务必定 10 秒结束。工具还会先发送不存在号码的探测，因此发包数不只等于三条分机。

printf '%s\n' 'wrong-demo' 'lab-demo-only' > lab-passwords.txt
sipvicious_svcrack -p 5060 -u 1001 -d lab-passwords.txt \
  -t 0.1 --maximumtime 10 -s lab-auth-01 192.168.56.10

仅用于已经配置为演示口令 lab-demo-only 的测试账户。-u 是认证用户名；-d 是候选口令文件。此演示口令不可用于真实业务。工具默认还可能尝试“用户名本身作为口令”，总请求数不能机械等同于文件行数。

sipvicious_svreport list -t svmap
sipvicious_svreport export -t svmap -s lab-map-01 \
  -f csv -o lab-map-01.csv -n
sipvicious_svreport export -t svwar -s lab-war-01 \
  -f txt -o lab-war-01.txt

-t 在 svreport 中是“会话类型”，与扫描器里的等待时间不是同一个含义。-s 必须匹配已保存会话；-n 关闭 svmap 报告的反向 DNS 查询。认证结果可能包含口令，内部留档时按测试凭证处理。

sipvicious_svmap -p 5060,5080-5082 -m OPTIONS \
  -t 0.1 -s lab-ports-01 192.168.56.10

仅查看同一台内部设备的四个 UDP 端口，用于确认容器映射、测试实例或迁移后的监听位置。

printf '%s\n' '192.168.56.10' '192.168.56.11' > lab-hosts.txt
sipvicious_svmap -I lab-hosts.txt -p 5060 \
  -t 0.1 -s lab-inventory-01

-I（大写 i）读取目标文本，每行一个主机或范围；文件应仅含本次内部资产。小写 -i 读取的是此前 svmap 会话中发现的 IP。

sipvicious_svmap -i lab-map-01 -p 5060 \
  -s lab-recheck-01 -t 0.1

适合补丁、ACL 或网络变更后的回归。输入只来自原发现列表，不代表新上线资产也已经被覆盖。

sipvicious_svmap -p 5060 -P 15070 -m OPTIONS \
  -d -v 192.168.56.10

-P 改本地源端口，避免与本机软电话的 5060 冲突；-d 打印收到的报文，检查 Via、From、To、Call-ID 和状态码。

sipvicious_svmap -b 192.168.56.20 -x 192.168.56.20 \
  -P 15070 -p 5060 -t 0.1 192.168.56.10

仅当测试机确实拥有 192.168.56.20 时使用。本例是同一测试网的多网卡选择；NAT 场景的 -x 必须换成有真实回程映射的地址。

sipvicious_svmap -6 -p 5060 '2001:db8::10'

2001:db8::/32 是文档示例地址，执行前换成内部实验地址。svmap 使用 IPv6 字面量和 -p，不使用 udp:// URI；带方括号时也建议引号，避免 shell 通配展开。

printf '%s\n' '1001' '1002' '1003' > lab-extensions.txt
sipvicious_svwar -d lab-extensions.txt --domain lab.invalid \
  -p 5060 -m REGISTER -t 0.1 192.168.56.10

网络目标仍是 IP；--domain 改 SIP 消息使用的域。用于按域区分租户的 PBX / Proxy，替换为产品配置的真实测试域。svmap 没有这一 --domain 参数。

sipvicious_svwar -e 1-3 -z 4 -m OPTIONS \
  -p 5060 -t 0.1 192.168.56.10

-z 4 把号码补到四位：0001、0002、0003。用 OPTIONS 比较是否存在响应差异；若服务器统一应答，这个方法不能判断分机。

sipvicious_svwar -e 1001 -m INVITE -p 5060 \
  -t 0.2 --maximumtime 10 192.168.56.10

仅用于专用测试分机，可能响铃、接通或触发 PBX 路由；0.3.6 起有 INVITE 对话清理相关修复。保持默认 CANCEL 行为，操作后在 PBX 上确认对话结束。这不是 RTP 播放或通话质量测试。

sipvicious_svcrack -u lab-user-1001 -e 1001 \
  -d lab-passwords.txt --domain lab.invalid \
  -p 5060 -t 0.2 192.168.56.10

-u 对应 Digest authentication username；-e 对应分机。很多产品将登录名与分机号分开配置，两者不能互换。此处需要沿用第 3 步的实验候选文件。

sipvicious_svcrack -u 1001 -r 1-3 -z 4 \
  -p 5060 -t 0.2 --maximumtime 10 192.168.56.10

-r 1-3 与 -z 4 生成 0001、0002、0003 三个候选，另外仍需考虑工具默认的用户名同密码尝试。适合实验账户的口令策略阳性/阴性对照；不用于大范围账号尝试。

printf '%s\n' 'wrong-demo' 'lab-demo-only' | \
  sipvicious_svcrack -u 1001 -d - -t 0.2 \
  udp://192.168.56.10:5080

-d - 从 stdin 读候选，便于接入受控内部检查；svwar 同样支持 -d -。udp://host:port 适用于 svwar / svcrack，不能照搬给 svmap。

sipvicious_svreport list -t svwar -c
sipvicious_svreport export -t svwar -s lab-war-01 \
  -f stdout
sipvicious_svreport stats -t svmap -s lab-map-01
sipvicious_svreport search Asterisk -t svmap -s lab-map-01

list -c 在会话列表中显示条目数；export -f stdout 在屏幕查看；stats 统计 svmap 横幅；search 在该会话中检索包含 Asterisk 的横幅字符串。以上操作读取本地会话，不产生新的 SIP 测试。

sipvicious_svreport export -t svmap -s lab-map-01 \
  -f xml -o lab-map-01.xml -n
# 仅在需要 PDF 且已安装 reportlab 时使用
sipvicious_svreport export -t svmap -s lab-map-01 \
  -f pdf -o lab-map-01.pdf -n
# 确认已留存必要结果后，才删除这个本地会话
sipvicious_svreport delete -t svmap -s lab-map-01

删除只针对指定的本地保存会话，不能撤销它曾发送的 SIP 请求，也不会清理 PBX 日志。search 子命令可在 svmap 横幅结果中检索；复杂集成更适合先导出 CSV 后处理。

sipvicious_svmap --resume lab-map-01
sipvicious_svwar --resume lab-war-01
sipvicious_svcrack --resume lab-auth-01 -u 1001

--resume 用于未完成会话的继续执行。已经完成的结果不要用恢复来代表一次新的整改复测；重测应使用新的 -s 会话名，并记录配置版本。

sipvicious_svcrash --help

它的 -d 是旧版扫描器的 IP，-p 是该扫描器的端口；--auto 与 --astlog 是历史自动响应/日志输入模式，-b 是端口尝试。它针对旧版扫描器自身的已修复问题，不是“把 PBX 测崩”的工具。常规内部产品验收无需运行这类响应。[S7]

rc=0
sipvicious_svwar -e 1001-1003 -p 5060 \
  -s lab-ci-01 192.168.56.10 > lab-ci-01.log 2>&1 || rc=$?
printf "svwar exit=%s\n" "$rc"
sipvicious_svreport export -t svwar -s lab-ci-01 \
  -f txt -o lab-ci-01.txt

这段只负责保留证据，不把某个数字硬编码成普适通过条件。若本地会话未创建，导出失败也应记录；正式流水线还要设置进程总超时、明确目标清单，并核查产品日志。

测试日期 / 执行人：
产品版本 / 配置版本：
测试机 IP / 来源网段：
目标 IP / SIP 端口 / UDP：
SIP 域 / realm / 认证用户名 / 分机：
已知存在 / 不存在的对照账户：
本次命令 / 会话名 / 候选集合：
预期结果 / 实际输出 / 退出码：
PBX 日志 / 抓包位置 / 认证次数：
是否触发锁定 / 是否完成对话清理：
整改项 / 复测会话 / 未覆盖范围：

完整回归至少要有：已知服务发现成功、存在/不存在号码对照、有限候选认证、服务端日志对账、结果导出，以及整改后的同条件复测。