dsh-pocket 2.6.0 → 2.6.1

package/README.en.md

@@ -194,7 +194,7 @@ Such tools take over all traffic and often cut cloudflared's tunnel-edge connect
 ```sh
 npm install
 node client/build.mjs   # rebuild after editing client/
-npm test                # proxy / auth / compression / tunnel / service / RPC / settings (105 tests)
+npm test                # proxy / auth / compression / tunnel / service / RPC / settings (108 tests)
 ```
 
 **Want to try your changes locally without publishing?** Point the installed plugin at your local checkout with a symlink and restart dsh web. Full steps (including switching back to the npm release) are in [LOCAL-DEV.md](./LOCAL-DEV.md).

package/README.md

@@ -195,7 +195,7 @@ npx @deepseek-ai/dsh web
 ```sh
 npm install
 node client/build.mjs   # 改 client/ 后重新打包
-npm test                # 代理 / 认证 / 压缩 / 隧道 / 服务 / RPC / 设置（105 测试）
+npm test                # 代理 / 认证 / 压缩 / 隧道 / 服务 / RPC / 设置（108 测试）
 ```
 
 **改完想在本机先试？** 不用发版：把插件换成指向本地仓库的软链，重启 dsh web 就是本地代码。完整步骤（含怎么换回 npm 官方版本）见 [LOCAL-DEV.md](./LOCAL-DEV.md)。

package/lib/tunnel.mjs

@@ -23,12 +23,37 @@ import { createWriteStream } from 'node:fs';
 export const QUICK_TUNNEL_URL_RE = /https:\/\/(?!api\.)[a-z0-9-]+\.trycloudflare\.com/i;
 
 function platformBinary() {
-  const archMap = { x64: 'amd64', arm64: 'arm64' };
+  const archMap = { x64: 'amd64', arm64: 'arm64', ia32: '386', arm: 'arm' };
   const a = archMap[process.arch] ?? process.arch;
   const os = process.platform === 'darwin' ? 'darwin' : process.platform === 'win32' ? 'windows' : 'linux';
   return { os, a, ext: os === 'windows' ? '.exe' : '' };
 }
 
