dsh-mobile-ios 0.2.17 → 0.2.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -97,6 +97,8 @@ dsh plugin --profile desktop add /path/to/dsh-mobile-ios
97
97
  | banner 状态点红色 | 网关未起或端口被占——插件自动顺延 3082–3085,重启 DSH 再试 |
98
98
  | 手机「需要重新配对」 | 设备被电脑端撤销或凭证过期;手机端「重新配对」不清本地历史 |
99
99
  | 隧道地址变了 | Quick Tunnel 重启后域名会变(网关会广播 `addr_changed`),手机端用新地址重配对 |
100
+ | 提示「登录的 Cloudflare 账号不对」 | 本机 `~/.cloudflared/cert.pem` 不是持有该域名那个账号签发的:在终端执行 `cloudflared tunnel login`,浏览器里选**持有该域名**的账号授权,再回面板点「重新检测」。重装插件 / 重启宿主 / 改 NS 都无效 |
101
+ | 固定地址忽然变成另一个前缀 | 本机状态被重置或来自另一台电脑(`tunnel-credentials.mjs` 的 machine 归属校验会拒绝冒充)。点「开启远程」重新分配,或先「重置本机状态」 |
100
102
 
101
103
  ## 兼容性
102
104
 
@@ -266,6 +268,10 @@ bash spike0/run-demo.sh # 自动起服务 → 造 3 帧 → 跑客户
266
268
  | `GET /mobile/v1/tunnel` | 状态。`executable: missing` 表示主机未装 cloudflared,客户端应**隐藏**入口 |
267
269
  | `POST /mobile/v1/tunnel/start` | 启动,幂等。地址漂移时向在线会话广播 `gateway{event:"addr_changed"}` |
268
270
  | `POST /mobile/v1/tunnel/stop` | 关闭并回收子进程(网关退出时也会收,不留孤儿) |
271
+ | `POST /mobile/v1/tunnel/provision` | 开通固定地址(幂等)。写 DNS 前先做凭据预检,见 9.1 |
272
+ | `POST /mobile/v1/tunnel/recheck-dns` | 强制重探解析 + 强制刷新凭据预检(解开「解析异常」自锁死) |
273
+ | `POST /mobile/v1/tunnel/reset` | 清本机固定地址状态与 ingress(不碰 cert.pem、不删云端隧道),幂等 |
274
+ | `POST /mobile/v1/tunnel/install-cloudflared` | 用户同意后从官方源自举安装 cloudflared 到私有目录 |
269
275
  | `GET /mobile/v1/diag/bundle` | 脱敏诊断包,含可直接粘贴的 `text` 字段 |
270
276
 
271
277
  三条硬约束:
@@ -275,6 +281,27 @@ bash spike0/run-demo.sh # 自动起服务 → 造 3 帧 → 跑客户
275
281
  `lastUrl` 跨 stop/start 保留,正是为了检测这种真实漂移。
276
282
  3. **诊断包不外发隐私**:不含设备 token、绝对路径、prompt 正文、产物内容(`test/ops.mjs` 有对应断言)。
277
283
 
284
+ ### 9.1 固定地址开通:换台电脑也必须能自证
285
+
286
+ 分发到另一台电脑后「分配不出固定地址」的根因不是网络,而是**本机凭据与状态的归属**。
287
+ 这条链路上有五条不可放松的规则(对应 `test/tunnel-credentials.mjs`):
288
+
289
+ | 规则 | 实现 | 为什么 |
290
+ |---|---|---|
291
+ | 开通前预检 cert 的可用性 | `zone-health.verifyCertAccess` | 跨账号的 cert 能列/建隧道、只有写 DNS 会失败;等 CLI 报错时用户已拿到「隧道正常」的假象 |
292
+ | 预检只在**确定**不可用时拦人 | `blocking` 状态集 | 断网/证书格式不认识 → `unknown`,不能因此判死一台本来能用的机器 |
293
+ | 失败信息保留 `code/reason` | `tunnel-error.explainTunnelFailure` | 旧实现 `split('\n')[0]` 把 `code: 10000, Authentication error` 丢掉,只剩命令回显 |
294
+ | 状态带机器归属 | `tunnel-state.machineIdentity` + `isForeignState` | 整份 `~/.dsh` 被拷到新机器时,旧地址指向旧机器;新机器绝不能冒充 |
295
+ | 没有 cert.pem 也能起隧道 | `LocalStateProvisioner` | 本地 ingress 与 tunnel 凭据都在本机,日常启动不需要 zone 凭据;端口顺延只重写本地配置 |
296
+
297
+ 诊断矩阵(`TunnelStatus.credentials.state`):`ok` / `missing`(没有 cert) / `unreadable`(解析不了,降级)
298
+ / `no-token`(旧版证书,降级) / `forbidden`(403) / `zone-missing`(这账号看不到域名) /
299
+ `account-mismatch`(证书账号 ≠ zone 账号) / `stale-zone`(证书指向已被重建的 zone) /
300
+ `zone-moved`(域名被另一账号接管) / `unknown`(网络不可达)。
301
+
302
+ 唯一正确的修法只有一个:**用持有该域名的账号重跑 `cloudflared tunnel login`**。
303
+ 换账号后 `ensure()` 会自动识别账号变更、重建隧道并**沿用同一个子域**(地址不变、无需重新配对)。
304
+
278
305
  ## 10. 下一步
