DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

ShuangYe-1991 /

ShuangYe-1991/dsh-link

Verified

DSH 插件:一个包装在电脑和手机两边,电脑开带密码的局域网/公网入口,手机在 DSH 面板里全屏操作电脑上的 dsh。

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@d340b06e

dsh-link · 一台电脑 + 一台手机

装同一个包在两边,用状态页里的开关选这台设备当什么:

角色 它干什么
电脑(默认) 在局域网/公网开一个带密码门的反向代理,把本机 dsh web 原样给手机用;能自己拉 cloudflared 起公网隧道
手机 在 127.0.0.1 开一个反向代理,把电脑那台 dsh 的整页喂给手机 DSH 的面板;会话登录、地址自愈都在这一侧

手机侧是 DSH 侧边栏里的一个面板(「电脑 DSH」):全屏就是电脑的对话页,顶部有「切换」胶囊,可多台电脑切换、改地址、扫码添加。

更新日志

1.6.1(相对 0.6.4 的主要变化)

1. 设备密钥验证(Ed25519):密码 + 密钥双因子,默认开启

  • 手机第一次用密码连上时会自动配对:手机本地生成密钥对,只把公钥交给电脑,私钥永不出手机;
  • 之后每次进面板,电脑端要求「密码会话 + 私钥签名会话」同时成立;只带密码的请求会被拒绝(HTTP 401);
  • 电脑状态页底部能看到已信任设备数与公钥指纹,可以「作废旧密钥」;
  • 作废后手机端会自动丢掉旧私钥、生成新密钥对、用密码重新配对,用户无感,不用删连接重加。

2. 密钥验证可以关(默认开,但必须能关)

  • 状态页有开关「只允许已配对设备」;
  • 之所以必须能关:手机浏览器不能保存设备密钥。开启后,用浏览器打开电脑 dsh 会被拒绝;
  • 所以界面在四个位置都写了提示:状态页密钥区、手机切换抽屉、手机设置页「本机环境检测」、以及浏览器被挡住时的 401 页面——都明确告诉用户「想用浏览器,请先关掉这个开关」。

3. 老旧安卓 WebView 的环境问题(重要)

  • 现象:部分老机型(例如 Android 13 + WebView 104)上,电脑 dsh 能打开,但一直显示「重新连接中」,插件页可能白屏;
  • 原因:手机 DSH 跑在系统 WebView 里,WebView 内核太旧时新前端初始化不起来;同一台手机的浏览器往往能正常打开(页面结构不同);
  • 多数安卓机的 WebView 烧在系统固件里、无法单独升级,所以插件内置了兜底:
    • 自动检测 WebView 版本,低于 110 时在面板顶部显示红色提示条(每次进入都会显示,可单次关闭);
    • 提示条与「切换」抽屉里都有「用浏览器打开」,直接打开这台电脑的真实地址(公网连接就开公网地址);
    • 手机设置页「本机环境检测」显示当前内核版本与建议值;
    • 这类设备只能用密码验证(浏览器存不了密钥),所以提示里会建议关闭密钥验证。

4. 连接与体验

  • 修复:关闭「局域网访问」会把本机管理页一起挡死(把自己锁在外面);
  • 修复:插件重挂时隧道被误判为失效而重建(导致公网地址频繁变化,手机存的地址全废)——现在认领成功就一直沿用;
  • 修复:密码填错时页面一直转圈不解释——现在直接给「密码不对」的失败页,带改地址/改密码入口;
  • 失败页可直接改地址、并用扫码识别填新地址(不用手敲一长串域名);
  • 手机端会记住电脑的局域网地址,公网地址变了可以用它找回;
  • 静态资源放行 gzip/br + 上游 keep-alive + 手机端资源缓存:公网首次打开从「几分钟白屏」降到数秒,第二次约 1 秒;
  • 已连电脑那一行改成两行(名字+状态 / 等宽按钮一排);
  • 新增「导出诊断包」(密码与 token 打码,含代理日志与 cloudflared 日志);
  • 设置页新增鸣谢与作者联系方式。

两种角色怎么用

电脑那台:状态页 →「这台设备当什么用」选「作为电脑」。页面里给二维码、局域网地址、访问密码,以及公网访问(快速隧道 / 固定域名)。手机扫这个码或者手填地址 + 密码即可。

手机那台:状态页选「作为手机」。之后打开手机 DSH 侧边栏里的「电脑 DSH」→「切换 → 添加电脑」,贴地址、填密码。本机代理端口会自动挑(默认 4319,被占就顺延)。

状态页地址(只允许本机打开):

