< 返回我的博客

爱国的张浩予 发表于 2023-04-29 21:25

get-host-ip

这是一款用rust制作的命令行工具。其被设计用来从C:\Windows\System32\ipconfig.exe的执行结果内提取出指定【网卡】的属性值。比如,从电脑本的【无线局域网适配器WLAN】中提取出【IPv4地址】字符串值。

使用场景

Windows Subsystem for Linux(比如,Ubuntu-20.04)读取其宿主主机(比如,Windows 11)无线物理网卡的IP地址。进而,将其作为两项重要功能的配置项入参:

  1. 投影WSL2图形界面至Windows宿主桌面系统显示。
    • 无论是将整个Gnome桌面系统投影作为Windows环境下的一个应用程序窗口,还仅只是投影某个Linux GUI应用程序,X11 Server都需要借助$DISPLAY环境变量明确地知晓XSTATA的准确IP位置。请不要自做聪明地认为127.0.0.1可能搪塞过去。127.0.0.1是指向WSL2子系统自身,而不是宿主主机。
    • 关于WSL2桌面投影的更多技术细节,可参见我早先的另一篇文章为 Rust+QT 编程搭建【伪】win32 开发环境。还算是详细吧!
  2. 使Windows宿主操作系统共享VPN客户端给WSL2子系统。
    • 从操作上,执行export HTTP_PROXY=***指令要比在Linux系统里安装与配置另一个Clash实例要省心多了。
    • 从后续维护上,对VPN客户端的软件升级与配置更新仅需要做一遍操作更节省时间。
    • 从经济上,更少的在线客户端数量也更便宜。

曾经的纠结

早先我也曾经使用nodejs脚本程序实现了相同的功能。但,node虚拟机首次启动时间着实有些长了。虽然该长延时弊端在交互式bash上下文中并不明显(毕竟咱敲键盘也不快,还时不时地敲错字母),但当被置于.bashrc内执行时,其造成的shell会话初始化阻滞就让人有点不好接受了(毕竟,每次开个新shell窗口都得明显黑幕个把秒钟,体验着实有些儿差)。所以,我决心使用rust重构此“热”指令。效果明显,几乎一闪便可完成shell初始化。

命令行指令-用法

$ get-host-ip --help
获取 wsl 宿主机器的物理 IP 地址

Usage: get-host-ip [OPTIONS]

Options:
  -s, --section <SECTION>  ipconfig.exe 返回结果中的【主分类】标题 [default: "无线局域网适配器 WLAN"]
  -e, --entry <ENTRY>      ipconfig.exe 返回结果中的【主分类】下各个条目的标签名 [default: "IPv4 地址"]
  -h, --help               Print help
  -V, --version            Print version

更详细图例

参数图

返回结果

get-host-ip执行输出就是没有结尾换行符的IP地址字符串。若将该指令添加入$PATH,那么在Shell求值表达式内可以直接

export HOST_IP=$(get-host-ip);

链接库依赖

因为Windows cmd指令输出文本内容的字符集是cp936,而不是UTF-8。所以,get-host-ip需要依赖操作系统预置的字符集转换动态链接库libiconv,来完成cp936 -> UTF-8的字符集转换。

Linux操作系统

大部分主流Linux OS都包含有libiconv。若你的Linux OS版本比较早或是compact版而缺失了libiconv也不必慌。按如下方式补装即可:

wget http://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.9.1.tar.gz
tar -xzvf libiconv-1.9.1.tar.gz
cd libiconv-1.9.1.tar.gz
./configure --prefix=/usr/local
sudo make -j8
sudo make install
sudo ln -s /usr/local/lib/libiconv.so /usr/lib/libiconv.so
sudo ln -s /usr/local/lib/libiconv.so.2 /usr/lib/libiconv.so.2

Windows操作系统

要么,从setup直接下载安装包,并本地安装之。缺点就是会“污染”你的PATH环境变量。

要么,从binary下载预编译包。在解压缩之后,将其下的bin目录添加到你的编译环境变量RUST_FLAGS内。比如,

set RUST_FLAGS=-L C:\libiconv-1.9.2-1-bin\bin

吐槽

同一款libiconv链接库怎么对LinuxWindows操作系统提供了不同名的导出函数呢?这个“缺德的”命名差异导致我在【编译期·动态链接】环节卡住了好几天。相对于Linux版的链接库导出函数名,Windows版的每个导出函数都有一个lib前缀 —— 故意的吧?真要命。

评论区

写评论

还没有评论

1 共 0 条评论, 1 页