279
306
 
280
307
  1. **X2 真宿主实跑**:desktop profile 的 `cordis.patch.yml` 打开 `host: mux` 重启,对照 diag 服务可见性。
@@ -5,7 +5,6 @@
5
5
  // 3. 宿主卸载插件时必须彻底释放 socket / 定时器,不留孤儿监听。
6
6
 
7
7
  import os from 'node:os';
8
- import fs from 'node:fs';
9
8
  import path from 'node:path';
10
9
  import { createGateway } from '../src/server.mjs';
11
10
  import { createFileLog } from '../src/file-log.mjs';
@@ -13,7 +12,7 @@ import { findCloudflared, sweepOrphanTunnels } from '../src/tunnel.mjs';
13
12
  import { createMockHost } from '../src/adapter/mock-host.mjs';
14
13
  import { createMuxHost } from '../src/adapter/mux-host.mjs';
15
14
  import { createCordisHost } from '../src/adapter/cordis-host.mjs';
16
- import { createProvisioner } from '../src/cloudflare.mjs';
15
+ import { resolveProvisioner, defaultTunnelStateFile } from '../src/provision-select.mjs';
17
16
  import { PLUGIN_VERSION } from '../src/version.mjs';
18
17
 
19
18
  export const name = 'dsh-mobile-ios';
