dsh-mobile-plugin 0.1.100 → 0.2.1

package/lib/relay/core.js

@@ -27,9 +27,16 @@ const MOBILE_BEARER_TTL_SEC = 365 * 24 * 3600;
 
 function genInstanceId() { return crypto.randomBytes(4).toString('hex'); }
 function genPairingCode() { return String(crypto.randomInt(0, 1000000)).padStart(6, '0'); }
+/**
+ * 二维码里那张一次性票据：32 字节随机数的 base64url（43 字符，无补位）。
+ *
+ * 它是**密钥材料**：手机拿它派生配对密钥，所以谁看到二维码谁就能配一次。它由宿主自己
+ * 生成、写进二维码、绝不经过中转 —— 中转连它长什么样都看不到。
+ */
+function genPairingTicket() { return crypto.randomBytes(32).toString('base64url'); }
 function defaultState() {
   return {
-    instanceId: genInstanceId(), pairingCode: genPairingCode(), relayUrl: '', name: os.hostname(),
+    instanceId: genInstanceId(), pairingCode: genPairingCode(), pairingTicket: genPairingTicket(), relayUrl: '', name: os.hostname(),
     lanEnabled: true, lanPort: 18787, lanSecret: crypto.randomBytes(32).toString('hex'), enabled: false,
     // 中转侧 TUNNEL_REGISTER_SECRET 的对偶值。为空时隧道注册会被中转以
     // close(1008, 'bad registration secret') 拒掉（除非中转根本没开校验）。
@@ -37,6 +44,9 @@ function defaultState() {
     // 手机优先用哪条地址（空 = 不指定）。它是 `RemoteControlSettingsSchema` 里的一项，
     // 写它不碰 sidecar（那份配置是 `impl.js` 的 `buildConfig` 逐字段拼的，不带它）。
     preferredLanAddress: '',
+    // 用户手填的直连地址（空 = 没填）。与上面那条同一条口径：也是 schema 里的一项、
+    // 也不进 sidecar 配置 —— 它只影响「报给手机的候选」与二维码，不影响隧道怎么连。
+    manualLanUrl: '',
     // 首次接入引导走完没有。**刻意不进 RemoteControlSettingsSchema**：它不是一项
     // 「远程控制设置」，改它不该触发 sidecar 重配（那条链上每加一个字段都要同步改
     // schema、worker 的 allowed 数组与 buildConfig，漏一处就抛 unknown field）。
@@ -55,6 +65,22 @@ function loadState() {
     return state;
   }
 }
+/**
+ * 配对成功之后换掉配对码与票据（§5.1）。
+ *
+ * **两件必须同一个动作**：只换码不换票据，那张截图里的票据还能再配一次；只换票据不换码，
+ * 旧码在旧形状那条路上还能用。所以这里一次改两个字段、一次落盘。
+ *
+ * 放在这里而不是装配层：它只碰 state，是可单测的纯状态变更；装配层只负责在写完之后
+ * 让旁路重读配置。
+ */
+function rotatePairing(state) {
+  state.pairingCode = genPairingCode();
+  state.pairingTicket = genPairingTicket();
+  saveState(state);
+  return { pairingCode: state.pairingCode, pairingTicket: state.pairingTicket };
+}
+
 function saveState(state) {
   fs.mkdirSync(path.dirname(STATE_FILE), { recursive: true });
   const tmp = `${STATE_FILE}.tmp`;
@@ -80,6 +106,6 @@ function signLanToken(secret, instanceId, ttlSec = MOBILE_TOKEN_TTL_SEC) { retur
 function verifyLanToken(secret, token, instanceId) { return sharedToken.verifyLanToken(secret, token, instanceId); }
 
 module.exports = {
-  STATE_FILE, MOBILE_TOKEN_TTL_SEC, MOBILE_BEARER_TTL_SEC, loadState, saveState, genInstanceId, genPairingCode,
+  STATE_FILE, MOBILE_TOKEN_TTL_SEC, MOBILE_BEARER_TTL_SEC, loadState, saveState, rotatePairing, genInstanceId, genPairingCode, genPairingTicket,
   tunnelWsUrl, signLanToken, verifyLanToken,
 };

package/lib/relay/lan-network.cjs

@@ -344,6 +344,39 @@ function advertisedCandidates(port, interfaces = os.networkInterfaces()) {
   }
 }
 
+/**
+ * 用户**自己填的**直连地址（设置项 `manualLanUrl`，通常是内网穿透域名）→ 候选。
+ *
+ * 为什么需要它：网卡扫描只能产出这台机器身上的 IP，域名一条都扫不出来。手机在「网络」页
+ * 手填的地址从前只活在手机自己那份会话里 —— 重启、换网、重新配对之后全没了，而且只要同网
+ * 还有一条扫出来的 IP 更快，手填的那条还会被顶掉。放进宿主配置之后，候选的唯一真源就回到
+ * 宿主：手机每次核对连接信息都重新拿到它，二维码里也带着它。
+ *
+ * 只挡明显不能用的：空、非 http(s)、解析不出主机。不校验端口、不要求是 IP —— 穿透域名后面
+ * 接的是什么由反代决定，宿主无从判断也没必要判断。
+ */
+function manualCandidate(value) {
+  const url = typeof value === 'string' ? value.trim().replace(/\/+$/, '') : ''
+  if (!url || !/^https?:\/\/[^\s/]+/i.test(url)) return null
+  let host = ''
+  try { host = new URL(url).hostname } catch { return null }
+  if (!host) return null
+  // `address` 与网卡候选同形（面板按裸地址显示、`orderCandidates` 按地址匹配）。
+  return { url, address: host, interface: 'manual', family: 'IPv4' }
+}
+
+/**
+ * 候选 = 用户填的那条（有的话）在前 + 其余照旧。按 url 去重，**不删**任何一条 NIC 候选：
+ * 穿透域名不通时手机还得能顺着网卡地址摸回这台机器。值不合法时原样返回 NIC 候选，
+ * 不让一条坏配置把整份候选清空（那正是彻底失联的形状）。
+ */
+function withManualCandidate(list, value) {
+  const manual = manualCandidate(value)
+  const rest = Array.isArray(list) ? list : []
+  if (!manual) return rest
+  return [manual, ...rest.filter(item => item && item.url !== manual.url)]
+}
+
 /**
  * 把用户选中的那条排到最前面（面板上的「手机优先用这条」，存在设置项 `preferredLanAddress`）。
  *
@@ -371,6 +404,17 @@ function orderCandidates(list, preferred) {
   return ordered
 }
 
+/**
+ * 报给手机的直连候选 —— 二维码、配对响应与 `/connection-info` 三处**只许走这一份**。
+ *
+ * 两步顺序不能反：先让「手机优先用这条」调网卡候选的顺序，再把用户手填的地址盖到最前
+ * （那条是用户在手机上手打的，`preferredLanAddress` 只是面板上对网卡地址的选择，压不过它）。
+ * 三处各写一遍的结果就是「画面上说这条、手机去试另一条」。
+ */
+function phoneCandidates(list, options = {}) {
+  return withManualCandidate(orderCandidates(list, options.preferred || ''), options.manual || '')
+}
+
 module.exports = {
   ipv4Number,
   ipv6Number,
@@ -391,5 +435,8 @@ module.exports = {
   ipv6Urls,
   ipv6Candidates,
   advertisedCandidates,
+  manualCandidate,
+  withManualCandidate,
   orderCandidates,
+  phoneCandidates,
 }