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.
@@ -0,0 +1,105 @@
1
+ // provision-select.mjs — 「这台机器该用哪种固定地址开通器」的唯一判定入口
2
+ //
3
+ // 背景:同一套判定原来在两个入口各写了一份(entries/plugin.mjs 与 entries/sidecar.mjs),
4
+ // 判据还不一样——sidecar 只看 `fs.existsSync(cert.pem)` 就选 local,plugin 还要看
5
+ // `configured`。分发到不同电脑后,「同一版本、同样的凭据,两个入口给出不同结论」,
6
+ // 这正是「换台电脑就分配不出固定地址 / 地址忽然没了」的一部分来源。
7
+ //
8
+ // 统一后的顺序(谁先齐备用谁):
9
+ // 1. 显式 provisioner:尊重运营决定,但配置的形态不可用时**明确降级并记录原因**;
10
+ // 2. hosted:有开通服务地址(endpoint + enrollToken)——产品形态;
11
+ // 3. cloudflare:本机有 accountId + apiToken——运营/自托管;
12
+ // 4. local:跑过 `cloudflared tunnel login`(cert.pem 存在)——零 API Token 的默认路径;
13
+ // 5. state:以前开通过的机器,没有证书也能按本机状态起隧道(token 或本地 ingress 两种形态);
14
+ // 6. 都没有 → null,隧道退回 Quick Tunnel(行为与旧版一致)。
15
+ //
16
+ // 判定只做**本地**检查(文件/配置存在性),不发网络请求。凭据是否真能写这个域名,
17
+ // 由 LocalProvisioner.checkCredentials 在真正开通前问 Cloudflare——两件事分开,
18
+ // 启动不能被网络拖住,写入不能带着错凭据。
19
+
20
+ import fs from 'node:fs';
21
+ import os from 'node:os';
22
+ import path from 'node:path';
23
+ import { createProvisioner } from './cloudflare.mjs';
24
+
25
+ /**
26
+ * @param {object} opts
27
+ * @param {object} opts.tunnelCfg 已归一化的 tunnel 配置(plugin config 或 sidecar args 映射后)
28
+ * @param {string|null} [opts.stateFile]
29
+ * @param {string|null} [opts.hostId]
30
+ * @param {string} [opts.homeDir] cert.pem 所在 home(测试必须能隔离;默认当前用户)
31
+ * @param {Function} [opts.log]
32
+ * @returns {object|null} 可用的开通器;null 表示保持 Quick Tunnel
33
+ */
34
+ export function resolveProvisioner({
35
+ tunnelCfg = {}, stateFile = null, hostId = null, log = () => {}, homeDir = os.homedir(),
36
+ } = {}) {
37
+ const baseDomain = tunnelCfg.baseDomain || process.env.DSH_TUNNEL_BASE_DOMAIN || 'matrixboard.cn';
38
+ const common = {
39
+ baseDomain,
40
+ homeDir,
41
+ prefix: tunnelCfg.prefix || 'dsh',
42
+ // 没找到就留 'auto':让发现链在真正要用的那一刻再解析一次(自动安装发生在启动之后)
43
+ executable: tunnelCfg.executable || 'auto',
44
+ };
45
+ const make = (kind, extra = {}) => createProvisioner(
46
+ { ...common, ...extra, provisioner: kind },
47
+ { log, stateFile, hostId },
48
+ );
49
+ const usable = (p) => (p && p.configured ? p : null);
50
+ const pick = (p, why) => {
51
+ if (p) log(`tunnel 固定地址开通器=${p.kind}(${why})域名=${baseDomain}`);
52
+ return p || null;
53
+ };
54
+ /** 启动时顺手预检一次凭据(不阻塞启动):面板因此能在用户点按钮之前就提示账号不对。 */
55
+ const warm = (p) => {
56
+ if (p && typeof p.checkCredentials === 'function') p.checkCredentials().catch(() => {});
57
+ return p;
58
+ };
59
+
60
+ const explicit = tunnelCfg.provisioner ? String(tunnelCfg.provisioner) : null;
61
+ // 「有没有登录过 Cloudflare」只由 cert.pem 决定:它是唯一能做特权写入(建隧道/写 DNS)的凭据。
62
+ // 状态文件只能复用已有地址,不能代替它——两者混在 configured 里会让判定随状态漂移。
63
+ const hasCert = (() => {
64
+ try {
65
+ return fs.statSync(path.join(homeDir, '.cloudflared', 'cert.pem')).isFile();
66
+ } catch {
67
+ return false;
68
+ }
69
+ })();
70
+ /** 没有证书时只能复用本机状态(token 形态或本地 ingress 形态)。 */
71
+ const stateOnly = () => usable(make('state'));
72
+
73
+ if (explicit === 'state') return warm(pick(stateOnly(), '显式 state'));
74
+ if (explicit === 'local') {
75
+ if (hasCert) {
76
+ const local = usable(make('local'));
77
+ if (local) return warm(pick(local, '显式 local'));
78
+ }
79
+ return warm(pick(stateOnly(), 'cert.pem 缺失,复用本机已开通状态'));
80
+ }
81
+ if (explicit === 'hosted' || (!explicit && tunnelCfg.endpoint)) {
82
+ return warm(pick(make('hosted', { endpoint: tunnelCfg.endpoint, enrollToken: tunnelCfg.enrollToken }), '开通服务'));
83
+ }
84
+ if (explicit === 'cloudflare') {
85
+ const cf = make('cloudflare', { apiToken: tunnelCfg.apiToken, accountId: tunnelCfg.accountId, zoneId: tunnelCfg.zoneId });
86
+ if (cf) return warm(pick(cf, '显式 cloudflare'));
87
+ return warm(pick(hasCert ? usable(make('local')) : null, 'cloudflare 凭据不全,改用 cloudflared 证书'));
88
+ }
89
+ // 自动:API 凭据 → 证书(可开通/可复用) → 本机状态(只复用)
90
+ const cf = make('cloudflare', { apiToken: tunnelCfg.apiToken, accountId: tunnelCfg.accountId, zoneId: tunnelCfg.zoneId });
91
+ if (cf) return warm(pick(cf, 'API 凭据'));
92
+ if (hasCert) {
93
+ const local = usable(make('local'));
94
+ if (local) return warm(pick(local, 'cloudflared 证书'));
95
+ }
96
+ const fromState = stateOnly();
97
+ if (fromState) return warm(pick(fromState, '本机已开通状态(无需证书)'));
98
+ log('tunnel 没有可用的固定地址凭据,保持 Quick Tunnel');
99
+ return null;
100
+ }
101
+
102
+ /** 供入口读取的默认状态文件位置(两个入口必须一致,否则状态会分裂成两份)。 */
103
+ export function defaultTunnelStateFile() {
104
+ return process.env.DSH_TUNNEL_STATE_FILE || path.join(os.homedir(), '.dsh', 'mobile-access', 'tunnel-named.json');
105
+ }