rdsh-gateway 0.5.0 → 0.6.0

package/dist/config.d.ts

@@ -30,6 +30,13 @@ export interface RdshConfig {
     hub?: string;
     name?: string;
     insecure?: boolean;
+    /** DSH UI 兼容开关（跟随 E2EE；trustE2EEAsLoopback 默认 true） */
+    dshUiCompat?: DshUiCompat;
+}
+/** DSH UI 兼容：把经隧道访问的前端 isLoopback 判定视为 loopback，使 Models/设置持久化可用。 */
+export interface DshUiCompat {
+    /** E2EE 激活（或宿主启用）时 patch JS；false = 保持 DSH 原样（共享 host/敏感场景） */
+    trustE2EEAsLoopback?: boolean;
 }
 export declare const DEFAULT_HOST_CONFIG_PATH: string;
 /** 解析配置文件路径（--config > $RDSH_CONFIG > 默认 host.json）。 */

package/dist/config.js

@@ -21,6 +21,7 @@ const DEFAULTS = {
     behindProxy: false,
     allowFrom: [],
     auth: DEFAULT_AUTH,
+    dshUiCompat: { trustE2EEAsLoopback: true },
 };
 /** 解析配置文件路径（--config > $RDSH_CONFIG > 默认 host.json）。 */
 export function resolveConfigPath(cliPath, env = process.env) {
@@ -174,6 +175,19 @@ export function normalizeConfig(raw, source = "config") {
         assertString(cfg.dshPath, "dshPath", source);
         out.dshPath = cfg.dshPath;
     }
+    // ---- dshUiCompat（缺省 trustE2EEAsLoopback: true）----
+    if (cfg.dshUiCompat !== undefined) {
+        if (typeof cfg.dshUiCompat !== "object" || cfg.dshUiCompat === null) {
+            throw new Error(`${source}: "dshUiCompat" must be an object`);
+        }
+        const compat = cfg.dshUiCompat;
+        if (compat.trustE2EEAsLoopback !== undefined) {
+            if (typeof compat.trustE2EEAsLoopback !== "boolean") {
+                throw new Error(`${source}: "dshUiCompat.trustE2EEAsLoopback" must be boolean`);
+            }
+            out.dshUiCompat = { trustE2EEAsLoopback: compat.trustE2EEAsLoopback };
+        }
+    }
     return out;
 }
 function assertString(v, field, source) {

package/dist/join.d.ts

@@ -1,3 +1,4 @@
+import type { IncomingHttpHeaders } from "node:http";
 import type { ProxyTarget } from "./proxy.ts";
 import type { JoinLockRole } from "./lock.ts";
 export interface JoinOptions {
@@ -11,6 +12,10 @@ export interface JoinOptions {
     insecure?: boolean;
     /** 主机名（注册命名 / host.json） */
     name?: string;
+    /** DSH UI 兼容（透传 host.json dshUiCompat；缺省 true） */
+    dshUiCompat?: {
+        trustE2EEAsLoopback?: boolean;
+    };
 }
 /** 注册/接入结果：解析出的 host token + 是否需 insecure + 生效的主机名（缺省=机器 hostname）。 */
 export interface RegisterOutcome {
@@ -41,10 +46,16 @@ export interface StartJoinOptions {
     /** 锁文件路径（缺省 ~/.rdsh/join.lock；测试可注入临时路径） */
     lockPath?: string;
     hooks?: JoinHooks;
+    /** DSH UI 兼容（缺省 trustE2EEAsLoopback=true；false 关闭 JS patch） */
+    dshUiCompat?: {
+        trustE2EEAsLoopback?: boolean;
+    };
 }
 /** 可停止的 join 隧道句柄。 */
 export interface JoinHandle {
     stop(): Promise<void>;
+    /** 运行中切换 DSH UI 兼容（trustE2EEAsLoopback）；下一个请求即生效。 */
+    setUiCompat(trustE2EEAsLoopback: boolean): void;
 }
 /** 探测 hub 是否需 insecure：以严格校验握手一次；证书错误 → true（需 insecure）。 */
 export declare function detectInsecure(hubUrl: string): Promise<boolean>;
@@ -56,6 +67,14 @@ export declare function registerJoin(opts: JoinOptions): Promise<RegisterOutcome
  * 启动 join 隧道（no-spawn）：转发到外部 `opts.target`，不 spawn dsh、不 process.exit。
  * 获取 pid 锁（opts.role）；返回 `JoinHandle`，`stop()` 干净停止（关 WS/清 heartbeat/释放锁）。
  */
+/** JS 响应判定（content-type 含 javascript）。 */
+export declare function isJsContentType(headers: IncomingHttpHeaders): boolean;
+/**
+ * 最小 patch：把 DSH 客户端 bundle 里的前端 isLoopback 判定替换为 true
+ * （持久设置/API key 输入只对 loopback 开放；E2EE 流上信任基础等同 loopback）。
+ * fail-open：未命中目标串 → 返回 null，调用方原样透传（DSH 升级不炸）。
+ */
+export declare function patchLoopbackJs(body: Buffer): Buffer | null;
 export declare function startJoin(opts: StartJoinOptions): JoinHandle;
 /** `rdsh host serve`（join 模式）的 CLI 封装：spawn dsh + 信号退出 + startJoin(role:cli)。 */
 export declare function join(opts: JoinOptions): Promise<void>;

package/dist/join.js

@@ -128,9 +128,29 @@ async function register(hubUrl, joinToken, name, insecure, e2eePublicKey) {
  * 启动 join 隧道（no-spawn）：转发到外部 `opts.target`，不 spawn dsh、不 process.exit。
  * 获取 pid 锁（opts.role）；返回 `JoinHandle`，`stop()` 干净停止（关 WS/清 heartbeat/释放锁）。
  */
+/** JS 响应判定（content-type 含 javascript）。 */
+export function isJsContentType(headers) {
+    const ct = headers["content-type"];
+    const s = Array.isArray(ct) ? ct.join(";") : (ct ?? "");
+    return /javascript/i.test(s);
+}
+/**
+ * 最小 patch：把 DSH 客户端 bundle 里的前端 isLoopback 判定替换为 true
+ * （持久设置/API key 输入只对 loopback 开放；E2EE 流上信任基础等同 loopback）。
+ * fail-open：未命中目标串 → 返回 null，调用方原样透传（DSH 升级不炸）。
+ */
+export function patchLoopbackJs(body) {
+    const src = body.toString("utf8");
+    const target = "isLoopbackHostname(pageLocation.hostname)";
+    if (!src.includes(target))
+        return null;
+    return Buffer.from(src.split(target).join("true"), "utf8");
+}
 export function startJoin(opts) {
     const hubWsBase = opts.hubUrl.replace(/^https/, "wss").replace(/^http/, "ws");
     const hooks = opts.hooks ?? {};
+    // DSH UI 兼容开关：缺省 true（跟随 E2EE）；可变引用 → 运行中可切换（插件面板即时生效）
+    const uiCompat = { trustE2EEAsLoopback: opts.dshUiCompat?.trustE2EEAsLoopback !== false };
     const log = (level, message) => {
         hooks.onLog?.(level, message);
     };
@@ -153,7 +173,7 @@ export function startJoin(opts) {
         }
     }
     /** 内层帧分发器（plain 与 raw 共用）：OPEN http/ws + DATA → DSH 转发，响应帧经 `send` 回传。 */
-    function makeInnerDispatcher(send) {
+    function makeInnerDispatcher(send, dio) {
         const httpStreams = new Map();
         const wsStreams = new Map();
         function closeStream(streamId) {
@@ -241,6 +261,25 @@ export function startJoin(opts) {
                     reason: upRes.statusMessage,
                     headers: normalizeRespHeaders(upRes.headers),
                 })));
+                if (dio?.jsPatch?.() === true && isJsContentType(upRes.headers)) {
+                    // 最小 patch：E2EE 流上的 JS 响应，把前端 isLoopback 判定替换为 true
+                    // （fail-open：未命中 → 原样透传；DSH 升级不炸）
+                    const chunks = [];
+                    upRes.on("data", (chunk) => chunks.push(chunk));
+                    upRes.on("end", () => {
+                        const body = Buffer.concat(chunks);
+                        const patched = patchLoopbackJs(body);
+                        // fail-open：未命中也必须原样发 body（否则空响应白屏）
+                        send(encodeFrame(FRAME_TYPE.DATA, streamId, patched !== null ? patched : body));
+                        send(encodeFrame(FRAME_TYPE.CLOSE, streamId, jsonPayload({ code: 0 })));
+                        httpStreams.delete(streamId);
+                    });
+                    upRes.on("error", () => {
+                        send(encodeFrame(FRAME_TYPE.CLOSE, streamId, jsonPayload({ code: 502, message: "upstream error" })));
+                        httpStreams.delete(streamId);
+                    });
+                    return;
+                }
                 upRes.on("data", (chunk) => {
                     send(encodeFrame(FRAME_TYPE.DATA, streamId, chunk));
                 });
@@ -310,7 +349,7 @@ export function startJoin(opts) {
         }
         return { handleFrame, cleanup };
     }
-    const plainDispatcher = makeInnerDispatcher(sendTunnelFrame);
+    const plainDispatcher = makeInnerDispatcher(sendTunnelFrame, { jsPatch: () => uiCompat.trustE2EEAsLoopback });
     // host 端 E2EE 静态密钥对（持久化 ~/.rdsh/e2ee-key.json；join 注册时上送指纹）
     const hostE2eeKeypair = loadOrCreateE2eeKeyPair();
     const rawStreams = new Map();
@@ -321,7 +360,7 @@ export function startJoin(opts) {
                 const ct = raw.encryptor.encrypt(frame, Buffer.alloc(0));
                 sendTunnelFrame(encodeFrame(FRAME_TYPE.DATA, streamId, ct, FLAG_E2E));
             }
-        });
+        }, { jsPatch: () => uiCompat.trustE2EEAsLoopback });
         rawStreams.set(streamId, {
             handshakeBuf: Buffer.alloc(0),
             keys: null,
@@ -498,6 +537,10 @@ export function startJoin(opts) {
     }
     connect();
     return {
+        setUiCompat(trustE2EEAsLoopback) {
+            uiCompat.trustE2EEAsLoopback = trustE2EEAsLoopback;
+            console.log(`rdsh join: dshUiCompat.trustE2EEAsLoopback = ${trustE2EEAsLoopback}（运行中生效）`);
+        },
         async stop() {
             if (shuttingDown)
                 return;
@@ -534,6 +577,7 @@ export async function join(opts) {
         insecure,
         target,
         role: "cli",
+        dshUiCompat: opts.dshUiCompat,
         hooks: {
             onLog: (level, message) => {
                 (level === "error" ? console.error : console.log)(`rdsh join: ${message}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rdsh-gateway",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "rdsh host-side component: LAN auth gateway + outbound tunnel endpoint (spawns dsh web)",
   "license": "MIT",
   "type": "module",