+/**
+ * 候选发布资产名，按优先级排列（issue #45）。
+ *
+ * cloudflared 现在的发布布局是**按平台分**：
+ * - linux：只有裸二进制 `cloudflared-linux-amd64`（没有 .tgz）
+ * - darwin：只有 `cloudflared-darwin-<arch>.tgz`
+ * - windows：只有 `cloudflared-windows-<arch>.exe`
+ *
+ * 我们以前给 linux 拼的是 `cloudflared-linux-amd64.tgz`，而它**根本不存在**
+ * （GitHub 返回 404），五个镜像全指向同一个 404 地址，于是必然"所有源都不通"
+ * —— 表现就是 Linux 服务器上开了公网访问一直报"无法安装"，而 macOS/Windows
+ * 一切正常。Linux 下裸二进制还有个额外好处：不用解压，也就不再依赖系统装了
+ * `tar`（Alpine / slim 镜像 / 容器里常常没有）。
+ *
+ * linux 仍把 .tgz 留在候选里作为回退，万一上游改回打包方式也不会直接躺平。
+ *
+ * @returns {string[]} 资产名列表，越靠前越优先。
+ */
+export function platformAssets() {
+  const { os, a } = platformBinary();
+  if (os === 'windows') return [`cloudflared-windows-${a}.exe`];
+  if (os === 'darwin') return [`cloudflared-darwin-${a}.tgz`];
+  return [`cloudflared-linux-${a}`, `cloudflared-linux-${a}.tgz`];
+}
+
 /**
  * cloudflared 下载源。
  * 优先：清华 TUNA 镜像的 Homebrew bottle（国内 CDN，实测 ~3MB/s）——仅 macOS/Linux
@@ -189,51 +214,59 @@ async function downloadCloudflared(binPath, signal) {
   const dir = dirname(binPath);
   const tmpFile = join(dir, `cloudflared.download`);
   const isWindows = os === 'windows';
-  // 发布资产：Windows 是 .exe（下载即二进制），macOS/Linux 是 .tgz（需解压）
-  const asset = isWindows ? `cloudflared-windows-${a}.exe` : `cloudflared-${os}-${a}.tgz`;
   const fetchSignal = signal
     ? AbortSignal.any([signal, AbortSignal.timeout(120_000)])
     : AbortSignal.timeout(120_000);
 
-  // 构建有序源列表：[{url, host}]；清华（如有，仅 macOS/Linux）排第一，再官方 + 加速源
-  const sources = [];
-  if (!isWindows) {
-    const tua = await tsinghuaBottleUrl({ os, a }).catch(() => null);
-    if (tua) sources.push({ url: tua, host: 'mirrors.tuna.tsinghua.edu.cn' });
-  }
-  for (const m of CLOUDFLARED_MIRRORS) sources.push({ url: m(asset), host: hostOf(m(asset)) });
+  // 清华 bottle（仅 macOS/Linux 且有对应 bottle）；与资产名无关，只算一次
+  const bottle = isWindows ? null : await tsinghuaBottleUrl({ os, a }).catch(() => null);
 
+  // 逐个资产试（linux 首选裸二进制，.tgz 只是回退），每个资产再逐个源试
+  const assets = platformAssets();
   let lastErr = null;
-  for (let i = 0; i < sources.length; i++) {
-    const { url, host } = sources[i];
-    console.log(`⬇️  下载 cloudflared（${i + 1}/${sources.length}：${host}）…`);
-    try {
-      // 多线程分块（官方 GitHub 支持 Range，Windows 50MB 从几分钟降到几十秒）；
-      // 不支持 Range 的源自动回退单线程
-      await downloadFile(url, tmpFile, { signal: fetchSignal });
-      // 简单校验：空文件/极小文件视为下载失败（可能是镜像返回了错误页）
-      const st = await stat(tmpFile);
-      if (st.size < 1024 * 1024) throw new Error(`文件异常小（${st.size} 字节），疑似镜像错误页`);
-      lastErr = null;
-      break; // 下载成功
-    } catch (err) {
-      lastErr = err;
-      await rm(tmpFile, { force: true }).catch(() => {}); // 清掉半截文件
-      console.warn(`  ⚠️ 源 ${i + 1} 失败：${err?.message ?? err}，尝试下一个…`);
+  let usedAsset = null;
+
+  for (let ai = 0; ai < assets.length && usedAsset === null; ai++) {
+    const asset = assets[ai];
+    const sources = [];
+    if (bottle && asset.endsWith('.tgz')) {
+      sources.push({ url: bottle, host: 'mirrors.tuna.tsinghua.edu.cn' });
+    }
+    for (const m of CLOUDFLARED_MIRRORS) sources.push({ url: m(asset), host: hostOf(m(asset)) });
+
+    for (let i = 0; i < sources.length; i++) {
+      const { url, host } = sources[i];
+      console.log(`⬇️  下载 cloudflared（${asset}，源 ${i + 1}/${sources.length}：${host}）…`);
+      try {
+        // 多线程分块（官方 GitHub 支持 Range，Windows 50MB 从几分钟降到几十秒）；
+        // 不支持 Range 的源自动回退单线程
+        await downloadFile(url, tmpFile, { signal: fetchSignal });
+        // 简单校验：空文件/极小文件视为下载失败（可能是镜像返回了错误页）
+        const st = await stat(tmpFile);
+        if (st.size < 1024 * 1024) throw new Error(`文件异常小（${st.size} 字节），疑似镜像错误页`);
+        usedAsset = asset;
+        lastErr = null;
+        break; // 下载成功
+      } catch (err) {
+        lastErr = err;
+        await rm(tmpFile, { force: true }).catch(() => {}); // 清掉半截文件
+        console.warn(`  ⚠️ 源 ${i + 1} 失败：${err?.message ?? err}，尝试下一个…`);
+      }
     }
   }
-  if (lastErr) {
+  if (usedAsset === null) {
     throw new Error(
       `cloudflared 下载失败：所有源都不通（最后错误：${lastErr?.message ?? lastErr}）。`
       + (isWindows
-        ? `Windows 可手动安装后重试：winget install cloudflared；或下载 ${asset} 放到 ${dir} 目录 | download failed — try: winget install cloudflared, or put the exe into ${dir}`
-        : `可手动安装后重试：npm i -g cloudflared（装好命令行 cloudflared 即可，无需下载）；或开启代理/换网络后重试 | all mirrors failed — install cloudflared manually: npm i -g cloudflared, then retry`),
+        ? `Windows 可手动安装后重试：winget install cloudflared；或下载 ${assets[0]} 放到 ${dir} 目录 | download failed — try: winget install cloudflared, or put the exe into ${dir}`
+        : `也可以自己装好后在 settings.json 写 "cloudflaredPath": "/path/to/cloudflared" 跳过下载（或用环境变量 DSH_POCKET_CLOUDFLARED）；或用包管理器安装：apt/dnf install cloudflared | all mirrors failed — install cloudflared manually and set "cloudflaredPath" in settings.json, or: apt/dnf install cloudflared`),
     );
   }
 
   let extracted = join(dir, `cloudflared${ext}`);
-  if (isWindows) {
-    // Windows：exe 直接就是二进制，无需解压
+  // 只有 .tgz 才需要解压：Windows 的 .exe 和 linux 的裸二进制本身就可直接执行
+  // （linux 用裸二进制还有个好处——不依赖系统装了 tar，见 platformAssets 的说明）
+  if (!usedAsset.endsWith('.tgz')) {
     await rename(tmpFile, extracted).catch(async () => {
       await cp(tmpFile, extracted).catch(() => {});
     });
@@ -246,7 +279,13 @@ async function downloadCloudflared(binPath, signal) {
       await new Promise((resolve, reject) => {
         const child = spawn('tar', ['-xzf', tmpFile, '-C', extractDir], { stdio: 'ignore' });
         child.once('exit', (code) => code === 0 ? resolve() : reject(new Error(`cloudflared 解压失败（code=${code}）`)));
-        child.once('error', reject);
+        // spawn 失败（Alpine / slim 镜像 / 容器里常见：根本没有 tar）时 err.code 是
+        // ENOENT，直接抛出来只有一句 "spawn tar ENOENT"，看不出该怎么办
+        child.once('error', (err) => reject(
+          err?.code === 'ENOENT'
+            ? new Error(`系统里没有 tar 命令，无法解压 ${usedAsset} —— 可改用 linux 裸二进制（默认已如此）或手动安装后设置 cloudflaredPath | no tar on this system`)
+            : err,
+        ));
       });
       // 找真实的二进制**文件**（排除目录）：
       // - GitHub tgz：extractDir/cloudflared

package/package.json

@@ -80,5 +80,5 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "version": "2.6.0"
+  "version": "2.6.1"
 }