角色 地址
电脑 http://127.0.0.1:3199/__link/ui(固定端口)或 http://127.0.0.1:<dsh端口>/__link/ui
手机 http://127.0.0.1:<dsh端口>/__link/ui(切到手机角色后 3199 不再监听,另给一个连接管理页 http://127.0.0.1:<手机代理端口>/__ctl/ui)

协议(dsh-link v1)

电脑端对手机端暴露的东西:

接口 说明
GET /__link/version 免鉴权,返回 { name:'dsh-link', version:1, host, features:['auth','ws'] };手机端据此识别协议
POST /__link/login 表单 token=<密码>:对 → 302 + Set-Cookie: dsh_link=…;错 → 200 + 登录页(含 current-password);试错 5 次锁 60 秒(429)
GET /__link/tunnel 要过密码门,返回当前公网地址:{ ok, mode, state, url, updatedAt }。手机端在同一局域网时问一次就能拿到新地址
其余所有请求 未带有效 cookie → 登录页(文档请求)或 401;带了 → 透传到 dsh web(HTTP + WebSocket)

手机端同时兼容第三方 dsh-pocket:先探 /__link/version,没有就走它的 POST /pocket-login。

公网访问

两种模式,都在状态页里开关:

模式 地址 需要什么
快速隧道 https://随机词.trycloudflare.com,重启电脑会变 什么都不需要,免费
固定域名 https://你的域名,重启也不变 Cloudflare 账号里一条隧道的 token + 一个指过去的域名

地址稳定性:隧道进程独立于 dsh 存活(detached + 输出写文件)。重启 dsh / 重开插件时按 pid + 进程名(tasklist)认领上一条隧道,所以只重启 dsh 地址不变,只有重启电脑才会换。

手机自动拿到新地址:连不上时手机侧会去局域网那个地址问 /__link/tunnel,拿到新公网地址就自己换掉、重新登录(连接管理页也有「自动找新地址」按钮)。前提是手机和电脑在同一个 WiFi——回过一次家就自动修好了。

cloudflared 从哪来:先找插件自己的 $DSH_HOME/dsh-link/bin/,再找 dsh-pocket 已经下好的、各 profile 的 node_modules/cloudflared、系统 PATH。都没有会自动下载,按顺序试 4 个源(GitHub 官方 → ghproxy.net → gh-proxy.com → ghfast.top),下完校验 --version 才改名落盘。全失败时状态页用红字列出:缺什么、找过哪些路径、每个源失败的原因,并给官方发布页——用户自己下下来放到 $DSH_HOME/dsh-link/bin/cloudflared.exe 再点「重新检测」就行。

竖屏适配

手机上竖屏时 dsh 自己的桌面布局会把主内容列算成 0 宽、推出屏幕外(一片空白、侧边栏反而拉得出来)。电脑端转发 HTML 时塞一小段脚本(约 1.5KB):只在「视口 ≤ 900 且主内容列确实被挤出屏幕」时给外壳加 grid-template-columns: 0 1fr 0。平板 / 横屏 / 电脑宽度一律不碰;手机面板里的「布局 / 缩放 / 侧边栏」按钮通过 postMessage 控制它。

判断只在"没开适配"时量一次——开了之后主列本来就满宽,再拿量到的宽度反推会自己把自己关掉,来回抖(踩过)。

配置与文件

位置 内容
$DSH_HOME/dsh-link/state.json 角色、开关、端口、访问密码、隧道配置(0600)
$DSH_HOME/dsh-link/tunnel.json 隧道运行时(pid/地址/模式),用来跨 dsh 重启认领
$DSH_HOME/dsh-link/tunnel.log cloudflared 自己的输出
$DSH_HOME/dsh-link/proxy.log 门口发生的事:换 dsh 会话 cookie、上游 401/403、重试
$DSH_HOME/dsh-link/phone/state.json 手机侧:连过哪些电脑、当前用哪台

三个实现要点(踩过的坑)

  1. dsh web 自己也有鉴权:根路径要带一次 ?token=<启动令牌> 换 cookie。令牌由插件向 dsh 要(ctx.connection.authenticatedUrl()),换 cookie 用的 authority 必须和转发时的 Host 一致,否则一直 401。
  2. 别注入 transport shim:dsh ≥ 0.2.2 上那类改写会让「壳渲染出来、内容全空」。本插件一个字节都不注入,只加竖屏适配那段。
  3. WebSocket 必须通:dsh 的实时通道走 WS(/api/remote.mux),升级请求要和普通请求一样过密码门与头改写。

已知限制

  • 快速隧道没有可用性保证(Cloudflare 免费给的就是"试试"级别),要稳定就得固定域名;
  • 手机不在家、电脑又刚重启过,那一次需要手贴新地址;
  • 窄屏横竖屏切换偶发要刷新一次才正常(已知,未修)。

