@hjd-hitsz/claudex-web 4.1.5 → 4.2.1
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/.env.example +2 -0
- package/CHANGELOG.md +57 -0
- package/README.md +16 -4
- package/bin/auth.mjs +86 -0
- package/bin/claudex-web.mjs +20 -0
- package/bin/p2p.mjs +134 -0
- package/build-info.json +4 -4
- package/client/dist/app.js +154 -122
- package/client/dist/code-highlight-style.js +23 -45
- package/client/dist/document-editor.js +54 -54
- package/client/dist/file-panel.js +5 -5
- package/client/dist/notification-worker.js +2 -1
- package/client/dist/p2p-sw.js +162 -0
- package/client/dist/style.css +1 -1
- package/client/dist/terminal-panel.js +11 -11
- package/docs/architecture/backends.md +11 -2
- package/docs/architecture/behavior.md +173 -59
- package/docs/architecture.md +36 -339
- package/docs/background-tasks.md +32 -26
- package/docs/deployment.md +53 -12
- package/docs/development.md +121 -149
- package/docs/images/desktop-dark.png +0 -0
- package/docs/images/desktop-light.png +0 -0
- package/docs/images/mobile-sidebar.png +0 -0
- package/docs/images/mobile.png +0 -0
- package/docs/releases/v4.2.0.md +15 -0
- package/docs/releases/v4.2.1.md +15 -0
- package/docs/versioning.md +15 -5
- package/package.json +9 -2
- package/packages/background-terminal/LICENSE +674 -0
- package/packages/background-terminal/README.md +17 -0
- package/packages/background-terminal/background-jobs.mjs +457 -0
- package/packages/background-terminal/background-mcp.mjs +79 -0
- package/packages/background-terminal/background-protocol.mjs +90 -0
- package/packages/background-terminal/cli.mjs +14 -0
- package/packages/background-terminal/client.mjs +61 -0
- package/packages/background-terminal/codex.mjs +88 -0
- package/packages/background-terminal/delivery.mjs +194 -0
- package/packages/background-terminal/log.mjs +25 -0
- package/packages/background-terminal/native-watches.mjs +160 -0
- package/packages/background-terminal/package.json +15 -0
- package/packages/background-terminal/service.mjs +126 -0
- package/packages/translation-engine/package.json +1 -1
- package/server/src/application.mjs +82 -10
- package/server/src/auth-http.mjs +187 -0
- package/server/src/auth-login.mjs +144 -0
- package/server/src/auth-totp.mjs +233 -0
- package/server/src/auth.mjs +169 -220
- package/server/src/backends/claude/background-tasks.mjs +88 -35
- package/server/src/backends/claude/messages.mjs +1 -1
- package/server/src/backends/claude/worker-client.mjs +47 -35
- package/server/src/backends/claude/worker-lines.mjs +17 -0
- package/server/src/backends/claude/worker-server.mjs +49 -69
- package/server/src/backends/codex/adapter.mjs +57 -7
- package/server/src/backends/codex/background-service.mjs +85 -0
- package/server/src/backends/codex/background-task-views.mjs +87 -0
- package/server/src/backends/codex/background-terminals.mjs +103 -0
- package/server/src/backends/codex/events.mjs +25 -1
- package/server/src/backends/codex/methods.mjs +1 -0
- package/server/src/backends/codex/native-background-handoff.mjs +72 -0
- package/server/src/backends/codex/requests.mjs +67 -38
- package/server/src/backends/codex/streaming-messages.mjs +50 -0
- package/server/src/backends/codex/subscriptions.mjs +34 -4
- package/server/src/backends/configuration.mjs +8 -0
- package/server/src/backends/manager.mjs +34 -32
- package/server/src/backends/storage.mjs +3 -14
- package/server/src/config.mjs +13 -0
- package/server/src/http/business.mjs +21 -0
- package/server/src/http/router.mjs +12 -25
- package/server/src/p2p/http.mjs +136 -0
- package/server/src/p2p/peers.mjs +132 -0
- package/server/src/p2p/service.mjs +229 -0
- package/server/src/p2p/storage.mjs +45 -0
- package/server/src/p2p/tunnel.mjs +95 -0
- package/server/src/p2p-http.mjs +149 -0
- package/server/src/p2p-peer.mjs +135 -0
- package/server/src/private-file.mjs +14 -0
- package/server/src/summary-translation.mjs +1 -1
- package/server/src/thread-folders.mjs +3 -13
- package/server/src/translation-service.mjs +3 -8
- package/shared/codex-preferences.mjs +9 -0
- package/shared/p2p-wire.mjs +157 -0
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { createBackgroundService } from "./codex/background-service.mjs";
|
|
1
2
|
import { createThreadFolders } from "../thread-folders.mjs";
|
|
2
3
|
import { createTokenUsageStore } from "../token-usage.mjs";
|
|
3
4
|
import { createTokenUsageReconciliation } from "../token-usage-reconciliation.mjs";
|
|
@@ -5,6 +6,7 @@ import { createCliInstallation } from "./cli-installation.mjs";
|
|
|
5
6
|
import { join } from "node:path";
|
|
6
7
|
import { readProjectlessDirectories } from "../thread-projects.mjs";
|
|
7
8
|
import { createWorkspace } from "../workspace/service.mjs";
|
|
9
|
+
import { isCodexPreference } from "../../../shared/codex-preferences.mjs";
|
|
8
10
|
import { hasBackendWork } from "../../../shared/backend-activity.mjs";
|
|
9
11
|
import {
|
|
10
12
|
resourceTarget,
|
|
@@ -37,6 +39,7 @@ export function createBackendManager({
|
|
|
37
39
|
const tokenUsage = createTokenUsageStore(config.configDir);
|
|
38
40
|
const workspace = createWorkspace({ broadcast, configDir: config.configDir });
|
|
39
41
|
const configuration = createBackendConfiguration(config);
|
|
42
|
+
const background = createBackgroundService(config);
|
|
40
43
|
const providers = createProviders(configuration);
|
|
41
44
|
const instances = new Map();
|
|
42
45
|
const installationJobs = new Map();
|
|
@@ -60,6 +63,9 @@ export function createBackendManager({
|
|
|
60
63
|
const publicBackends = () =>
|
|
61
64
|
[...instances.values()].map(({ backend, adapter, error }) => ({
|
|
62
65
|
...backend,
|
|
66
|
+
...(backend.type === "codex" && {
|
|
67
|
+
backgroundTerminalAvailable: background.available,
|
|
68
|
+
}),
|
|
63
69
|
installation: {
|
|
64
70
|
...cli.state(backend.id),
|
|
65
71
|
installing: installationJobs.has(backend.id),
|
|
@@ -122,6 +128,9 @@ export function createBackendManager({
|
|
|
122
128
|
entry.adapter = factory({
|
|
123
129
|
backend,
|
|
124
130
|
config,
|
|
131
|
+
background,
|
|
132
|
+
backgroundEnabled: () =>
|
|
133
|
+
entry.backend.backgroundTerminalEnabled && background.available,
|
|
125
134
|
version,
|
|
126
135
|
providers,
|
|
127
136
|
readSubagentSettings: () =>
|
|
@@ -169,6 +178,15 @@ export function createBackendManager({
|
|
|
169
178
|
throw new Error(entry?.error || "后端未启用,请在设置中检查配置。");
|
|
170
179
|
return entry;
|
|
171
180
|
}
|
|
181
|
+
function projectResult(entry, result, method, usageRevision, forkUsage) {
|
|
182
|
+
return tokenUsage.result(
|
|
183
|
+
folders.result(mapResult(result, entry.backend.id, method), method),
|
|
184
|
+
method,
|
|
185
|
+
usageRevision,
|
|
186
|
+
forkUsage,
|
|
187
|
+
entry.adapter.readTokenUsage,
|
|
188
|
+
);
|
|
189
|
+
}
|
|
172
190
|
function proxy(entry, client) {
|
|
173
191
|
if (!entry.proxies.has(client)) {
|
|
174
192
|
const methods = new Map();
|
|
@@ -190,15 +208,12 @@ export function createBackendManager({
|
|
|
190
208
|
send(client, {
|
|
191
209
|
...message,
|
|
192
210
|
...(message.result && {
|
|
193
|
-
result: await
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
method,
|
|
197
|
-
),
|
|
211
|
+
result: await projectResult(
|
|
212
|
+
entry,
|
|
213
|
+
message.result,
|
|
198
214
|
method,
|
|
199
215
|
usageRevision,
|
|
200
216
|
forkUsage,
|
|
201
|
-
entry.adapter.readTokenUsage,
|
|
202
217
|
),
|
|
203
218
|
}),
|
|
204
219
|
});
|
|
@@ -233,15 +248,11 @@ export function createBackendManager({
|
|
|
233
248
|
if (message.error) reject(new Error(message.error.message));
|
|
234
249
|
else
|
|
235
250
|
resolve(
|
|
236
|
-
await
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
method,
|
|
240
|
-
),
|
|
251
|
+
await projectResult(
|
|
252
|
+
entry,
|
|
253
|
+
message.result,
|
|
241
254
|
method,
|
|
242
255
|
usageRevision,
|
|
243
|
-
undefined,
|
|
244
|
-
entry.adapter.readTokenUsage,
|
|
245
256
|
),
|
|
246
257
|
);
|
|
247
258
|
} catch (error) {
|
|
@@ -297,20 +308,13 @@ export function createBackendManager({
|
|
|
297
308
|
const next = validateBackend({ ...old?.backend, ...params }, config);
|
|
298
309
|
await validateSubagentSettings(next, providers);
|
|
299
310
|
if (
|
|
300
|
-
params.
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
)
|
|
304
|
-
)
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
...old.backend,
|
|
308
|
-
hiddenModels: params.hiddenModels,
|
|
309
|
-
});
|
|
310
|
-
emitState();
|
|
311
|
-
return { backends: publicBackends() };
|
|
312
|
-
}
|
|
313
|
-
if (!prepare && isSubagentSettings(params)) {
|
|
311
|
+
params.backgroundTerminalEnabled === true &&
|
|
312
|
+
!old?.backend.backgroundTerminalEnabled
|
|
313
|
+
)
|
|
314
|
+
await background.ensure();
|
|
315
|
+
if (params.hiddenModels !== undefined && params.id !== "codex")
|
|
316
|
+
throw new Error("模型显示配置仅用于 Codex");
|
|
317
|
+
if (!prepare && (isCodexPreference(params) || isSubagentSettings(params))) {
|
|
314
318
|
old.backend = await configuration.save(params);
|
|
315
319
|
emitState();
|
|
316
320
|
return { backends: publicBackends() };
|
|
@@ -370,10 +374,10 @@ export function createBackendManager({
|
|
|
370
374
|
instances.get("codex")?.backend.dataDir || config.codexHome,
|
|
371
375
|
),
|
|
372
376
|
});
|
|
373
|
-
if (method === "lan/backends/versions")
|
|
374
|
-
|
|
377
|
+
if (method === "lan/backends/versions" && !instances.has(params.id))
|
|
378
|
+
throw new Error("未知后端");
|
|
379
|
+
if (["lan/backends/list", "lan/backends/versions"].includes(method))
|
|
375
380
|
return reply({ backends: publicBackends() });
|
|
376
|
-
}
|
|
377
381
|
if (method === "lan/backends/install") {
|
|
378
382
|
const entry = instances.get(params.id);
|
|
379
383
|
if (!entry) throw new Error("未知后端");
|
|
@@ -396,8 +400,6 @@ export function createBackendManager({
|
|
|
396
400
|
}
|
|
397
401
|
return reply({ backends: publicBackends() });
|
|
398
402
|
}
|
|
399
|
-
if (method === "lan/backends/list")
|
|
400
|
-
return reply({ backends: publicBackends() });
|
|
401
403
|
if (
|
|
402
404
|
[
|
|
403
405
|
"lan/backends/save",
|
|
@@ -1,6 +1,5 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
3
|
-
import { randomUUID } from "node:crypto";
|
|
1
|
+
import { readFile } from "node:fs/promises";
|
|
2
|
+
import { writePrivateFile } from "../private-file.mjs";
|
|
4
3
|
|
|
5
4
|
export function createStorage(path, initial) {
|
|
6
5
|
let writing = Promise.resolve();
|
|
@@ -15,17 +14,7 @@ export function createStorage(path, initial) {
|
|
|
15
14
|
function update(change, readCurrent = true) {
|
|
16
15
|
const operation = writing.then(async () => {
|
|
17
16
|
const next = await change(readCurrent ? await read() : undefined);
|
|
18
|
-
await
|
|
19
|
-
const temporary = `${path}.${randomUUID()}.tmp`;
|
|
20
|
-
try {
|
|
21
|
-
await writeFile(temporary, JSON.stringify(next, null, 2) + "\n", {
|
|
22
|
-
mode: 0o600,
|
|
23
|
-
flag: "wx",
|
|
24
|
-
});
|
|
25
|
-
await rename(temporary, path);
|
|
26
|
-
} finally {
|
|
27
|
-
await rm(temporary, { force: true });
|
|
28
|
-
}
|
|
17
|
+
await writePrivateFile(path, JSON.stringify(next, null, 2) + "\n");
|
|
29
18
|
return next;
|
|
30
19
|
});
|
|
31
20
|
writing = operation.catch(() => {});
|
package/server/src/config.mjs
CHANGED
|
@@ -4,6 +4,14 @@ import { fileURLToPath } from "node:url";
|
|
|
4
4
|
|
|
5
5
|
import { productDirectories } from "./product-config.mjs";
|
|
6
6
|
|
|
7
|
+
export function supportsBackgroundTerminal(upstream) {
|
|
8
|
+
const url = new URL(upstream);
|
|
9
|
+
return (
|
|
10
|
+
url.protocol === "ws:" &&
|
|
11
|
+
["127.0.0.1", "localhost", "[::1]"].includes(url.hostname)
|
|
12
|
+
);
|
|
13
|
+
}
|
|
14
|
+
|
|
7
15
|
export function readConfig(env = process.env) {
|
|
8
16
|
const port = Number(env.PORT || 8766);
|
|
9
17
|
if (!Number.isInteger(port) || port < 0 || port > 65535)
|
|
@@ -22,6 +30,8 @@ export function readConfig(env = process.env) {
|
|
|
22
30
|
!["127.0.0.1", "localhost", "[::1]"].includes(backend.hostname)
|
|
23
31
|
)
|
|
24
32
|
throw new Error("跨主机 CODEX_APP_SERVER_URL 必须使用 wss://");
|
|
33
|
+
if (env.CLAUDEX_BACKGROUND_TASKS_DIR && !supportsBackgroundTerminal(backend))
|
|
34
|
+
throw new Error("后台终端 MCP 需要同机回环 WebSocket 地址");
|
|
25
35
|
if (!!env.TLS_CERT !== !!env.TLS_KEY)
|
|
26
36
|
throw new Error("TLS_CERT 与 TLS_KEY 必须同时配置");
|
|
27
37
|
const sessionDays = Number(env.AUTH_SESSION_DAYS || 30);
|
|
@@ -31,6 +41,9 @@ export function readConfig(env = process.env) {
|
|
|
31
41
|
if (!/^[a-zA-Z0-9_-]+$/.test(pamService))
|
|
32
42
|
throw new Error("AUTH_PAM_SERVICE 必须是 PAM 服务名称");
|
|
33
43
|
return {
|
|
44
|
+
backgroundTaskDir: env.CLAUDEX_BACKGROUND_TASKS_DIR
|
|
45
|
+
? resolve(env.CLAUDEX_BACKGROUND_TASKS_DIR)
|
|
46
|
+
: null,
|
|
34
47
|
backendsFile: env.CLAUDEX_WEB_BACKENDS_FILE
|
|
35
48
|
? resolve(env.CLAUDEX_WEB_BACKENDS_FILE)
|
|
36
49
|
: join(configDir, "backends.json"),
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { createMaintenanceHandler } from "./maintenance.mjs";
|
|
2
|
+
import { serveFile } from "../file-content.mjs";
|
|
3
|
+
import {
|
|
4
|
+
createSummaryTranslationHandler,
|
|
5
|
+
createTranslationSettingsHandler,
|
|
6
|
+
} from "../summary-translation.mjs";
|
|
7
|
+
|
|
8
|
+
export function createBusinessHttpHandler({ translation, maintenance }) {
|
|
9
|
+
const handleMaintenance = createMaintenanceHandler(maintenance);
|
|
10
|
+
const translate = createSummaryTranslationHandler(translation.translate);
|
|
11
|
+
const translationSettings = createTranslationSettingsHandler(translation);
|
|
12
|
+
return (request, response, path) => {
|
|
13
|
+
if (path === "/api/files" || path === "/api/media")
|
|
14
|
+
return serveFile(request, response);
|
|
15
|
+
if (path === "/api/translation")
|
|
16
|
+
return translationSettings(request, response);
|
|
17
|
+
if (path === "/api/translate") return translate(request, response);
|
|
18
|
+
if (/^\/api\/maintenance(?:\/|$)/.test(path))
|
|
19
|
+
return handleMaintenance(request, response, path);
|
|
20
|
+
};
|
|
21
|
+
}
|
|
@@ -1,10 +1,4 @@
|
|
|
1
|
-
import { createMaintenanceHandler } from "./maintenance.mjs";
|
|
2
1
|
import { X509Certificate } from "node:crypto";
|
|
3
|
-
import {
|
|
4
|
-
createSummaryTranslationHandler,
|
|
5
|
-
createTranslationSettingsHandler,
|
|
6
|
-
} from "../summary-translation.mjs";
|
|
7
|
-
import { serveFile } from "../file-content.mjs";
|
|
8
2
|
import { createStaticHandler } from "./static.mjs";
|
|
9
3
|
export function createHttpHandler({
|
|
10
4
|
config,
|
|
@@ -12,15 +6,10 @@ export function createHttpHandler({
|
|
|
12
6
|
authentication,
|
|
13
7
|
version,
|
|
14
8
|
isReady,
|
|
15
|
-
|
|
16
|
-
|
|
9
|
+
handleBusiness,
|
|
10
|
+
handleP2p,
|
|
17
11
|
}) {
|
|
18
|
-
const handleMaintenance = createMaintenanceHandler(maintenance);
|
|
19
12
|
const publicCertificate = new X509Certificate(tls.cert);
|
|
20
|
-
const translateSummary = createSummaryTranslationHandler(
|
|
21
|
-
translation.translate,
|
|
22
|
-
);
|
|
23
|
-
const translationSettings = createTranslationSettingsHandler(translation);
|
|
24
13
|
const serveStatic = createStaticHandler(config.staticDir);
|
|
25
14
|
return async function handleHttp(request, response) {
|
|
26
15
|
const ready = isReady();
|
|
@@ -63,25 +52,23 @@ export function createHttpHandler({
|
|
|
63
52
|
return;
|
|
64
53
|
}
|
|
65
54
|
if (await authentication.handle(request, response, path)) return;
|
|
55
|
+
const p2p = /^\/api\/p2p(?:\/|$)/.test(path);
|
|
56
|
+
if (p2p && authentication.maintenance(request)) {
|
|
57
|
+
await handleP2p(request, response, path);
|
|
58
|
+
return;
|
|
59
|
+
}
|
|
66
60
|
if (
|
|
67
61
|
path.startsWith("/api/") &&
|
|
68
62
|
!authentication.authorize(request, response)
|
|
69
63
|
)
|
|
70
64
|
return;
|
|
71
|
-
if (
|
|
72
|
-
await
|
|
73
|
-
return;
|
|
74
|
-
}
|
|
75
|
-
if (["/api/files", "/api/media"].includes(path)) {
|
|
76
|
-
await serveFile(request, response);
|
|
77
|
-
return;
|
|
78
|
-
}
|
|
79
|
-
if (path === "/api/translation") {
|
|
80
|
-
await translationSettings(request, response);
|
|
65
|
+
if (p2p) {
|
|
66
|
+
await handleP2p(request, response, path);
|
|
81
67
|
return;
|
|
82
68
|
}
|
|
83
|
-
|
|
84
|
-
|
|
69
|
+
const business = handleBusiness(request, response, path);
|
|
70
|
+
if (business) {
|
|
71
|
+
await business;
|
|
85
72
|
return;
|
|
86
73
|
}
|
|
87
74
|
if (path === "/healthz") {
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
import { once } from "node:events";
|
|
2
|
+
import { createServer } from "node:http";
|
|
3
|
+
import { createStaticHandler } from "../http/static.mjs";
|
|
4
|
+
|
|
5
|
+
export function fail(message, status) {
|
|
6
|
+
return new Error(message, { cause: status });
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
function json(response, status, body) {
|
|
10
|
+
if (response.destroyed) return;
|
|
11
|
+
response.writeHead(status, {
|
|
12
|
+
"Cache-Control": "no-store",
|
|
13
|
+
"Content-Type": "application/json; charset=utf-8",
|
|
14
|
+
});
|
|
15
|
+
response.end(JSON.stringify(body));
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
async function readObject(request, limit) {
|
|
19
|
+
if (!/^application\/json(?:;|$)/i.test(request.headers["content-type"] || ""))
|
|
20
|
+
throw fail("请使用 JSON 提交请求", 415);
|
|
21
|
+
let length = 0;
|
|
22
|
+
const chunks = [];
|
|
23
|
+
for await (const chunk of request.iterator({ destroyOnReturn: false })) {
|
|
24
|
+
length += chunk.length;
|
|
25
|
+
if (length > limit) throw fail("请求内容过长", 413);
|
|
26
|
+
chunks.push(chunk);
|
|
27
|
+
}
|
|
28
|
+
try {
|
|
29
|
+
const value = JSON.parse(Buffer.concat(chunks).toString("utf8"));
|
|
30
|
+
if (value && typeof value === "object" && !Array.isArray(value))
|
|
31
|
+
return value;
|
|
32
|
+
} catch {
|
|
33
|
+
// JSON 解析失败与请求形状错误使用同一响应。
|
|
34
|
+
}
|
|
35
|
+
throw fail("请求内容格式错误", 400);
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
const actions = new Map([
|
|
39
|
+
["/api/p2p", "status"],
|
|
40
|
+
["/api/p2p/enable", "enable"],
|
|
41
|
+
["/api/p2p/disable", "disable"],
|
|
42
|
+
["/api/p2p/create", "create"],
|
|
43
|
+
["/api/p2p/revoke", "revoke"],
|
|
44
|
+
]);
|
|
45
|
+
|
|
46
|
+
export function createP2pManagementHandler(service) {
|
|
47
|
+
return async (request, response, path) => {
|
|
48
|
+
try {
|
|
49
|
+
const action = actions.get(path);
|
|
50
|
+
if (!action) throw fail("P2P 操作不存在", 404);
|
|
51
|
+
if (request.method !== (action === "status" ? "GET" : "POST"))
|
|
52
|
+
throw fail("P2P 请求方法无效", 405);
|
|
53
|
+
const input =
|
|
54
|
+
action === "create" || action === "revoke"
|
|
55
|
+
? await readObject(request, 2048)
|
|
56
|
+
: undefined;
|
|
57
|
+
json(response, 200, await service.manage(action, input));
|
|
58
|
+
} catch (error) {
|
|
59
|
+
json(response, Number.isInteger(error.cause) ? error.cause : 500, {
|
|
60
|
+
error: Number.isInteger(error.cause)
|
|
61
|
+
? error.message
|
|
62
|
+
: "P2P 设置更新失败",
|
|
63
|
+
});
|
|
64
|
+
}
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
export async function openSignalingServer({
|
|
69
|
+
assetsDirectory,
|
|
70
|
+
getOrigin,
|
|
71
|
+
negotiate,
|
|
72
|
+
}) {
|
|
73
|
+
const serveStatic = createStaticHandler(assetsDirectory);
|
|
74
|
+
let requests = 0;
|
|
75
|
+
|
|
76
|
+
async function handle(request, response) {
|
|
77
|
+
const origin = getOrigin();
|
|
78
|
+
if (!origin || request.headers.host !== new URL(origin).host)
|
|
79
|
+
return json(response, 421, { error: "P2P 地址不可用" });
|
|
80
|
+
response.setHeader("X-Content-Type-Options", "nosniff");
|
|
81
|
+
response.setHeader("Referrer-Policy", "no-referrer");
|
|
82
|
+
response.setHeader(
|
|
83
|
+
"Content-Security-Policy",
|
|
84
|
+
"script-src 'self' 'wasm-unsafe-eval'; frame-src 'self'; frame-ancestors 'none'; base-uri 'none'; object-src 'self' blob:; form-action 'none'; upgrade-insecure-requests",
|
|
85
|
+
);
|
|
86
|
+
const path = request.url?.split("?", 1)[0];
|
|
87
|
+
if (request.method === "GET" || request.method === "HEAD") {
|
|
88
|
+
if (path === "/p2p") return serveStatic(request, response, "/");
|
|
89
|
+
if (path !== "/" && /^\/[\w.-]+\.(js|css|ico|png)$/.test(path || ""))
|
|
90
|
+
return serveStatic(request, response, path);
|
|
91
|
+
}
|
|
92
|
+
if (request.method !== "POST" || path !== "/p2p/offer")
|
|
93
|
+
return json(response, 404, { error: "资源不存在" });
|
|
94
|
+
if (
|
|
95
|
+
request.headers.origin !== origin ||
|
|
96
|
+
request.headers["sec-fetch-site"] === "cross-site"
|
|
97
|
+
)
|
|
98
|
+
return json(response, 403, { error: "P2P 信令请求来源无效" });
|
|
99
|
+
if (requests >= 24)
|
|
100
|
+
return json(response, 429, { error: "P2P 信令繁忙,请稍后重试" });
|
|
101
|
+
requests++;
|
|
102
|
+
const abort = new AbortController();
|
|
103
|
+
response.once("close", () => {
|
|
104
|
+
if (!response.writableFinished) abort.abort();
|
|
105
|
+
});
|
|
106
|
+
try {
|
|
107
|
+
const input = await readObject(request, 65536);
|
|
108
|
+
json(response, 200, await negotiate(input, abort.signal));
|
|
109
|
+
} finally {
|
|
110
|
+
requests--;
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
const server = createServer(
|
|
115
|
+
{
|
|
116
|
+
requestTimeout: 15000,
|
|
117
|
+
headersTimeout: 8000,
|
|
118
|
+
connectionsCheckingInterval: 2000,
|
|
119
|
+
},
|
|
120
|
+
(request, response) => {
|
|
121
|
+
handle(request, response).catch((error) => {
|
|
122
|
+
if (response.headersSent) return response.destroy();
|
|
123
|
+
response.setHeader("Connection", "close");
|
|
124
|
+
json(response, Number.isInteger(error.cause) ? error.cause : 500, {
|
|
125
|
+
error: Number.isInteger(error.cause)
|
|
126
|
+
? error.message
|
|
127
|
+
: "P2P 信令处理失败",
|
|
128
|
+
});
|
|
129
|
+
});
|
|
130
|
+
},
|
|
131
|
+
);
|
|
132
|
+
server.setTimeout(15000);
|
|
133
|
+
server.listen(0, "127.0.0.1");
|
|
134
|
+
await once(server, "listening");
|
|
135
|
+
return server;
|
|
136
|
+
}
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
import { fail } from "./http.mjs";
|
|
3
|
+
|
|
4
|
+
function directOffer(sdp) {
|
|
5
|
+
if (typeof sdp !== "string" || sdp.includes("\0")) return false;
|
|
6
|
+
const media = sdp.match(/^m=.*$/gm) || [];
|
|
7
|
+
const candidates = sdp.match(/^a=candidate:.*$/gm) || [];
|
|
8
|
+
return (
|
|
9
|
+
media.length === 1 &&
|
|
10
|
+
/^m=application \d+ UDP\/DTLS\/SCTP webrtc-datachannel\s*$/.test(
|
|
11
|
+
media[0],
|
|
12
|
+
) &&
|
|
13
|
+
candidates.length <= 64 &&
|
|
14
|
+
!candidates.some((candidate) => /\s+typ\s+relay(?:\s|$)/i.test(candidate))
|
|
15
|
+
);
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
export function createPeerRegistry(PeerConnection, connectPeer) {
|
|
19
|
+
const peers = new Set();
|
|
20
|
+
|
|
21
|
+
async function offer(link, sdp, signal) {
|
|
22
|
+
if (!directOffer(sdp)) throw fail("无效的 WebRTC 直连请求", 400);
|
|
23
|
+
if (
|
|
24
|
+
peers.size >= 32 ||
|
|
25
|
+
[...peers].filter((peer) => peer.link === link).length >= 8
|
|
26
|
+
)
|
|
27
|
+
throw fail("P2P 连接数已达上限,请关闭闲置页面后重试", 429);
|
|
28
|
+
signal.throwIfAborted();
|
|
29
|
+
const rtc = new PeerConnection(`claudex-${randomUUID()}`, {
|
|
30
|
+
iceServers: ["stun:stun.l.google.com:19302"],
|
|
31
|
+
disableAutoNegotiation: true,
|
|
32
|
+
maxMessageSize: 16 * 1024,
|
|
33
|
+
});
|
|
34
|
+
let channel;
|
|
35
|
+
let detach;
|
|
36
|
+
let deadline;
|
|
37
|
+
let stopWaiting;
|
|
38
|
+
let dropDeadline;
|
|
39
|
+
const peer = { link, dispose };
|
|
40
|
+
peers.add(peer);
|
|
41
|
+
|
|
42
|
+
function dispose() {
|
|
43
|
+
if (!peers.delete(peer)) return;
|
|
44
|
+
clearTimeout(deadline);
|
|
45
|
+
clearTimeout(dropDeadline);
|
|
46
|
+
stopWaiting?.(fail("这次 P2P 连接已关闭", 409));
|
|
47
|
+
detach?.();
|
|
48
|
+
channel?.close();
|
|
49
|
+
rtc.close();
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
function open() {
|
|
53
|
+
if (!peers.has(peer) || detach) return;
|
|
54
|
+
clearTimeout(deadline);
|
|
55
|
+
try {
|
|
56
|
+
detach = connectPeer(channel, link);
|
|
57
|
+
} catch {
|
|
58
|
+
dispose();
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
const onAborted = () => dispose();
|
|
63
|
+
signal.addEventListener("abort", onAborted, { once: true });
|
|
64
|
+
try {
|
|
65
|
+
deadline = setTimeout(dispose, 30000);
|
|
66
|
+
deadline.unref();
|
|
67
|
+
rtc.onStateChange((state) => {
|
|
68
|
+
clearTimeout(dropDeadline);
|
|
69
|
+
if (!peers.has(peer)) return;
|
|
70
|
+
if (state === "failed" || state === "closed") dispose();
|
|
71
|
+
if (state === "disconnected") {
|
|
72
|
+
dropDeadline = setTimeout(dispose, 15000);
|
|
73
|
+
dropDeadline.unref();
|
|
74
|
+
}
|
|
75
|
+
});
|
|
76
|
+
rtc.onDataChannel((incoming) => {
|
|
77
|
+
if (!peers.has(peer) || channel || incoming.getLabel() !== "claudex") {
|
|
78
|
+
incoming.close();
|
|
79
|
+
return;
|
|
80
|
+
}
|
|
81
|
+
channel = incoming;
|
|
82
|
+
channel.onClosed(dispose);
|
|
83
|
+
channel.onError(dispose);
|
|
84
|
+
channel.onOpen(open);
|
|
85
|
+
if (channel.isOpen()) open();
|
|
86
|
+
});
|
|
87
|
+
const answer = await new Promise((resolve, reject) => {
|
|
88
|
+
const finish = () => {
|
|
89
|
+
try {
|
|
90
|
+
const result = rtc.localDescription();
|
|
91
|
+
if (!result?.sdp || result.type !== "answer")
|
|
92
|
+
throw fail("暂时无法收集直连地址,请重试", 503);
|
|
93
|
+
resolve({ sdp: result.sdp });
|
|
94
|
+
} catch (error) {
|
|
95
|
+
reject(error);
|
|
96
|
+
}
|
|
97
|
+
};
|
|
98
|
+
const timer = setTimeout(() => stopWaiting?.(), 8000);
|
|
99
|
+
timer.unref();
|
|
100
|
+
stopWaiting = (error) => {
|
|
101
|
+
clearTimeout(timer);
|
|
102
|
+
stopWaiting = undefined;
|
|
103
|
+
if (error) reject(error);
|
|
104
|
+
else finish();
|
|
105
|
+
};
|
|
106
|
+
try {
|
|
107
|
+
rtc.onGatheringStateChange((state) => {
|
|
108
|
+
if (state === "complete") stopWaiting?.();
|
|
109
|
+
});
|
|
110
|
+
rtc.setRemoteDescription(sdp, "offer");
|
|
111
|
+
rtc.setLocalDescription("answer");
|
|
112
|
+
} catch {
|
|
113
|
+
stopWaiting?.(fail("WebRTC 信令格式无效", 400));
|
|
114
|
+
}
|
|
115
|
+
});
|
|
116
|
+
if (!peers.has(peer)) throw fail("这次 P2P 连接已关闭", 409);
|
|
117
|
+
return answer;
|
|
118
|
+
} catch (error) {
|
|
119
|
+
dispose();
|
|
120
|
+
throw error;
|
|
121
|
+
} finally {
|
|
122
|
+
signal.removeEventListener("abort", onAborted);
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
return {
|
|
127
|
+
offer,
|
|
128
|
+
close(link) {
|
|
129
|
+
for (const peer of peers) if (!link || peer.link === link) peer.dispose();
|
|
130
|
+
},
|
|
131
|
+
};
|
|
132
|
+
}
|