dsh-mobile-ios 0.2.6 → 0.2.8

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,219 +1,219 @@
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
- /** 首个非内部私网 IPv4 —— 手机要填的「电脑地址」就来自它 */
23
- export function lanIPv4() {
24
- for (const ifaces of Object.values(os.networkInterfaces())) {
25
- for (const i of ifaces || []) {
26
- if (i.family === 'IPv4' && !i.internal && isPrivateIPv4(i.address)) return i.address;
27
- }
28
- }
29
- return null;
30
- }
31
-
32
- export function makeHostAllow(suffixes = []) {
33
- const list = suffixes.map((s) => s.toLowerCase().replace(/^\*?\./, ''));
34
- return (hostHeader) => {
35
- if (!hostHeader) return false;
36
- const host = String(hostHeader).split(':')[0].toLowerCase();
37
- if (host === '127.0.0.1' || host === 'localhost' || host === '::1') return true;
38
- // 手机经局域网 IP 直连:Host 头是私网地址(例 192.168.1.5:3081),必须放行,
39
- // 否则 REST 通了 WS 握手也会被拒(半通比不通更难诊断)。
40
- if (isPrivateIPv4(host)) return true;
41
- if (/^(fc|fd)[0-9a-f]{2}:/.test(host) || host.startsWith('fe80:')) return true; // IPv6 ULA/链路本地
42
- return list.some((s) => host === s || host.endsWith(`.${s}`));
43
- };
44
- }
45
-
46
- export async function createGateway({
47
- host,
48
- port = 3081,
49
- hostSuffixes = [],
50
- dev = false,
51
- log = () => {},
52
- addrs = {},
53
- allowLan = true,
54
- tunnelExecutable = 'auto',
55
- // 设备注册表落盘路径(可选)。提供后配对设备跨重启保留,手机无需重新配对。
56
- pairingFile = null,
57
- tunnelAutoRestart = false,
58
- // Pro 固定地址开通器(见 cloudflare.mjs)。**提供即切到 named 模式**:
59
- // 有稳定子域就不该再退化成随机域名。为 null 时保持 Quick Tunnel 行为不变。
60
- tunnelProvisioner = null,
61
- tunnelPidFile = null,
62
- } = {}) {
63
- if (!host) throw new Error('createGateway 需要 host 适配器');
64
-
65
- // 网关自身提供的能力(与宿主能力合并后对外声明):
66
- // 只加"客户端需要据此决定走哪条路"的项,不虚报业务能力。
67
- const GATEWAY_CAPS = ['ws.ticket'];
68
- // info() 绝不抛:宿主未就绪时给"降级但可诊断"的答案,
69
- // 否则网关会连启动都失败,用户在手机上只会看到"连不上"而不知道原因。
70
- const hostView = Object.create(host, {
71
- info: {
72
- value: () => {
73
- try {
74
- const i = host.info();
75
- return { ...i, caps: [...new Set([...(i.caps || []), ...GATEWAY_CAPS])] };
76
- } catch (err) {
77
- return {
78
- hostId: 'host_unknown',
79
- hostName: '主机端未就绪',
80
- hostVersion: 'unknown',
81
- platform: process.platform,
82
- protocolVersion: '1.0',
83
- caps: [...GATEWAY_CAPS],
84
- degraded: true,
85
- reason: err.message,
86
- };
87
- }
88
- },
89
- },
90
- kind: { value: host.kind },
91
- });
92
-
93
- const pairing = new PairingService({ log, file: pairingFile });
94
- const tickets = new TicketStore();
95
- const core = new GatewayCore({ host: hostView, pairing, log });
96
-
97
- // 隧道(GW-8):地址漂移必须广播,否则客户端会一直连旧域名。
98
- const tunnel = new TunnelManager({
99
- port,
100
- log,
101
- executable: tunnelExecutable,
102
- // 插件形态默认开自动重拉:宿主进程长活,cloudflared 意外退出后
103
- // 不重拉的话手机会一直显示「在线」但隧道实际已死。
104
- autoRestart: tunnelAutoRestart,
105
- mode: tunnelProvisioner ? 'named' : 'quick',
106
- // 孤儿回收用:宿主被 kill -9 时 cloudflared 不随父进程退出
107
- pidFile: tunnelPidFile || path.join(os.homedir(), '.dsh', 'mobile-access', 'cloudflared.pid'),
108
- // named 的 token 每次启动时现取(可能顺带完成开通),**不进 argv**。
109
- // 这里读 tunnel.port 而不是外层 port:端口被占用时会顺延,ingress 必须跟着走。
110
- resolveNamedTarget: tunnelProvisioner
111
- ? () => tunnelProvisioner.credential({ port: tunnel.port })
112
- : null,
113
- onAddrChanged: (url, prevUrl) => {
114
- core.notifyGateway({ event: 'addr_changed', baseUrl: url, prevBaseUrl: prevUrl });
115
- },
116
- });
117
-
118
- const config = {
119
- dev,
120
- addrs,
121
- adapterKind: host.kind,
122
- wsStats: () => ws.stats(),
123
- dropAll: () => ws.dropAll?.() ?? 0,
124
- tunnel,
125
- tunnelProvisioner,
126
- hostView,
127
- // 手机端要填的「电脑地址」(LAN IP:port);未起或无私网地址时为 null
128
- lanAddr: () => (listening?.lan ?? null),
129
- };
130
- const handler = createRestRouter({ core, pairing, host: hostView, tickets, config, log });
131
- // 固定地址是自有域名:隧道进来的 Host 是 dsh-xxxx.matrixboard.cn,
132
- // 不把 zone 加进白名单会在 WS 握手阶段 403(REST 通但实时不通,最难查的一种半通)。
133
- const suffixes = tunnelProvisioner?.baseDomain ? [...hostSuffixes, tunnelProvisioner.baseDomain] : hostSuffixes;
134
- const hostAllow = makeHostAllow(suffixes);
135
-
136
- const server = http.createServer((req, res) => {
137
- handler(req, res).catch((err) => {
138
- log(`http unhandled ${err.stack || err}`);
139
- if (!res.headersSent) {
140
- res.writeHead(500, { 'Content-Type': 'application/json' });
141
- res.end(JSON.stringify({ error: { code: 4500, message: '网关内部错误' } }));
142
- } else res.end();
143
- });
144
- });
145
- server.keepAliveTimeout = 15_000;
146
-
147
- const ws = attachWebSocket(server, { core, pairing, tickets, log, hostAllow });
148
-
149
- let listening = null;
150
-
151
- const tryListen = (candidate) =>
152
- new Promise((resolve, reject) => {
153
- const onError = (err) => {
154
- server.removeListener('listening', onListening);
155
- reject(err);
156
- };
157
- const onListening = () => {
158
- server.removeListener('error', onError);
159
- resolve(candidate);
160
- };
161
- server.once('error', onError);
162
- server.once('listening', onListening);
163
- server.listen(candidate, allowLan ? '0.0.0.0' : '127.0.0.1');
164
- });
165
-
166
- async function start() {
167
- core.start();
168
- let lastErr = null;
169
- for (let i = 0; i < PORT_FALLBACK; i += 1) {
170
- try {
171
- const used = await tryListen(port + i);
172
- const addr = server.address();
173
- const lan = lanIPv4();
174
- listening = {
175
- port: used,
176
- address: addr.address,
177
- requested: port,
178
- fallback: used !== port,
179
- lan: allowLan && lan ? `${lan}:${used}` : null,
180
- };
181
- // 隧道指向真实监听端口(端口可能因占用而顺延)
182
- tunnel.port = used;
183
- log(`srv listening ${addr.address}:${used}${used !== port ? ` (端口 ${port} 被占用,已顺延)` : ''}`);
184
- if (listening.lan) log(`srv LAN http://${listening.lan}/mobile/v1/health(手机端填这个地址)`);
185
- return listening;
186
- } catch (err) {
187
- lastErr = err;
188
- if (err.code !== 'EADDRINUSE' && err.code !== 'EACCES') break;
189
- }
190
- }
191
- core.stop();
192
- throw lastErr || new Error('无法绑定端口');
193
- }
194
-
195
- async function stop() {
196
- ws.closeAll();
197
- core.stop();
198
- // 先收隧道子进程,再关监听:反序会让 cloudflared 变成连不上任何东西的孤儿进程。
199
- await tunnel.stop().catch((err) => log(`tunnel stop error: ${err.message}`));
200
- await new Promise((resolve) => server.close(() => resolve()));
201
- await host.close?.();
202
- listening = null;
203
- log('srv stopped');
204
- }
205
-
206
- return {
207
- server,
208
- core,
209
- pairing,
210
- tickets,
211
- tunnel,
212
- start,
213
- stop,
214
- get address() {
215
- return listening;
216
- },
217
- stats: () => ({ ...core.stats(), ws: ws.stats(), address: listening }),
218
- };
219
- }
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
+ /** 首个非内部私网 IPv4 —— 手机要填的「电脑地址」就来自它 */
23
+ export function lanIPv4() {
24
+ for (const ifaces of Object.values(os.networkInterfaces())) {
25
+ for (const i of ifaces || []) {
26
+ if (i.family === 'IPv4' && !i.internal && isPrivateIPv4(i.address)) return i.address;
27
+ }
28
+ }
29
+ return null;
30
+ }
31
+
32
+ export function makeHostAllow(suffixes = []) {
33
+ const list = suffixes.map((s) => s.toLowerCase().replace(/^\*?\./, ''));
34
+ return (hostHeader) => {
35
+ if (!hostHeader) return false;
36
+ const host = String(hostHeader).split(':')[0].toLowerCase();
37
+ if (host === '127.0.0.1' || host === 'localhost' || host === '::1') return true;
38
+ // 手机经局域网 IP 直连:Host 头是私网地址(例 192.168.1.5:3081),必须放行,
39
+ // 否则 REST 通了 WS 握手也会被拒(半通比不通更难诊断)。
40
+ if (isPrivateIPv4(host)) return true;
41
+ if (/^(fc|fd)[0-9a-f]{2}:/.test(host) || host.startsWith('fe80:')) return true; // IPv6 ULA/链路本地
42
+ return list.some((s) => host === s || host.endsWith(`.${s}`));
43
+ };
44
+ }
45
+
46
+ export async function createGateway({
47
+ host,
48
+ port = 3081,
49
+ hostSuffixes = [],
50
+ dev = false,
51
+ log = () => {},
52
+ addrs = {},
53
+ allowLan = true,
54
+ tunnelExecutable = 'auto',
55
+ // 设备注册表落盘路径(可选)。提供后配对设备跨重启保留,手机无需重新配对。
56
+ pairingFile = null,
57
+ tunnelAutoRestart = false,
58
+ // Pro 固定地址开通器(见 cloudflare.mjs)。**提供即切到 named 模式**:
59
+ // 有稳定子域就不该再退化成随机域名。为 null 时保持 Quick Tunnel 行为不变。
60
+ tunnelProvisioner = null,
61
+ tunnelPidFile = null,
62
+ } = {}) {
63
+ if (!host) throw new Error('createGateway 需要 host 适配器');
64
+
65
+ // 网关自身提供的能力(与宿主能力合并后对外声明):
66
+ // 只加"客户端需要据此决定走哪条路"的项,不虚报业务能力。
67
+ const GATEWAY_CAPS = ['ws.ticket'];
68
+ // info() 绝不抛:宿主未就绪时给"降级但可诊断"的答案,
69
+ // 否则网关会连启动都失败,用户在手机上只会看到"连不上"而不知道原因。
70
+ const hostView = Object.create(host, {
71
+ info: {
72
+ value: () => {
73
+ try {
74
+ const i = host.info();
75
+ return { ...i, caps: [...new Set([...(i.caps || []), ...GATEWAY_CAPS])] };
76
+ } catch (err) {
77
+ return {
78
+ hostId: 'host_unknown',
79
+ hostName: '主机端未就绪',
80
+ hostVersion: 'unknown',
81
+ platform: process.platform,
82
+ protocolVersion: '1.0',
83
+ caps: [...GATEWAY_CAPS],
84
+ degraded: true,
85
+ reason: err.message,
86
+ };
87
+ }
88
+ },
89
+ },
90
+ kind: { value: host.kind },
91
+ });
92
+
93
+ const pairing = new PairingService({ log, file: pairingFile });
94
+ const tickets = new TicketStore();
95
+ const core = new GatewayCore({ host: hostView, pairing, log });
96
+
97
+ // 隧道(GW-8):地址漂移必须广播,否则客户端会一直连旧域名。
98
+ const tunnel = new TunnelManager({
99
+ port,
100
+ log,
101
+ executable: tunnelExecutable,
102
+ // 插件形态默认开自动重拉:宿主进程长活,cloudflared 意外退出后
103
+ // 不重拉的话手机会一直显示「在线」但隧道实际已死。
104
+ autoRestart: tunnelAutoRestart,
105
+ mode: tunnelProvisioner ? 'named' : 'quick',
106
+ // 孤儿回收用:宿主被 kill -9 时 cloudflared 不随父进程退出
107
+ pidFile: tunnelPidFile || path.join(os.homedir(), '.dsh', 'mobile-access', 'cloudflared.pid'),
108
+ // named 的 token 每次启动时现取(可能顺带完成开通),**不进 argv**。
109
+ // 这里读 tunnel.port 而不是外层 port:端口被占用时会顺延,ingress 必须跟着走。
110
+ resolveNamedTarget: tunnelProvisioner
111
+ ? () => tunnelProvisioner.credential({ port: tunnel.port })
112
+ : null,
113
+ onAddrChanged: (url, prevUrl) => {
114
+ core.notifyGateway({ event: 'addr_changed', baseUrl: url, prevBaseUrl: prevUrl });
115
+ },
116
+ });
117
+
118
+ const config = {
119
+ dev,
120
+ addrs,
121
+ adapterKind: host.kind,
122
+ wsStats: () => ws.stats(),
123
+ dropAll: () => ws.dropAll?.() ?? 0,
124
+ tunnel,
125
+ tunnelProvisioner,
126
+ hostView,
127
+ // 手机端要填的「电脑地址」(LAN IP:port);未起或无私网地址时为 null
128
+ lanAddr: () => (listening?.lan ?? null),
129
+ };
130
+ const handler = createRestRouter({ core, pairing, host: hostView, tickets, config, log });
131
+ // 固定地址是自有域名:隧道进来的 Host 是 dsh-xxxx.matrixboard.cn,
132
+ // 不把 zone 加进白名单会在 WS 握手阶段 403(REST 通但实时不通,最难查的一种半通)。
133
+ const suffixes = tunnelProvisioner?.baseDomain ? [...hostSuffixes, tunnelProvisioner.baseDomain] : hostSuffixes;
134
+ const hostAllow = makeHostAllow(suffixes);
135
+
136
+ const server = http.createServer((req, res) => {
137
+ handler(req, res).catch((err) => {
138
+ log(`http unhandled ${err.stack || err}`);
139
+ if (!res.headersSent) {
140
+ res.writeHead(500, { 'Content-Type': 'application/json' });
141
+ res.end(JSON.stringify({ error: { code: 4500, message: '网关内部错误' } }));
142
+ } else res.end();
143
+ });
144
+ });
145
+ server.keepAliveTimeout = 15_000;
146
+
147
+ const ws = attachWebSocket(server, { core, pairing, tickets, log, hostAllow });
148
+
149
+ let listening = null;
150
+
151
+ const tryListen = (candidate) =>
152
+ new Promise((resolve, reject) => {
153
+ const onError = (err) => {
154
+ server.removeListener('listening', onListening);
155
+ reject(err);
156
+ };
157
+ const onListening = () => {
158
+ server.removeListener('error', onError);
159
+ resolve(candidate);
160
+ };
161
+ server.once('error', onError);
162
+ server.once('listening', onListening);
163
+ server.listen(candidate, allowLan ? '0.0.0.0' : '127.0.0.1');
164
+ });
165
+
166
+ async function start() {
167
+ core.start();
168
+ let lastErr = null;
169
+ for (let i = 0; i < PORT_FALLBACK; i += 1) {
170
+ try {
171
+ const used = await tryListen(port + i);
172
+ const addr = server.address();
173
+ const lan = lanIPv4();
174
+ listening = {
175
+ port: used,
176
+ address: addr.address,
177
+ requested: port,
178
+ fallback: used !== port,
179
+ lan: allowLan && lan ? `${lan}:${used}` : null,
180
+ };
181
+ // 隧道指向真实监听端口(端口可能因占用而顺延)
182
+ tunnel.port = used;
183
+ log(`srv listening ${addr.address}:${used}${used !== port ? ` (端口 ${port} 被占用,已顺延)` : ''}`);
184
+ if (listening.lan) log(`srv LAN http://${listening.lan}/mobile/v1/health(手机端填这个地址)`);
185
+ return listening;
186
+ } catch (err) {
187
+ lastErr = err;
188
+ if (err.code !== 'EADDRINUSE' && err.code !== 'EACCES') break;
189
+ }
190
+ }
191
+ core.stop();
192
+ throw lastErr || new Error('无法绑定端口');
193
+ }
194
+
195
+ async function stop() {
196
+ ws.closeAll();
197
+ core.stop();
198
+ // 先收隧道子进程,再关监听:反序会让 cloudflared 变成连不上任何东西的孤儿进程。
199
+ await tunnel.stop().catch((err) => log(`tunnel stop error: ${err.message}`));
200
+ await new Promise((resolve) => server.close(() => resolve()));
201
+ await host.close?.();
202
+ listening = null;
203
+ log('srv stopped');
204
+ }
205
+
206
+ return {
207
+ server,
208
+ core,
209
+ pairing,
210
+ tickets,
211
+ tunnel,
212
+ start,
213
+ stop,
214
+ get address() {
215
+ return listening;
216
+ },
217
+ stats: () => ({ ...core.stats(), ws: ws.stats(), address: listening }),
218
+ };
219
+ }