目录

dsh-link/
├─ index.js              入口:按角色起电脑端或手机端
├─ client.js             手机侧面板(侧边栏入口 + iframe + 切换抽屉)
├─ lib/
│  ├─ link.mjs           电脑端:密码门反向代理 + 状态页接口
│  ├─ tunnel.mjs         公网隧道(cloudflared 生命周期、认领、可达性)
│  ├─ cloudflared.mjs    找/下载 cloudflared(多源、校验)
│  ├─ pages.mjs          电脑端状态页 / 登录页
│  ├─ state.mjs          电脑端状态与密码
│  ├─ fit.mjs            竖屏适配脚本(注入到转发的 HTML)
│  └─ phone/
│     ├─ runtime.mjs     手机端:本机反向代理 + 登录 + 地址自愈
│     └─ pages.mjs       手机端连接管理 / 扫码页
├─ vendor/               二维码生成(MIT)、jsQR(Apache-2.0)
└─ cordis.patch.yml

安装(别人怎么用)

方式一:直接从 GitHub 装

dsh plugin --profile web add github:ShuangYe-1991/dsh-link

方式二:下载 Release 里的 tgz

dsh plugin --profile web add /sdcard/Download/dsh-link-0.6.2.tgz

装完重开 DSH。电脑和手机装的是同一个包,只是角色选得不一样:

设备 装完后要做
电脑 设置 → 电脑 DSH → 选「作为电脑」;到 http://127.0.0.1:3199/__link/ui 看地址、密码、二维码
手机 设置 → 电脑 DSH → 选「作为手机」;填电脑的地址 + 密码(或扫码);打开「在侧边栏显示入口」

作者

ShuangYe-1991

已知问题

  1. 从电脑画面切回手机 DSH 会停在空白主区,回不到会话列表/对话。当前实现是「占用宿主 main 面板 + 全屏覆盖层」,退出时宿主没有可用的"切回会话"入口。计划改用官方面板切换 API,或换一种不占 main 的承载方式。
  2. 扫码页在"设置 → 电脑 DSH → 扫码添加"入口下偶发卡顿/黑屏("电脑画面 → 切换 → 扫码"入口正常)。表现为首次点击要等几秒。
  3. 相机与剪贴板在手机 App 内可能不可用:getUserMedia / clipboard.readText 需要宿主在 WebView 的权限回调里放行,插件层无权授予。已提供替代路径:系统「拍照扫码」、从相册选图识别、以及在电脑上复制地址手填。
  4. 多台电脑切换只做了逻辑,没有第二台真机验证过。
  5. 快速隧道地址在重启电脑后会变;只重启 dsh 会沿用(靠认领上次的进程)。要固定地址需要命名隧道 + 域名。
  6. 关闭「局域网访问」后,电脑本机的管理页也会被 403 挡住(把自己锁在外面),需要用 state.json 手动改回。这个开关暂时不要用。
  7. 连接失败后在设置页出现的红框,更新网址成功后仍然挂着,容易误导;下一版要挪到"进入面板失败"那一页里,并和扫码/相册识别放在一起。
  8. 已连电脑那行按钮有 5~6 个、挤在一行;下一版改成两行(上行名字+状态,下行等宽按钮)。

鸣谢

这个项目的灵感与协议设计来自 dsh-pocket(作者 @shaobeichen)。

它最早做出了"手机扫码就能用电脑上的 DSH"这件事,也是本插件的起点:先有了 dsh-pocket 的能力边界、它的登录门与反向代理思路,才有后面的协议约定(/__link/version、/__link/login、WebSocket 透传)。本项目的手机端面板交互(悬浮胶囊 + 切换抽屉 + 多台电脑)同样是沿着它那套探索走过来的。

需要说明:本项目不复用 dsh-pocket 的代码(它是 GPL-2.0,本项目是 MIT),只按它的对外行为实现客户端;两者协议不兼容时,各以各自文档为准。

另外用到的开源组件与外部服务:

  • Cloudflare cloudflared —— 公网隧道(免费快速隧道 / 命名隧道)
  • qrcode-generator(MIT)—— 生成二维码
  • jsQR(Apache-2.0)—— 解码二维码图片

以及所有愿意试用、反馈问题的人。

联系

  • GitHub:@ShuangYe-1991
  • 问题与建议:直接在这个仓库开 Issue,比私信更容易被看见

许可

MIT。二维码生成用 qrcode-generator(MIT);扫码解码用 jsQR(Apache-2.0)。

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout
—/ 5

No ratings yet

Verified DSH bundle

Commit d340b06e0a5e

Community comments

No comments yet. Be the first to write one.