@@ -95,62 +94,37 @@ export function apply(ctx = {}, config = {}) {
95
94
  .catch(() => { /* 清扫失败不挡启动 */ });
96
95
 
97
96
  /**
98
- * Pro 固定地址开通器。按「已经能用的证据」排序,谁先齐备用谁:
97
+ * Pro 固定地址开通器。判定统一在 resolveProvisioner(与 sidecar 同一套顺序):
99
98
  * 1. config.tunnel.provisioner(显式指定,尊重运营决定)
100
- * 2. Cloudflare API(config 或 env 里有 accountId + apiToken)
101
- * 3. 开通服务(endpoint + enrollToken,产品形态;zone 权限留在服务端)
99
+ * 2. 开通服务(endpoint + enrollToken,产品形态;zone 权限留在服务端)
100
+ * 3. Cloudflare API(config 或 env 里有 accountId + apiToken)
102
101
  * 4. 本地管理型(~/.cloudflared/cert.pem 存在,说明跑过 tunnel login)
103
- * 5. 只读状态(以前开通过,日常启动不该再要 zone 凭据)
102
+ * 5. 只读状态(以前开通过,日常启动不该再要 zone 凭据;token 或本地 ingress 两种形态)
104
103
  * 都没有就保持 Quick Tunnel——免费层行为一字不改。
104
+ *
105
+ * 两个入口共用同一个判定,是为了避免「同一台机器换个启动方式就换一种结论」:
106
+ * 那会让固定地址时有时无,用户只会觉得插件坏了。
105
107
  */
106
108
  const tunnelCfg = config.tunnel || {};
107
- const tunnelStateFile = tunnelCfg.stateFile || path.join(os.homedir(), '.dsh', 'mobile-access', 'tunnel-named.json');
108
- const baseDomain = tunnelCfg.baseDomain || process.env.DSH_TUNNEL_BASE_DOMAIN || 'matrixboard.cn';
109
+ const tunnelStateFile = tunnelCfg.stateFile || defaultTunnelStateFile();
109
110
  const cloudflareBin = resolveCloudflared(config);
110
- const common = {
111
- baseDomain,
112
- prefix: tunnelCfg.prefix || 'dsh',
113
- // 没找到就留 'auto':让发现链在真正要用的那一刻再解析一次(自动安装发生在启动之后)
114
- executable: cloudflareBin,
115
- };
116
- const explicit = tunnelCfg.provisioner ? String(tunnelCfg.provisioner) : null;
117
- const apiToken = tunnelCfg.apiToken || process.env.DSH_CF_API_TOKEN;
118
- const accountId = tunnelCfg.accountId || process.env.DSH_CF_ACCOUNT_ID;
119
- const endpoint = tunnelCfg.endpoint || process.env.DSH_TUNNEL_ENDPOINT;
120
-
121
- let provisioner = null;
122
- if (explicit === 'state') {
123
- provisioner = createProvisioner({ ...common, provisioner: 'state' }, { log, stateFile: tunnelStateFile });
124
- if (provisioner && !provisioner.configured) provisioner = null;
125
- } else if (explicit === 'local') {
126
- provisioner = createProvisioner({ ...common, provisioner: 'local' }, { log, stateFile: tunnelStateFile });
127
- if (provisioner && !provisioner.configured) provisioner = null;
128
- } else if (explicit === 'hosted' || (!explicit && endpoint)) {
129
- provisioner = createProvisioner(
130
- { ...common, provisioner: 'hosted', endpoint, enrollToken: tunnelCfg.enrollToken || process.env.DSH_TUNNEL_ENROLL_TOKEN },
131
- { log, stateFile: tunnelStateFile, hostId: 'host_cordis' },
132
- );
133
- } else {
134
- provisioner = createProvisioner(
135
- { ...common, provisioner: 'cloudflare', apiToken, accountId, zoneId: tunnelCfg.zoneId || process.env.DSH_CF_ZONE_ID },
136
- { log, stateFile: tunnelStateFile },
137
- );
138
- if (!provisioner) {
139
- const local = createProvisioner({ ...common, provisioner: 'local' }, { log, stateFile: tunnelStateFile });
140
- if (local?.configured) provisioner = local;
141
- }
142
- }
143
111
 
144
- // 没有开通凭据,但这台机器以前开通过:用只读状态继续跑固定地址。
145
- // 日常启动不该依赖 zone 级凭据——token 就在 0600 状态文件里。
146
- if (!provisioner && fs.existsSync(tunnelStateFile)) {
147
- const fromState = createProvisioner({ provisioner: 'state', baseDomain }, { log, stateFile: tunnelStateFile });
148
- if (fromState?.configured) {
149
- provisioner = fromState;
150
- log('tunnel 复用已开通的固定地址(只读状态,无 zone 凭据)');
151
- }
152
- }
153
- if (provisioner) log(`tunnel 固定地址开通器=${provisioner.kind} 域名=${provisioner.baseDomain}`);
112
+ const provisioner = resolveProvisioner({
113
+ tunnelCfg: {
114
+ ...tunnelCfg,
115
+ // 环境变量兜底:与 sidecar 一致,避免只在某个入口生效
116
+ apiToken: tunnelCfg.apiToken || process.env.DSH_CF_API_TOKEN,
117
+ accountId: tunnelCfg.accountId || process.env.DSH_CF_ACCOUNT_ID,
118
+ zoneId: tunnelCfg.zoneId || process.env.DSH_CF_ZONE_ID,
119
+ endpoint: tunnelCfg.endpoint || process.env.DSH_TUNNEL_ENDPOINT,
120
+ enrollToken: tunnelCfg.enrollToken || process.env.DSH_TUNNEL_ENROLL_TOKEN,
121
+ baseDomain: tunnelCfg.baseDomain || process.env.DSH_TUNNEL_BASE_DOMAIN || 'matrixboard.cn',
122
+ executable: cloudflareBin,
123
+ },
124
+ stateFile: tunnelStateFile,
125
+ hostId: 'host_cordis',
126
+ log,
127
+ });
154
128
 
155
129
  const booting = createGateway({
156
130
  host,
@@ -1,11 +1,10 @@
1
1
  // entries/sidecar.mjs — 独立进程入口(X1 不通过时的降级路径)
2
2
  // 与插件入口共用同一个 core:形态不同,契约一致。
3
3
 
4
- import fs from 'node:fs';
5
4
  import os from 'node:os';
6
5
  import path from 'node:path';
7
6
  import { createGateway } from '../src/server.mjs';
8
- import { createProvisioner } from '../src/cloudflare.mjs';
7
+ import { resolveProvisioner } from '../src/provision-select.mjs';
9
8
  import { createMockHost } from '../src/adapter/mock-host.mjs';
10
9
  import { createMuxHost } from '../src/adapter/mux-host.mjs';
11
10
 
@@ -33,11 +32,13 @@ if (hostKind === 'mux') {
33
32
  log(`mux probe ${probe.ok ? 'OK' : 'FAIL'} status=${probe.status} ${probe.url}`);
34
33
  }
35
34
 
36
- // 固定地址开通器(可选):有凭据就切 named 模式,没有保持 Quick Tunnel。
37
- const tunnelStateFile = args['tunnel-state'] || path.join(os.homedir(), '.dsh', 'mobile-access', 'tunnel-named.json');
38
- let provisioner = createProvisioner(
39
- {
40
- provisioner: args['tunnel-provisioner'] || (args['tunnel-endpoint'] || process.env.DSH_TUNNEL_ENDPOINT ? 'hosted' : 'cloudflare'),
35
+ // 固定地址开通器(可选):判定与插件入口共用 resolveProvisioner——
36
+ // 同一台机器换个启动方式不该得到不同结论(那会让固定地址时有时无)。
37
+ const tunnelStateFile = args['tunnel-state'] || process.env.DSH_TUNNEL_STATE_FILE
38
+ || path.join(os.homedir(), '.dsh', 'mobile-access', 'tunnel-named.json');
39
+ const provisioner = resolveProvisioner({
40
+ tunnelCfg: {
41
+ provisioner: args['tunnel-provisioner'] || undefined,
41
42
  apiToken: args['cf-token'] || process.env.DSH_CF_API_TOKEN,
42
43
  accountId: args['cf-account'] || process.env.DSH_CF_ACCOUNT_ID,
43
44
  zoneId: args['cf-zone'] || process.env.DSH_CF_ZONE_ID,
@@ -45,31 +46,11 @@ let provisioner = createProvisioner(
45
46
  prefix: args['tunnel-prefix'] || 'dsh',
46
47
  endpoint: args['tunnel-endpoint'] || process.env.DSH_TUNNEL_ENDPOINT,
47
48
  enrollToken: args['tunnel-enroll'] || process.env.DSH_TUNNEL_ENROLL_TOKEN,
48
- },
49
- {
50
- log,
51
- stateFile: tunnelStateFile,
52
- },
53
- );
54
- // 本地管理型:跑过 `cloudflared tunnel login`(~/.cloudflared/cert.pem 存在)就能开通。
55
- if (!provisioner && fs.existsSync(path.join(os.homedir(), '.cloudflared', 'cert.pem'))) {
56
- const localCfg = {
57
- provisioner: 'local',
58
- baseDomain: args['tunnel-domain'] || process.env.DSH_TUNNEL_BASE_DOMAIN || 'matrixboard.cn',
59
- prefix: args['tunnel-prefix'] || 'dsh',
60
49
  executable: args['tunnel-bin'] || 'cloudflared',
61
- };
62
- const local = createProvisioner(localCfg, { log, stateFile: tunnelStateFile });
63
- if (local?.configured) provisioner = local;
64
- }
65
- // 已开通过的机器:没有凭据也能按状态文件起固定地址(token 在 0600 文件里)。
66
- if (!provisioner && fs.existsSync(tunnelStateFile)) {
67
- const fromState = createProvisioner(
68
- { provisioner: 'state', baseDomain: args['tunnel-domain'] || process.env.DSH_TUNNEL_BASE_DOMAIN || 'matrixboard.cn' },
69
- { log, stateFile: tunnelStateFile },
70
- );
71
- if (fromState?.configured) provisioner = fromState;
72
- }
50
+ },
51
+ stateFile: tunnelStateFile,
52
+ log,
53
+ });
73
54
 
74
55
  const gw = await createGateway({
75
56
  host,
package/lib/client.js CHANGED
@@ -508,15 +508,20 @@ window.__ModuleLoader__.load({
508
508
  // 按钮永远点不到,NS 改对了也不恢复,只能删状态文件(自锁死)。
509
509
  mainBtn.disabled = tunnelBusy || bannerBusy.remote;
510
510
  const needsInstall = tunnel.executable === 'missing';
511
+ // 凭据确定不可用时先把「换账号登录」摆在前面:此刻点开启必然在写 DNS 处失败,
512
+ // 直接给可执行的出口,比让人反复点一个注定失败的按钮有用。
513
+ const credBlocked = Boolean(tunnel.credentials?.blocking) && !running && !needsInstall;
511
514
  mainBtn.textContent = needsInstall && tunnel.canAutoInstall
512
515
  ? '安装 cloudflared 并开启远程'
513
- : dnsBroken
514
- ? (zoneCode === 'moved' ? '查看原因(域名被占用)' : '重新检测域名解析')
515
- : running
516
- ? (bannerBusy.remote ? '生成中…' : '生成配对码(远程)')
517
- : tunnel.mode === 'named'
518
- ? (tunnel.provisioned ? '开启远程并生成配对码' : '开启远程(分配固定地址)')
519
- : '启动隧道(外网连接)';
516
+ : credBlocked
517
+ ? '开启远程(需重新授权)'
518
+ : dnsBroken
519
+ ? (zoneCode === 'moved' ? '查看原因(域名被占用)' : '重新检测域名解析')
520
+ : running
521
+ ? (bannerBusy.remote ? '生成中…' : '生成配对码(远程)')
522
+ : tunnel.mode === 'named'
523
+ ? (tunnel.provisioned ? '开启远程并生成配对码' : '开启远程(分配固定地址)')
524
+ : '启动隧道(外网连接)';
520
525
  }
521
526
  const stopBtn = panelEl.querySelector('#dsh-mios-remote-stop');
522
527
  if (stopBtn) {
@@ -538,7 +543,10 @@ window.__ModuleLoader__.load({
538
543
  const hint = panelEl.querySelector('#dsh-mios-hint');
539
544
  if (hint) {
540
545
  const t = ok ? summary.tunnel : null;
541
- const msg = t?.warning || t?.error || null;
546
+ // 凭据预检不通过是「确定写不了 DNS」:要在用户点按钮之前就说,
547
+ // 而不是等他点了、写失败了,再看到一句 cloudflared 的命令回显。
548
+ const credBlocked = t?.credentials?.blocking ? t.credentials : null;
549
+ const msg = t?.warning || t?.error || credBlocked?.hint || null;
542
550
  hint.textContent = msg ? `⚠️ ${msg}` : '';
543
551
  hint.style.color = t?.error && !t?.warning ? '#d94f3d' : '#e0a03c';
544
552
  hint.style.display = msg ? '' : 'none';
@@ -1290,6 +1298,108 @@ window.__ModuleLoader__.load({
1290
1298
  /** 记住最近一次触发远程动作的 banner:弹窗里的「重新检测」要能继续同一条链。 */
1291
1299
  let lastRemoteBanner = null;
1292
1300
 
1301
+ /**
1302
+ * 凭据不可用(登录的账号与域名不匹配 / 证书过时)时的唯一正确出口。
1303
+ *
1304
+ * 现场(2026-11-21):新 Mac 上 cert.pem 属于另一个 Cloudflare 账号,
1305
+ * 面板只报「写入 DNS 失败:Command failed: …」,用户以为插件坏了,重装、重启、
1306
+ * 改 NS 全试了一遍——都无效。真正要做的只有一件:用**持有该域名**的账号重跑
1307
+ * `cloudflared tunnel login`。这个弹窗把这句话说清楚,并给出两条兜底:
1308
+ * · 重新检测:login 完之后不用重启插件,点一下就能继续开通;
1309
+ * · 重置本机状态:状态文件被跨机拷贝时的自救入口。
1310
+ */
1311
+ function showCredentialHelpModal(credentials = {}) {
1312
+ const stateText = credentials.hint || '当前登录的 Cloudflare 账号无法管理这个域名';
1313
+ const exe = 'cloudflared';
1314
+ const lines = [
1315
+ ...(credentials.accountName ? [{ label: '当前证书账号', value: credentials.accountName }] : []),
1316
+ ...(credentials.zoneName ? [{ label: '固定地址域名', value: credentials.zoneName }] : []),
1317
+ ...(credentials.zoneStatus ? [{ label: '域名状态', value: credentials.zoneStatus }] : []),
1318
+ ];
1319
+ showUpdateModal({
1320
+ title: '登录的 Cloudflare 账号不对',
1321
+ banner: { text: `⚠️ ${stateText}`, tone: 'warn' },
1322
+ lines,
1323
+ note: '固定地址写在 Cloudflare 的域名下,只有「持有该域名的账号」才写得进去。'
1324
+ + '换账号登录后,本机会自动重建隧道并沿用同一个地址,手机不需要重新配对。'
1325
+ + `请在终端执行:${exe} tunnel login(面板无法代做浏览器授权)。`,
1326
+ steps: [
1327
+ `在这台电脑打开「终端」,执行:${exe} tunnel login`,
1328
+ '浏览器里选择「持有该域名」的账号,点授权(会覆盖 ~/.cloudflared/cert.pem)。',
1329
+ '回到面板点「重新检测」——账号一致后会自动重建隧道、保留原地址。',
1330
+ '如果这台电脑是从别的电脑拷过来的(状态文件不是本机生成的),可先点「重置本机状态」再重试。',
1331
+ ],
1332
+ actions: [
1333
+ { label: '关闭', onClick: closeUpdateModal },
1334
+ { label: '重置本机状态', onClick: () => confirmResetTunnelState() },
1335
+ {
1336
+ label: '重新检测', primary: true,
1337
+ onClick: () => { closeUpdateModal(); recheckDnsAction(lastRemoteBanner); },
1338
+ },
1339
+ ],
1340
+ });
1341
+ }
1342
+
1343
+ /** 重置是「清本机状态」,不是删云端隧道:必须讲清后果再执行。 */
1344
+ function confirmResetTunnelState() {
1345
+ showUpdateModal({
1346
+ title: '重置本机固定地址状态',
1347
+ banner: { text: '⚠️ 只清本机状态,不动 Cloudflare', tone: 'warn' },
1348
+ lines: [],
1349
+ note: '将删除本机的固定地址记录与 ingress 配置(不删除 ~/.cloudflared/cert.pem,'
1350
+ + '也不删除 Cloudflare 上的隧道与 DNS 记录)。重置后需要重新「开启远程」才会分配地址;'
1351
+ + '如果旧地址仍指向这台机器,新地址会换一个前缀。',
1352
+ steps: [],
1353
+ actions: [
1354
+ { label: '取消', onClick: showCredentialHelpModal.bind(null, summary?.tunnel?.credentials || {}) },
1355
+ { label: '确认重置', primary: true, onClick: () => resetTunnelStateAction() },
1356
+ ],
1357
+ });
1358
+ }
1359
+
1360
+ async function resetTunnelStateAction() {
1361
+ showUpdateModal({
1362
+ title: '正在重置',
1363
+ banner: { text: '⏳ 清理本机固定地址状态', tone: 'info' },
1364
+ lines: [],
1365
+ note: '正在删除本机状态与 ingress 配置,请稍候。',
1366
+ actions: [],
1367
+ });
1368
+ try {
1369
+ const res = await fetchJson('/mobile/v1/tunnel/reset', { method: 'POST' }, 25000);
1370
+ await probe();
1371
+ renderSummary();
1372
+ showUpdateModal({
1373
+ title: '已重置',
1374
+ banner: { text: '✅ 本机固定地址状态已清空', tone: 'success' },
1375
+ lines: res?.removed?.length ? [{ label: '已删除', value: res.removed.join('、') }] : [],
1376
+ note: res?.hadState
1377
+ ? 'Cloudflare 上的隧道与 DNS 记录未删除。点「开启远程」会重新分配固定地址;若这台机器的证书属于别的账号,请先执行 cloudflared tunnel login。'
1378
+ : '本机本来就没有固定地址状态。点「开启远程」开始分配。',
1379
+ steps: [],
1380
+ actions: [
1381
+ { label: '关闭', onClick: closeUpdateModal },
1382
+ {
1383
+ label: '开启远程', primary: true,
1384
+ onClick: () => { closeUpdateModal(); remoteMainAction(lastRemoteBanner); },
1385
+ },
1386
+ ],
1387
+ });
1388
+ } catch (err) {
1389
+ showUpdateModal({
1390
+ title: '重置失败',
1391
+ banner: { text: '❌ 未能重置本机状态', tone: 'error' },
1392
+ lines: [],
1393
+ note: `${err?.body?.error?.message || err?.message || String(err)}。可稍后重试,或在终端删除 ~/.dsh/mobile-access/tunnel-named.json。`,
1394
+ steps: [],
1395
+ actions: [
1396
+ { label: '关闭', onClick: closeUpdateModal },
1397
+ { label: '重试', primary: true, onClick: () => resetTunnelStateAction() },
1398
+ ],
1399
+ });
1400
+ }
1401
+ }
1402
+
1293
1403
  /**
1294
1404
  * 域名未生效时的排障弹窗。
1295
1405
  *
@@ -1423,6 +1533,12 @@ window.__ModuleLoader__.load({
1423
1533
  await remoteMainAction(lastRemoteBanner);
1424
1534
  return;
1425
1535
  }
1536
+ // 账号/证书问题与 NS 问题是两码事:重探一万次也不会让跨账号的证书变得可用。
1537
+ // 先把「换账号 login」这条唯一出口摆出来,别让人照着改 NS 白跑。
1538
+ if (res?.credentials?.blocking) {
1539
+ showCredentialHelpModal(res.credentials);
1540
+ return;
1541
+ }
1426
1542
  showDnsHelpModal(res || {});
1427
1543
  } catch (err) {
1428
1544
  showDnsHelpModal({
@@ -1446,6 +1562,13 @@ window.__ModuleLoader__.load({
1446
1562
  installCloudflaredAction(banner);
1447
1563
  return;
1448
1564
  }
1565
+ // 凭据确定不可用(跨账号 / 证书过时):此刻开通必然在写 DNS 处失败。
1566
+ // 已经跑起来的隧道不拦——那种情况用户是在生成配对码,地址本身是通的。
1567
+ const creds = summary?.tunnel?.credentials;
1568
+ if (creds?.blocking && summary?.tunnel?.state !== 'running') {
1569
+ showCredentialHelpModal(creds);
1570
+ return;
1571
+ }
1449
1572
  // 域名解析异常:先重检,别把人堵在「暂不可开启」上(那就是原来的死锁)
1450
1573
  if (summary?.tunnel?.dnsOk === false) {
1451
1574
  // 已经确诊「域名被另一个 Cloudflare 账号接管」:重探改变不了归属,
@@ -1485,11 +1608,20 @@ window.__ModuleLoader__.load({
1485
1608
  if (mainBtn) mainBtn.textContent = '生成中…';
1486
1609
  mountCode(banner, await issuePairingCode('tunnel'));
1487
1610
  } catch (err) {
1488
- const hint = panelEl?.querySelector('#dsh-mios-hint');
1489
- if (hint) {
1490
- hint.textContent = `⚠️ ${err?.body?.error?.message || err.message}`;
1491
- hint.style.display = '';
1492
- hint.style.color = '#d94f3d';
1611
+ // 服务端已经归因到「凭据」时,别把一句 Command failed 摆在提示行上——
1612
+ // 直接把 login 指引弹出来(这是唯一能修好的动作)。
1613
+ if (err?.body?.error?.reason === 'credentials') {
1614
+ showCredentialHelpModal({
1615
+ ...(summary?.tunnel?.credentials || {}),
1616
+ hint: err?.body?.error?.message || summary?.tunnel?.credentials?.hint,
1617
+ });
1618
+ } else {
1619
+ const hint = panelEl?.querySelector('#dsh-mios-hint');
1620
+ if (hint) {
1621
+ hint.textContent = `⚠️ ${err?.body?.error?.message || err.message}`;
1622
+ hint.style.display = '';
1623
+ hint.style.color = '#d94f3d';
1624
+ }
1493
1625
  }
1494
1626
  } finally {
1495
1627
  tunnelBusy = false;
@@ -1607,6 +1739,7 @@ window.__ModuleLoader__.load({
1607
1739
  PORT_CANDIDATES, STATUS_OK, STATUS_DOWN,
1608
1740
  showUpdateModal, closeUpdateModal, copyToClipboard,
1609
1741
  showModalToast, offerManualCopy, showDnsHelpModal, recheckDnsAction,
1742
+ showCredentialHelpModal, confirmResetTunnelState, resetTunnelStateAction,
1610
1743
  performUpdate, checkPluginUpdate, compareVersions, unwrapRemote,
1611
1744
  setPluginManager: (m) => { pluginManager = m; },
1612
1745
  probe, remoteMainAction, renderSummary,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-mobile-ios",
3
- "version": "0.2.17",
3
+ "version": "0.2.18",
4
4
  "type": "module",
5
5
  "description": "DSH iOS移动伴侣:iPhone/iPad 扫码连接 DSH 桌面端,局域网直连 + Cloudflare Tunnel 固定域名远程两种通道",
6
6
  "main": "entries/plugin.mjs",
@@ -29,7 +29,7 @@
29
29
  "scripts": {
30
30
  "start": "node entries/sidecar.mjs --host=mock --dev",
31
31
  "start:lan": "node entries/sidecar.mjs --host=mock --dev --lan=true",
32
- "test": "node test/selftest.mjs && node test/version.mjs && node test/lan-ip.mjs && node test/update-dialog.mjs && node test/ops.mjs && node test/resilience.mjs && node test/borrowed.mjs && node test/mux-table.mjs && node test/live-frames.mjs && node test/artifacts.mjs && node test/attachments.mjs && node test/session-actions.mjs && node test/workspace-actions.mjs && node test/workspace-index.mjs && node test/enhance.mjs && node test/tunnel-named.mjs && node test/tar.mjs && node test/cloudflared-install.mjs && node test/install-continue.mjs && node test/dns-recheck.mjs && node test/plugin-selfupdate.mjs && node test/zone-moved.mjs",
32
+ "test": "node test/selftest.mjs && node test/version.mjs && node test/lan-ip.mjs && node test/update-dialog.mjs && node test/ops.mjs && node test/resilience.mjs && node test/borrowed.mjs && node test/mux-table.mjs && node test/live-frames.mjs && node test/artifacts.mjs && node test/attachments.mjs && node test/session-actions.mjs && node test/workspace-actions.mjs && node test/workspace-index.mjs && node test/enhance.mjs && node test/tunnel-named.mjs && node test/tar.mjs && node test/cloudflared-install.mjs && node test/install-continue.mjs && node test/dns-recheck.mjs && node test/tunnel-credentials.mjs && node test/plugin-selfupdate.mjs && node test/zone-moved.mjs",
33
33
  "probe": "node spike0/probe.mjs"
34
34
  },
35
35
  "dsh": {
@@ -18,12 +18,13 @@
18
18
 
19
19
  import crypto from 'node:crypto';
20
20
  import fs from 'node:fs';
21
+ import os from 'node:os';
21
22
  import path from 'node:path';
22
23
  import { fail } from './protocol.mjs';
23
24
  import { deriveSubdomain, isValidLabel } from './dns-label.mjs';
24
25
  import { DNS_PENDING_HINT, DNS_TAMPER_HINT, dnsWarningFor, evaluateDnsAnswer, probeDns } from './dns-probe.mjs';
25
- import { LocalProvisioner, sanitizeZone } from './provision-local.mjs';
26
- import { diagnoseZone, findDnsOwner, ZONE_STATUS_HINT } from './zone-health.mjs';
26
+ import { LocalProvisioner, LocalStateProvisioner, sanitizeZone } from './provision-local.mjs';
27
+ import { diagnoseZone, findDnsOwner, verifyCertAccess, ZONE_STATUS_HINT } from './zone-health.mjs';
27
28
 
28
29
  // 兼容既有调用方与测试:子域规则从 dns-label.mjs 来,这里一并导出
29
30
  export { deriveSubdomain, isValidLabel };
@@ -266,6 +267,26 @@ class BaseProvisioner {
266
267
  get notConfiguredDetail() {
267
268
  return null;
268
269
  }
270
+
271
+ /** 非本地形态没有 cert.pem 可预检;面板统一按「无凭据信息」处理。 */
272
+ get credentials() {
273
+ return null;
274
+ }
275
+
276
+ /** 重置本机状态:token 形态由状态文件承载,删掉即「重新开通」。 */
277
+ async reset() {
278
+ let removed = [];
279
+ try {
280
+ if (this.stateFile && fs.statSync(this.stateFile).isFile()) {
281
+ fs.unlinkSync(this.stateFile);
282
+ removed = [path.basename(this.stateFile)];
283
+ }
284
+ } catch { /* 不存在即目标状态 */ }
285
+ const hadState = Boolean(this.state?.hostname);
286
+ this._state = null;
287
+ this._zone = null;
288
+ return { reset: true, hadState, removed, hostname: null, provisioned: false };
289
+ }
269
290
  }
270
291
 
271
292
  /**
@@ -670,18 +691,34 @@ export function createProvisioner(config = {}, { log = () => {}, stateFile = nul
670
691
  stateFile,
671
692
  configFile: config.configFile || null,
672
693
  seed: config.seed || null,
694
+ // 默认当前用户;显式传入便于测试与「非标准 home」的宿主环境
695
+ homeDir: config.homeDir || os.homedir(),
673
696
  log,
674
697
  // 生产路径才接真实探测:测试直接 new LocalProvisioner 时保持零网络依赖
675
698
  zoneDiagnose: diagnoseZone,
676
699
  ownerLookup: findDnsOwner,
700
+ // 开通前凭据预检:跨账号的 cert.pem 必须在写 DNS **之前**被识别出来
701
+ verifyAccess: verifyCertAccess,
702
+ hostname: os.hostname(),
677
703
  });
678
704
  }
679
705
  if (kind === 'state') {
680
- return new StateProvisioner({
706
+ // 先按 token 形态找;找不到再按**本地管理型**状态找(cert.pem 被删了也能继续用固定地址)。
707
+ // 返回 null 的语义是「这台机器确实没有可复用的固定地址」,而不是「凭据不全就降级成随机地址」。
708
+ const byToken = new StateProvisioner({
709
+ stateFile,
710
+ baseDomain: config.baseDomain || 'matrixboard.cn',
711
+ log,
712
+ });
713
+ if (byToken.configured) return byToken;
714
+ const byLocal = new LocalStateProvisioner({
681
715
  stateFile,
716
+ configFile: config.configFile || null,
682
717
  baseDomain: config.baseDomain || 'matrixboard.cn',
718
+ homeDir: config.homeDir || os.homedir(),
683
719
  log,
684
720
  });
721
+ return byLocal.configured ? byLocal : null;
685
722
  }
686
723
  if (kind === 'hosted') {
687
724
  const provisioner = new HostedProvisioner({