dsh-mobile-ios 0.2.16 → 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/LICENSE +21 -21
- package/README.md +311 -284
- package/cordis.patch.yml +20 -20
- package/entries/plugin.mjs +197 -223
- package/entries/sidecar.mjs +92 -111
- package/lib/client.js +1754 -1621
- package/lib/vendor/qrcode-generator.cjs +2297 -2297
- package/lib/vendor/qrcode-utf8.cjs +26 -26
- package/package.json +3 -2
- package/src/adapter/artifacts.mjs +235 -235
- package/src/adapter/cordis-host.mjs +1444 -1225
- package/src/adapter/mock-host.mjs +498 -430
- package/src/adapter/mux-host.mjs +99 -99
- package/src/adapter/session-history.mjs +241 -241
- package/src/cloudflare.mjs +735 -698
- package/src/dns-label.mjs +32 -32
- package/src/dns-probe.mjs +110 -110
- package/src/file-log.mjs +68 -68
- package/src/gateway.mjs +285 -285
- package/src/host-name.mjs +42 -0
- package/src/pairing.mjs +300 -300
- package/src/protocol.mjs +59 -59
- package/src/provision-local.mjs +883 -560
- package/src/provision-select.mjs +105 -0
- package/src/rest.mjs +958 -894
- package/src/ring.mjs +148 -148
- package/src/server.mjs +246 -246
- package/src/tunnel-error.mjs +91 -0
- package/src/tunnel-state.mjs +122 -0
- package/src/tunnel.mjs +544 -544
- package/src/version.mjs +24 -24
- package/src/ws.mjs +332 -332
- package/src/zone-health.mjs +430 -251
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
// tunnel-state.mjs — 固定地址本地状态的**读写与归属校验**(唯一入口)
|
|
2
|
+
//
|
|
3
|
+
// 事故背景(2026-11-21,新 Mac 装插件后分配不出固定地址):
|
|
4
|
+
// 本机 `~/.cloudflared/cert.pem` 是另一个 Cloudflare 账号签发的旧证书,
|
|
5
|
+
// 插件却只检查「文件存在」就当已登录,于是隧道能建、写 DNS 才失败,
|
|
6
|
+
// 面板只留一句「写入 DNS 失败」,用户无从下手。
|
|
7
|
+
//
|
|
8
|
+
// 同一类问题还有第二个形态:**状态文件被跨机复用**。
|
|
9
|
+
// · 用户把 ~/.dsh 连同 tunnel-named.json 一起拷到新机器;
|
|
10
|
+
// · 或者网盘/迁移工具把整个 home 同步过去;
|
|
11
|
+
// · 状态里记着上一台机器的 tunnelId / credentialsFile / hostname。
|
|
12
|
+
// 若直接信这份状态,新机器会对外宣称一个指向**旧机器**的固定地址,
|
|
13
|
+
// 面板显示「已开通」,扫码却连到别人那里——比报错更糟。
|
|
14
|
+
//
|
|
15
|
+
// 因此状态文件的读必须带「这台机器是不是它的主人」这一条:
|
|
16
|
+
// · machine.id 与当前机器不同 → 外来状态,整份作废并重新派生地址;
|
|
17
|
+
// · credentialsFile 不存在 → 状态在本机不可用(缺 tunnel 凭据跑不起来);
|
|
18
|
+
// · 都没有(0.2.18 之前的旧状态)→ 认领,补写 machine 字段。
|
|
19
|
+
//
|
|
20
|
+
// 注:状态结构保持 version: 1,新字段全部可选——老插件读到新文件也只是忽略,
|
|
21
|
+
// 不需要迁移逻辑,升级与回滚都不会丢地址。
|
|
22
|
+
|
|
23
|
+
import crypto from 'node:crypto';
|
|
24
|
+
import fs from 'node:fs';
|
|
25
|
+
import os from 'node:os';
|
|
26
|
+
import path from 'node:path';
|
|
27
|
+
|
|
28
|
+
export const STATE_VERSION = 1;
|
|
29
|
+
const MACHINE_FILE = 'machine-id';
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* 读状态文件。不存在/结构不符都当「没有」,绝不抛。
|
|
33
|
+
* 结构不符时留一份备份,方便用户把地址找回来(与设备注册表同一取舍)。
|
|
34
|
+
*/
|
|
35
|
+
export function readState(file, log) {
|
|
36
|
+
if (!file) return null;
|
|
37
|
+
let raw;
|
|
38
|
+
try {
|
|
39
|
+
raw = fs.readFileSync(file, 'utf8');
|
|
40
|
+
} catch (err) {
|
|
41
|
+
if (err.code !== 'ENOENT') log?.(`tunnel 本地开通状态不可用:${err.message}`);
|
|
42
|
+
return null;
|
|
43
|
+
}
|
|
44
|
+
try {
|
|
45
|
+
const parsed = JSON.parse(raw);
|
|
46
|
+
if (!parsed || typeof parsed !== 'object' || parsed.version !== STATE_VERSION) throw new Error('结构不符');
|
|
47
|
+
return parsed;
|
|
48
|
+
} catch (err) {
|
|
49
|
+
const backup = `${file}.corrupt-${new Date().toISOString().replace(/[:.]/g, '-')}`;
|
|
50
|
+
try {
|
|
51
|
+
fs.renameSync(file, backup);
|
|
52
|
+
log?.(`tunnel 状态损坏,已备份到 ${path.basename(backup)}(${err.message})`);
|
|
53
|
+
} catch {
|
|
54
|
+
log?.(`tunnel 状态损坏且备份失败(${err.message})`);
|
|
55
|
+
}
|
|
56
|
+
return null;
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
export function writeState(file, state) {
|
|
61
|
+
if (!file) return;
|
|
62
|
+
fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
|
|
63
|
+
const tmp = `${file}.${process.pid}.tmp`;
|
|
64
|
+
fs.writeFileSync(tmp, JSON.stringify({ version: STATE_VERSION, ...state }, null, 2), { mode: 0o600, flag: 'w' });
|
|
65
|
+
fs.renameSync(tmp, file);
|
|
66
|
+
try { fs.chmodSync(file, 0o600); } catch { /* 刚写即 0600 */ }
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* 本机的持久标识。
|
|
71
|
+
*
|
|
72
|
+
* 放在状态文件同目录(生产是 ~/.dsh/mobile-access/),0600。
|
|
73
|
+
* 为什么不用 hostname:改机器名、切网络都会变,拿它做身份会把正常机器判成新机器;
|
|
74
|
+
* 而 machine-id 只在首次运行时生成一次,稳定且不依赖系统信息。
|
|
75
|
+
* 目录整体被拷贝时 id 会跟着走——这种情况由 credentialsFile 存在性兜底(见 isStateUsable)。
|
|
76
|
+
*/
|
|
77
|
+
export function machineIdentity({ stateFile = null, hostname = null } = {}) {
|
|
78
|
+
if (!stateFile) return null;
|
|
79
|
+
const dir = path.dirname(stateFile);
|
|
80
|
+
const file = path.join(dir, MACHINE_FILE);
|
|
81
|
+
let id = null;
|
|
82
|
+
try {
|
|
83
|
+
const raw = fs.readFileSync(file, 'utf8').trim();
|
|
84
|
+
if (/^[0-9a-f]{16,64}$/i.test(raw)) id = raw.toLowerCase();
|
|
85
|
+
} catch { /* 没有就建 */ }
|
|
86
|
+
if (!id) {
|
|
87
|
+
id = crypto.randomBytes(16).toString('hex');
|
|
88
|
+
try {
|
|
89
|
+
fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
|
|
90
|
+
fs.writeFileSync(file, `${id}\n`, { mode: 0o600, flag: 'w' });
|
|
91
|
+
try { fs.chmodSync(file, 0o600); } catch { /* 刚写即 0600 */ }
|
|
92
|
+
} catch {
|
|
93
|
+
// 写不进去(只读目录/权限)不能挡住开通:退化成「无身份」,行为等同旧版本
|
|
94
|
+
return null;
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
return { id, hostname: hostname || os.hostname() };
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
/** 状态里记的机器身份是否与当前机器不同(不同 = 从别的电脑拷来的)。 */
|
|
101
|
+
export function isForeignState(state, machine) {
|
|
102
|
+
if (!state || !machine?.id) return false;
|
|
103
|
+
const recorded = state.machine?.id;
|
|
104
|
+
// 旧状态没有 machine 字段:无法判断,按「认领」处理(不重建,避免老用户地址漂移)
|
|
105
|
+
if (!recorded) return false;
|
|
106
|
+
return String(recorded).toLowerCase() !== String(machine.id).toLowerCase();
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
* 这份状态在本机是否**可执行**:tunnel 凭据文件必须还在。
|
|
111
|
+
*
|
|
112
|
+
* 只查状态里记的路径(不探测网络):凭据缺失时隧道根本起不来,
|
|
113
|
+
* 继续对外宣称这个地址就是给用户一个必然失败的扫码结果。
|
|
114
|
+
*/
|
|
115
|
+
export function hasLocalCredentials(state) {
|
|
116
|
+
if (!state?.credentialsFile) return false;
|
|
117
|
+
try {
|
|
118
|
+
return fs.statSync(state.credentialsFile).isFile();
|
|
119
|
+
} catch {
|
|
120
|
+
return false;
|
|
121
|
+
}
|
|
122
|
+
}
|