dsh-pocket 1.12.0 → 1.12.2

package/README.en.md

@@ -46,7 +46,7 @@ What it looks like — the phone shows the exact same UI as your computer, live:
 | 🔐 Access PIN | Public links require an **8-digit PIN** (rotated on every tunnel start by default; **customizable to a fixed PIN** — custom PINs are not rotated); LAN has its own separate **8-digit PIN** (on by default; switchable off in Settings — then LAN scans connect directly) |
 | 🔑 Custom PINs | Both the public and LAN PINs can be **set to your own fixed 8-digit number** in Settings (custom PINs are never auto-rotated) |
 | 🧘 Session persistence | Enter the PIN once and you're set for a long time (login is tied to the computer's dsh web process: as long as it stays up, the phone won't ask again; **after a dsh web restart/update, enter it once more**) |
-| ⚡ Real-time sync | Streaming output passes through WebSocket untouched — what the computer renders, the phone renders live; fully interactive both ways |
+| ⚡ Real-time sync | Streaming output passes through WebSocket untouched — what the computer renders, the phone renders live; fully interactive both ways; built-in WS heartbeat keep-alive (defeats silent NAT/battery link drops with auto-reconnect) |
 | 📱 Mobile-adaptive layout | Narrow screens get a drawer layout automatically (ported from dsh-web-mobile, MIT): sidebar drawer, full-width conversation, safe-area insets, touch optimizations |
 | 🗜️ Transfer compression | Large JSON responses are gzip/brotli'd on the fly (17MB session history → ~1MB; brotli quality 6: fast and bandwidth-friendly) — faster loads, less mobile data |
 | 🔁 Tunnel auto-restore | After a DSH restart the previously-running public tunnel comes back automatically |

package/README.md

@@ -46,7 +46,7 @@ DSH Pocket 就是干这个的：**装上它，手机扫个码，就能实时看
 | 🔐 访问密码 | 公网链接需输入 **8 位数字密码**（默认每次开启公网自动换新；**可自定义固定密码**——自定义后不再换新）；局域网有独立 **8 位数字密码**（默认开启，设置页可**一键关闭**——关闭后局域网扫码直连） |
 | 🔑 自定义密码 | 公网/局域网密码都可在设置页**设成自己固定的 8 位数字**（自定义后公网不再自动换新） |
 | 🧘 会话保持 | 手机输一次密码后**长期免输**（登录状态绑定电脑上的 dsh web 进程：只要它不重启，手机不用再输；**dsh web 重启/更新后需重新输入一次**） |
-| ⚡ 实时同步 | 流式输出走 WebSocket 全透传——**电脑上在输出，手机上同步在滚**，可双向操作 |
+| ⚡ 实时同步 | 流式输出走 WebSocket 全透传——**电脑上在输出，手机上同步在滚**，可双向操作；内置心跳保活（防路由器 NAT/省电机制静默断链，断线自动重连） |
 | 📱 移动端适配 | 窄屏自动变抽屉布局（移植 dsh-web-mobile，MIT）：侧栏抽屉、会话全宽、状态栏安全区、触控优化 |
 | 🗜️ 传输压缩 | 大 JSON 响应自动 gzip/brotli（长会话 17MB → ~1MB，brotli 质量 6：快且省流量），手机加载更快、更省流量 |
 | 🔁 隧道自动恢复 | DSH 重启后自动重新拉起之前开着的公网隧道，无需手动重开 |

package/lib/proxy.mjs

@@ -209,6 +209,62 @@ function loopbackAuthority(headers, upstream) {
   return headers;
 }
 
