npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

dsh-plugin-lan-gateway

v0.1.1

Published

内网/隧道网关:让手机等设备访问 dsh 网页(dsh 仍只监听 loopback),自带登录口令,口令仅本机可改

Readme

dsh-plugin-lan-gateway

让手机等设备通过内网或隧道访问 dsh 的网页,而 dsh 自己仍然只监听 127.0.0.1。

手机 ──(网关登录口令)──▶ 网关 :3081 ──(网关代持 token / cookie)──▶ dsh @127.0.0.1:<dsh端口>

安装

CLI="/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
"$CLI" plugin --profile desktop add dsh-plugin-lan-gateway

或在插件市场里搜 dsh-plugin-lan-gateway 点安装。装完重启 DSH 生效。

为什么要这么绕

dsh web --host 0.0.0.0 被刻意拒绝:

--host 0.0.0.0 is intentionally not supported yet for safety:
it would expose remote code execution to the network; use 127.0.0.1 instead

这个界面能执行 shell、读写文件,所以上游选择不让它绑到所有网卡。本插件不去绕那个闸: dsh 依旧只听 loopback,暴露面由插件自己控制——默认关闭、地址白名单、自带登录、卸载即恢复。

安全设计(默认值都是刻意的)

| 机制 | 说明 | |---|---| | 默认关闭 | 必须在本机 node lib/cli.js enable(或设 DSH_GATEWAY_ENABLE=1)才监听任何端口 | | 无口令不启动 | 状态文件里没有口令记录时拒绝监听(fail closed) | | 地址白名单 | auto 只取私有段 IPv4,并排除 utun*/tun*/tap*/ppp* —— 免得把界面顺手暴露到 VPN 网段;绑 Tailscale 地址要显式写出 | | 公网地址需显式放行 | 绑非私有地址还要求 --allow-public(或 DSH_GATEWAY_ALLOW_PUBLIC=1) | | token 不外泄 | 网关在服务端用 launch token 换取 dsh cookie 并自己持有;手机只拿网关自己的会话 cookie,URL 里从来没有 dsh token | | 口令只存哈希 | scrypt + 随机盐,状态文件 0600,无明文 | | 改口令即吊销 | 换口令同时轮换签名密钥,所有已登录设备立即失效 | | 配置可在本机改 | 选项与口令同存一个 0600 状态文件,CLI 改完插件 3 秒内生效,不依赖环境变量、不用重启 App | | 爆破防护 | 同一来源连续失败达阈值后锁定(默认 5 次锁 15 分钟) | | 反 DNS rebinding | 网关自己校验 Host 必须属于它公告的权威集合(dsh 那层围栏只护 loopback,护不到网关) | | 管理面本机独占 | 管理页挂在 dsh 自己的 loopback 服务器(/plugins/lan-gateway/admin),物理上无法从外部到达;网关还会显式拒绝转发该前缀 |

两个必须处理对的细节(都是实测踩出来的)

  1. Origin 必须跟着 Host 一起改写。dsh 的信任围栏要求「Origin 若存在就必须等于 Host」。 真实浏览器在 WebSocket 握手与 POST 上一定会带 Origin(值是手机看到的网关地址);只改 Host 会得到 403,表现是"页面能打开、但 RPC 与实时流全坏"。curl 默认不带 Origin,所以这个坑 只有沙箱对照实验才暴露。
  2. WebSocket upgrade 必须转发。GUI 的实时流走 /api/remote.mux;只做普通 HTTP 反代会半残。

配置:两种来源

优先级 环境变量 > 状态文件里的 options > 内置默认。两条路都在,是因为两种启动方式:

  • dsh web 从终端起,环境变量顺手;
  • 桌面版 App(双击启动)拿不到终端的环境变量,所以配置用 node lib/cli.js enable … 写进状态文件 (0600,和口令同一个文件),插件看门狗每 3 秒读一次,改完不用重启应用。

| 环境变量 | 对应的文件键 | 默认 | 说明 | |---|---|---| | DSH_GATEWAY_ENABLE | enabled | 关 | 置 1 启用网关 | | DSH_GATEWAY_ADDRESSES | addresses | auto | 逗号分隔的监听地址;auto 按上表规则自动选,可以和固定地址混用(auto,100.x.y.z) | | DSH_GATEWAY_PORT | port | 3081 | 监听端口 | | DSH_GATEWAY_USER | user | dsh | 登录用户名 | | DSH_GATEWAY_STATE | — | $DSH_HOME/lan-gateway.json | 口令/密钥状态文件(0600) | | DSH_GATEWAY_AUTHORITIES | authorities | 空 | 额外允许的 Host 值(如 tailscale serve 的域名) | | DSH_GATEWAY_SESSION_DAYS | sessionDays | 7 | 登录会话有效期 | | DSH_GATEWAY_MAX_FAILURES | maxFailures | 5 | 连续失败几次后锁定来源 | | DSH_GATEWAY_ALLOW_PUBLIC | allowPublic | 关 | 允许绑定非私有地址(公网 IPv6 等) |

用法

1. 设登录口令 + 启用(都在本机命令行,不经过任何浏览器)

cd ~/dsh-dingtalk-workspace/dsh-plugin-lan-gateway

