terminal-bridge-setup 3.3.0 → 3.3.2

package/bin/setup.mjs

@@ -42,6 +42,33 @@ const step = (n, total, msg) => console.log(`\n${c.bold(c.cyan(`[${n}/${total}]`
 const STEPS = 5;
 
 // ===================== 步骤 1：释放文件 =====================
+// 升级安装前停掉旧代理实例：读 .proxy.pid 杀进程（跨平台 process.kill）。
+// 不停的话旧实例一直占 8787，新代理启动即 EADDRINUSE 异常退出（Windows 实测踩过）
+function stopOldProxy() {
+  const pidFile = join(INSTALL_DIR, "proxy", ".proxy.pid");
+  if (!existsSync(pidFile)) return;
+  let pid;
+  try {
+    pid = Number(String(readFileSync(pidFile, "utf8")).trim());
+  } catch { return; }
+  if (!Number.isInteger(pid) || pid <= 0) return;
+  try {
+    process.kill(pid, "SIGTERM");
+    console.log(c.yellow(`  已停止旧代理实例 (pid ${pid})`));
+    // 给旧进程一点退出时间，避免端口未释放
+    const deadline = Date.now() + 2000;
+    while (Date.now() < deadline) {
+      try { process.kill(pid, 0); Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 100); }
+      catch { break; }  // 进程已退出
+    }
+  } catch (err) {
+    // ESRCH=进程不存在（正常）；EPERM=权限不足（尽力而为，不阻断安装）
+    if (err.code !== "ESRCH") {
+      console.log(c.yellow(`  旧代理 (pid ${pid}) 停止失败（${err.code || err.message}），如新代理启动报端口占用请手动结束 node 进程`));
+    }
+  }
+}
+
 function releaseFiles() {
   step(1, STEPS, `释放文件到 ${c.dim(INSTALL_DIR)}`);
 
@@ -54,10 +81,12 @@ function releaseFiles() {
   if (existsSync(INSTALL_DIR)) {
     if (isForce) {
       console.log(c.yellow("  已存在 ~/.terminal-bridge/，--force 模式：覆盖"));
+      stopOldProxy();
       rmSync(INSTALL_DIR, { recursive: true, force: true });
     } else {
       // 不强制覆盖时，仍然更新文件（保留 .proxy.pid/.proxy.log 等运行时产物）
       console.log(c.yellow("  ~/.terminal-bridge/ 已存在，将更新文件（运行时产物保留）"));
+      stopOldProxy();
     }
   }
 
@@ -78,14 +107,19 @@ function releaseFiles() {
 
 // ===================== 步骤 2：装代理依赖 =====================
 function installProxyDeps() {
-  step(2, STEPS, "安装代理依赖 (ws)");
+  step(2, STEPS, "安装代理依赖 (ws + @msgpack/msgpack)");
 
-  // 如果 node_modules/ws 已存在（从包里带出来的），跳过
+  // 跳过条件：两个依赖都存在才跳过。只查 ws 会漏掉 @msgpack/msgpack——
+  // 旧版本装的 node_modules 只有 ws，升级后代理启动即 ERR_MODULE_NOT_FOUND
   const wsPath = join(INSTALL_DIR, "proxy", "node_modules", "ws");
-  if (existsSync(wsPath)) {
-    ok("依赖已存在，跳过");
+  const msgpackPath = join(INSTALL_DIR, "proxy", "node_modules", "@msgpack", "msgpack");
+  if (existsSync(wsPath) && existsSync(msgpackPath)) {
+    ok("依赖已存在（ws + @msgpack/msgpack），跳过");
     return;
   }
+  if (existsSync(wsPath) && !existsSync(msgpackPath)) {
+    console.log(c.yellow("  检测到 ws 存在但 @msgpack/msgpack 缺失（旧版本残留），补装"));
+  }
 
   const proxyDir = join(INSTALL_DIR, "proxy");
 
@@ -124,7 +158,13 @@ function installProxyDeps() {
     console.error("");
     fail("npm install 失败（见上方排查建议）");
   }
-  ok("依赖安装完成");
+  // 装完验证两个依赖真实落盘（防 npm 静默半装/registry 缺包）
+  if (!existsSync(wsPath) || !existsSync(msgpackPath)) {
+    console.error(c.red("  ✗ 依赖验证失败：ws 或 @msgpack/msgpack 未落盘"));
+    console.error(c.yellow(`  手动修复：cd "${join(INSTALL_DIR, "proxy")}" && npm install`));
+    fail("依赖安装不完整");
+  }
+  ok("依赖安装完成（已验证 ws + @msgpack/msgpack）");
 }
 
 // ===================== 步骤 3：注册 native host =====================

package/files/extension/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "JumpServer 终端桥接",
-  "version": "3.3.0",
+  "version": "3.3.2",
   "description": "终端桥接：JumpServer / Arthas / Yearning，让 Agent 能通过浏览器执行命令、收结果与查数据",
   "key": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtsnqR6PcFUueZwYria79tVbstvjk+tM7PpvIXILm5xbd6bAdjDIhzg3lsnKioVfvxjfvT+s6vJsiOYa9ojVZyJMFc5m/05TYqr770ovYwQmz0e88fmiy6dUoSulbtKvBCSLbN6OOL7u+ul8ixLZ/HautxSmou/eNgAFPmhE+4UueE7wfCqcgMYvjLvEzlqTVumMW+5LKw9YsRk6WhHPghY1a3MVUn3eQOWXBtQTEUy3wBM3v4wHxLwDeinVOR4f/P87IlUNo84C5DeimoFit0qCj3K04hS8MIYCLCYZc3v9ftRJDJBkAoah6Eaqj7JajbS3KvLR1ctOYfDhubgmURQIDAQAB",
   "permissions": ["debugger", "tabs", "alarms", "webNavigation", "nativeMessaging", "scripting", "downloads", "storage"],

package/files/proxy/server.js

@@ -13,7 +13,6 @@
 
 import { WebSocketServer } from "ws";
 import { randomBytes } from "node:crypto";
-import { decode as msgpackDecode } from "@msgpack/msgpack";
 import { writeFileSync, unlinkSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 
@@ -34,6 +33,17 @@ const PROBE_LOG = process.env.PROBE_LOG !== "0"; // 默认开探针日志
 
 const TAG = "[proxy]";
 
+// msgpack 只有 Yearning 结果解析用到，终端桥接（JumpServer/Arthas）不需要。
+// 按需动态加载：缺依赖时降级为告警 + Yearning 功能不可用，而不是整个代理
+// 启动崩溃（Windows 用户 npm install 缺包时曾把终端功能一起拖死，实测踩过）。
+let msgpackDecode = null;
+try {
+  ({ decode: msgpackDecode } = await import("@msgpack/msgpack"));
+} catch {
+  console.warn(TAG, "⚠ @msgpack/msgpack 未安装：Yearning 查询结果解析不可用（终端命令不受影响）");
+  console.warn(TAG, "⚠ 修复：cd ~/.terminal-bridge/proxy && npm install");
+}
+
 // ===================== 客户端管理 =====================
 // 一个端点两类客户端：插件（唯一）和 Agent（多个）。
 // 我们不严格区分谁连进来，靠消息 type 路由。
@@ -151,6 +161,7 @@ function feedYearningWaiters(payload) {
   const opcode = payload && payload.opcode;
   const data = payload && payload.data;
   if (opcode !== 2 || typeof data !== "string") return;
+  if (!msgpackDecode) return;  // msgpack 缺失时 Yearning 解析不可用（启动时已告警）
   let obj = null;
   try {
     obj = msgpackDecode(Buffer.from(data, "base64"));
@@ -917,6 +928,17 @@ function finalizeOutput(entry) {
 
 // ===================== WebSocket 服务 =====================
 const wss = new WebSocketServer({ host: HOST, port: PORT });
+// 绑定失败（典型：升级安装时旧代理实例还在占端口）必须给出可读原因再退出，
+// 否则 Windows 上表现为"node 抛异常退出"，用户无从下手
+wss.on("error", (err) => {
+  if (err && err.code === "EADDRINUSE") {
+    console.error(TAG, `端口 ${PORT} 已被占用：很可能有一个旧代理实例还在运行。`);
+    console.error(TAG, "请先停止旧代理（插件 popup「停止代理」，或任务管理器结束对应 node 进程）后重试。");
+  } else {
+    console.error(TAG, "代理启动失败:", err && (err.stack || err.message || err));
+  }
+  process.exit(1);
+});
 
 wss.on("connection", (ws, req) => {
   const url = req.url || "/ssh";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terminal-bridge-setup",
-  "version": "3.3.0",
+  "version": "3.3.2",
   "description": "一次性安装器：释放终端桥接（JumpServer / Arthas / Yearning）的本地代理 + Chrome 插件，并注册 native messaging host。让 Agent 能通过浏览器 xterm 终端执行命令并拿回输出。",
   "license": "MIT",
   "author": "encorearon",