URH（Universal Radio Hacker）使用手册模板

URH（UniversalRadioHacker）使用手册URH是一款开源无线协议分析工具，用于SDR信号捕获、解调、协议逆向、信号生成与重放，适配RTLSDR、HackRF、USRP等设备，支持Linux/Windows/macOS，广泛用于物联网、遥控、私有无线协议分析。一、安装与环境准备1.软件安装Linux/macOS：pip3installurh（需Python3.8+）Windows：下载安装包或通过pip安装；RTLSDR需用Zadig安装WinUSB驱动依赖：自动安装NumPy、PyQt5、SciPy等；SDR设备需对应驱动（如rtlsdr、hackrf）2.硬件连接与驱动插入SDR设备（如RTLSDRBlogV4）Linux：安装驱动包（sudoaptinstallrtlsdr），添加udev规则避免权限问题Windows：用Zadig替换驱动为WinUSB启动URH，进入编辑→选项→设备，确认设备被识别二、核心界面与标签页URH主界面分5个核心标签页，覆盖捕获→分析→解码→生成→仿真全流程：Interpretation（解析）：查看原始IQ波形、频谱，标记信号段Analysis（分析）：解调、比特流提取、协议字段标注、消息对比Generator（生成）：编辑/构造数据包、导出信号、重放配置Simulation（仿真）：有状态协议交互仿真、模糊测试、流程建模Receive（接收）：实时频谱扫描、信号录制、参数配置三、信号捕获（Receive/Record）1.启动捕获（两种方式）方式1：实时接收（Receive标签）进入Receive标签，选择SDR设备（如RTLSDR）配置核心参数：中心频率：目标信号频率（如433.92MHz、868MHz、2.4GHz）采样率：匹配信号带宽（常用1–4MSPS）增益：自动/手动（20–40dB，避免饱和）带宽：滤波器带宽（略大于信号带宽）点击Start，实时查看频谱图与波形；找到目标信号后点击Record录制方式2：文件录制（File→RecordSignal）打开File→RecordSignal，设置参数后开始录制录制完成点击Save，保存为.complex16或.wav格式2.捕获要点先频谱扫描（宽采样率）定位信号，再缩小带宽精准捕获录制时长≥3次完整通信，确保包含完整消息序列避免信号饱和（波形削顶），适当降低增益四、信号解析与解调（Interpretation+Analysis）1.信号预处理（Interpretation）打开录制文件，在波形区用鼠标框选有效信号段（蓝色高亮）裁剪无用噪声，保留完整消息包切换视图：IQ波形、幅度、相位、频谱，观察信号特征2.自动/手动解调（Analysis标签）进入Analysis，URH自动检测调制类型（ASK/FSK/PSK）手动调整解调参数（关键）：调制方式：ASK（幅度）、FSK（频移）、PSK（相移）符号率：信号波特率（如1k、2.4k、10k）采样点/符号：匹配符号率与采样率同步字：设置帧头同步码（如0xAA、0x55）解调成功后，下方显示比特流（Bits）、十六进制（Hex）、ASCII3.协议字段标注（核心逆向步骤）在比特流中框选字段，右键AddLabel，命名（如Sync、ID、Cmd、Data、CRC）用Compare对比多包数据，找出固定/可变字段（如地址、命令码）标注长度、偏移、数据类型，生成协议结构模板五、协议解码与验证（Analysis→Decode）在Analysis→Decode标签，配置解码规则：字节序：大端/小端校验：CRC8/16/32、校验和（自动计算验证）字段映射：将比特映射为数值、枚举、字符串应用解码后，查看结构化消息，验证协议逻辑（如命令→响应）六、信号生成与重放（Generator）1.构造数据包进入Generator，基于已标注协议新建消息编辑字段值（修改ID、命令、数据）支持批量生成、随机模糊测试字段2.信号重放（关键操作）配置重放参数：中心频率、采样率、增益、重复次数选择SDR发送设备（如HackRF）点击Transmit，发送构造的信号观察目标设备响应，验证重放有效性七、有状态协议仿真（Simulation）进入Simulation，创建参与者（如设备A、设备B）用流程图定义交互逻辑：发送→等待响应→条件判断→循环实时修改字段值，模拟动态协议（如带序列号、加密挑战的通信）用于重放攻击、模糊测试、协议漏洞挖掘八、常见问题与排查表格问题排查方法设备未识别检查驱动；Linux添加udev规则；Windows用Zadig换驱动无信号/噪声大提高增益；检查天线；降低采样率；缩小带宽解调失败确认调制方式；校准符号率；调整同步字；重新捕获重放无效核对频率/采样率；检查设备发射权限；确认协议时序字段解析错误对比多包数据；修正字节序/校验；重新标注九、核心快捷键新建录制：Ctrl+R保存：Ctrl+S播放/暂停：Space放大波形：Ctrl++缩小波形：Ctrl+-框选信号：鼠标拖动添加标签：右键→AddLa