dsh-mesh-access 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # 更新日志
 
+## 1.0.2 — 把卖点改成「手机远程控制」
+
+功能没变，只是把话说对：这东西最主要的用法是**用手机远程控制电脑上的 DSH**（同一个实例、同一份会话），
+「笔记本 / NAS / 电视盒子也能开」降级成附加卖点。
+
+- README 中英开头改成手机优先；
+- npm 描述、市场条目中英描述同步；
+- 面板副标题改成「用手机远程控制：手机浏览器打开就是你在电脑上用的那个 DSH」。
+
+## 1.0.1 — 修「一直重新连接中」
+
+`Origin` 没有跟着 `Host` 一起改写，DSH 的 WebSocket 升级被自己的同源校验挡成 **403**，
+于是 HTTP 一切正常（页面能开、API 能通），但实时通道连不上，界面底部一直显示「重新连接中…」。这一版修掉它，并顺手把长连接的 TCP keepalive 打开。
+
+- `rewrite()` 在改写 `Host` 的同时改写 `Origin`（`http://<upstream>`）；
+- upgrade 路径两个 socket 都 `setNoDelay(true)` + `setKeepAlive(true, 30000)`，让中继上的空闲长连接不容易被悄悄丢掉。
+
 ## 1.0.0 — 改名（原名 dsh-phone-tunnel）
 
 插件和「手机」没关系：它做的是把组网地址上的请求转给本进程。所以改了名，顺便把定位放宽。

package/README.en.md

@@ -1,7 +1,11 @@
 # dsh-mesh-access
 
-Expose the **running** DeepSeek Harness web UI on a mesh/VPN interface — from inside the server,
-without a second instance, without SSH, without touching the router.
+**Control your DSH from your phone.** Open the address in a phone browser and you get the very
+same UI you are using on the desktop — same instance, same session list, same context. No SSH,
+no second `dsh`, no router to touch.
+
+Under the hood it mounts the running DeepSeek Harness web UI onto a mesh/VPN interface, from
+inside the server process.
 
 [English](#what-it-does) | [中文](README.md)
 

package/README.md

@@ -1,7 +1,9 @@
 # dsh-mesh-access
 
-把**正在运行**的 DeepSeek Harness 网页界面挂到组网网卡上 —— 在服务进程内部完成，
-不需要第二个实例，不需要 SSH，也不用碰路由器。
+**用手机远程控制电脑上的 DSH。** 手机浏览器打开，就是你在电脑上正在用的那个界面 ——
+同一个实例、同一份会话、同一份上下文，不需要 SSH，不需要第二个 `dsh`，也不用碰路由器。
+
+底层做法是把正在运行的 DeepSeek Harness 网页界面挂到组网网卡上，在服务进程内部完成。
 
 [中文](#它做什么) | [English](README.en.md)
 
@@ -130,3 +132,30 @@ curl -s http://127.0.0.1:3080/api/dsh-mesh-access/status
 ## 许可
 
 MIT。
+
+## 常见问题
+
+**页面能打开、侧边栏也有，但底部一直「重新连接中…」，工作区列表空着**
+
+这是 1.0.0 的 bug，升级到 **1.0.1** 即可。原因：反代把 `Host` 改写成上游（`127.0.0.1:3080`）却没改 `Origin`，DSH 对 WebSocket 升级做同源校验，浏览器带着 `Origin: http://<组网IP>:<端口>` 过来，两边不一致 → 上游直接 `403 Forbidden`。于是普通 HTTP 全通（页面能开、API 能查），实时通道一次都没握上手，浏览器每几秒重试一次，看起来就像“网络一直断”。
+
+自查一行就够：
+
+```bash
+curl -s -o /dev/null -w '%{http_code}\n' --http1.1 \
+  -H 'Connection: Upgrade' -H 'Upgrade: websocket' \
+  -H 'Sec-WebSocket-Version: 13' -H 'Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==' \
+  -H "Origin: http://<组网IP>:<端口>" \
+  -b <你浏览器的 cookie> \
+  http://<组网IP>:<端口>/api/remote.mux
+```
+
+`101` 是正常，`403` 就是中了这个 bug。
+
+**改了端口或组网 IP，面板上的地址还能用吗**
+
+不能。反代一开出来，监听地址和上游端口就固定了；「访问地址」里的 token 也是按当时的地址签的。换了就点「关闭」→「在组网地址上开端口」，重新复制地址。
+
+**组网里的设备打开地址却超时**
+
+先确认那台设备能路由到组网 IP（`ping <组网IP>`），再确认本机防火墙放行该端口。Linux 上 `firewall-cmd --zone=<组网域> --list-ports`，Windows 上查该端口的入站规则。

package/lib/client.js

@@ -140,7 +140,7 @@ window.__ModuleLoader__.load({
         'div',
         { style: S.wrap },
         h('div', { style: S.h1 }, '组网访问'),
-        h('div', { style: S.sub }, '把当前这个 DSH 实例搬到组网网卡上，组网内任意设备直接打开，不用第二个实例、不用 SSH。'),
+        h('div', { style: S.sub }, '用手机远程控制：手机浏览器打开就是你在电脑上用的那个 DSH——同一实例、同一份会话，不用第二个实例，不用 SSH。'),
 
         h(
           Card, { title: '当前状态' },

package/lib/index.js

@@ -84,11 +84,17 @@ function readBody(req, limit = 8 * 1024) {
  */
 function createProxy({ listenAddress, listenPort, upstream, upstreamPort }) {
   const target = `${upstream}:${upstreamPort}`
+  // DSH 会校验 Origin 与 Host 是否一致（不一致直接 403），所以我们转发时把 Host 改写成
+  // 上游地址，就必须把 Origin 一起改写成上游的 origin；否则浏览器的 WebSocket 升级
+  // 永远 403，界面上表现成「一直重新连接中」。
+  const upstreamOrigin = `http://${target}`
   const rewrite = (headers) => {
     const h = { ...headers }
+    const incomingHost = headers.host ?? ''
     h.host = target
-    h['x-forwarded-host'] = headers.host ?? ''
+    h['x-forwarded-host'] = incomingHost
     h['x-forwarded-proto'] = 'http'
+    if (headers.origin) h.origin = upstreamOrigin
     return h
   }
 
@@ -109,7 +115,11 @@ function createProxy({ listenAddress, listenPort, upstream, upstreamPort }) {
 
   // WebSocket / HTTP upgrade：裸 socket 双向转发（DSH 的实时通道靠它）
   server.on('upgrade', (req, socket, head) => {
+    socket.setNoDelay(true)
+    socket.setKeepAlive(true, 30_000)
     const up = net.connect(upstreamPort, upstream, () => {
+      up.setNoDelay(true)
+      up.setKeepAlive(true, 30_000)
       const lines = [`${req.method} ${req.url} HTTP/1.1`]
       for (const [k, v] of Object.entries(rewrite(req.headers))) {
         if (v === undefined) continue

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-mesh-access",
-  "version": "1.0.0",
-  "description": "Expose the DSH web UI on a mesh/VPN interface (StarVPN, Tailscale, WireGuard tun) from inside the running server: in-process reverse proxy + status panel, so any device on the mesh — phone, laptop, NAS — opens it in a browser. No second instance.",
+  "version": "1.0.2",
+  "description": "Control your DSH from your phone: opens a port on the mesh/VPN interface from inside the running server process, so a phone browser gets the same instance and the same session list — no SSH, no second dsh. Also reachable from another PC, a GUI NAS, or a TV box.",
   "type": "module",
   "main": "lib/index.js",
   "exports": {