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/src/server.mjs CHANGED
@@ -1,246 +1,246 @@
1
- // server.mjs — 组装:http server + REST + WS
2
- // 监听面:默认绑 0.0.0.0(局域网伴侣是产品的核心路径;管理面仍回环-only,见 rest.mjs)。
3
- // 端口被占用时自动顺延(R12:插件跑在宿主进程内,不能因为端口冲突就挂掉宿主)
4
-
5
- import http from 'node:http';
6
- import os from 'node:os';
7
- import path from 'node:path';
8
- import { GatewayCore } from './gateway.mjs';
9
- import { PairingService } from './pairing.mjs';
10
- import { TicketStore, attachWebSocket } from './ws.mjs';
11
- import { createRestRouter } from './rest.mjs';
12
- import { TunnelManager } from './tunnel.mjs';
13
-
14
- const PORT_FALLBACK = 8;
15
-
16
- const PRIVATE_IPV4 = [/^10\./, /^192\.168\./, /^172\.(1[6-9]|2\d|3[01])\./];
17
-
18
- function isPrivateIPv4(addr) {
19
- return PRIVATE_IPV4.some((re) => re.test(addr));
20
- }
21
-
22
- // 虚拟网卡:Windows 上 Hyper-V / WSL / VMware 会各造一块 172.x 的网卡,
23
- // macOS 上 utun* 是 VPN。如果按「第一个私网地址」取,手机拿到的往往是这些
24
- // 根本不通的地址 —— 扫码后一直转圈,用户只会以为插件坏了。
25
- const VIRTUAL_IF = /(vEthernet|VMware|VirtualBox|Hyper-?V|Loopback|WSL|Docker|Tailscale|ZeroTier|TAP-|tap\d|utun|tun\d|ppp\d)/i;
26
- // 物理网卡常见命名(Windows 中文系统是「以太网 / WLAN / Wi-Fi」,macOS 是 en0/en1)
27
- const PHYSICAL_IF = /^(en\d|eth\d|wlan\d|wi-?fi|ethernet|以太网|wlan|无线)/i;
28
-
29
- /**
30
- * 手机要填的「电脑地址」。
31
- *
32
- * 优先级:物理网卡 > 其它非虚拟网卡;同类里 192.168 > 10 > 172.16-31
33
- * (家用路由器几乎都在 192.168,而 172.16/12 更容易是虚拟网段)。
34
- * 实在挑不出来再退回「第一个私网 IPv4」,保证老行为不至于更差。
35
- */
36
- export function lanIPv4(ifaces = os.networkInterfaces()) {
37
- const candidates = [];
38
- for (const [name, list] of Object.entries(ifaces)) {
39
- for (const i of list || []) {
40
- if (i.family !== 'IPv4' || i.internal || !isPrivateIPv4(i.address)) continue;
41
- let score = 0;
42
- if (!VIRTUAL_IF.test(name)) score += 10;
43
- if (PHYSICAL_IF.test(name)) score += 5;
44
- if (i.address.startsWith('192.168.')) score += 3;
45
- else if (i.address.startsWith('10.')) score += 2;
46
- else score += 1;
47
- candidates.push({ address: i.address, score, name });
48
- }
49
- }
50
- if (!candidates.length) return null;
51
- candidates.sort((a, b) => b.score - a.score);
52
- return candidates[0].address;
53
- }
54
-
55
- export function makeHostAllow(suffixes = []) {
56
- const list = suffixes.map((s) => s.toLowerCase().replace(/^\*?\./, ''));
57
- return (hostHeader) => {
58
- if (!hostHeader) return false;
59
- const host = String(hostHeader).split(':')[0].toLowerCase();
60
- if (host === '127.0.0.1' || host === 'localhost' || host === '::1') return true;
61
- // 手机经局域网 IP 直连:Host 头是私网地址(例 192.168.1.5:3081),必须放行,
62
- // 否则 REST 通了 WS 握手也会被拒(半通比不通更难诊断)。
63
- if (isPrivateIPv4(host)) return true;
64
- if (/^(fc|fd)[0-9a-f]{2}:/.test(host) || host.startsWith('fe80:')) return true; // IPv6 ULA/链路本地
65
- return list.some((s) => host === s || host.endsWith(`.${s}`));
66
- };
67
- }
68
-
69
- export async function createGateway({
70
- host,
71
- port = 3081,
72
- hostSuffixes = [],
73
- dev = false,
74
- log = () => {},
75
- addrs = {},
76
- allowLan = true,
77
- tunnelExecutable = 'auto',
78
- // 设备注册表落盘路径(可选)。提供后配对设备跨重启保留,手机无需重新配对。
79
- pairingFile = null,
80
- tunnelAutoRestart = false,
81
- // Pro 固定地址开通器(见 cloudflare.mjs)。**提供即切到 named 模式**:
82
- // 有稳定子域就不该再退化成随机域名。为 null 时保持 Quick Tunnel 行为不变。
83
- tunnelProvisioner = null,
84
- tunnelPidFile = null,
85
- // 隧道子进程的 spawn 实现。默认用 node:child_process;测试注入假进程,
86
- // 嵌入式场景也可替换(TunnelManager 本身已支持,这里只是让网关能透传)。
87
- tunnelSpawn = null,
88
- } = {}) {
89
- if (!host) throw new Error('createGateway 需要 host 适配器');
90
-
91
- // 网关自身提供的能力(与宿主能力合并后对外声明):
92
- // 只加"客户端需要据此决定走哪条路"的项,不虚报业务能力。
93
- const GATEWAY_CAPS = ['ws.ticket'];
94
- // info() 绝不抛:宿主未就绪时给"降级但可诊断"的答案,
95
- // 否则网关会连启动都失败,用户在手机上只会看到"连不上"而不知道原因。
96
- const hostView = Object.create(host, {
97
- info: {
98
- value: () => {
99
- try {
100
- const i = host.info();
101
- return { ...i, caps: [...new Set([...(i.caps || []), ...GATEWAY_CAPS])] };
102
- } catch (err) {
103
- return {
104
- hostId: 'host_unknown',
105
- hostName: '主机端未就绪',
106
- hostVersion: 'unknown',
107
- platform: process.platform,
108
- protocolVersion: '1.0',
109
- caps: [...GATEWAY_CAPS],
110
- degraded: true,
111
- reason: err.message,
112
- };
113
- }
114
- },
115
- },
116
- kind: { value: host.kind },
117
- });
118
-
119
- const pairing = new PairingService({ log, file: pairingFile });
120
- const tickets = new TicketStore();
121
- const core = new GatewayCore({ host: hostView, pairing, log });
122
-
123
- // 隧道(GW-8):地址漂移必须广播,否则客户端会一直连旧域名。
124
- const tunnel = new TunnelManager({
125
- port,
126
- log,
127
- executable: tunnelExecutable,
128
- ...(tunnelSpawn ? { spawnImpl: tunnelSpawn } : {}),
129
- // 插件形态默认开自动重拉:宿主进程长活,cloudflared 意外退出后
130
- // 不重拉的话手机会一直显示「在线」但隧道实际已死。
131
- autoRestart: tunnelAutoRestart,
132
- mode: tunnelProvisioner ? 'named' : 'quick',
133
- // 孤儿回收用:宿主被 kill -9 时 cloudflared 不随父进程退出
134
- pidFile: tunnelPidFile || path.join(os.homedir(), '.dsh', 'mobile-access', 'cloudflared.pid'),
135
- // named 的 token 每次启动时现取(可能顺带完成开通),**不进 argv**。
136
- // 这里读 tunnel.port 而不是外层 port:端口被占用时会顺延,ingress 必须跟着走。
137
- resolveNamedTarget: tunnelProvisioner
138
- ? () => tunnelProvisioner.credential({ port: tunnel.port })
139
- : null,
140
- onAddrChanged: (url, prevUrl) => {
141
- core.notifyGateway({ event: 'addr_changed', baseUrl: url, prevBaseUrl: prevUrl });
142
- },
143
- });
144
-
145
- const config = {
146
- dev,
147
- addrs,
148
- adapterKind: host.kind,
149
- wsStats: () => ws.stats(),
150
- dropAll: () => ws.dropAll?.() ?? 0,
151
- tunnel,
152
- tunnelProvisioner,
153
- hostView,
154
- // 手机端要填的「电脑地址」(LAN IP:port);未起或无私网地址时为 null
155
- lanAddr: () => (listening?.lan ?? null),
156
- };
157
- const handler = createRestRouter({ core, pairing, host: hostView, tickets, config, log });
158
- // 固定地址是自有域名:隧道进来的 Host 是 dsh-xxxx.matrixboard.cn,
159
- // 不把 zone 加进白名单会在 WS 握手阶段 403(REST 通但实时不通,最难查的一种半通)。
160
- const suffixes = tunnelProvisioner?.baseDomain ? [...hostSuffixes, tunnelProvisioner.baseDomain] : hostSuffixes;
161
- const hostAllow = makeHostAllow(suffixes);
162
-
163
- const server = http.createServer((req, res) => {
164
- handler(req, res).catch((err) => {
165
- log(`http unhandled ${err.stack || err}`);
166
- if (!res.headersSent) {
167
- res.writeHead(500, { 'Content-Type': 'application/json' });
168
- res.end(JSON.stringify({ error: { code: 4500, message: '网关内部错误' } }));
169
- } else res.end();
170
- });
171
- });
172
- server.keepAliveTimeout = 15_000;
173
-
174
- const ws = attachWebSocket(server, { core, pairing, tickets, log, hostAllow });
175
-
176
- let listening = null;
177
-
178
- const tryListen = (candidate) =>
179
- new Promise((resolve, reject) => {
180
- const onError = (err) => {
181
- server.removeListener('listening', onListening);
182
- reject(err);
183
- };
184
- const onListening = () => {
185
- server.removeListener('error', onError);
186
- resolve(candidate);
187
- };
188
- server.once('error', onError);
189
- server.once('listening', onListening);
190
- server.listen(candidate, allowLan ? '0.0.0.0' : '127.0.0.1');
191
- });
192
-
193
- async function start() {
194
- core.start();
195
- let lastErr = null;
196
- for (let i = 0; i < PORT_FALLBACK; i += 1) {
197
- try {
198
- const used = await tryListen(port + i);
199
- const addr = server.address();
200
- const lan = lanIPv4();
201
- listening = {
202
- port: used,
203
- address: addr.address,
204
- requested: port,
205
- fallback: used !== port,
206
- lan: allowLan && lan ? `${lan}:${used}` : null,
207
- };
208
- // 隧道指向真实监听端口(端口可能因占用而顺延)
209
- tunnel.port = used;
210
- log(`srv listening ${addr.address}:${used}${used !== port ? ` (端口 ${port} 被占用,已顺延)` : ''}`);
211
- if (listening.lan) log(`srv LAN http://${listening.lan}/mobile/v1/health(手机端填这个地址)`);
212
- return listening;
213
- } catch (err) {
214
- lastErr = err;
215
- if (err.code !== 'EADDRINUSE' && err.code !== 'EACCES') break;
216
- }
217
- }
218
- core.stop();
219
- throw lastErr || new Error('无法绑定端口');
220
- }
221
-
222
- async function stop() {
223
- ws.closeAll();
224
- core.stop();
225
- // 先收隧道子进程,再关监听:反序会让 cloudflared 变成连不上任何东西的孤儿进程。
226
- await tunnel.stop().catch((err) => log(`tunnel stop error: ${err.message}`));
227
- await new Promise((resolve) => server.close(() => resolve()));
228
- await host.close?.();
229
- listening = null;
230
- log('srv stopped');
231
- }
232
-
233
- return {
234
- server,
235
- core,
236
- pairing,
237
- tickets,
238
- tunnel,
239
- start,
240
- stop,
241
- get address() {
242
- return listening;
243
- },
244
- stats: () => ({ ...core.stats(), ws: ws.stats(), address: listening }),
245
- };
246
- }
1
+ // server.mjs — 组装:http server + REST + WS
2
+ // 监听面:默认绑 0.0.0.0(局域网伴侣是产品的核心路径;管理面仍回环-only,见 rest.mjs)。
3
+ // 端口被占用时自动顺延(R12:插件跑在宿主进程内,不能因为端口冲突就挂掉宿主)
4
+
5
+ import http from 'node:http';
6
+ import os from 'node:os';
7
+ import path from 'node:path';
8
+ import { GatewayCore } from './gateway.mjs';
9
+ import { PairingService } from './pairing.mjs';
10
+ import { TicketStore, attachWebSocket } from './ws.mjs';
11
+ import { createRestRouter } from './rest.mjs';
12
+ import { TunnelManager } from './tunnel.mjs';
13
+
14
+ const PORT_FALLBACK = 8;
15
+
16
+ const PRIVATE_IPV4 = [/^10\./, /^192\.168\./, /^172\.(1[6-9]|2\d|3[01])\./];
17
+
18
+ function isPrivateIPv4(addr) {
19
+ return PRIVATE_IPV4.some((re) => re.test(addr));
20
+ }
21
+
22
+ // 虚拟网卡:Windows 上 Hyper-V / WSL / VMware 会各造一块 172.x 的网卡,
23
+ // macOS 上 utun* 是 VPN。如果按「第一个私网地址」取,手机拿到的往往是这些
24
+ // 根本不通的地址 —— 扫码后一直转圈,用户只会以为插件坏了。
25
+ const VIRTUAL_IF = /(vEthernet|VMware|VirtualBox|Hyper-?V|Loopback|WSL|Docker|Tailscale|ZeroTier|TAP-|tap\d|utun|tun\d|ppp\d)/i;
26
+ // 物理网卡常见命名(Windows 中文系统是「以太网 / WLAN / Wi-Fi」,macOS 是 en0/en1)
27
+ const PHYSICAL_IF = /^(en\d|eth\d|wlan\d|wi-?fi|ethernet|以太网|wlan|无线)/i;
28
+
29
+ /**
30
+ * 手机要填的「电脑地址」。
31
+ *
32
+ * 优先级:物理网卡 > 其它非虚拟网卡;同类里 192.168 > 10 > 172.16-31
33
+ * (家用路由器几乎都在 192.168,而 172.16/12 更容易是虚拟网段)。
34
+ * 实在挑不出来再退回「第一个私网 IPv4」,保证老行为不至于更差。
35
+ */
36
+ export function lanIPv4(ifaces = os.networkInterfaces()) {
37
+ const candidates = [];
38
+ for (const [name, list] of Object.entries(ifaces)) {
39
+ for (const i of list || []) {
40
+ if (i.family !== 'IPv4' || i.internal || !isPrivateIPv4(i.address)) continue;
41
+ let score = 0;
42
+ if (!VIRTUAL_IF.test(name)) score += 10;
43
+ if (PHYSICAL_IF.test(name)) score += 5;
44
+ if (i.address.startsWith('192.168.')) score += 3;
45
+ else if (i.address.startsWith('10.')) score += 2;
46
+ else score += 1;
47
+ candidates.push({ address: i.address, score, name });
48
+ }
49
+ }
50
+ if (!candidates.length) return null;
51
+ candidates.sort((a, b) => b.score - a.score);
52
+ return candidates[0].address;
53
+ }
54
+
55
+ export function makeHostAllow(suffixes = []) {
56
+ const list = suffixes.map((s) => s.toLowerCase().replace(/^\*?\./, ''));
57
+ return (hostHeader) => {
58
+ if (!hostHeader) return false;
59
+ const host = String(hostHeader).split(':')[0].toLowerCase();
60
+ if (host === '127.0.0.1' || host === 'localhost' || host === '::1') return true;
61
+ // 手机经局域网 IP 直连:Host 头是私网地址(例 192.168.1.5:3081),必须放行,
62
+ // 否则 REST 通了 WS 握手也会被拒(半通比不通更难诊断)。
63
+ if (isPrivateIPv4(host)) return true;
64
+ if (/^(fc|fd)[0-9a-f]{2}:/.test(host) || host.startsWith('fe80:')) return true; // IPv6 ULA/链路本地
65
+ return list.some((s) => host === s || host.endsWith(`.${s}`));
66
+ };
67
+ }
68
+
69
+ export async function createGateway({
70
+ host,
71
+ port = 3081,
72
+ hostSuffixes = [],
73
+ dev = false,
74
+ log = () => {},
75
+ addrs = {},
76
+ allowLan = true,
77
+ tunnelExecutable = 'auto',
78
+ // 设备注册表落盘路径(可选)。提供后配对设备跨重启保留,手机无需重新配对。
79
+ pairingFile = null,
80
+ tunnelAutoRestart = false,
81
+ // Pro 固定地址开通器(见 cloudflare.mjs)。**提供即切到 named 模式**:
82
+ // 有稳定子域就不该再退化成随机域名。为 null 时保持 Quick Tunnel 行为不变。
83
+ tunnelProvisioner = null,
84
+ tunnelPidFile = null,
85
+ // 隧道子进程的 spawn 实现。默认用 node:child_process;测试注入假进程,
86
+ // 嵌入式场景也可替换(TunnelManager 本身已支持,这里只是让网关能透传)。
87
+ tunnelSpawn = null,
88
+ } = {}) {
89
+ if (!host) throw new Error('createGateway 需要 host 适配器');
90
+
91
+ // 网关自身提供的能力(与宿主能力合并后对外声明):
92
+ // 只加"客户端需要据此决定走哪条路"的项,不虚报业务能力。
93
+ const GATEWAY_CAPS = ['ws.ticket'];
94
+ // info() 绝不抛:宿主未就绪时给"降级但可诊断"的答案,
95
+ // 否则网关会连启动都失败,用户在手机上只会看到"连不上"而不知道原因。
96
+ const hostView = Object.create(host, {
97
+ info: {
98
+ value: () => {
99
+ try {
100
+ const i = host.info();
101
+ return { ...i, caps: [...new Set([...(i.caps || []), ...GATEWAY_CAPS])] };
102
+ } catch (err) {
103
+ return {
104
+ hostId: 'host_unknown',
105
+ hostName: '主机端未就绪',
106
+ hostVersion: 'unknown',
107
+ platform: process.platform,
108
+ protocolVersion: '1.0',
109
+ caps: [...GATEWAY_CAPS],
110
+ degraded: true,
111
+ reason: err.message,
112
+ };
113
+ }
114
+ },
115
+ },
116
+ kind: { value: host.kind },
117
+ });
118
+
119
+ const pairing = new PairingService({ log, file: pairingFile });
120
+ const tickets = new TicketStore();
121
+ const core = new GatewayCore({ host: hostView, pairing, log });
122
+
123
+ // 隧道(GW-8):地址漂移必须广播,否则客户端会一直连旧域名。
124
+ const tunnel = new TunnelManager({
125
+ port,
126
+ log,
127
+ executable: tunnelExecutable,
128
+ ...(tunnelSpawn ? { spawnImpl: tunnelSpawn } : {}),
129
+ // 插件形态默认开自动重拉:宿主进程长活,cloudflared 意外退出后
130
+ // 不重拉的话手机会一直显示「在线」但隧道实际已死。
131
+ autoRestart: tunnelAutoRestart,
132
+ mode: tunnelProvisioner ? 'named' : 'quick',
133
+ // 孤儿回收用:宿主被 kill -9 时 cloudflared 不随父进程退出
134
+ pidFile: tunnelPidFile || path.join(os.homedir(), '.dsh', 'mobile-access', 'cloudflared.pid'),
135
+ // named 的 token 每次启动时现取(可能顺带完成开通),**不进 argv**。
136
+ // 这里读 tunnel.port 而不是外层 port:端口被占用时会顺延,ingress 必须跟着走。
137
+ resolveNamedTarget: tunnelProvisioner
138
+ ? () => tunnelProvisioner.credential({ port: tunnel.port })
139
+ : null,
140
+ onAddrChanged: (url, prevUrl) => {
141
+ core.notifyGateway({ event: 'addr_changed', baseUrl: url, prevBaseUrl: prevUrl });
142
+ },
143
+ });
144
+
145
+ const config = {
146
+ dev,
147
+ addrs,
148
+ adapterKind: host.kind,
149
+ wsStats: () => ws.stats(),
150
+ dropAll: () => ws.dropAll?.() ?? 0,
151
+ tunnel,
152
+ tunnelProvisioner,
153
+ hostView,
154
+ // 手机端要填的「电脑地址」(LAN IP:port);未起或无私网地址时为 null
155
+ lanAddr: () => (listening?.lan ?? null),
156
+ };
157
+ const handler = createRestRouter({ core, pairing, host: hostView, tickets, config, log });
158
+ // 固定地址是自有域名:隧道进来的 Host 是 dsh-xxxx.matrixboard.cn,
159
+ // 不把 zone 加进白名单会在 WS 握手阶段 403(REST 通但实时不通,最难查的一种半通)。
160
+ const suffixes = tunnelProvisioner?.baseDomain ? [...hostSuffixes, tunnelProvisioner.baseDomain] : hostSuffixes;
161
+ const hostAllow = makeHostAllow(suffixes);
162
+
163
+ const server = http.createServer((req, res) => {
164
+ handler(req, res).catch((err) => {
165
+ log(`http unhandled ${err.stack || err}`);
166
+ if (!res.headersSent) {
167
+ res.writeHead(500, { 'Content-Type': 'application/json' });
168
+ res.end(JSON.stringify({ error: { code: 4500, message: '网关内部错误' } }));
169
+ } else res.end();
170
+ });
171
+ });
172
+ server.keepAliveTimeout = 15_000;
173
+
174
+ const ws = attachWebSocket(server, { core, pairing, tickets, log, hostAllow });
175
+
176
+ let listening = null;
177
+
178
+ const tryListen = (candidate) =>
179
+ new Promise((resolve, reject) => {
180
+ const onError = (err) => {
181
+ server.removeListener('listening', onListening);
182
+ reject(err);
183
+ };
184
+ const onListening = () => {
185
+ server.removeListener('error', onError);
186
+ resolve(candidate);
187
+ };
188
+ server.once('error', onError);
189
+ server.once('listening', onListening);
190
+ server.listen(candidate, allowLan ? '0.0.0.0' : '127.0.0.1');
191
+ });
192
+
193
+ async function start() {
194
+ core.start();
195
+ let lastErr = null;
196
+ for (let i = 0; i < PORT_FALLBACK; i += 1) {
197
+ try {
198
+ const used = await tryListen(port + i);
199
+ const addr = server.address();
200
+ const lan = lanIPv4();
201
+ listening = {
202
+ port: used,
203
+ address: addr.address,
204
+ requested: port,
205
+ fallback: used !== port,
206
+ lan: allowLan && lan ? `${lan}:${used}` : null,
207
+ };
208
+ // 隧道指向真实监听端口(端口可能因占用而顺延)
209
+ tunnel.port = used;
210
+ log(`srv listening ${addr.address}:${used}${used !== port ? ` (端口 ${port} 被占用,已顺延)` : ''}`);
211
+ if (listening.lan) log(`srv LAN http://${listening.lan}/mobile/v1/health(手机端填这个地址)`);
212
+ return listening;
213
+ } catch (err) {
214
+ lastErr = err;
215
+ if (err.code !== 'EADDRINUSE' && err.code !== 'EACCES') break;
216
+ }
217
+ }
218
+ core.stop();
219
+ throw lastErr || new Error('无法绑定端口');
220
+ }
221
+
222
+ async function stop() {
223
+ ws.closeAll();
224
+ core.stop();
225
+ // 先收隧道子进程,再关监听:反序会让 cloudflared 变成连不上任何东西的孤儿进程。
226
+ await tunnel.stop().catch((err) => log(`tunnel stop error: ${err.message}`));
227
+ await new Promise((resolve) => server.close(() => resolve()));
228
+ await host.close?.();
229
+ listening = null;
230
+ log('srv stopped');
231
+ }
232
+
233
+ return {
234
+ server,
235
+ core,
236
+ pairing,
237
+ tickets,
238
+ tunnel,
239
+ start,
240
+ stop,
241
+ get address() {
242
+ return listening;
243
+ },
244
+ stats: () => ({ ...core.stats(), ws: ws.stats(), address: listening }),
245
+ };
246
+ }
@@ -0,0 +1,91 @@
1
+ // tunnel-error.mjs — 把 cloudflared 的失败翻译成「用户能照做」的一句话 + 一条命令
2
+ //
3
+ // 事故现场(2026-11-21):`cloudflared tunnel route dns` 失败时,
4
+ // provision-local 只取 stderr 第一行(`Command failed: /opt/homebrew/bin/cloudflared …`),
5
+ // 真正的原因在第二行 `Failed to add route: code: 10000, reason: Authentication error`,
6
+ // 被 `split('\n')[0]` 直接丢掉;detail 又固定写「确认域名在当前账号下」。
7
+ // 用户在面板上看到的是一句命令回显 —— 既不知道是账号问题,也不知道接下来做什么。
8
+ //
9
+ // 这里做两件事:
10
+ // 1. **如实保留** cloudflared 的错误码与原因(code / reason),不截断;
11
+ // 2. 按错误语义给出**对应的**修法。特别是「账号/域名不匹配」这一类,
12
+ // 唯一正确的动作是用持有该域名的账号重跑 `cloudflared tunnel login`,
13
+ // 重装插件、改 NS、重启宿主都无效——这一点必须写在提示里。
14
+
15
+ /** codeflared 的错误码含义(只收录会被我们误判成「网络问题」的几种)。 */
16
+ const CREDENTIAL_CODES = new Set([10000, 1001, 1003, 1004, 9109]);
17
+
18
+ /**
19
+ * 解析 cloudflared 的失败文本。
20
+ * @returns {{ code: number|null, reason: string|null, first: string, stderr: string }}
21
+ */
22
+ export function parseCloudflaredFailure(input) {
23
+ const text = String(input ?? '');
24
+ // 形如:Failed to add route: code: 10000, reason: Authentication error
25
+ const m = /code:\s*(\d{3,6})\s*,\s*reason:\s*([^\n\r]+)/i.exec(text);
26
+ const lines = text.split(/\r?\n/).map((s) => s.trim()).filter(Boolean);
27
+ const first = lines[0] || '';
28
+ return {
29
+ code: m ? Number(m[1]) : null,
30
+ reason: m ? m[2].trim() : null,
31
+ first,
32
+ // 保留完整文本供 detail 使用(面板/日志需要原始证据,不做二次截断)
33
+ stderr: text.trim(),
34
+ };
35
+ }
36
+
37
+ /** cloudflared 的失败文本里有没有「凭据/权限」语义。 */
38
+ function looksLikeCredentialIssue(text) {
39
+ return /authentication error|invalid zone identifier|unauthorized|forbidden|permission|not authorized|403/i.test(text);
40
+ }
41
+
42
+ function looksLikeZoneIssue(text) {
43
+ return /zone not found|invalid zone|no zone|zone does not exist|1001/i.test(text);
44
+ }
45
+
46
+ /**
47
+ * 生成可直接展示的错误。
48
+ *
49
+ * @param {unknown} err route/create 抛出的异常
50
+ * @param {object} opts
51
+ * @param {string} opts.baseDomain 固定地址所用域名(提示里要指名道姓)
52
+ * @param {'route-dns'|'create-tunnel'} [opts.operation] 失败发生在哪一步
53
+ * @param {string|null} [opts.accountName] 当前证书所属账号(已知时写进提示)
54
+ * @param {string|null} [opts.exe] 实际使用的 cloudflared 路径/名字
55
+ * @returns {{ message: string, detail: string, reason: string, code: number|null }}
56
+ */
57
+ export function explainTunnelFailure(err, { baseDomain = 'matrixboard.cn', operation = 'route-dns', accountName = null, exe = 'cloudflared' } = {}) {
58
+ const parsed = parseCloudflaredFailure(err?.message || err);
59
+ const raw = parsed.stderr || parsed.first;
60
+ const codeText = parsed.code !== null ? `code: ${parsed.code}${parsed.reason ? `, reason: ${parsed.reason}` : ''}` : null;
61
+ const accountText = accountName ? `(当前证书属于 ${accountName})` : '';
62
+ const loginHint = `请在这台电脑的终端执行:${exe} tunnel login`
63
+ + `,在浏览器里选择持有 ${baseDomain} 的账号完成授权(会覆盖 ~/.cloudflared/cert.pem),`
64
+ + '然后回到面板点「开启远程」重试。重装插件或重启宿主都不能替代这一步。';
65
+
66
+ if ((parsed.code !== null && CREDENTIAL_CODES.has(parsed.code)) || looksLikeCredentialIssue(raw)) {
67
+ return {
68
+ message: `Cloudflare 拒绝了写入:当前账号没有 ${baseDomain} 的权限`,
69
+ detail: `${loginHint}${codeText ? ` cloudflared 返回 ${codeText}。` : ''}${accountText}`,
70
+ reason: 'credentials',
71
+ code: parsed.code,
72
+ };
73
+ }
74
+ if (looksLikeZoneIssue(raw)) {
75
+ return {
76
+ // 保留 cloudflared 的原文(排障要用),同时把结论写在前面(用户要能一眼看懂)
77
+ message: `域名 ${baseDomain} 不在当前登录的 Cloudflare 账号下(${parsed.reason || parsed.first})`,
78
+ detail: `cloudflared 返回:${raw || 'zone not found'}。${loginHint}`,
79
+ reason: 'zone',
80
+ code: parsed.code,
81
+ };
82
+ }
83
+ const action = operation === 'create-tunnel' ? '创建隧道' : '写入 DNS';
84
+ return {
85
+ message: `${action}失败:${parsed.first || 'cloudflared 未给出原因'}`,
86
+ detail: `cloudflared 返回:${raw || '(空)'}`
87
+ + `。若反复失败,请执行 ${exe} tunnel login 重新授权 ${baseDomain} 后再试。`,
88
+ reason: 'unknown',
89
+ code: parsed.code,
90
+ };
91
+ }