dsh-pocket 1.3.2 → 1.3.3

package/lib/service.mjs

@@ -19,13 +19,54 @@ export async function qrDataUrl(text, { width = 220, margin = 1 } = {}) {
   return QRCode.toDataURL(text, { errorCorrectionLevel: 'M', margin, width, type: 'image/png' });
 }
 
-function lanIPv4() {
-  for (const ifaces of Object.values(networkInterfaces())) {
-    for (const i of ifaces ?? []) {
-      if (i.family === 'IPv4' && !i.internal) return i.address;
+/** RFC1918 私网地址：手机与电脑连同一局域网时通常可直连。 */
+const PRIVATE_IPV4_RE = /^(?:10\.|192\.168\.|172\.(?:1[6-9]|2\d|3[01])\.)/;
+
+/** 名称像真实物理网卡的接口（WLAN / Wi-Fi / Ethernet / 以太网 / en / eth）。 */
+const PHYSICAL_IFACE_RE = /^(?:wlan|wi-?fi|wireless|ethernet|eth\d|en\d|wlp\d|以太网|本地连接)/i;
+
+/** 常见的 VPN / 虚拟网卡名称：手机通常无法通过它们直连电脑。 */
+const VPN_IFACE_RE = /(?:radmin|tailscale|zerotier|tun|tap|vpn|vethernet|virtual|vmware|virtualbox|wsl|docker|teredo|hamachi|bluetooth|bridge)/i;
+
+/**
+ * 从 networkInterfaces() 返回的接口表里选出手机最可能可达的 IPv4。
+ *
+ * `os.networkInterfaces()` 的枚举顺序不可靠：Windows 上 Radmin VPN / Tailscale /
+ * vEthernet 等虚拟网卡常排在 WLAN 前面，旧实现直接取第一张非回环网卡，会生成
+ * 手机打不开的二维码。这里按以下规则打分排序：
+ *   - RFC1918 私网地址优先（10/8、172.16/12、192.168/16）；
+ *   - 名称像物理网卡再加分；
+ *   - 名称像 VPN/虚拟网卡减分；
+ *   - 同分保持原枚举顺序。
+ * 没有任何私网地址时回退到最高分地址（例如纯 VPN 环境仍可用）。
+ *
+ * @param {ReturnType<typeof networkInterfaces>} interfaces
+ * @returns {string|null}
+ */
+export function selectLanIPv4(interfaces) {
+  const candidates = [];
+  for (const [name, addrs] of Object.entries(interfaces ?? {})) {
+    for (const addr of addrs ?? []) {
+      if (addr.family !== 'IPv4' || addr.internal) continue;
+      const ip = addr.address;
+      // 排除 loopback 与 link-local；其余地址即使不是私网（如 Radmin 的 26.x）也保留兜底
+      if (!ip || ip.startsWith('127.') || ip.startsWith('169.254.')) continue;
+
+      let score = 0;
+      if (PRIVATE_IPV4_RE.test(ip)) score += 100;
+      if (PHYSICAL_IFACE_RE.test(name)) score += 20;
+      else if (VPN_IFACE_RE.test(name)) score -= 50;
+
+      candidates.push({ ip, score, order: candidates.length });
     }
   }
-  return null;
+
+  candidates.sort((a, b) => b.score - a.score || a.order - b.order);
+  return candidates[0]?.ip ?? null;
+}
+
+function lanIPv4() {
+  return selectLanIPv4(networkInterfaces());
 }
 
 /**

package/package.json

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