Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stuartzhang/get-host-ip
运行于WSL中，读取宿主Windows的物理网上IP地址
https://github.com/stuartzhang/get-host-ip
Last synced: 16 days ago
JSON representation
运行于WSL中，读取宿主Windows的物理网上IP地址
- Host: GitHub
- URL: https://github.com/stuartzhang/get-host-ip
- Owner: stuartZhang
- Created: 2023-04-27T14:52:13.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-04T08:17:32.000Z (about 1 year ago)
- Last Synced: 2024-11-21T20:25:22.968Z (about 1 month ago)
- Language: Rust
- Size: 27.3 KB
- Stars: 11
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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 开发环境](https://rustcc.cn/article?id=96458b90-9e62-44fd-8155-afe9642d4170)。还算是详细吧！
2. 使`Windows`宿主操作系统共享`VPN`客户端给`WSL2`子系统。
* 从操作上，执行`export HTTP_PROXY=***`指令要比在`Linux`系统里安装与配置另一个`Clash`实例要省心多了。
* 从后续维护上，对`VPN`客户端的软件升级与配置更新仅需要做一遍操作更节省时间。
* 从经济上，更少的在线客户端数量也更便宜。
## 曾经的纠结
早先我也曾经使用`nodejs`脚本程序实现了相同的功能。但，`node`虚拟机首次启动时间着实有些长了。虽然该长延时弊端在交互式`bash`上下文中并不明显（毕竟咱敲键盘也不快，还时不时地敲错字母），但当被置于`.bashrc`内执行时，其造成的`shell`会话初始化阻滞就让人有点不好接受了（毕竟，每次开个新`shell`窗口都得明显黑幕个把秒钟，体验着实有些儿差）。所以，我决心使用`rust`重构此“热”指令。效果明显，几乎一闪便可完成`shell`初始化。
## 命令行指令-用法
```shell
$ get-host-ip --help
获取 wsl 宿主机器的物理 IP 地址
Usage: get-host-ip [OPTIONS]
Options:
-s, --section ipconfig.exe 返回结果中的【主分类】标题 [default: "无线局域网适配器 WLAN"]
-e, --entry ipconfig.exe 返回结果中的【主分类】下各个条目的标签名 [default: "IPv4 地址"]
-h, --help Print help
-V, --version Print version
```
### 更详细图例
### 返回结果
`get-host-ip`执行输出就是没有结尾换行符的`IP`地址字符串。若将该指令添加入`$PATH`，那么在`Shell`求值表达式内可以直接
```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`也不必慌。按如下方式补装即可：
```shell
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](https://sourceforge.net/projects/gnuwin32/files/libiconv/1.9.2-1/libiconv-1.9.2-1.exe/download?use_mirror=jaist&download=)直接下载安装包，并本地安装之。缺点就是会“污染”你的`PATH`环境变量。
要么，从[binary](https://sourceforge.net/projects/gnuwin32/files/libiconv/1.9.2-1/libiconv-1.9.2-1-bin.zip/download?use_mirror=jaist&download=)下载预编译包。在解压缩之后，将其下的`bin`目录添加到你的编译环境变量`RUST_FLAGS`内。比如，
```shell
set RUST_FLAGS=-L C:\libiconv-1.9.2-1-bin\bin
```
### 吐槽
同一款`libiconv`链接库怎么对`Linux`与`Windows`操作系统提供了**不同名**的导出函数呢？这个“缺德的”命名差异导致我在【编译期·动态链接】环节卡住了好几天。相对于`Linux`版的链接库导出函数名，`Windows`版的每个导出函数都有一个`lib`前缀 —— 故意的吧？真要命。