面向 2G GSM、3G UMTS、4G LTE 和 5G NR 空口、核心网、SIM 身份、射频追踪与攻击分析的 GTK4 与 CLI 蜂窝安全工具包,包含 57 个模块。
一个面向 Linux 的 GTK4 蜂窝安全工具包,背后配有完整的 CLI。Shell 模块覆盖 2G/GSM、3G/UMTS、4G/LTE 和 5G/NR,并支持基于抓包的被动分析以及按代际划分的 CVE 工具集。
每个模块都是独立脚本。GUI 只是这些脚本之上的一个视图,而非容器——没有任何功能被锁在界面之后。
处于早期开发阶段,并对此坦诚。 此代码树中没有任何模块曾在真实无线电上运行过。构建它的机器上没有 SDR,因此每一条空口路径虽已编写并经过审查,但并未测试。实际可用功能一节明确说明了哪些是哪些,在提交 bug 之前值得一读。
蜂窝工具按层和按代际割裂。gr-gsm 是 2G。srsRAN 是 4G/5G。Osmocom 是底层协议栈。Wireshark 解析你抓到的数据,但不会替你抓取,而且它们都不共享同一个目标视图。
此代码树刻意做得宽泛:一个工作台、一个启动器、一个地方,让小区勘察、NAS 解码、Diameter 消息和加密审计都落到同一个 TSV 中。
它另一处不同之处在于:大多数工具会告诉你它们成功了。 而这个工具被设计为在它们没有成功时告诉你。每个模块都有 --selftest,受硬件限制的模块会指明缺失的无线电设备,而不是返回空结果,无法完成工作的模块会以非零状态退出,而不是报告成功。
没有任何模块设有审批门。 不会因为未先设置某个标志或环境变量而拒绝执行。已废弃的 --i-have-a-lab-and-authorisation、--ack-isolated-lab、LTE_ARMED、NR_ARMED、MAP_ARMED、FEMT_S1_ARMED、SBA_ARMED、BEXP_TX_ARMED、NRJ_TX_ARMED 和 JAMD_LAB_AUTHORISED 会被接受并忽略,因此旧命令行仍可继续工作。bash modules/00_deps.sh --preflight 会在一页中打印机器的状态。
构建 GUI:
cd native
meson setup builddir
meson compile -C builddir
然后,从项目根目录执行:
sudo ./imsisting.sh # CLI menu
./imsisting.sh --list # module list
./imsisting.sh --index # the module index as TSV
./imsisting.sh --gui # launch the GUI
./imsisting.sh --tui # launch the TUI (modules listed by their menu keys)
或直接启动已构建的二进制文件:
./native/builddir/imsisting-gui
快捷方式。 仓库提供了 bin/ 包装脚本,因此你可以直接输入 imsisting、imsisting-gui、imsisting-tui,而无需使用完整路径。将它们添加到你的 PATH 中:
export PATH="$PWD/bin:$PATH" # add to ~/.bashrc or ~/.profile
imsisting --list # works from any directory
imsisting-gui # launch the GUI
imsisting-tui # launch the TUI
GUI 每次操作都会通过 pkexec 请求你的密码,而不是在启动时一次性请求。
必需: GTK4(4.14+)、meson、ninja、C 编译器、python3。
# Debian / Ubuntu
sudo apt install build-essential meson ninja-build libgtk-4-dev \
python3 python3-numpy python3-scipy
# Arch
sudo pacman -S base-devel meson ninja gtk4 python python-numpy python-scipy
可选但特定模块会用到: gnuradio + gr-gsm、srsRAN、
Open5GS/free5GC、tshark、pcsc-tools、gpsd、python3-cryptography。
00_deps 会报告哪些已存在、哪些缺失,并区分已安装的工具
与真正完整的协议栈。
解码能给你一个身份;参考表能给你一个归属。它们是 公开的,但不会随附发布,因为数据有数十万行且会 过时——每次检出后运行一次抓取器:
tools/fetch-reference-data.sh # ~2 500 PLMNs, ~6 300 ISPCs, ~67 000 PENs
tools/fetch-reference-data.sh --check # what is present, without downloading
查找会区分三种状态,工具包绝不会将它们混为一谈:ok(运营商)、absent(寄存器已被读取,且不存在这样的行——这正是发现结果),以及 silent(该表不在这台机器上——答案是未观测,而非否定)。02_cell_recon --status-tsv 在 plmn_register 下报告寄存器;26_ss7_map --ispc 在每次查找时打印 owner_state。
data/opops/ 是私有部分:由运营商提供的表,用于全局标题前缀、小区标识块、核心地址范围和 SMSC 标识。该目录树只附带加载器和模式,从不附带内容,并将缺失文件报告为 silent,而不是空答案。
GUI 打开时显示一个 Dashboard——每个模块都是一张卡片,按类别分组。点击卡片,模块会作为自己的标签页打开。六个标签页是永久的:
| 标签页 | 说明 |
|---|---|
| Dashboard | 每个模块都是一张卡片,按类别分组。主菜单。 |
| Live Traffic | 实时 GSMTAP 视图(见下文)。打开时开始监听。 |
| Casebook | 案件、选中的小区、证据/捕获、时间线、IDS 告警、被动传感器节点以及 HTML/JSON/TSV 报告。Evidence 页面保留按模块的 loot 浏览器和预览。 |
| Map | 一张永久地图,用于显示工具包定位到的一切:小区、TA 环、地理定位帧以及来自 loot/map/layers/*.tsv 的区域,绘制在捆绑的 Natural Earth 底图上。可平移、缩放和切换图层。 |
| Fleet | 远程节点以及每个节点测量到的内容:类别、传输方式、角色、能力、最后出现时间以及其事件流落后多少。勘察节点、收集流窗口、将其复制到案件中,或派发模块在那里运行。 |
| Stats | 模块和收集计数、健康状态行,以及工具包在哪些方面内容充实。 |
| Notifications | 目录树决定告诉你的内容,最早的在前。 |
| Help | 目录树如何组合在一起,以及如何驱动它。 |
| Settings | 环境事实,以及依赖和 SDR 探测操作。 |
| Workflows | 已保存的链,从面板运行。 |
模块标签页会出现在这些标签页旁边,并且可以关闭;永久标签页则不能关闭。
Settings → Interface → Theme 可在两个调色板之间切换整个工作台:Night,即应用绘制时所用的蓝黑色调色板;以及 Ember,同一个工作台,温度高一度——接近黑色的表面带有暖色偏向,并有一个单一的余烬强调色。
更改生成器后:
tools/gen-theme.py # write native/resources/theme-ember.css
tools/check-theme.sh # packaged? generated? in step with the base sheet?
cd native && ninja -C builddir
tools/check-theme.sh 的存在是因为一个未打包的主题会静默失败:GTK 绘制基础样式表,而下拉菜单仍然显示 "Ember"。GUI 的 --selftest 断言同样的事情(gui-theme-ember PASS packaged)。
扫描不必发生在你面前的机器上。任何读取空口数据的模块都可以指向一个已注册的节点,节点会用它实际测量到的数据来回应:
modules/02_cell_recon.sh --node desk # survey through the node, store rows here
modules/03_gsmtap.sh --node desk # fetch its newest capture and decode it
modules/17_pcap_analysis.sh --node desk # list the captures that node holds
modules/18_imsi_exposure.sh --node desk # audit the node's newest capture
tools/node_source.py support # what each transport can answer
tools/node_source.py cells desk # the node's cells, in the store's table
tools/node_source.py events desk # the node's spool, as event rows
tools/node_source.py captures desk # the node's capture store
抓取到的数据会保存到 captures/nodes/<name>/,因此之后每个现有动词都能在本地路径上操作,存储中会同时保留这两类文件。
一个节点能如实提供什么取决于它的传输方式,工具包会明确说明这一点,而不是含糊带过:local 和 ssh 节点会执行真实勘察,adb 手机上报自身的服务小区和邻区,并标记出被隐去的字段,serial/qmi/mbim 调制解调器只上报一个服务小区,并会如此标注,而 diag/sms 会拒绝执行,并指出缺失的条款。每一行都带有 source node:<name>:<transport>:<kind>,因此表格永远不会丢失某个小区是在哪里被监听到的。存储为空的节点表示交接(退出码 3),而不是空勘察。
模块页面是一个左侧视图菜单,内容位于其旁,按卡片分组——STATUS、ACTIONS 和 ALL MODULE VERBS。操作按钮涵盖你最常用的动词;生成的选择器由模块索引构建,并暴露其余所有内容,配有单独的参数字段和命令复制按钮,因此没有任何内容不可达。
Live Traffic 是一个真实表格(sequence、time、type、channel、ARFCN、timeslot、signal、direction、length、payload),上方有一个筛选框,可按 type、channel 或 payload 匹配。上行链路行会被标记。
仪表盘可配置,并且会记住配置。 每张卡片都带有一个星标:无论排序设置如何,固定模块都会排在网格最前面。Sort 提供 Workflow(类别顺序)、Most used(按运行次数)、Name 和 Category,Density 可切换 Compact、Comfortable 或 Spacious 卡片尺寸。所有这些在重启后都会保留,因为它们存放在 state/ 中,而不是二进制文件里——并且两个搜索都会显示 no match,而不是悄悄留空。
Stats 以磁贴显示主要计数,以条形图显示按类别细分,并显示所有内容在磁盘上的位置。打开时会重新统计,因此刚写入战利品的模块不会仍显示启动时的数字。
左侧的模块列表可以折叠——通过标题栏中的 Modules 按钮。当模块页面需要全宽时,将其折叠。
标题栏显示实时蜂窝状态,直接从模块本身读取,因此不会与模块不一致:
SDR 所选无线电(01_radio --status-tsv)
TX 该无线电是否可以发射——大多数攻击动词需要此项
FREQ 已调谐频率
CELLS 勘察存储中的小区(02_cell_recon)
GPS 勘察位置来源(04_tower_map)
--tab N 可直接打开某个标签页(0 Dashboard、1 Live Traffic、2 Casebook、3 Stats、4 Notifications、5 Help、6 Settings、7 Workflows、8 Map、9 Fleet):
./native/builddir/imsisting-gui --tab 1
在 GUI 进程内无法对 GSM 或 LTE 进行解调;那需要完整的 PHY。因此这不是原始无线电视图,也不假装是。
它是什么:一个监听 UDP 4729 的 GSMTAP 监听器。GSMTAP 是 gr-gsm、srsRAN 和 Open5GS 都会输出的格式,也是 Wireshark 所依据的格式。该标签页绑定端口,在每条消息到达时解码其 16 字节头部,并显示类型、GSM 信道、ARFCN、时隙、信号、方向、长度和载荷。
这使得它在两方面都有用——被动地观察寻呼、SI 和身份交换的发生,以及主动地确认发射器确实在发射,并查看 UE 的应答内容。
它需要一个上游发射器。如果三秒内没有数据到达,它会说明这一点并指出应启动什么,而不是显示一个空面板:
grgsm_livemon # GSM, via gr-gsm
# or an eNB/gNB started with GSMTAP enabled
两个诚实的限制。头部的 arfcn 字段是 16 位,因此 NR-ARFCN(其数值可达数百万)无法在其中表示——该字段并非通用的 NR ARFCN 载波。而 sub_type 仅在 GSM 载荷下才是 GSM 信道类型;在 LTE/NR 下它不是信道,因此该列显示 —,而不是一个看似合理但错误的名称。
--status-tsv。它无需连接无线电即可工作,因此是一个很好的冒烟测试。六十一个模块,按应用程序自身使用的类别分组,因此此列表与 Dashboard 不会出现偏差。模块记录的每个动词在其页面上都有对应控件,每个页面都在发起请求的卡片中作答:单条记录返回值列表,多条记录返回记录列表并附带逐行 Copy。