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.
@@ -1,251 +1,430 @@
1
- // zone-health.mjs — 「域名到底归谁、公网到底在服务哪一份 zone」
2
- //
3
- // 为什么需要这个模块:DNS 解析失败只是**症状**,原因是 zone 层面的事,而面板原来
4
- // 一律解释成「zone 处于 pending」——这在真实世界里会把人带偏。
5
- //
6
- // Cloudflare 的 zone 有四种会让地址「开通成功但解析不到」的状态:
7
- // · active 公网 NS 指向本账号、记录正常下发 —— 正常
8
- // · pending 域名已加进本账号,但注册商 NS 还没指过来 —— 改 NS 即可
9
- // · moved 域名已被**另一个 Cloudflare 账号**接管 —— 本账号写什么都无效,
10
- // 公网 NS 是对方那一对(每个账号的 NS 对是固定的,所以能直接看出来)
11
- // · 记录在某台机器上被 --overwrite-dns 改指到另一条隧道 —— 见 findDnsOwner()
12
- //
13
- // 本机 `cloudflared tunnel login` 生成的 cert.pem 里就带着 zoneID / accountID /
14
- // 一份 zone 范围的 apiToken,因此**不需要额外凭据**就能只读地问清 zone 状态。
15
- // 这里只做 GET,绝不写;token 只在函数内部流转,不进状态文件、不进日志。
16
- //
17
- // 另一条硬约束:所有失败都必须**降级为 null**(返回「不知道」),不能让一个
18
- // 查不到状态的网络问题把本来能用的固定地址判死。
19
-
20
- import crypto from 'node:crypto';
21
- import fs from 'node:fs';
22
- import os from 'node:os';
23
- import path from 'node:path';
24
-
25
- export const CF_API_BASE = 'https://api.cloudflare.com/client/v4';
26
-
27
- /** zone 状态码 → 面板可读的一句话(短,塞得进 300px 宽的面板)。 */
28
- export const ZONE_STATUS_HINT = {
29
- active: '域名在 Cloudflare 已生效',
30
- pending: '域名在本账号尚未生效(zone pending),公网 NS 没指向本账号',
31
- moved: '域名已被另一个 Cloudflare 账号接管(zone moved),本账号写入的记录不再下发',
32
- initializing: '域名正在本账号初始化(zone initializing)',
33
- };
34
-
35
- /** 诊断码 → 短提示。code 比 status 更适合面板:它已经带上了「NS 对不对」的结论。 */
36
- export const ZONE_CODE_HINT = {
37
- moved: '域名已被另一个 Cloudflare 账号接管,公网 NS 指向对方,本机写入的记录不会生效',
38
- pending: '域名在本账号还没生效(zone pending):公网 NS 还没指向本账号分配的那一对',
39
- 'ns-mismatch': '域名在本账号显示已生效,但公网 NS 与本账号分配的不一致',
40
- unresolved: '域名在 Cloudflare 已生效,但公网仍解析不到这台主机的地址',
41
- };
42
-
43
- /**
44
- * 读 cert.pem 里的 zone 身份。结构是 PEM 包一层 base64(JSON)。
45
- * @returns {{ zoneId: string|null, accountId: string|null, apiToken: string|null }|null}
46
- */
47
- export function readZoneCert({ homeDir = os.homedir() } = {}) {
48
- const file = path.join(homeDir, '.cloudflared', 'cert.pem');
49
- let pem;
50
- try {
51
- pem = fs.readFileSync(file, 'utf8');
52
- } catch {
53
- return null;
54
- }
55
- try {
56
- const b64 = pem.replace(/-----[^-]+-----/g, '').replace(/\s+/g, '');
57
- const parsed = JSON.parse(Buffer.from(b64, 'base64').toString('utf8'));
58
- return {
59
- zoneId: parsed.zoneID || parsed.zoneId || null,
60
- accountId: parsed.accountID || parsed.accountId || null,
61
- apiToken: parsed.apiToken || null,
62
- };
63
- } catch {
64
- return null;
65
- }
66
- }
67
-
68
- async function cfGet(apiBase, apiToken, pathname, fetchImpl) {
69
- const res = await fetchImpl(`${apiBase}${pathname}`, {
70
- headers: { Authorization: `Bearer ${apiToken}` },
71
- });
72
- const text = await res.text();
73
- let payload = null;
74
- try {
75
- payload = text ? JSON.parse(text) : null;
76
- } catch {
77
- return null;
78
- }
79
- if (!payload || payload.success !== true) return null;
80
- return payload.result;
81
- }
82
-
83
- /**
84
- * 查 zone 现状:状态 + **这个账号要求**的 NS 对 + 账号名。
85
- * 任一环节失败都返回 null(未知 ≠ 异常)。
86
- */
87
- export async function fetchZoneHealth({
88
- zoneId = null,
89
- baseDomain,
90
- apiToken,
91
- fetchImpl = globalThis.fetch,
92
- apiBase = CF_API_BASE,
93
- accountId = null,
94
- } = {}) {
95
- if (!apiToken || typeof fetchImpl !== 'function') return null;
96
- let zone = null;
97
- try {
98
- if (zoneId) {
99
- zone = await cfGet(apiBase, apiToken, `/zones/${zoneId}`, fetchImpl);
100
- }
101
- // cert 里的 zoneID 可能属于旧 zone(重新接入后会换),名字查一遍更稳
102
- if (!zone && baseDomain) {
103
- const list = await cfGet(apiBase, apiToken, `/zones?name=${encodeURIComponent(baseDomain)}`, fetchImpl);
104
- zone = Array.isArray(list) ? list.find((z) => z && z.name === baseDomain) || null : null;
105
- }
106
- } catch {
107
- return null;
108
- }
109
- if (!zone) return null;
110
-
111
- let accountName = null;
112
- const acc = accountId || zone.account?.id || null;
113
- if (acc) {
114
- try {
115
- const a = await cfGet(apiBase, apiToken, `/accounts/${acc}`, fetchImpl);
116
- accountName = a?.name || null;
117
- } catch {
118
- /* 只是少一句「账号是谁」,不影响结论 */
119
- }
120
- }
121
- return {
122
- zoneId: zone.id || null,
123
- zoneName: zone.name || baseDomain || null,
124
- status: zone.status || null,
125
- nameServers: (zone.name_servers || []).map((n) => String(n).toLowerCase().replace(/\.$/, '')).sort(),
126
- accountId: acc,
127
- accountName,
128
- modifiedAt: zone.modified_on || null,
129
- };
130
- }
131
-
132
- const norm = (list) => (Array.isArray(list) ? list : [])
133
- .map((n) => String(n).toLowerCase().replace(/\.$/, ''))
134
- .filter(Boolean)
135
- .sort();
136
-
137
- /**
138
- * 把 zone 身份 + 公网 NS 合成为一个诊断码。
139
- *
140
- * 判据刻意简单:`moved` 是 Cloudflare 已经明确告诉我们「这域名不归你了」,
141
- * 优先采信;`active` 时用 NS 交集兜底(NS 刚改完的过渡期两边都可能答话)。
142
- */
143
- export function classifyZone({ zone = null, publicNs = [], dnsOk = false } = {}) {
144
- const expectedNs = norm(zone?.nameServers);
145
- const publicNsNorm = norm(publicNs);
146
- const status = zone?.status || null;
147
- const base = { status, expectedNs, publicNs: publicNsNorm, zoneName: zone?.zoneName || null, accountName: zone?.accountName || null };
148
-
149
- if (!zone) return { code: 'unknown', ...base };
150
- if (status === 'moved') return { code: 'moved', ...base };
151
- if (status === 'pending' || status === 'initializing') return { code: 'pending', ...base };
152
- if (status === 'active') {
153
- const overlap = publicNsNorm.some((n) => expectedNs.includes(n));
154
- if (publicNsNorm.length && expectedNs.length && !overlap) return { code: 'ns-mismatch', ...base };
155
- return { code: dnsOk ? 'ok' : 'unresolved', ...base };
156
- }
157
- return { code: 'unknown', ...base };
158
- }
159
-
160
- /** 诊断码 → 面板短提示(null 表示不必打扰用户)。 */
161
- export function zoneHint(code) {
162
- return ZONE_CODE_HINT[code] || null;
163
- }
164
-
165
- /**
166
- * 完整诊断:读证书 → 查 zone → 若给了公网 NS 就一并归类。
167
- * 任何一步不可用都退回 `{ code: 'unknown' }`,绝不抛。
168
- */
169
- export async function diagnoseZone({
170
- homeDir = os.homedir(),
171
- baseDomain,
172
- publicNs = [],
173
- dnsOk = false,
174
- zoneId = null,
175
- apiToken = null,
176
- accountId = null,
177
- fetchImpl = globalThis.fetch,
178
- apiBase = CF_API_BASE,
179
- } = {}) {
180
- const cert = apiToken ? null : readZoneCert({ homeDir });
181
- const health = await fetchZoneHealth({
182
- zoneId: zoneId || cert?.zoneId || null,
183
- accountId: accountId || cert?.accountId || null,
184
- baseDomain,
185
- apiToken: apiToken || cert?.apiToken || null,
186
- fetchImpl,
187
- apiBase,
188
- });
189
- if (!health) return { code: 'unknown', status: null, expectedNs: [], publicNs: norm(publicNs), zoneName: null, accountName: null };
190
- const verdict = classifyZone({ zone: health, publicNs, dnsOk });
191
- return {
192
- ...verdict,
193
- zoneId: health.zoneId,
194
- accountId: health.accountId,
195
- modifiedAt: health.modifiedAt,
196
- };
197
- }
198
-
199
- /**
200
- * 这条 hostname 现在的 CNAME 指向哪条隧道?
201
- *
202
- * 用途:多台机器共用一个 Cloudflare 账号时,`cloudflared tunnel route dns
203
- * --overwrite-dns` 会**静默**把别人的地址抢过来——A 机好好的,B 机一开通 A 机就断,
204
- * 而且两边面板都显示「成功」。开通前先看一眼归属,能避免这种互相踩踏。
205
- *
206
- * @returns {string|null} 小写 CNAME 目标;无记录返回 null;查不到(无凭据/断网)也返回 null
207
- */
208
- export async function findDnsOwner({
209
- homeDir = os.homedir(),
210
- baseDomain,
211
- hostname,
212
- fetchImpl = globalThis.fetch,
213
- apiBase = CF_API_BASE,
214
- zoneId = null,
215
- apiToken = null,
216
- } = {}) {
217
- const cert = apiToken ? null : readZoneCert({ homeDir });
218
- const token = apiToken || cert?.apiToken || null;
219
- if (!token || !hostname) return null;
220
- try {
221
- let zid = zoneId || null;
222
- if (!zid && baseDomain) {
223
- const list = await cfGet(apiBase, token, `/zones?name=${encodeURIComponent(baseDomain)}`, fetchImpl);
224
- zid = Array.isArray(list) ? list.find((z) => z && z.name === baseDomain)?.id || null : null;
225
- }
226
- if (!zid) return null;
227
- const records = await cfGet(
228
- apiBase,
229
- token,
230
- `/zones/${zid}/dns_records?type=CNAME&name=${encodeURIComponent(hostname)}`,
231
- fetchImpl,
232
- );
233
- const hit = Array.isArray(records) ? records[0] : null;
234
- return hit?.content ? String(hit.content).toLowerCase().replace(/\.$/, '') : null;
235
- } catch {
236
- return null;
237
- }
238
- }
239
-
240
- /** 这条 CNAME 目标是不是"本机隧道":只比较 UUID 前缀,容忍 cfdargotunnel.com 结尾差异。 */
241
- export function cnameBelongsTo(content, tunnelId) {
242
- if (!content || !tunnelId) return false;
243
- return String(content).toLowerCase().startsWith(String(tunnelId).toLowerCase());
244
- }
245
-
246
- /** 稳定摘要,用于把「同一份 zone」与「另一份 zone」区分开(不写 ID,只做等值比较)。 */
247
- export function zoneFingerprint(zone) {
248
- const src = `${zone?.accountId || ''}|${zone?.zoneId || ''}|${zone?.zoneName || ''}`;
249
- if (!src.replace(/\|/g, '')) return null;
250
- return crypto.createHash('sha256').update(src).digest('hex').slice(0, 12);
251
- }
1
+ // zone-health.mjs — 「域名到底归谁、公网到底在服务哪一份 zone」
2
+ //
3
+ // 为什么需要这个模块:DNS 解析失败只是**症状**,原因是 zone 层面的事,而面板原来
4
+ // 一律解释成「zone 处于 pending」——这在真实世界里会把人带偏。
5
+ //
6
+ // Cloudflare 的 zone 有四种会让地址「开通成功但解析不到」的状态:
7
+ // · active 公网 NS 指向本账号、记录正常下发 —— 正常
8
+ // · pending 域名已加进本账号,但注册商 NS 还没指过来 —— 改 NS 即可
9
+ // · moved 域名已被**另一个 Cloudflare 账号**接管 —— 本账号写什么都无效,
10
+ // 公网 NS 是对方那一对(每个账号的 NS 对是固定的,所以能直接看出来)
11
+ // · 记录在某台机器上被 --overwrite-dns 改指到另一条隧道 —— 见 findDnsOwner()
12
+ //
13
+ // 本机 `cloudflared tunnel login` 生成的 cert.pem 里就带着 zoneID / accountID /
14
+ // 一份 zone 范围的 apiToken,因此**不需要额外凭据**就能只读地问清 zone 状态。
15
+ // 这里只做 GET,绝不写;token 只在函数内部流转,不进状态文件、不进日志。
16
+ //
17
+ // 另一条硬约束:所有失败都必须**降级为 null**(返回「不知道」),不能让一个
18
+ // 查不到状态的网络问题把本来能用的固定地址判死。
19
+
20
+ import crypto from 'node:crypto';
21
+ import fs from 'node:fs';
22
+ import os from 'node:os';
23
+ import path from 'node:path';
24
+
25
+ export const CF_API_BASE = 'https://api.cloudflare.com/client/v4';
26
+
27
+ /** zone 状态码 → 面板可读的一句话(短,塞得进 300px 宽的面板)。 */
28
+ export const ZONE_STATUS_HINT = {
29
+ active: '域名在 Cloudflare 已生效',
30
+ pending: '域名在本账号尚未生效(zone pending),公网 NS 没指向本账号',
31
+ moved: '域名已被另一个 Cloudflare 账号接管(zone moved),本账号写入的记录不再下发',
32
+ initializing: '域名正在本账号初始化(zone initializing)',
33
+ };
34
+
35
+ /** 诊断码 → 短提示。code 比 status 更适合面板:它已经带上了「NS 对不对」的结论。 */
36
+ export const ZONE_CODE_HINT = {
37
+ moved: '域名已被另一个 Cloudflare 账号接管,公网 NS 指向对方,本机写入的记录不会生效',
38
+ pending: '域名在本账号还没生效(zone pending):公网 NS 还没指向本账号分配的那一对',
39
+ 'ns-mismatch': '域名在本账号显示已生效,但公网 NS 与本账号分配的不一致',
40
+ unresolved: '域名在 Cloudflare 已生效,但公网仍解析不到这台主机的地址',
41
+ };
42
+
43
+ /**
44
+ * 读 cert.pem 里的 zone 身份。结构是 PEM 包一层 base64(JSON)。
45
+ * @returns {{ zoneId: string|null, accountId: string|null, apiToken: string|null }|null}
46
+ */
47
+ export function readZoneCert({ homeDir = os.homedir() } = {}) {
48
+ const file = path.join(homeDir, '.cloudflared', 'cert.pem');
49
+ let pem;
50
+ try {
51
+ pem = fs.readFileSync(file, 'utf8');
52
+ } catch {
53
+ return null;
54
+ }
55
+ try {
56
+ const b64 = pem.replace(/-----[^-]+-----/g, '').replace(/\s+/g, '');
57
+ const parsed = JSON.parse(Buffer.from(b64, 'base64').toString('utf8'));
58
+ return {
59
+ zoneId: parsed.zoneID || parsed.zoneId || null,
60
+ accountId: parsed.accountID || parsed.accountId || null,
61
+ apiToken: parsed.apiToken || null,
62
+ };
63
+ } catch {
64
+ return null;
65
+ }
66
+ }
67
+
68
+ async function cfGet(apiBase, apiToken, pathname, fetchImpl) {
69
+ const res = await fetchImpl(`${apiBase}${pathname}`, {
70
+ headers: { Authorization: `Bearer ${apiToken}` },
71
+ });
72
+ const text = await res.text();
73
+ let payload = null;
74
+ try {
75
+ payload = text ? JSON.parse(text) : null;
76
+ } catch {
77
+ return null;
78
+ }
79
+ if (!payload || payload.success !== true) return null;
80
+ return payload.result;
81
+ }
82
+
83
+ /**
84
+ * 查 zone 现状:状态 + **这个账号要求**的 NS 对 + 账号名。
85
+ * 任一环节失败都返回 null(未知 ≠ 异常)。
86
+ */
87
+ export async function fetchZoneHealth({
88
+ zoneId = null,
89
+ baseDomain,
90
+ apiToken,
91
+ fetchImpl = globalThis.fetch,
92
+ apiBase = CF_API_BASE,
93
+ accountId = null,
94
+ } = {}) {
95
+ if (!apiToken || typeof fetchImpl !== 'function') return null;
96
+ let zone = null;
97
+ try {
98
+ if (zoneId) {
99
+ zone = await cfGet(apiBase, apiToken, `/zones/${zoneId}`, fetchImpl);
100
+ }
101
+ // cert 里的 zoneID 可能属于旧 zone(重新接入后会换),名字查一遍更稳
102
+ if (!zone && baseDomain) {
103
+ const list = await cfGet(apiBase, apiToken, `/zones?name=${encodeURIComponent(baseDomain)}`, fetchImpl);
104
+ zone = Array.isArray(list) ? list.find((z) => z && z.name === baseDomain) || null : null;
105
+ }
106
+ } catch {
107
+ return null;
108
+ }
109
+ if (!zone) return null;
110
+
111
+ let accountName = null;
112
+ const acc = accountId || zone.account?.id || null;
113
+ if (acc) {
114
+ try {
115
+ const a = await cfGet(apiBase, apiToken, `/accounts/${acc}`, fetchImpl);
116
+ accountName = a?.name || null;
117
+ } catch {
118
+ /* 只是少一句「账号是谁」,不影响结论 */
119
+ }
120
+ }
121
+ return {
122
+ zoneId: zone.id || null,
123
+ zoneName: zone.name || baseDomain || null,
124
+ status: zone.status || null,
125
+ nameServers: (zone.name_servers || []).map((n) => String(n).toLowerCase().replace(/\.$/, '')).sort(),
126
+ accountId: acc,
127
+ accountName,
128
+ modifiedAt: zone.modified_on || null,
129
+ };
130
+ }
131
+
132
+ const norm = (list) => (Array.isArray(list) ? list : [])
133
+ .map((n) => String(n).toLowerCase().replace(/\.$/, ''))
134
+ .filter(Boolean)
135
+ .sort();
136
+
137
+ /**
138
+ * 把 zone 身份 + 公网 NS 合成为一个诊断码。
139
+ *
140
+ * 判据刻意简单:`moved` 是 Cloudflare 已经明确告诉我们「这域名不归你了」,
141
+ * 优先采信;`active` 时用 NS 交集兜底(NS 刚改完的过渡期两边都可能答话)。
142
+ */
143
+ export function classifyZone({ zone = null, publicNs = [], dnsOk = false } = {}) {
144
+ const expectedNs = norm(zone?.nameServers);
145
+ const publicNsNorm = norm(publicNs);
146
+ const status = zone?.status || null;
147
+ const base = { status, expectedNs, publicNs: publicNsNorm, zoneName: zone?.zoneName || null, accountName: zone?.accountName || null };
148
+
149
+ if (!zone) return { code: 'unknown', ...base };
150
+ if (status === 'moved') return { code: 'moved', ...base };
151
+ if (status === 'pending' || status === 'initializing') return { code: 'pending', ...base };
152
+ if (status === 'active') {
153
+ const overlap = publicNsNorm.some((n) => expectedNs.includes(n));
154
+ if (publicNsNorm.length && expectedNs.length && !overlap) return { code: 'ns-mismatch', ...base };
155
+ return { code: dnsOk ? 'ok' : 'unresolved', ...base };
156
+ }
157
+ return { code: 'unknown', ...base };
158
+ }
159
+
160
+ /** 诊断码 → 面板短提示(null 表示不必打扰用户)。 */
161
+ export function zoneHint(code) {
162
+ return ZONE_CODE_HINT[code] || null;
163
+ }
164
+
165
+ /**
166
+ * 完整诊断:读证书 → 查 zone → 若给了公网 NS 就一并归类。
167
+ * 任何一步不可用都退回 `{ code: 'unknown' }`,绝不抛。
168
+ */
169
+ export async function diagnoseZone({
170
+ homeDir = os.homedir(),
171
+ baseDomain,
172
+ publicNs = [],
173
+ dnsOk = false,
174
+ zoneId = null,
175
+ apiToken = null,
176
+ accountId = null,
177
+ fetchImpl = globalThis.fetch,
178
+ apiBase = CF_API_BASE,
179
+ } = {}) {
180
+ const cert = apiToken ? null : readZoneCert({ homeDir });
181
+ const health = await fetchZoneHealth({
182
+ zoneId: zoneId || cert?.zoneId || null,
183
+ accountId: accountId || cert?.accountId || null,
184
+ baseDomain,
185
+ apiToken: apiToken || cert?.apiToken || null,
186
+ fetchImpl,
187
+ apiBase,
188
+ });
189
+ if (!health) return { code: 'unknown', status: null, expectedNs: [], publicNs: norm(publicNs), zoneName: null, accountName: null };
190
+ const verdict = classifyZone({ zone: health, publicNs, dnsOk });
191
+ return {
192
+ ...verdict,
193
+ zoneId: health.zoneId,
194
+ accountId: health.accountId,
195
+ modifiedAt: health.modifiedAt,
196
+ };
197
+ }
198
+
199
+ /**
200
+ * 这条 hostname 现在的 CNAME 指向哪条隧道?
201
+ *
202
+ * 用途:多台机器共用一个 Cloudflare 账号时,`cloudflared tunnel route dns
203
+ * --overwrite-dns` 会**静默**把别人的地址抢过来——A 机好好的,B 机一开通 A 机就断,
204
+ * 而且两边面板都显示「成功」。开通前先看一眼归属,能避免这种互相踩踏。
205
+ *
206
+ * @returns {string|null} 小写 CNAME 目标;无记录返回 null;查不到(无凭据/断网)也返回 null
207
+ */
208
+ export async function findDnsOwner({
209
+ homeDir = os.homedir(),
210
+ baseDomain,
211
+ hostname,
212
+ fetchImpl = globalThis.fetch,
213
+ apiBase = CF_API_BASE,
214
+ zoneId = null,
215
+ apiToken = null,
216
+ } = {}) {
217
+ const cert = apiToken ? null : readZoneCert({ homeDir });
218
+ const token = apiToken || cert?.apiToken || null;
219
+ if (!token || !hostname) return null;
220
+ try {
221
+ let zid = zoneId || null;
222
+ if (!zid && baseDomain) {
223
+ const list = await cfGet(apiBase, token, `/zones?name=${encodeURIComponent(baseDomain)}`, fetchImpl);
224
+ zid = Array.isArray(list) ? list.find((z) => z && z.name === baseDomain)?.id || null : null;
225
+ }
226
+ if (!zid) return null;
227
+ const records = await cfGet(
228
+ apiBase,
229
+ token,
230
+ `/zones/${zid}/dns_records?type=CNAME&name=${encodeURIComponent(hostname)}`,
231
+ fetchImpl,
232
+ );
233
+ const hit = Array.isArray(records) ? records[0] : null;
234
+ return hit?.content ? String(hit.content).toLowerCase().replace(/\.$/, '') : null;
235
+ } catch {
236
+ return null;
237
+ }
238
+ }
239
+
240
+ /** 这条 CNAME 目标是不是"本机隧道":只比较 UUID 前缀,容忍 cfdargotunnel.com 结尾差异。 */
241
+ export function cnameBelongsTo(content, tunnelId) {
242
+ if (!content || !tunnelId) return false;
243
+ return String(content).toLowerCase().startsWith(String(tunnelId).toLowerCase());
244
+ }
245
+
246
+ /**
247
+ * 凭据状态码 → 面板一句话。blocking 的几种都是**确定不可用**,
248
+ * 其余(unknown / unreadable / no-token)只表示「查不清」,绝不能据此拦人。
249
+ */
250
+ export const CREDENTIAL_STATE_HINT = {
251
+ ok: '登录的 Cloudflare 账号可以管理这个域名',
252
+ missing: '主机还没有登录 Cloudflare',
253
+ unreadable: 'cert.pem 无法解析(可能是旧格式或文件损坏)',
254
+ 'no-token': 'cert.pem 里没有可用的 zone token(旧版证书)',
255
+ forbidden: '登录的 Cloudflare 账号没有这个域名的权限',
256
+ 'zone-missing': '当前登录的账号里看不到这个域名',
257
+ 'account-mismatch': '证书所属账号与域名所在账号不是同一个',
258
+ 'stale-zone': 'cert.pem 指向的 zone 已失效(域名可能被删后重新接入)',
259
+ 'zone-moved': '域名已被另一个 Cloudflare 账号接管',
260
+ unknown: '暂时查不到凭据的可用性(网络不可达)',
261
+ };
262
+
263
+ /** 这些状态是「确定不可用」:可以放心在写 DNS 之前拦下,并给出对应修法。 */
264
+ const BLOCKING_STATES = new Set(['missing', 'forbidden', 'zone-missing', 'account-mismatch', 'stale-zone', 'zone-moved']);
265
+
266
+ /**
267
+ * 带 HTTP 状态的只读请求(cfGet 只关心 result,这里需要区分 403 与「断网」)。
268
+ * 任何异常都收敛成一个对象,绝不抛。
269
+ */
270
+ async function cfRequest(apiBase, apiToken, pathname, fetchImpl, timeoutMs = 4000) {
271
+ const controller = typeof AbortController === 'function' ? new AbortController() : null;
272
+ const timer = controller ? setTimeout(() => controller.abort(), timeoutMs) : null;
273
+ try {
274
+ const res = await fetchImpl(`${apiBase}${pathname}`, {
275
+ headers: { Authorization: `Bearer ${apiToken}` },
276
+ ...(controller ? { signal: controller.signal } : {}),
277
+ });
278
+ const text = await res.text();
279
+ let payload = null;
280
+ try { payload = text ? JSON.parse(text) : null; } catch { payload = null; }
281
+ return {
282
+ status: res.status,
283
+ ok: Boolean(res.ok),
284
+ success: payload?.success === true,
285
+ result: payload?.result ?? null,
286
+ errors: payload?.errors ?? [],
287
+ reached: true,
288
+ };
289
+ } catch (err) {
290
+ return { status: 0, ok: false, success: false, result: null, errors: [], reached: false, error: err?.message || String(err) };
291
+ } finally {
292
+ if (timer) clearTimeout(timer);
293
+ }
294
+ }
295
+
296
+ /**
297
+ * 开通前凭据预检:**这本 cert.pem 能不能写这个域名的 DNS**。
298
+ *
299
+ * 为什么必须在写 DNS 之前问:cross-account 的证书能列隧道、能建隧道(账号级权限正常),
300
+ * 只有写 DNS 会失败。等 CLI 报错时,用户已经拿到一个「隧道正常」的假象,
301
+ * 而错误又被截断成一行命令回显——这正是 2026-11-21 的现场。
302
+ *
303
+ * 判定口径(宁可放过,不可误杀):
304
+ * · 403 / success:false → 确定无权限(forbidden)
305
+ * · 200 且 zone 列表为空 → 这个 token 看不到该域名(zone-missing)
306
+ * · zone.account 与证书 account 不同 → account-mismatch
307
+ * · zone.id 与证书 zoneID 不同 → 证书指向旧 zone(stale-zone)
308
+ * · zone.status = moved → 域名被另一账号接管(zone-moved)
309
+ * · 断网/超时/无 token/解析失败 → unknown(不拦,交给 CLI 报错兜底)
310
+ *
311
+ * @returns {Promise<{state: string, blocking: boolean, hint: string|null,
312
+ * accountName: string|null, zoneName: string|null, zoneStatus: string|null,
313
+ * certAccountId: string|null, zoneId: string|null, detail: string|null}>}
314
+ */
315
+ export async function verifyCertAccess({
316
+ homeDir = os.homedir(),
317
+ baseDomain,
318
+ fetchImpl = globalThis.fetch,
319
+ apiBase = CF_API_BASE,
320
+ timeoutMs = 4000,
321
+ } = {}) {
322
+ const base = {
323
+ state: 'unknown',
324
+ blocking: false,
325
+ hint: CREDENTIAL_STATE_HINT.unknown,
326
+ accountName: null,
327
+ zoneName: baseDomain || null,
328
+ zoneStatus: null,
329
+ certAccountId: null,
330
+ zoneId: null,
331
+ detail: null,
332
+ };
333
+ const certFile = path.join(homeDir, '.cloudflared', 'cert.pem');
334
+ if (!fs.existsSync(certFile)) {
335
+ return { ...base, state: 'missing', blocking: true, hint: CREDENTIAL_STATE_HINT.missing, detail: '没有找到 cert.pem' };
336
+ }
337
+ if (typeof fetchImpl !== 'function') return { ...base, detail: '当前运行时不支持网络请求' };
338
+
339
+ const cert = readZoneCert({ homeDir });
340
+ if (!cert) {
341
+ return { ...base, state: 'unreadable', blocking: false, hint: CREDENTIAL_STATE_HINT.unreadable, detail: 'cert.pem 结构无法解析' };
342
+ }
343
+ if (!cert.apiToken) {
344
+ return {
345
+ ...base,
346
+ state: 'no-token',
347
+ blocking: false,
348
+ hint: CREDENTIAL_STATE_HINT['no-token'],
349
+ certAccountId: cert.accountId || null,
350
+ detail: '证书里没有 apiToken,无法预检',
351
+ };
352
+ }
353
+ if (!baseDomain) return { ...base, detail: '未配置固定地址域名' };
354
+
355
+ const list = await cfRequest(apiBase, cert.apiToken, `/zones?name=${encodeURIComponent(baseDomain)}`, fetchImpl, timeoutMs);
356
+ if (!list.reached) return { ...base, certAccountId: cert.accountId || null, detail: list.error || null };
357
+ if (!list.ok || !list.success) {
358
+ // 403 是确定无权限;其余 4xx/5xx 说不清,交给 CLI
359
+ if (list.status === 403 || list.status === 401) {
360
+ return {
361
+ ...base,
362
+ state: 'forbidden',
363
+ blocking: true,
364
+ hint: CREDENTIAL_STATE_HINT.forbidden,
365
+ certAccountId: cert.accountId || null,
366
+ detail: `HTTP ${list.status}`,
367
+ };
368
+ }
369
+ return { ...base, certAccountId: cert.accountId || null, detail: `HTTP ${list.status}` };
370
+ }
371
+
372
+ const zones = Array.isArray(list.result) ? list.result : [];
373
+ const zone = zones.find((z) => z && String(z.name).toLowerCase() === baseDomain.toLowerCase()) || null;
374
+ if (!zone) {
375
+ // 空列表 = 这个 token 看不到该域名(zone 范围的 token 只列得出自己那把 zone)
376
+ return {
377
+ ...base,
378
+ state: 'zone-missing',
379
+ blocking: true,
380
+ hint: CREDENTIAL_STATE_HINT['zone-missing'],
381
+ certAccountId: cert.accountId || null,
382
+ detail: `证书指向 zone ${String(cert.zoneId || '未知').slice(0, 8)}…,但它已不在任何可访问的 ${baseDomain} 之下`,
383
+ };
384
+ }
385
+
386
+ const zoneAccountId = zone.account?.id || null;
387
+ const accountMismatch = Boolean(cert.accountId && zoneAccountId && cert.accountId !== zoneAccountId);
388
+ const staleZone = Boolean(cert.zoneId && zone.id && cert.zoneId !== zone.id);
389
+ let accountName = null;
390
+ if (zoneAccountId) {
391
+ const acc = await cfRequest(apiBase, cert.apiToken, `/accounts/${zoneAccountId}`, fetchImpl, timeoutMs);
392
+ if (acc.ok && acc.success) accountName = acc.result?.name || null;
393
+ }
394
+ const common = {
395
+ ...base,
396
+ accountName,
397
+ zoneName: zone.name || baseDomain,
398
+ zoneStatus: zone.status || null,
399
+ certAccountId: cert.accountId || null,
400
+ zoneId: zone.id || null,
401
+ };
402
+ if (accountMismatch) {
403
+ return {
404
+ ...common,
405
+ state: 'account-mismatch',
406
+ blocking: true,
407
+ hint: CREDENTIAL_STATE_HINT['account-mismatch'],
408
+ detail: `证书账号 ${String(cert.accountId).slice(0, 8)}…,域名归属 ${String(zoneAccountId).slice(0, 8)}…`,
409
+ };
410
+ }
411
+ if (staleZone) {
412
+ return { ...common, state: 'stale-zone', blocking: true, hint: CREDENTIAL_STATE_HINT['stale-zone'] };
413
+ }
414
+ if (zone.status === 'moved') {
415
+ return { ...common, state: 'zone-moved', blocking: true, hint: CREDENTIAL_STATE_HINT['zone-moved'] };
416
+ }
417
+ return { ...common, state: 'ok', blocking: false, hint: CREDENTIAL_STATE_HINT.ok };
418
+ }
419
+
420
+ /** 预检结论 → 是否阻断(供不关心细节的调用方使用)。 */
421
+ export function isCredentialBlocking(verdict) {
422
+ return Boolean(verdict && BLOCKING_STATES.has(verdict.state));
423
+ }
424
+
425
+ /** 稳定摘要,用于把「同一份 zone」与「另一份 zone」区分开(不写 ID,只做等值比较)。 */
426
+ export function zoneFingerprint(zone) {
427
+ const src = `${zone?.accountId || ''}|${zone?.zoneId || ''}|${zone?.zoneName || ''}`;
428
+ if (!src.replace(/\|/g, '')) return null;
429
+ return crypto.createHash('sha256').update(src).digest('hex').slice(0, 12);
430
+ }