# 设口令(交互输入、不回显、不进 shell 历史);换口令会立刻吊销所有已登录设备
node lib/cli.js set-password

# 启用:绑内网地址(auto = 私有段 IPv4,自动排除 VPN/隧道接口)
node lib/cli.js enable --addresses auto --port 3081

# 其它命令
node lib/cli.js status     # 看配置、口令状态、实际会绑的地址
node lib/cli.js disable    # 关掉监听(保留口令)

桌面版 App 不需要重启:插件会在 3 秒内读到这份配置并开始监听。 也可以在本机管理页设置口令(http://127.0.0.1:<dsh端口>/plugins/lan-gateway/admin, 只在 loopback 上、外部不可达),但 CLI 更省事。

启动日志会给出手机能直接打开的地址,例如 http://192.168.1.10:3081/。

2. 手机打开 → 登录 → 用

手机会先看到网关登录页(这里没有 dsh token),登录后即是完整 GUI:会话列表、实时输出流 (/api/remote.mux 的 WebSocket)、输入框发任务,全都走这一条通道。

两个前置条件:

  • 手机与电脑在同一个内网(下面的 Tailscale 章节解决"不在同一个内网");
  • 电脑不能睡。合盖睡眠会让所有连接断掉,长任务期间建议: caffeinate -s(或系统设置 → 锁定屏幕 → 显示器关闭时防止自动进入睡眠)。

外网:走 Tailscale(推荐)

dsh 网关天然适配 Tailscale:不开公网端口、不动路由器、隧道自带加密。

A. 直连 tailnet 地址(最省事)

# 1) 启动并登录 Tailscale(一次性,开浏览器授权)
open -a Tailscale
# 或命令行:/Applications/Tailscale.app/Contents/MacOS/Tailscale up

# 2) 取 tailnet 地址(形如 100.x.y.z)
/Applications/Tailscale.app/Contents/MacOS/Tailscale ip -4

# 3) 同时绑内网与 tailnet 地址(100.64/10 属于私有段,不需要 allowPublic)
node lib/cli.js enable --addresses auto,100.x.y.z --port 3081

手机装 Tailscale 并登录同一 tailnet 后,访问 http://100.x.y.z:3081/ 即可。 传输由 Tailscale 的 WireGuard 加密;只有 tailnet 内设备能连。

注意:这种访问是 http://,浏览器不视为"安全上下文",个别 Web API(剪贴板、crypto.subtle) 可能不可用。要拿到真正的 HTTPS 用下面 B。

B. 用 tailscale serve 提供 HTTPS(推荐给外网)

Tailscale 能签发真实证书并终止 TLS,于是浏览器看到的是 https://<machine>.<tailnet>.ts.net/ ——安全上下文,且外部仍无法直连。

# 网关只需监听本机,由 Tailscale 转发进来
node lib/cli.js enable --addresses 127.0.0.1 --port 3081 \
  --authorities <machine>.<tailnet>.ts.net

# 另一终端:把 tailnet 的 HTTPS 转到网关
/Applications/Tailscale.app/Contents/MacOS/Tailscale serve --bg 3081

DSH_GATEWAY_AUTHORITIES 填 Tailscale 转发时送进来的 Host。不确定填什么就看日志: 网关遇到没在白名单里的 Host 会打印

[lan-gateway] 拒绝未知 Host: "xxx.ts.net"(如属预期,请加入 DSH_GATEWAY_AUTHORITIES)

照抄那个值即可(必要时带 :443)。

关于"直接用公网 IPv6"

本插件也支持,但要清楚代价(不推荐,除非你确实需要):

  1. 家用路由器默认禁止入站 IPv6,要手动加放行规则(有些固件没有这个开关);
  2. 运营商下发的前缀会变,接口的临时地址还会按 RFC 4941 轮换 → 需要 DDNS 才能稳定访问;
  3. 明文 HTTP 暴露在公网不合适,得自己解决 TLS。
# 说明:非私有地址必须显式放行
DSH_GATEWAY_ENABLE=1 DSH_GATEWAY_ALLOW_PUBLIC=1 \
DSH_GATEWAY_ADDRESSES=2001:db8:xxxx:xxxx::1 dsh web

卸载 / 停用

  • 停用监听:node lib/cli.js disable(几秒内生效,不用重启);彻底不加载则从 dsh.profile.bundles 里去掉本包;
  • 卸载:dsh plugin --profile web remove dsh-plugin-lan-gateway,再从 profile 的 dsh.profile.bundles 里删掉 dsh-plugin-lan-gateway;
  • 想立即吊销所有已登录设备:在管理页换一次口令。

自检

node scripts/verify.mjs     # 33 项:认证单元 + 配置来源 + 地址选择 + 真起服务的网关集成

集成部分会真起一个假上游与一个网关,覆盖:登录页不含 token、口令错误 401、登录成功下发网关 cookie、 转发时 Host/Origin/Referer 改写与上游 cookie 替换、上游 401 自愈、管理路径不被转发、Host 白名单 403、 WebSocket upgrade(未登录拒绝 / 已登录 101 + 数据)、失败锁定 429;以及配置来源(默认 / 状态文件 / 环境变量 优先级、签名、setOptions 不动口令与密钥)、auto 与固定地址混用。