+// ---------- WebSocket 心跳注入（PR #41，issue #29） ----------
+// DSH 客户端与宿主的 WebSocket downlink 都不发 ping/pong（客户端只读流、
+// 宿主只推帧），空闲连接会被路由器 NAT 空闲超时或手机系统省电机制**静默**
+// 丢弃：没有 FIN/RST，浏览器收不到 close 事件，dsh-client-connection 也就
+// 永远不会重连——手机页面看起来还开着，实则实时通道已死（消息不同步、
+// 点击会话卡在加载）。
+//
+// 代理在每个透传的 WS 连接上定期向浏览器侧发送协议层 Ping（0x89 0x00，
+// server→client 不掩码）：
+//   - 浏览器网络栈按 RFC 6455 自动回 Pong（不经过任何 JS），一来一回让
+//     双向都有流量，NAT/防火墙空闲超时不再触发；
+//   - 连续 missLimit 个周期没有任何入站字节（浏览器已死或链路被静默丢弃）
+//     → 主动 destroy 连接：浏览器拿到 close 后 dsh-client-connection 会
+//     按指数退避自动重连，实时通道随即恢复。
+// 只 Ping 浏览器侧：上游是本机 loopback，不会过期；浏览器回的 Pong 原样
+// 透传给上游 ws 服务（未请求的 Pong 对 ws 库无害，只触发无害的 pong 事件）。
+const WS_PING_FRAME = Buffer.from([0x89, 0x00]); // FIN + opcode 9、长度 0、不掩码
+
+/**
+ * 在透传的浏览器侧 socket 上挂载心跳：定期 Ping 保活 + 静默断链检测。
+ * 任一路由方向只要有字节流动（Pong 响应）就把静默计数归零；连续 missLimit
+ * 个周期零入站流量则判定链路已死，销毁 socket 触发浏览器端重连。
+ * @param {import('node:net').Socket} socket 浏览器侧的透传 socket
+ * @param {{intervalMs?:number, missLimit?:number}} [opts] 心跳周期与容忍的静默周期数
+ */
+function attachWebSocketHeartbeat(socket, { intervalMs = 30_000, missLimit = 2 } = {}) {
+  let misses = 0;
+  let stopped = false;
+  const onInbound = () => { misses = 0; };
+  const timer = setInterval(() => {
+    if (stopped) return;
+    misses += 1;
+    if (misses >= missLimit) {
+      // 连续多个周期没有任何入站流量（连 Pong 都没有）→ 静默断链，断开让客户端重连
+      socket.destroy();
+      return;
+    }
+    // write 到已销毁的 socket 会抛错（destroy 竞态），写前检查并兜底
+    if (!socket.destroyed) {
+      try { socket.write(WS_PING_FRAME); } catch { /* 忽略 */ }
+    }
+  }, intervalMs);
+  timer.unref?.();
+  socket.on('data', onInbound);
+  const cleanup = () => {
+    if (stopped) return;
+    stopped = true;
+    clearInterval(timer);
+    socket.off('data', onInbound);
+    socket.off('close', cleanup);
+    socket.off('error', cleanup);
+  };
+  socket.on('close', cleanup);
+  socket.on('error', cleanup);
+}
+
 /**
  * 启动 dsh-pocket 代理。
  * @param {object} opts
@@ -217,10 +273,11 @@ function loopbackAuthority(headers, upstream) {
  * @param {{host:string,port:number}} [opts.upstream] 上游 dsh web（默认 127.0.0.1:3080）
  * @param {string} [opts.injectHtml] 注入 HTML 的内容（默认 polyfill + 移动端适配；传 '' 关闭）
  * @param {object} [opts.auth]       可选访问令牌认证（issue #13）：{ getToken, isProtected, sessionKey }
- * @param {object} [opts.rateLimit]  登录速率限制参数覆盖（issue #40；测试用短窗口）
+ * @param {object|false} [opts.rateLimit] 登录速率限制参数覆盖（issue #40；测试用短窗口）
+ * @param {object|false} [opts.heartbeat] WebSocket 心跳注入（PR #41）：{ intervalMs, missLimit }；false 关闭（默认开：30s/容忍 2 个静默周期）
  * @returns {Promise<{server:import('node:http').Server, close:()=>Promise<void>}>}
  */
-export function createPocketProxy({ port = 3081, host = '0.0.0.0', upstream = DEFAULT_UPSTREAM, log = null, injectHtml = DEFAULT_INJECT, auth = null, rateLimit = null } = {}) {
+export function createPocketProxy({ port = 3081, host = '0.0.0.0', upstream = DEFAULT_UPSTREAM, log = null, injectHtml = DEFAULT_INJECT, auth = null, rateLimit = null, heartbeat = {} } = {}) {
   const limiter = auth ? createRateLimiter(rateLimit ?? {}) : null;
   const server = createServer((req, res) => {
     // 访问令牌认证（issue #13 + #18 + #33 + #40）：局域网与公网按开关/来源要求密码
@@ -384,6 +441,8 @@ export function createPocketProxy({ port = 3081, host = '0.0.0.0', upstream = DE
       if (proxyHead?.length) socket.write(proxyHead);
       proxySocket.pipe(socket);
       socket.pipe(proxySocket);
+      // 心跳注入（PR #41）：保活 + 静默断链检测（见 attachWebSocketHeartbeat）
+      if (heartbeat !== false) attachWebSocketHeartbeat(socket, heartbeat ?? {});
       // 任一端断开都要清理另一端（避免上游残留僵尸连接占用 dsh 连接槽）
       const teardown = () => { try { proxySocket.destroy(); } catch {} try { socket.destroy(); } catch {} };
       proxySocket.on('close', teardown);

package/lib/tunnel.mjs

@@ -11,7 +11,13 @@ import { pipeline } from 'node:stream/promises';
 import { Readable } from 'node:stream';
 import { createWriteStream } from 'node:fs';
 
-const QUICK_TUNNEL_URL_RE = /https:\/\/[a-z0-9-]+\.trycloudflare\.com/i;
+// 快速隧道 URL：https://<随机子域>.trycloudflare.com
+// (?!api\.) 负向前瞻排除保留子域 api（issue #32）：某些 cloudflared 版本/网络环境下
+// 进程输出会先出现 https://api.trycloudflare.com（Cloudflare API 注册地址），原正则
+// [a-z0-9-]+ 会把它误当隧道 URL → 设置页/二维码给出 api 地址 → 扫码打开返回
+// {"code":10005,"message":"Method Not Allowed"}。api.trycloudflare.com 访问 GET 实测
+// 正是该错误体，与 issue 完全一致。
+export const QUICK_TUNNEL_URL_RE = /https:\/\/(?!api\.)[a-z0-9-]+\.trycloudflare\.com/i;
 
 function platformBinary() {
   const archMap = { x64: 'amd64', arm64: 'arm64' };

package/package.json

@@ -76,5 +76,5 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "version": "1.12.0"
+  "version": "1.12.2"
 }