dsh-remote-agent 0.9.2 → 0.9.4

package/lib/client.js

@@ -109,6 +109,11 @@ window.__ModuleLoader__.load({
       '.dra-err{margin:8px 0;padding:8px 10px;border-radius:6px;font-size:12px;',
       'border:1px solid var(--dsw-alias-state-error-primary);',
       'color:var(--dsw-alias-state-error-primary)}',
+      // 警告（黄）：用于"策略性受阻"而非"出错"——例如 nodeToken 为空导致
+      // 独立监听绑回环。误用红色会让用户以为插件坏了（v0.9.3 的真实教训）。
+      '.dra-warn{margin:8px 0;padding:8px 10px;border-radius:6px;font-size:12px;',
+      'border:1px solid var(--dsw-alias-state-warning-primary,rgba(230,162,60,.6));',
+      'color:var(--dsw-alias-state-warning-primary,#e6a23c)}',
       '.dra-form{display:flex;flex-direction:column;gap:6px;margin:8px 0 4px}',
       '.dra-in,.dra-ta,.dra-sel{width:100%;box-sizing:border-box;border-radius:6px;',
       'border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);',
@@ -1052,8 +1057,12 @@ window.__ModuleLoader__.load({
       const setPairNote = pairNoteS[1]
 
       function loadPair() {
-        // 端口不用问服务端：面板本身就由 hub 的 webserver 服务，
-        // 浏览器地址栏的端口 = 节点拨入端口（同一服务）。
+        // 2026-10-20（C1）：**端口不再由前端决定**。
+        // 原来传 window.location.port，理由是"面板与节点端点同端口"——
+        // 0.9.3 把端点搬到独立监听（19387）后这个前提就不成立了，
+        // 于是生成的每个配对码都指向 DSH 面板端口（且每次启动还随机变）。
+        // 现在服务端从真实监听状态取端口；这里仍带 port 只是为了兼容
+        // "独立监听没起来、退回老通道"的旧部署。
         const port = window.location.port
           ? Number(window.location.port)
           : (window.location.protocol === 'https:' ? 443 : 80)
@@ -1576,37 +1585,95 @@ window.__ModuleLoader__.load({
         !pair
           ? h('div', { className: 'dra-empty' }, pairNote || '读取中…（/pair-info 不可达时请刷新重试）')
           : h('div', null,
+            // ── 独立监听状态（2026-10-20）──────────────────────────────
+            // 0.9.3 起副机拨的是插件自己的端口，不是 DSH 面板的端口。
+            // 这里必须如实告诉用户"在听哪个 host:port"，否则拿到配对码也
+            // 无从判断它指向哪里（这正是 C1 隐蔽的地方）。
+            (function () {
+              const L = pair.listener
+              if (!L) return null
+              if (L.state === 'listening') {
+                return h('div', { className: 'dra-kv', style: { padding: '4px 9px' } },
+                  h('span', { className: 'dra-k' }, '节点端口'),
+                  h('span', { className: 'dra-mono' }, (L.host || '?') + ':' + (L.port || '?')),
+                  h('span', { className: 'dra-dim', style: { fontSize: '11px' } },
+                    '（独立监听' + (L.source ? ' · ' + L.source : '') + '）'),
+                )
+              }
+              return h('div', {
+                className: L.state === 'failed' ? 'dra-err' : 'dra-warn',
+                style: { margin: '4px 9px 8px' },
+              },
+              h('div', { style: { fontWeight: '600' } },
+                L.state === 'failed' ? '⚠ 独立监听启动失败 —— 下面这些码连不上'
+                  : (L.state === 'disabled' ? '⚠ 独立监听已关闭 —— 走 DSH 的 Web 服务通道' : '⏳ 独立监听尚未就绪')),
+              L.hint ? h('div', { style: { marginTop: '2px' } }, L.hint) : null)
+            })(),
+            // ── 生成口令（2026-10-20，H3）──────────────────────────────
+            // 面板此前**没有**任何生成 nodeToken 的入口：YAML 与 instance.json
+            // 都不写它，所以走面板配的 hub 永远空口令 → 独立监听只能绑回环
+            // → 副机连不上，而用户完全不知道"口令"这件事。
+            h('div', { className: 'dra-kv', style: { padding: '4px 9px' } },
+              h('span', { className: 'dra-k' }, '入网口令'),
+              h('span', { className: 'dra-mono' }, pair.tokenSet ? '已设置 ✓' : '未设置（副机连不上）'),
+              !pair.tokenSet
+                ? h('button', {
+                  className: 'dra-btn',
+                  onClick: function () {
+                    const ok = window.confirm('生成一个新口令？\n\n生成后旧口令立即失效，'
+                      + '已配置旧口令的副机需要重新贴一次配对码。\n\nDSH 需要重启才生效。')
+                    if (!ok) return
+                    apiPost('/setup/rotate-token', {}).then(function (d) {
+                      if (d && d.token) {
+                        // 只显示这一次，之后服务端不再回显明文
+                        setPairNote('新口令（复制保存，只显示这一次）：' + d.token)
+                        window.setTimeout(loadPair, 400)
+                      } else {
+                        setPairNote('生成失败：' + ((d && d.message) || '未知原因'))
+                      }
+                    }, function (e) { setPairNote('生成失败：' + (e && e.message ? e.message : e)) })
+                  },
+                }, '生成口令')
+                : null,
+            ),
             pair.note ? h('div', { className: 'dra-dim', style: { padding: '2px 9px' } }, pair.note) : null,
             (pair.codes || []).length === 0
               ? h('div', { className: 'dra-empty' }, '本机没有可用的局域网地址。')
               : (pair.codes || []).map(function (c, i) {
-                return h('div', { key: c.address, style: { padding: '6px 9px' } },
-                  h('div', { className: 'dra-kv' },
-                    h('span', { className: 'dra-k' }, '地址 ' + (i + 1)),
-                    h('span', { className: 'dra-mono' }, c.address + (c.private ? '' : '（公网）')),
-                  ),
-                  h('div', { className: 'dra-mono dra-ell', style: { fontSize: '11px', padding: '2px 9px' }, title: c.hubUrl }, c.hubUrl),
-                  h('div', { className: 'dra-mono', style: {
-                    fontSize: '11px', margin: '4px 9px', padding: '6px',
-                    background: 'rgba(127,127,127,.12)', borderRadius: '4px',
-                    wordBreak: 'break-all', userSelect: 'all',
-                  } }, c.pairCode),
-                  h('div', { className: 'dra-actions', style: { padding: '0 9px 4px' } },
-                    h('button', {
-                      className: 'dra-btn',
-                      onClick: function () {
-                        copyText("pair: '" + c.pairCode + "'").then(function () {
-                          setPairNote('已复制 pair 配置行 —— 粘到副机 cordis.patch.yml 后重启副机 DSH')
-                        }, function () {
-                          setPairNote('复制失败 —— 请手动选中上面的配对码复制（整行，含 dshra1:// 开头）')
-                        })
-                      },
-                    }, '复制 pair 配置行'),
-                    h('button', {
-                      className: 'dra-btn',
-                      onClick: function () { copyText(c.pairCode).then(function () { setPairNote('已复制配对码') }, function () { setPairNote('复制失败 —— 请手动选中复制') }) },
-                    }, '只复制码'),
-                  ),
+                return h('div', {
+                  key: c.address,
+                  // 只有真正绑定的那个地址能用；其余标灰并说明原因（C2）
+                  style: { padding: '6px 9px', opacity: c.usable === false ? 0.45 : 1 },
+                },
+                h('div', { className: 'dra-kv' },
+                  h('span', { className: 'dra-k' },
+                    '地址 ' + (i + 1) + (c.usable === false ? '（不是监听地址，连不上）' : '')),
+                  h('span', { className: 'dra-mono' }, c.address + (c.private ? '' : '（公网）')),
+                ),
+                h('div', { className: 'dra-mono dra-ell', style: { fontSize: '11px', padding: '2px 9px' }, title: c.hubUrl }, c.hubUrl),
+                h('div', { className: 'dra-mono', style: {
+                  fontSize: '11px', margin: '4px 9px', padding: '6px',
+                  background: 'rgba(127,127,127,.12)', borderRadius: '4px',
+                  wordBreak: 'break-all', userSelect: 'all',
+                } }, c.pairCode),
+                h('div', { className: 'dra-actions', style: { padding: '0 9px 4px' } },
+                  h('button', {
+                    className: 'dra-btn',
+                    disabled: c.usable === false,
+                    onClick: function () {
+                      copyText("pair: '" + c.pairCode + "'").then(function () {
+                        setPairNote('已复制 pair 配置行 —— 粘到副机 cordis.patch.yml 后重启副机 DSH')
+                      }, function () {
+                        setPairNote('复制失败 —— 请手动选中上面的配对码复制（整行，含 dshra1:// 开头）')
+                      })
+                    },
+                  }, '复制 pair 配置行'),
+                  h('button', {
+                    className: 'dra-btn',
+                    disabled: c.usable === false,
+                    onClick: function () { copyText(c.pairCode).then(function () { setPairNote('已复制配对码') }, function () { setPairNote('复制失败 —— 请手动选中复制') }) },
+                  }, '只复制码'),
+                ),
                 )
               }),
             h('div', { className: 'dra-kv', style: { padding: '4px 9px' } },
@@ -1728,28 +1795,70 @@ window.__ModuleLoader__.load({
       // （托管块残留）、自己改错。
       //
       // 所以这里渲染成**红色横幅 + 具体修法**。日志用户不会看，面板会看。
+      //
+      // ═══════════════════════════════════════════════════════════════════════
+      // 2026-10-20 重写（v0.9.3 审查 H5）：横幅要按**独立监听**判断
+      // ═══════════════════════════════════════════════════════════════════════
+      //
+      // 0.9.3 把节点端点搬到了插件自己的监听端口（默认 19387），不再跟 DSH 的
+      // webserver 同端口。但这里的判断条件仍是 `reach.loopback === true` ——
+      // 而 DSH 的 webserver 默认就绑 127.0.0.1。
+      //
+      // 结果：副机明明能从 19387 连上，面板却天天挂一条大红条说"连不上"，
+      // 还把用户引向"改 webserver 的 host"这个**已被证伪**的修法
+      // （DSH 每次启动都重写 patch，改了就丢，而且跟新通道无关）。
+      //
+      // 现在分三种情况，只有真的连不上才红：
+      //   · 独立监听在听且绑非回环 → 不显示横幅（正常）
+      //   · 独立监听在听但绑回环   → 黄条：多半是 nodeToken 为空（安全策略）
+      //   · 独立监听没起来          → 红条：端口被占/地址不可用，给改法
       const reach = caps && caps.reachability ? caps.reachability : null
-      const reachBox = reach && reach.loopback === true
-        ? h('div', { className: 'dra-err', style: { marginBottom: '10px' } },
-          h('div', { style: { fontWeight: '600', marginBottom: '4px' } },
-            '⚠ 副机连不上：本机 Web 服务只监听 ' + (reach.bound || '127.0.0.1')),
-          h('div', null, '现在监听在 ', h('code', null, reach.origin || ''),
-            '，只有本机能访问。副机用任何地址都连不上。'),
-          h('div', { style: { marginTop: '6px' } }, '修法：在 profile 的 ',
-            h('code', null, 'cordis.patch.yml'), ' 里把 ', h('code', null, 'webserver'),
-            ' 的 ', h('code', null, 'host'), ' 改成一个具体的本机 IP，然后重启 DSH。'),
-          // ⚠ 修法**不能写 0.0.0.0**（2026-10-18 事故）：新版 dsh-host-webserver
-          // 在 schema 校验阶段就拒绝通配地址，会让 **DSH 启动崩溃**
-          // （webserver 是 required 插件）。必须绑一个具体的本机接口地址。
-          h('div', { className: 'dra-dim', style: { marginTop: '2px' } },
-            '⚠ 不能用 0.0.0.0 —— 新版 DSH 会拒绝并导致启动失败。'
-            + '查地址：Tailscale 用 tailscale ip -4，局域网用 ipconfig。'
-            + '推荐绑 Tailscale IP（固定不变、跨网可达）。'),
-          reach.hint
-            ? h('div', { className: 'dra-dim', style: { marginTop: '4px' } }, reach.hint)
-            : null,
-        )
-        : null
+      const lis = caps && caps.listener ? caps.listener : null
+      const listenUp = lis && lis.ok === true
+      const listenLoop = listenUp && reach ? reach.loopback === true : false
+
+      // 只有"确实没有可用通道"才用红色；回环是策略问题，用黄色提示
+      const reachBox = (function () {
+        if (listenUp && listenLoop !== true) return null // 主通道正常，什么都不显示
+
+        if (listenUp && listenLoop === true) {
+          return h('div', { className: 'dra-warn', style: { marginBottom: '10px' } },
+            h('div', { style: { fontWeight: '600', marginBottom: '4px' } },
+              '⚠ 独立监听绑在回环（' + (reach && reach.origin ? reach.origin : lis.host) + '），副机还连不上'),
+            h('div', null, '这是**安全策略**：nodeToken 为空时，端点不暴露到网络'
+              + '（否则同网络里任何人都能无口令接入）。'),
+            h('div', { style: { marginTop: '6px' } },
+              '修法：点右上角「副机接入」→「生成口令」，然后按提示重启 DSH。'),
+          )
+        }
+
+        if (lis && lis.ok === false) {
+          return h('div', { className: 'dra-err', style: { marginBottom: '10px' } },
+            h('div', { style: { fontWeight: '600', marginBottom: '4px' } },
+              '⚠ 独立监听启动失败：副机拨不进来'),
+            h('div', null, '原因：', h('code', null, lis.error || '未知')),
+            h('div', { style: { marginTop: '6px' } },
+              '修法：多半是端口 ' + (lis.port || 19387) + ' 被占用，'
+              + '或者 listenHost 填的本机 IP 在这台机器上不存在（换网卡/换网络后很常见）。'
+              + '改一个空闲的 listenPort、或把 listenHost 留空让它自动选，然后重启 DSH。'
+              + '注意 listenHost 不能用 0.0.0.0（新版 DSH 直接拒绝，必须填具体 IP）。'),
+          )
+        }
+
+        // 独立监听关闭/未就绪 → 退回老通道判断
+        if (reach && reach.loopback === true) {
+          return h('div', { className: 'dra-err', style: { marginBottom: '10px' } },
+            h('div', { style: { fontWeight: '600', marginBottom: '4px' } },
+              '⚠ 副机连不上：没有可用的节点端口'),
+            h('div', null, '独立监听未启用',
+              lis && lis.disabled ? '（' + lis.disabled + '）' : '',
+              '，而 DSH 的 Web 服务只监听 ', h('code', null, reach.origin || '127.0.0.1'), '。'),
+            h('div', { style: { marginTop: '6px' } },
+              '修法：去掉配置里的 ', h('code', null, 'listenPort: 0'), '，让独立监听启用。'),
+          )
+        }
+        return null
+      })()
 
       const cards = h('div', { className: 'dra-cards' },
         h('div', { className: 'dra-card' },

package/lib/env-check.js

@@ -57,6 +57,74 @@ function item(ok, id, label, { fix = '', detail = '', autoFix = false, severity
 // 凡是判定"这台机器是 hub 还是 worker"的地方都得过这一层。
 // （v0.9.0 审查 H1 的根因就是这里漏了 —— 直接拿原始 'auto' 跟 'hub' 比。）
 import { resolveRole } from './index.js'
+// 回环判据**必须只有一份实现**（2026-10-20 收口）：
+// 独立监听、env-check、面板曾各写一份，C2 就是这类"两套判据"分叉的直接后果。
+import { isLoopbackHost } from './listen-server.js'
+
+/**
+ * 独立监听这一项的体检（2026-10-20 新增，v0.9.3 审查 M4）。
+ *
+ * 三种状态要分开报，因为**修法完全不同**：
+ *   · listening  → 看绑在哪（回环 = 副机连不上，多半是 nodeToken 为空）
+ *   · disabled   → 用户显式关了（listenPort: 0），走老通道，不算错
+ *   · failed     → 端口被占/地址不可用，改 listenPort 或 listenHost
+ *   · 未就绪     → 刚启动，稍后刷新
+ *
+ * @param {object|null} listener { ok, disabled, host, port, source, error }
+ * @param {object} cfg 归一化后的配置（用于给出可粘贴的修法片段）
+ */
+function listenerCheck(listener, cfg) {
+  const L = listener && typeof listener === 'object' ? listener : null
+  const host = L && typeof L.host === 'string' ? L.host : ''
+  const port = L && Number.isFinite(L.port) ? L.port : null
+  const source = L && typeof L.source === 'string' ? L.source : ''
+  const err = L && typeof L.error === 'string' ? L.error : ''
+  const disabled = L && typeof L.disabled === 'string' ? L.disabled : ''
+
+  if (!L || L.ok === null || L.ok === undefined) {
+    return item(true, 'listener', '独立监听（尚未就绪）', {
+      detail: '插件刚启动？稍后刷新体检',
+      severity: 'info',
+    })
+  }
+
+  if (L.ok === true) {
+    const loop = isLoopbackHost(host)
+    return item(!loop, 'listener', loop
+      ? '独立监听绑在回环（副机连不上）'
+      : '独立监听已就绪（副机从这里拨入）', {
+      detail: loop
+        ? `${host}:${port ?? '?'} —— 安全策略：nodeToken 为空时不暴露到网络`
+        : `${host}:${port ?? '?'}（来源 ${source || 'auto'}）`,
+      fix: loop
+        ? '到面板「副机接入」点「生成口令」（写入 nodeToken），重启 DSH 后会改绑可达地址。\n'
+          + '  或显式指定：yaml:\n'
+          + '  - id: remote-agent\n'
+          + '    config:\n'
+          + "      listenHost: '<本机具体 IP，如 tailscale ip -4 的结果>'"
+        : '',
+      autoFix: true,
+    })
+  }
+
+  if (disabled !== '') {
+    return item(true, 'listener', '独立监听已关闭（走 DSH 的 Web 服务通道）', {
+      detail: `原因：${disabled}`,
+      severity: 'info',
+    })
+  }
+
+  return item(false, 'listener', '独立监听启动失败（副机拨不进来）', {
+    detail: err !== '' ? err : '未知原因',
+    fix: '端口多半被占用。换一个空闲端口后重启 DSH：\n'
+      + '  yaml:\n'
+      + '  - id: remote-agent\n'
+      + '    config:\n'
+      + `      listenPort: ${Number.isFinite(cfg?.listenPort) ? (cfg.listenPort + 1) : 19388}`,
+    autoFix: true,
+  })
+}
+
 
 /**
  * 判定一个 origin/URL 是否只对本机可见。
@@ -82,7 +150,8 @@ export function isLoopbackOrigin(origin) {
  * @param {object} o
  * @param {'hub'|'worker'} o.role
  * @param {object} [o.config] 本行生效配置（只读快照）
- * @param {object|null} [o.reachability] hub 的可达性自检结论（applyHub 产出）
+ * @param {object|null} [o.reachability] 可达性结论（独立监听优先；见 applyHub 的 currentReachability）
+ * @param {object|null} [o.listener] 独立监听原始状态 { ok, disabled, host, port, source, error }
  * @param {number|null} [o.webPort] 实际监听的端口（探测结果）
  * @param {boolean|null} [o.portFree] 目标端口是否空闲（探测结果）
  * @param {boolean|null} [o.firewallOk] 防火墙是否放行（探测结果；null=未探测）
@@ -95,6 +164,7 @@ export function envChecks({
   role,
   config = {},
   reachability = null,
+  listener = null,
   webPort = null,
   portFree = null,
   firewallOk = null,
@@ -187,49 +257,67 @@ export function envChecks({
     ))
   }
 
-  /* ── 3. hub 可达性（**最贵的一条**：绑 loopback 时副机永远连不上）── */
+  /* ── 3. 独立监听（0.9.3 起**副机拨入的主通道**）─────────────────
+   *
+   * ⚠ 这是 2026-10-20 补的（v0.9.3 审查 M4）。此前体检查了 10 项，
+   * **没有一项**观察独立监听到底起没起来 —— 而它才是副机真正连的那条路。
+   * 端口被占、绑错地址、因为 nodeToken 为空退回回环，体检全都看不见。
+   */
+  if (isHub) {
+    out.push(listenerCheck(listener, cfg))
+  }
+
+  /* ── 4. 节点端点可达性（两条通道联合判断）────────────────────────
+   *
+   * 2026-10-20 重写（v0.9.3 审查 H5）：
+   * 原实现只看 `ctx.webServer.getOrigin()`。0.9.3 把端点搬到独立监听后，
+   * 这造成**假红** —— DSH 的 webserver 仍绑 127.0.0.1（它的默认行为），
+   * 于是面板天天报"副机用任何地址都连不上"，而 19387 上正好好地服务着。
+   * 更糟的是修法让用户去改 webserver 的 host —— 那个改动会被 DSH 每次启动
+   * 重写冲掉，且与新通道无关。
+   *
+   * 现在：独立监听在听且绑非回环 → 直接判可达，并把实际地址报出来。
+   */
   if (isHub) {
+    const listenUp = listener !== null && typeof listener === 'object'
+      && listener.ok === true
+      && typeof listener.host === 'string' && listener.host !== ''
+    const listenLoop = listenUp ? isLoopbackHost(listener.host) : null
+
     const loop = reachability && typeof reachability.loopback === 'boolean'
       ? reachability.loopback
       : (reachability && typeof reachability.origin === 'string' ? isLoopbackOrigin(reachability.origin) : null)
-    if (loop === null) {
-      out.push(item(true, 'reachability', 'Web 服务可达性（无法判定，已跳过）', {
-        detail: reachability && reachability.hint ? reachability.hint : '未拿到 webServer.getOrigin()',
+
+    if (listenUp && listenLoop === false) {
+      // 主通道好着 —— 不再看 webServer（它绑 loopback 也无所谓）
+      out.push(item(true, 'reachability', '节点端点可达（副机从独立监听拨入）', {
+        detail: `${listener.host}:${listener.port ?? '?'}（来源 ${listener.source || 'auto'}）`,
+      }))
+    } else if (listenUp && listenLoop === true) {
+      out.push(item(false, 'reachability', '独立监听绑在回环 —— 副机连不上', {
+        fix: '这是安全策略：nodeToken 为空时不把端点暴露到网络。\n'
+          + '  到面板「副机接入」点「生成口令」，重启 DSH 后会自动选可达地址；\n'
+          + '  或显式配置 listenHost: \'<本机具体 IP>\' 并设置 nodeToken。',
+        detail: `当前绑 ${listener.host}:${listener.port ?? '?'}`,
+        autoFix: true,
+      }))
+    } else if (loop === null) {
+      out.push(item(true, 'reachability', '节点端点可达性（无法判定，已跳过）', {
+        detail: reachability && reachability.hint ? reachability.hint : '未拿到独立监听或 webServer 状态',
         severity: 'info',
       }))
     } else {
+      // 主通道没起来 → 只能靠 DSH webserver 那条老通道（绑具体 IP 才通）
       out.push(item(
         loop === false,
         'reachability',
-        'Web 服务绑在可达地址（副机才能连上）',
+        '节点端点可达（独立监听未启用，退回 DSH 的 Web 服务）',
         {
-          // 修法给**可直接粘贴的片段**（v0.9.0 审查 L3：不假装有一键修复）。
-          // 这是用户 profile 的配置，插件客观上不能静默代改 ——
-          // 用户 profile 优先于包内 patch 是明确的设计。
-          //
-          // ⚠ **绝对不要建议 `0.0.0.0`**（2026-10-18 事故）。
-          //
-          // 新版 `dsh-host-webserver` 在 schema 校验阶段就硬拒绝通配地址：
-          //   host "0.0.0.0" is an unspecified (wildcard) address, which is not
-          //   supported: binding every interface would expose remote code
-          //   execution to the network; bind one concrete IPv4 or IPv6 address
-          //   of a local interface instead
-          //
-          // 后果是 **DSH 启动崩溃**（webserver 是 required 插件，它挂了
-          // `webServer` 服务就缺失，至少 6 个插件排队等它）。v0.9.0 曾把这个
-          // 建议写进包内 patch，实测产生 10 份 crash 日志。
-          //
-          // 正确做法：绑**一个具体的本机接口地址**。推荐 Tailscale IP ——
-          // 它固定不变、跨网可达，正好是本插件的使用场景。
-          fix: '把 profile 的 cordis.patch.yml 里 webserver 的 host 改成'
-            + '**一个具体的本机 IP**（不能用 0.0.0.0 —— 新版 DSH 会拒绝并启动失败），'
-            + '然后**重启 DSH**。\n'
-            + '  查地址：Tailscale 用 `tailscale ip -4`，局域网用 `ipconfig`。\n'
-            + '  推荐绑 Tailscale IP（固定不变、跨网可达）：\n'
-            + '  - id: webserver\n'
-            + '    config:\n'
-            + "      host: '<你的具体 IP，例如 100.x.x.x>'\n"
-            + '      port: 19387',
+          // ⚠ **绝对不要建议 `0.0.0.0`**（2026-10-18 事故，10 份 crash 日志）
+          fix: '优先让独立监听起来（改 listenPort 换个空闲端口，或检查 nodeToken）。\n'
+            + '  若确实要走 DSH 的 Web 服务：把 profile 的 cordis.patch.yml 里 webserver 的 host\n'
+            + '  改成**一个具体的本机 IP**（不能用 0.0.0.0），然后重启 DSH。\n'
+            + '  查地址：Tailscale 用 `tailscale ip -4`，局域网用 `ipconfig`。',
           detail: loop
             ? `当前只监听 ${reachability.bound || '127.0.0.1'}（${reachability.origin || ''}）—— 副机用任何地址都连不上`
             : `当前监听 ${reachability.origin || ''}`,