第二周进展

Wireshark lua插件开发第二周进展

本周在Wireshark lua插件开发方面取得了以下进展：

1. Lua简介

Lua是一种轻量级的脚本语言，它不需要编译器等额外的工具，可以直接进行解释执行。Lua的基本语法可以参考官网或者菜鸟教程。Wireshark内置对Lua脚本的支持，无需额外的配置，使用起来非常方便。如果需要更详细的文档资料，可以查阅Wireshark Developer's Guide中的第10章和第11章，这些章节详细介绍了Lua的支持。

2. Wireshark Lua插件基本结构

Wireshark Lua插件主要由两个重要的概念组成：Dissector（解剖器）和DissectorTable（解剖器表）：

• Dissector（解剖器）用于解析特定协议的类，我们需要在这部分进行编写。
• DissectorTable（解剖器表）用于组织不同的解析器，使得Wireshark能够根据协议选择合适的解析器。

3. 编写Lua插件实例

以下是本周编写的一个简单的Lua脚本示例，并在Wireshark中启用：

do
    -- 定义协议名称和描述
    local myProtocol = Proto("MyProtocol", "Custom Protocol")

    -- 定义协议字段
    local f_field1 = ProtoField.uint8("MyProtocol.field1", "Field 1", base.HEX)
    local f_field2 = ProtoField.uint16("MyProtocol.field2", "Field 2", base.HEX)

    -- 将字段添加到协议
    myProtocol.fields = {f_field1, f_field2}

    -- 获取data解析器
    local data_dissector = Dissector.get("data")

    -- 解析器函数
    local function myProtocol_dissector(buf, pkt, root)
        local buf_len = buf:len()

        -- 根据协议报文格式判断是否为自定义协议
        if buf_len < 3 or buf(0, 1):uint() ~= 0xAA then
            -- 不是自定义协议，调用data解析器
            return data_dissector:call(buf, pkt, root)
        end

        -- 提取字段值
        local field1_value = buf(1, 1):uint()
        local field2_value = buf(2, 2):uint()

        -- 在Packet Details窗口显示协议信息
        local tree = root:add(myProtocol, buf)
        tree:add(f_field1, buf(1, 1)):append_text(", Field 1: " .. field1_value)
        tree:add(f_field2, buf(2, 2)):append_text(", Field 2: " .. field2_value)

        -- 设置Packet List窗口的协议列
        pkt.cols.protocol = "MyProtocol"

        -- 返回true表示成功解析
        return true
    end

    -- 将解析器函数注册到协议解析器
    function myProtocol.dissector(buf, pkt, root)
        myProtocol_dissector(buf, pkt, root)
    end

    -- 将协议解析器添加到udp.port解析器表，监听特定端口
    local udp_table = DissectorTable.get("udp.port")
    udp_table:add(12345, myProtocol)
end

4. 启用Lua插件

为了启用Lua插件，按照以下步骤进行操作：

• 将以上代码保存为一个lua文件，例如my_protocol.lua。
• 打开Wireshark，选择菜单【文件】-【全局配置文件夹】，找到init.lua文件。
• 在init.lua文件末尾添加以下内容：dofile("path/to/my_protocol.lua")，将路径替换为实际文件路径。
• 确认你的Wireshark版本支持Lua插件（Windows版本默认应该启用了支持）。可以通过【帮助】-【关于】窗口来确认