wireshark 用LUA二次开发插件 解析器（Dissector）

LUA菜鸟教程：https://www.runoob.com/lua/lua-functions.html

在线编辑运行器：https://www.runoob.com/try/runcode.php?filename=HelloWorld&type=lua

【参考】

https://www.cnblogs.com/zzqcn/p/4846745.html

https://blog.csdn.net/wangquan1992/article/details/100161021

前言

Wireshark是一款流行的网络协议分析工具，它支持多种协议的解析，并且允许用户通过编写插件来扩展其功能。Lua是一种轻量级的编程语言，它被集成到Wireshark中，允许用户编写脚本来自定义协议解析逻辑。

协议

Protocol: TCP 0x6（6）

UDP 0x11 (17)

===========================================================

1. 环境准备

• 安装Wireshark：确保你的系统上已经安装了Wireshark。
• 创建插件文件夹：Wireshark安装目录下plugins的子文件夹，用于存放Lua插件。

  2. 解析器 Dissector

  解析器（Dissector）是Wireshark中的概念，用于解析协议，将报文中对应的Bytes转为相应的字段值，可以简单理解为Wireshark中的解码器。

  它不只能解析将相应位置的Bytes转为对应字段，还能将解析出来的字段用于报文过滤，还能自定义信息（Info）列中显示的自定义信息。

  能方便开发人员调试诊断协议相关问题，比如断连后不重连，报文不正确，未发心跳。

  解析器组成部分：

  协议定义

  字段定义

  协议和字段关联

  解析器主函数

  协议注册

  3. 编写Lua插件

  • 创建Lua文件：在plugins文件夹中创建一个新的Lua文件，例如myplugin.lua。

  • 定义协议：在Lua文件中定义一个新的协议，例如：

    local myproto = Proto("myproto", "My Protocol")
    local ptype = ProtoField.uint8("myproto.ptype", "Type", base.DEC)
    local pval = ProtoField.uint16("myproto.pval", "Val", base.HEX)
    local pbyte = ProtoField.new("Bytes", "myproto.bytes", ftypes.BYTES)
    local pstr = ProtoField.new("Str", "myproto.str", ftypes.STRING)
    myproto.fields = {ptype, pval, pbyte, pstr}
    

  • 编写解析函数：定义一个函数来解析数据包，例如：

    function myproto.dissector(tvb, pinfo, tree)
      local offset = 0
      tree:add(ptype, tvb(offset, 1))
      offset = offset + 1
      tree:add(pval, tvb(offset, 2))
      offset = offset + 2
      tree:add(pbyte, tvb(offset, tvb:len() - offset))
      tree:add(pstr, tvb(offset, tvb:len() - offset))
    end
    

  • 绑定协议到端口：如果需要将你的协议绑定到一个特定的端口，可以使用以下代码：

    local udp_port = 12345
    local udp_dissector_table = DissectorTable.get("udp.port")
    local myproto_dissector = Dissector.get("myproto")
    udp_dissector_table:add(udp_port, myproto_dissector)
    

    4. 调试和测试

    • 使用Lua控制台：Wireshark提供了一个Lua控制台，你可以在这里运行Lua代码来测试你的插件。