在桌面系统上用 libpcap 驱动 Mongoose 内置 TCP/IP 协议栈（pcap-driver 实战指南）

在桌面系统上用 libpcap 驱动 Mongoose 内置 TCP/IP 协议栈pcap-driver 实战指南【免费下载链接】mongooseEmbedded web server, with TCP/IP network stack, MQTT and Websocket项目地址: https://gitcode.com/gh_mirrors/mon/mongooseMongoose 自带的 TCP/IP 协议栈MIP位于 src/net_builtin.c原本主要面向嵌入式硬件但它与硬件解耦得足够彻底任何实现了收包、发包、链路轮询三个回调的驱动都能把它搬到桌面系统上。本指南基于仓库中的 tutorials/tcpip/pcap-driver/README.md 及其配套示例 tutorials/tcpip/pcap-driver/main.c完整讲解如何在装有 libpcap 的 macOS / Linux 系统上通过 pcap 接口让 Mongoose 协议栈跑在一台真实电脑上。读完本文你将掌握示例的构建与命令行用法、pcap_tx / pcap_rx / pcap_poll三个驱动的实现原理以及 macOS 的feth双端虚拟网卡方案和 Linux 的 veth 桥接 / 转发三种网络接入拓扑。示例概览pcap 驱动的定位与原理libpcap 是各类抓包工具tcpdump、Wireshark的底层库它提供两个关键 APIpcap_next_ex()从接口读取下一个数据包pcap_inject()向接口注入写入一个数据包。pcap-driver 示例正是用这两个 API 把 Mongoose 的 TCP/IP 协议栈接到操作系统的一张真实或虚拟网络接口卡上。应用打开一个网络接口后收包走pcap_next_ex()发包走pcap_inject()。整个示例的骨架在 tutorials/tcpip/pcap-driver/main.c只实现了三个函数static size_t pcap_tx(const void *buf, size_t len, struct mg_tcpip_if *ifp) { int res pcap_inject((pcap_t *) ifp-driver_data, buf, len); if (res PCAP_ERROR) { MG_ERROR((pcap_inject: %d, res)); } return res PCAP_ERROR ? 0 : len; } static bool pcap_poll(struct mg_tcpip_if *ifp, bool s1) { return s1 ifp-driver_data ? true : false; } static size_t pcap_rx(void *buf, size_t len, struct mg_tcpip_if *ifp) { size_t received 0; struct pcap_pkthdr *hdr NULL; const unsigned char *pkt NULL; usleep(1000); // Sleep 1 millisecond. This is to avoid 100% CPU if (pcap_next_ex((pcap_t *) ifp-driver_data, hdr, pkt) 1) { received hdr-len len ? hdr-len : len; memcpy(buf, pkt, received); } return received; }这三者与协议栈的接口约定定义在 src/net_builtin.hstruct mg_tcpip_driver { bool (*init)(struct mg_tcpip_if *); // One-time hardware init; return false on failure size_t (*tx)(const void *, size_t, struct mg_tcpip_if *); // Transmit one raw frame; return bytes sent size_t (*rx)(void *buf, size_t len, struct mg_tcpip_if *); // Read one raw frame; return frame size, 0 if none. NULL for interrupt-driven drivers bool (*poll)(struct mg_tcpip_if *, bool); // Check link status; second arg is true once per second. Return trueup, falsedown };对照可以看出pcap_tx对应tx回调把协议栈封装好的一帧原始以太网数据交给pcap_inject()注入接口pcap_inject返回PCAP_ERROR即 -1时按发送失败处理并记日志pcap_rx对应rx回调用pcap_next_ex()从接口取一帧拷贝到协议栈提供的缓冲区返回收到的字节数无包返回 0其中usleep(1000)是刻意为之——协议栈以轮询方式驱动如果收包循环不加 1ms 休眠示例会把 CPU 跑满pcap_poll对应poll回调用于上报链路状态这里只要接口句柄有效就认为链路处于 UP接口句柄pcap_t *存放在ifp-driver_data中由 main.c 组装进struct mg_tcpip_if并调用mg_tcpip_init(mgr, mif)完成协议栈初始化。协议栈侧的驱动调用点在 src/net_builtin.c 中发送帧走ifp-driver-tx(...)第 381 行轮询时通过ifp-driver-poll(...)判断链路第 2145 行而rx非空则按简单轮询驱动逐帧收取第 2159-2161 行。构建与运行Makefile 与命令行参数示例的构建脚本是 tutorials/tcpip/pcap-driver/Makefile它把 main.c 和仓库根目录的 mongoose.c 编译成一个可执行文件examplePROG ? example SOURCES main.c mongoose.c CFLAGS -W -Wall -Wextra -g -I. CFLAGS -lpcap # Mongoose build options. See https://mongoose.ws/documentation/#build-options CFLAGS_MONGOOSE -DMG_ENABLE_LINES1 -DMG_ENABLE_TCPIP1 -DMG_ENABLE_SOCKET0 CFLAGS_MONGOOSE -DMG_ENABLE_TCPIP_DRIVER_INIT0 CFLAGS_EXTRA ? -DMG_TLSMG_TLS_BUILTIN几个关键的构建选项含义如下-lpcap链接 libpcap宿主系统必须已安装该库MG_ENABLE_TCPIP1启用 Mongoose 内置 TCP/IP 协议栈MG_ENABLE_SOCKET0关闭标准 socket 后端本示例完全依靠内置协议栈MG_ENABLE_TCPIP_DRIVER_INIT0禁止协议栈调用驱动自带的init因为 pcap 接口的打开工作pcap_open_live由示例自己完成MG_TLSMG_TLS_BUILTIN启用 Mongoose 内置 TLSmbedTLS 的移植实现示例同时监听 HTTPS 端口并连接 MQTTS broker 时依赖它若宿主是 WindowsMinGWMakefile 会自动改用.exe输出并链接-lws2_32。构建并直接运行make的all目标会在编译后立即执行程序$ make -C tutorials/tcpip/pcap-driver/ clean all ARGS-i feth0运行参数在 main.c 的命令行解析中定义参数默认值说明-i ifacelo0要打开的 pcap 网络接口名-mac mac02:00:01:02:03:77赋给协议栈的 MAC 地址格式hh:hh:hh:hh:hh:hh-bpf expr无可选的 BPF 过滤表达式用于减少抓包噪声如host x.x.x.x or ether host ff:ff:ff:ff:ff:ff-v levelMG_LL_DEBUG代码内mg_log_set调用设置日志级别在部分 Linux 系统上打开 pcap 设备需要 root 权限因此直接运行通常写作$ sudo tutorials/tcpip/pcap-driver/example -i my0打开接口的过程在 main.cpcap_open_live(iface, 0xffff, 1, 1, errbuf)打开接口、pcap_setnonblock(ph, 1, errbuf)设为非阻塞配合轮询、pcap_setdirection(ph, PCAP_D_IN)只接收入向包若指定了-bpf还会用pcap_compilepcap_setfilter安装 BPF 过滤器。打开失败时会调用pcap_findalldevs列出系统上所有可用接口方便排查接口名写错的情况。程序启动后默认提供两个 HTTP 服务http://0.0.0.0:8000对应处理函数 http_ev_handler内置/api/debug动态调整日志级别、/api/md5对请求体算 MD5、/api/url把请求体中的 URL 交给内置协议栈发起 HTTP 请求并回显响应三个接口https://0.0.0.0:8443TLS 握手使用内置在示例中的 ECC 证书/私钥s_tls_cert/s_tls_key。同时当接口进入已就绪状态时示例还会向mqtts://mongoose.ws:8883发起 MQTTS 连接并订阅主题mg/rx见 if_ev_handlerMQTT 收到消息时会打日志打印主题与载荷。一个必须注意的前提注入包的回环问题README 在开头就强调了一个依赖 libpcap 实现细节的坑取决于 libpcap 实现注入的包可能回环loop back到该接口自身的 TCP/IP 协议栈也可能不会。如果不会回环就必须创建另一个与目标接口桥接的独立接口——见下面的 macOS 示例。pcap_inject()是把帧塞进接口驱动但塞进去的帧是否会像真实收到的帧一样被协议栈处理完全取决于平台。正因为存在这种不确定性README 给出的所有拓扑都避免让示例直接跑在一张真实网卡上要么用虚拟接口对macOSfeth/ Linuxveth要么在接口对之外再叠加桥接或 NAT。这也解释了为何默认接口名是lo0——回环接口天然会把注入的帧回环给自己。macOS 环境搭建feth 虚拟网卡对macOS 支持fethfake ethernet接口。可以创建一对feth接口并互相指认对方为 peer一旦某个feth接口被指定了 peer 并配上 IP注入到它的任何帧都会出现在 peer 接口上反之亦然——这正是我们想要的注入回环能力。创建并连接一对 feth 接口$ sudo ifconfig feth0 create $ sudo ifconfig feth1 create $ sudo ifconfig feth1 peer feth0 # Link two fake ethernet ifaces together $ sudo ifconfig feth1 10.10 # Assign 10.0.0.10 to feth1 $ sudo ifconfig feth0 up $ sudo ifconfig feth1 up注意ifconfig feth1 10.10这条命令会分配10.0.0.10macOS 的简写语法。执行后feth0与feth1已经互连并处于激活状态。通过 Internet Sharing 接入外网要让 Mongoose 能访问外网需要把它接入宿主的路由体系。在 macOS 的系统偏好设置 → 共享中开启互联网共享Internet Sharing并选择 Thunderbolt bridge这会在bridge0接口上启用 DHCP 服务bridge0是所有 Thunderbolt 设备的桥向 WiFi 接口添加必要的路由。典型效果是bridge0拿到192.168.2.1为192.168.2/24网段提供 DHCP。然后把一个虚拟接口挂进这个桥$ sudo ifconfig bridge0 addm feth1之后用feth0运行示例$ make -C tutorials/tcpip/pcap-driver/ clean all ARGS-i feth0整体拓扑README 原图┌──────────► 192.168.2.1 bridge0 │ routing DHCP │ │ ┌──────────────────┴──────────────────┐ ▼ │ │ 192.168.2.17 │ ┌─────────┐ fake ethernet pair ┌─────────┐ 192.168.0.10 │ │ feth1 ├────────────┬───────┤ feth0 │ ┌─────────┐ │ └─────────┘ │ └────┬────┘ │ en0 │ │ │ │ └────┬────┘ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ │ │ en1 │ │ en2 │ │ en3 │ │ pcap-driver │ └────┬────┘ └────┬────┘ └────┬────┘ │ WiFi │ │ │ │ │ └──────┼───────────┼───────────┼──────┘ │ │ │ │ ▼ Internet Thunderbolt Ethernet数据流向是feth0上由 Mongoose 发出的帧 → 出现在feth1→bridge0收到 → 经路由/DHCP 转发到en0WiFi走向互联网返回流量沿反方向回到feth0。Mongoose 侧看到的是192.168.2.17DHCP 从bridge0分配。Linux 环境搭建veth 虚拟接口对Linux 侧的思路类似用veth创建一对管道接口包从一端注入就从另一端出来。README 给出的快速选项有三种打开回环设备通常是loMongoose 只能从本机访问同时能看到自己流量的回显打开以太网/WiFi 设备以太网通常是eth0或enpXsYMongoose 可以访问网络和互联网但本机内不可达若已有虚拟桥接口用于连接多台虚拟机等通常是br0或virbr0可以打开它但行为与直接打开底层物理接口一致。其中打开物理接口就是典型的注入不回环场景会失去本机可达性因此 README 建议的最佳实践是创建一张虚拟接口对按需叠加使用、桥接或转发/伪装$ sudo ip link add my0 type veth peer [name] my1 $ sudo ip link set my0 up $ sudo ip link set my1 up在部分系统如 RHEL7上name是必填的其他系统可省略因此文档用方括号[name]标注。方案一当纯虚拟接口用仅本机可达与使用回环设备类似Mongoose 仅能从宿主机器访问但之后可以随时追加转发和伪装。流程是给管道一端配上 IP$ sudo ip addr add 192.168.0.1/24 dev my1在该接口上启动 DHCP 服务器服务192.168.0.x网段或者反过来让 Mongoose 使用该网段内的固定地址。打开管道另一端运行示例$ make -C tutorials/tcpip/pcap-driver/ clean all ARGS-i my0部分系统需要超级用户权限$ sudo tutorials/tcpip/pcap-driver/example -i my0拓扑[DHCP server for 192.168.0.x] 192.168.0.1 192.168.0.x ┌─────────┐ virtual eth pair ┌─────────┐ │ my1 ├────────────────────┤ my0 │ └─────────┘ └────┬────┘ │ │ pcap-driver由于此时无法访问工作站之外的任何主机所需的公共服务如 DNS必须配在my1这一端并在 Mongoose 侧做相应配置。这是最基础的拓扑后续两种方案都建立在它之上。方案二桥接到现有网络本机 局域网均可达把 veth 的一端挂到桥接设备上桥同时挂载你的物理网卡。这样 Mongoose 既能访问网络并经由它访问互联网也能被本机与局域网内其他主机访问。若还没有桥接接口先创建并把物理网卡挂上去。注意你的 IP 要改配到桥上而不是网卡若用 DHCPDHCP 客户端也必须跑在桥接口上$ ip link add virbr0 type bridge $ sudo ip link set virbr0 up $ sudo ip addr del 10.1.0.10/24 dev enp9s0 $ sudo ip link set enp9s0 master virbr0 $ sudo ip addr add 10.1.0.10/24 dev virbr0用ifconfig检查并尝试 ping 局域网内主机验证。把 veth 的一端挂到桥$ sudo ip link set my1 master virbr0确认接口对处于 UP 状态$ ip link show master virbr0 2: enp9s0: BROADCAST,MULTICAST,UP,LOWER_UP mtu 1500 qdisc pfifo_fast master virbr0 state UP mode DEFAULT group default qlen 1000 link/ether 30:5a:3a:08:db:90 brd ff:ff:ff:ff:ff:ff 396: my1my0: BROADCAST,MULTICAST,UP,LOWER_UP mtu 1500 qdisc noqueue master virbr0 state UP mode DEFAULT group default qlen 1000 link/ether b6:ee:bc:53:f2:6e brd ff:ff:ff:ff:ff:ff打开另一端的my0运行示例$ make -C tutorials/tcpip/pcap-driver/ clean all ARGS-i my0同样部分系统需要sudo tutorials/tcpip/pcap-driver/example -i my0。拓扑10.1.0.10 virbr0 │ ┌──────────────────┴──────────────────┐ │ │ 10.1.0.x │ ┌─────────┐ virtual eth pair ┌─────────┐ │ │ my1 ├────────────┬───────┤ my0 │ │ └─────────┘ │ └────┬────┘ │ │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ │ vnet1 │ │ enp9s0 │ │ vnet2 │ │ pcap-driver │ └────┬────┘ └────┬────┘ └────┬────┘ │ │ │ │ │ │ └──────┼───────────┼───────────┼──────┘ │ │ │ │ Ethernet │ Local LAN 10.1.0.x │ DHCP server, router ▼ Internet注意事项如果宿主运行着 Docker它引入的防火墙规则可能会破坏桥接桥接方式通常不适用于 Wi-Fi原因见 tap-driver 文档的附录Wi-Fi 帧需要 SA/DA/TA/RA 四个 MAC 地址工作站STA侧的桥接要求两端都启用4addr模式相当于 WDS不同厂商实现可能存在兼容性问题。方案三转发 伪装仅本机 互联网可达当 veth 对已经配好 IP 后可以让 Linux 用 NAT 把 Mongoose 的流量转发到另一个接口例如连接互联网的网卡。此时 Mongoose 可访问互联网、也可从本机访问但局域网内其他主机不可达。适合直连互联网、或希望把 Mongoose 与局域网隔离的场景。假设已有防火墙强烈建议配置伪装与转发换成你实际的网卡名$ sudo iptables -t nat -A POSTROUTING -o enp9s0 -j MASQUERADE $ echo 1 | sudo tee /proc/sys/net/ipv4/ip_forward打开 veth 的另一端运行示例$ make -C tutorials/tcpip/pcap-driver/ clean all ARGS-i my0部分系统需要sudo tutorials/tcpip/pcap-driver/example -i my0。拓扑[DHCP server for 192.168.0.x] ┌────────────► 192.168.0.1 192.168.0.x │ forwarding ┌─────────┐ virtual eth pair ┌─────────┐ │ masquerading │ my1 ├────────────────────┤ my0 │ │ └─────────┘ └────┬────┘ ▼ │ Your IP (LAN / Public) │ ┌─────────┐ pcap-driver │ enp9s0 │ └────┬────┘ │ │ Ethernet [Wi-Fi] │ ▼ Internet如果网卡本身已经是某个桥的一部分例如你在跑虚拟机则改用桥接口做伪装即可——此时你的 IP 属于虚拟桥而非网卡$ sudo iptables -t nat -A POSTROUTING -o virbr0 -j MASQUERADE $ echo 1 | sudo tee /proc/sys/net/ipv4/ip_forward对应拓扑[DHCP server for 192.168.0.x] 10.1.0.10 ◀──────────────► 192.168.0.1 192.168.0.x virbr0 forwarding ┌─────────┐ virtual eth pair ┌─────────┐ │ masquerading │ my1 ├────────────────────┤ my0 │ │ └─────────┘ └────┬────┘ ┌──────────────────┴──────────────────┐ │ │ │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ pcap-driver │ │ vnet1 │ │ enp9s0 │ │ vnet2 │ │ │ └────┬────┘ └────┬────┘ └────┬────┘ │ │ │ │ │ │ └──────┼───────────┼───────────┼──────┘ │ │ │ │ Ethernet │ Local LAN 10.1.0.x │ DHCP server, router ▼ Internet进阶无 DHCP 环境的自动 IPAuto-IP示例示例代码内置了一个自动 IP分支便于在没有 DHCP 服务的桥接/虚拟接口环境中让协议栈自举出一个链路本地地址。在编译时定义DISABLE_DHCP即可启用main.c$ make CFLAGS_EXTRA-DMG_TLSMG_TLS_BUILTIN -DDISABLE_DHCP -C tutorials/tcpip/pcap-driver/ clean all ARGS-i my0该分支的逻辑是初始自分配169.254.2.100IPv4 链路本地网段链路进入MG_TCPIP_STATE_UP后每秒触发一次MG_TCPIP_EV_TIMER_1S事件前 3 次发送 ARP 探测包mg_tcpip_arp_request(ifp, ip, NULL)检测地址冲突若 3 秒内没有冲突就正式把ifp-ip设为目标地址并发送一个免费 ARPgratuitous ARP宣告mg_tcpip_arp_request(ifp, ip, ifp-mac)协议栈随即进入 IP 就绪状态。相关事件常量的语义定义在 src/net_builtin.h链路状态机MG_TCPIP_STATE_DOWN / LINK_UP / UP / REQ / IP / READY也在同一文件的struct mg_tcpip_if中第 100-105 行。注意mif.enable_dhcp_client false;必须在mg_tcpip_init()之后设置main.c因为初始化时协议栈会根据ip 0自动开启 DHCP 客户端。验证与排错要点确认接口被正确打开程序启动时会打印Opened interface iface打开失败会列出所有可用接口pcap_findalldevs并提示检查接口名与权限。确认链路状态与 IP 获取MG_LL_DEBUG日志级别下可以看到协议栈的状态迁移与 DHCP 交互使用DISABLE_DHCP变体时可以观察 ARP 探测、地址分配与免费 ARP 的日志。验证可达性按所采用的拓扑从宿主pingMongoose 的 IP或反之然后访问http://ip:8000验证 HTTP 服务HTTPS 服务在8443端口。关注pcap_inject错误日志若pcap_tx持续报pcap_inject: -1说明注入失败通常是接口状态异常或权限不足。CPU 占用pcap_rx中的 1ms 休眠是防止 100% CPU 的关键不要随意移除。参考与进一步阅读本示例完整源码tutorials/tcpip/pcap-driver/main.c构建脚本与编译选项tutorials/tcpip/pcap-driver/Makefile驱动接口与网络接口结构体定义src/net_builtin.h内置协议栈实现驱动回调调用点src/net_builtin.c基于 TUN/TAP 的同系列示例含 Wi-Fi 桥接限制的附录tutorials/tcpip/tap-driver/README.md其余内置 TCP/IP 驱动STM32、W5500、W5100、TM4C、IMXRT 等声明同样位于 src/net_builtin.h如需在真实嵌入式网卡上使用协议栈可参照本示例的驱动接线方式阅读对应驱动源码。【免费下载链接】mongooseEmbedded web server, with TCP/IP network stack, MQTT and Websocket项目地址: https://gitcode.com/gh_mirrors/mon/mongoose创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考