Skip to content

dsh-ip-info

Verified

dsh-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

English · 安装 · 配置

license npm dsh-plugin dependencies writes font VPN size IP coffee

输入框下方一行、可拖动的悬浮卡片,或者干脆不显示 —— 当前公网 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 包(下载解压后本地安装)

  1. 从 Releases 下载 dsh-ip-info.zip,最新直链: https://github.com/EndlessPoem/dsh-ip-info/releases/latest/download/dsh-ip-info.zip

  2. 解压,得到一个 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
    
  3. 安装这个目录 —— 插件页 → 添加 → 选中解压出来的 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