dsh-ip-info
Verifieddsh-ip-info · v1.0.1 · MIT · Web UI
Read-only network widget: public IP, location, provider and local interfaces — composer line, floating card, or off.
Install
dsh plugin add dsh-ip-info Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-ip-info
输入框下方一行、可拖动的悬浮卡片,或者干脆不显示 —— 当前公网 IP 及其归属地、运营商和本地网卡。
关于
一眼看清这台机器从哪儿上网:公网 IP、归属地、运营商,以及每块本地网卡的地址。输入框下方一行或可拖动的悬浮卡,字号与主题跟随 Harness,VPN 开着就显示 VPN 的出口。只读,不写盘,随时可以关掉。
特性
- 三种显示方式:输入框下方 / 悬浮窗 / 关闭,设置里一键切换。
- 字号与主题跟随 Harness:读
--dsh-content-font-size与--dsw-alias-*,和旁边的行同宽同高。 - 悬浮窗不添乱:可拖动、可缩成小条,永远夹在窗口内并停在标题栏下方,抓得住也收得回。
- 两个视角:出口 IP(含归属地、运营商、ASN、时区)+ 每块本地网卡。
- 跟随系统代理:开着 VPN 就显示 VPN 的出口,不再"直连到底"。
- 只读:不写盘、不改会话,无运行时依赖。
显示方式
设置 → 通用 →「IP 地址信息显示」,三选一,立即生效:
| 选项 | 形态 |
|---|---|
| 输入框下方(默认) | 输入框下环境栏一行,点击原地展开详情 |
| 悬浮窗 | 可拖动卡片,记住位置;「缩小」收成小条,「展开」恢复 |
| 关闭 | 完全不显示,设置行保留 |
悬浮窗被夹在窗口内(按卡片实际尺寸),并停在标题栏下方 8px —— 标题栏是系统拖拽区,落在里面的内容收不到鼠标事件。
显示内容
公网地址(含来源)、IPv6、归属地、运营商与 ASN、坐标、时区、采集时间、出口(直连/代理)、本地接口(v4/v6、回环/虚拟、CIDR)、主机名与系统版本。
刷新
页面可见时每 4 秒轮询本地快照 —— 命中缓存时只是一次本地读,不打探测源;缓存 5 分钟,多个请求同时到期也只重建一次。Host 侧另有一个轻量探测:只问一家、只取 IP,发现出口地址变了(换 VPN 节点、切线路)就丢掉缓存,下一次轮询重建完整快照,所以换节点后大约 10 秒内面板就会变。这个探测在启动、手动刷新或刚检测到变化后的两分钟里是 6 秒一次,之后放缓到 15 秒一次;连续 5 分钟没有请求就自动停,下次打开再启动。followMs 可调(0 关闭)。
公网探测失败会显示失败来源(如 ipwho.is: timeout),本地信息照常显示。
代理
探测跟随这台机器的代理:先读 HTTPS_PROXY / HTTP_PROXY,Windows 上再读「Internet 选项」里的系统代理(FlClash、Clash Verge 之类开的 127.0.0.1:7890)。走 HTTP CONNECT 隧道,展开态「出口」一栏写明 直连 或 代理 127.0.0.1:7890;代理连不上任何探测源时自动回退直连并标注「代理失败」。
要固定直连,在配置里写 proxy: direct。
安装
已发布到 npm:dsh-ip-info。任选一种装法,装完在 设置 → 通用 →「IP 地址信息显示」里选展示方式。
npm(推荐)
dsh plugin add dsh-ip-info
dsh plugin 会把参数转发给 profile 目录里的 pnpm,所以 remove、update、list 同样可用;有多个 profile 时加 --profile <名字>。桌面版的 desktop profile 由应用自己托管,直接在插件页装即可。
插件页 / GitHub / 本地目录
侧栏 Plugins → 添加,填入其中之一:
dsh-ip-info—— npm 包名https://github.com/EndlessPoem/dsh-ip-info—— GitHub 仓库- 本目录的绝对路径 —— 本地源码
release 包(下载解压后本地安装)
从 Releases 下载
dsh-ip-info.zip,最新直链: https://github.com/EndlessPoem/dsh-ip-info/releases/latest/download/dsh-ip-info.zip解压,得到一个
dsh-ip-info/目录(里面已经有index.js、client.js、cordis.patch.yml):# Windows PowerShell Expand-Archive dsh-ip-info.zip -DestinationPath . # macOS / Linux unzip dsh-ip-info.zip安装这个目录 —— 插件页 → 添加 → 选中解压出来的
dsh-ip-info/;或者走命令行:dsh plugin add /绝对路径/dsh-ip-info
解压即可用,不需要 npm install、不需要构建。
纯 JavaScript,无构建步骤、无运行时依赖。
配置
cordis.patch.yml 里可加 cacheTtlMs(毫秒)调整快照缓存,proxy 固定出口:
- insert:
- id: dsh-ip-info
name: dsh-ip-info
config:
cacheTtlMs: 300000
followMs: 6000 # 出口探测间隔(毫秒),0 关闭
隐私
探测请求由本机 Host 发往五个公开 IP 服务与 api6.ipify.org;快照只在内存里,响应不含网卡 MAC 与 Node 版本。展示偏好存在浏览器 localStorage(dsh-ip-info:prefs)。
许可
MIT