@feng3d/cts 0.0.6

package/dist/handlers/unified-proxy.js

@@ -0,0 +1,475 @@
+/**
+ * @module unified-proxy
+ * @description 统一代理处理器模块，在指定端口上同时支持 HTTP 和 WebSocket 代理。
+ * 将外部 HTTP/WebSocket 请求转发给穿透客户端，实现双向数据转发。
+ */
+import { Server as HttpServer } from 'http';
+import { WebSocket, WebSocketServer } from 'ws';
+import { v4 as uuidv4 } from 'uuid';
+import { MessageType, createMessage, logger } from '@feng3d/chuantou-shared';
+/**
+ * 统一代理处理器
+ *
+ * 管理多个代理服务器实例，每个代理监听一个独立端口，
+ * 同时支持 HTTP 请求和 WebSocket 升级请求。
+ * 当外部请求到达代理端口时，将请求信息通过控制通道转发给对应的穿透客户端。
+ */
+export class UnifiedProxyHandler {
+    /**
+     * 创建统一代理处理器实例
+     *
+     * @param sessionManager - 会话管理器，用于获取客户端连接和管理连接记录
+     */
+    constructor(sessionManager) {
+        /**
+         * 待处理响应映射表
+         *
+         * 存储等待客户端响应的 Promise 回调和超时定时器，键为连接 ID。
+         */
+        this.pendingResponses = new Map();
+        /**
+         * 用户 WebSocket 连接映射表
+         *
+         * 存储外部用户的 WebSocket 连接，键为连接 ID，值为用户的 WebSocket 实例。
+         */
+        this.userConnections = new Map();
+        /**
+         * 流式 HTTP 响应映射表
+         *
+         * 存储正在进行的流式响应（如 SSE）的响应对象。
+         */
+        this.streamingResponses = new Map();
+        this.sessionManager = sessionManager;
+        this.proxies = new Map();
+        this.wsServers = new Map();
+    }
+    /**
+     * 启动代理服务器
+     *
+     * 在指定端口创建并启动一个 HTTP 服务器，该端口同时支持 HTTP 请求和 WebSocket 升级。
+     * 若该端口已存在代理或端口被占用，将抛出异常。
+     *
+     * @param port - 代理监听的端口号
+     * @param clientId - 绑定的客户端唯一标识 ID
+     * @returns 代理服务器启动完成的 Promise
+     * @throws 端口已存在代理或端口被占用时抛出错误
+     */
+    async startProxy(port, clientId) {
+        if (this.proxies.has(port)) {
+            throw new Error(`端口 ${port} 的代理已存在`);
+        }
+        const server = new HttpServer();
+        // 处理 HTTP 请求
+        server.on('request', async (req, res) => {
+            await this.handleHttpRequest(clientId, req, res);
+        });
+        // 处理 WebSocket 升级请求
+        server.on('upgrade', async (req, socket, head) => {
+            await this.handleWebSocketUpgrade(clientId, req, socket, head);
+        });
+        server.on('error', (error) => {
+            logger.error(`代理在端口 ${port} 上发生错误:`, error);
+        });
+        return new Promise((resolve, reject) => {
+            server.listen(port, () => {
+                logger.log(`代理正在端口 ${port} 上监听（HTTP + WebSocket），绑定客户端 ${clientId}`);
+                this.proxies.set(port, server);
+                resolve();
+            });
+            server.on('error', (error) => {
+                if (error.code === 'EADDRINUSE') {
+                    reject(new Error(`端口 ${port} 已被占用`));
+                }
+                else {
+                    reject(error);
+                }
+            });
+        });
+    }
+    /**
+     * 处理外部 HTTP 请求
+     *
+     * 将外部 HTTP 请求封装为消息发送给穿透客户端，等待客户端处理后返回响应。
+     * 支持流式响应（如 SSE）和普通 HTTP 响应。
+     *
+     * @param clientId - 处理该请求的客户端唯一标识 ID
+     * @param req - 收到的 HTTP 请求对象
+     * @param res - 用于发送响应的 HTTP 响应对象
+     */
+    async handleHttpRequest(clientId, req, res) {
+        const connectionId = uuidv4();
+        const clientSocket = this.sessionManager.getClientSocket(clientId);
+        if (!clientSocket || clientSocket.readyState !== WebSocket.OPEN) {
+            res.writeHead(502, { 'Content-Type': 'text/plain; charset=utf-8' });
+            res.end('网关错误：客户端未连接');
+            return;
+        }
+        // 记录连接
+        this.sessionManager.addConnection(clientId, connectionId, req.socket.remoteAddress || '', 'http');
+        logger.log(`HTTP 请求: ${req.method} ${req.url} -> 客户端 ${clientId} (${connectionId})`);
+        try {
+            // 构建请求头
+            const headers = {};
+            for (const [key, value] of Object.entries(req.headers)) {
+                if (value !== undefined) {
+                    headers[key] = Array.isArray(value) ? value.join(', ') : value;
+                }
+            }
+            // 读取请求体
+            let body;
+            if (req.method !== 'GET' && req.method !== 'HEAD') {
+                body = await this.readRequestBody(req);
+            }
+            // 发送新连接消息给客户端
+            const newConnMsg = createMessage(MessageType.NEW_CONNECTION, {
+                connectionId,
+                protocol: 'http',
+                method: req.method,
+                url: req.url || '/',
+                headers,
+                body: body?.toString('base64'),
+            });
+            clientSocket.send(JSON.stringify(newConnMsg));
+            // 等待客户端响应头（第一个消息）
+            const firstResponse = await this.waitForResponse(connectionId, clientId);
+            // 检查是否为流式响应（仅根据 Content-Type 判断）
+            const contentType = String(firstResponse.headers['content-type'] || '').toLowerCase();
+            const isStreaming = contentType.includes('text/event-stream') ||
+                contentType.includes('stream');
+            if (isStreaming) {
+                // 流式响应模式（SSE）
+                logger.log(`HTTP 流式响应: ${req.url} (${connectionId})`);
+                this.streamingResponses.set(connectionId, res);
+                // 发送响应头
+                res.writeHead(firstResponse.statusCode, firstResponse.headers);
+                res.flushHeaders();
+                // 如果有初始 body，先发送
+                if (firstResponse.body) {
+                    const bodyBuffer = Buffer.isBuffer(firstResponse.body)
+                        ? firstResponse.body
+                        : Buffer.from(firstResponse.body, 'base64');
+                    res.write(bodyBuffer);
+                }
+                // 等待流结束，不清理连接（由流结束事件处理）
+                this.pendingResponses.delete(connectionId);
+            }
+            else {
+                // 普通 HTTP 响应模式
+                res.writeHead(firstResponse.statusCode, firstResponse.headers);
+                if (firstResponse.body) {
+                    const bodyBuffer = Buffer.isBuffer(firstResponse.body)
+                        ? firstResponse.body
+                        : Buffer.from(firstResponse.body, 'base64');
+                    res.end(bodyBuffer);
+                }
+                else {
+                    res.end();
+                }
+                logger.log(`HTTP 响应: ${firstResponse.statusCode}，连接 ${connectionId}`);
+                // 清理连接
+                this.sessionManager.removeConnection(connectionId);
+                this.pendingResponses.delete(connectionId);
+            }
+        }
+        catch (error) {
+            logger.error(`处理 HTTP 请求 ${connectionId} 时出错:`, error);
+            if (!res.headersSent) {
+                res.writeHead(500, { 'Content-Type': 'text/plain; charset=utf-8' });
+                res.end('服务器内部错误');
+            }
+            // 清理连接
+            this.sessionManager.removeConnection(connectionId);
+            this.pendingResponses.delete(connectionId);
+            this.streamingResponses.delete(connectionId);
+        }
+    }
+    /**
+     * 处理 WebSocket 升级请求
+     *
+     * 将外部 WebSocket 连接桥接到穿透客户端，实现双向实时数据转发。
+     *
+     * @param clientId - 处理该连接的客户端唯一标识 ID
+     * @param req - HTTP 升级请求对象
+     * @param socket - 底层 socket 连接
+     * @param head - 升级请求的头部 buffer
+     */
+    async handleWebSocketUpgrade(clientId, req, socket, head) {
+        const connectionId = uuidv4();
+        const clientSocket = this.sessionManager.getClientSocket(clientId);
+        if (!clientSocket || clientSocket.readyState !== WebSocket.OPEN) {
+            socket.write('HTTP/1.1 502 Bad Gateway\r\n\r\n');
+            socket.destroy();
+            return;
+        }
+        // 记录连接
+        this.sessionManager.addConnection(clientId, connectionId, req.socket.remoteAddress || '', 'websocket');
+        logger.log(`WebSocket 升级: ${req.url} -> 客户端 ${clientId} (${connectionId})`);
+        // 构建 WebSocket 服务器处理此连接
+        const wsServer = new WebSocketServer({ noServer: true });
+        wsServer.handleUpgrade(req, socket, head, (ws) => {
+            this.handleWebSocketConnection(clientId, connectionId, ws, req);
+        });
+    }
+    /**
+     * 处理 WebSocket 连接
+     *
+     * 当外部用户连接到代理端口时，记录连接信息，通知穿透客户端有新连接到来，
+     * 并设置消息转发、关闭和错误的事件处理。
+     *
+     * @param clientId - 处理该连接的客户端唯一标识 ID
+     * @param connectionId - 连接唯一标识 ID
+     * @param userWs - 外部用户的 WebSocket 连接
+     * @param req - HTTP 升级请求对象
+     */
+    handleWebSocketConnection(clientId, connectionId, userWs, req) {
+        const clientSocket = this.sessionManager.getClientSocket(clientId);
+        if (!clientSocket || clientSocket.readyState !== WebSocket.OPEN) {
+            userWs.close(1011, '客户端未连接');
+            return;
+        }
+        logger.log(`WebSocket 连接已建立: ${req.url} (${connectionId})`);
+        // 存储用户 WebSocket 引用
+        this.userConnections.set(connectionId, userWs);
+        // 构建请求头
+        const headers = {};
+        for (const [key, value] of Object.entries(req.headers)) {
+            if (value !== undefined) {
+                headers[key] = Array.isArray(value) ? value.join(', ') : value;
+            }
+        }
+        // 发送新连接消息给客户端
+        const newConnMsg = createMessage(MessageType.NEW_CONNECTION, {
+            connectionId,
+            protocol: 'websocket',
+            url: req.url || '/',
+            wsHeaders: headers,
+        });
+        clientSocket.send(JSON.stringify(newConnMsg));
+        // 处理来自用户的消息
+        userWs.on('message', (data) => {
+            this.forwardToClient(clientId, connectionId, data);
+        });
+        // 处理来自用户关闭
+        userWs.on('close', (code, reason) => {
+            logger.log(`用户 WebSocket 已关闭: ${connectionId} (${code})`);
+            this.notifyClientClose(clientId, connectionId, code);
+            this.cleanupConnection(connectionId);
+        });
+        // 处理错误
+        userWs.on('error', (error) => {
+            logger.error(`用户 WebSocket 错误 ${connectionId}:`, error);
+            this.cleanupConnection(connectionId);
+        });
+    }
+    /**
+     * 将用户消息转发到穿透客户端
+     *
+     * 将外部用户发送的 WebSocket 数据编码为 Base64 后，通过控制通道发送给穿透客户端。
+     *
+     * @param clientId - 目标客户端唯一标识 ID
+     * @param connectionId - 连接唯一标识 ID
+     * @param data - 用户发送的原始数据
+     */
+    forwardToClient(clientId, connectionId, data) {
+        const clientSocket = this.sessionManager.getClientSocket(clientId);
+        if (clientSocket && clientSocket.readyState === WebSocket.OPEN) {
+            clientSocket.send(JSON.stringify({
+                type: 'connection_data',
+                connectionId,
+                data: data.toString('base64'),
+            }));
+        }
+    }
+    /**
+     * 通知穿透客户端连接已关闭
+     *
+     * 当外部用户的 WebSocket 连接关闭时，向穿透客户端发送连接关闭通知消息。
+     *
+     * @param clientId - 目标客户端唯一标识 ID
+     * @param connectionId - 已关闭的连接唯一标识 ID
+     * @param code - WebSocket 关闭状态码
+     */
+    notifyClientClose(clientId, connectionId, code) {
+        const clientSocket = this.sessionManager.getClientSocket(clientId);
+        if (clientSocket && clientSocket.readyState === WebSocket.OPEN) {
+            const closeMsg = createMessage(MessageType.CONNECTION_CLOSE, {
+                connectionId,
+            });
+            clientSocket.send(JSON.stringify(closeMsg));
+        }
+    }
+    /**
+     * 等待客户端响应
+     *
+     * 创建一个 Promise，等待穿透客户端处理完请求并返回响应数据。
+     * 若超过 30 秒未收到响应，将自动超时并拒绝 Promise。
+     *
+     * @param connectionId - 连接唯一标识 ID
+     * @param clientId - 客户端唯一标识 ID
+     * @returns 客户端返回的 HTTP 响应数据
+     */
+    waitForResponse(connectionId, clientId) {
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.pendingResponses.delete(connectionId);
+                reject(new Error('响应超时'));
+            }, 30000); // 30秒超时
+            this.pendingResponses.set(connectionId, { resolve, reject, timeout });
+        });
+    }
+    /**
+     * 读取 HTTP 请求体
+     *
+     * 从 IncomingMessage 流中读取完整的请求体数据。
+     *
+     * @param req - HTTP 请求对象
+     * @returns 包含完整请求体的 Buffer
+     */
+    readRequestBody(req) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            req.on('data', (chunk) => {
+                chunks.push(chunk);
+            });
+            req.on('end', () => {
+                resolve(Buffer.concat(chunks));
+            });
+            req.on('error', reject);
+        });
+    }
+    /**
+     * 处理穿透客户端返回的响应数据
+     *
+     * 接收客户端处理完请求后返回的 HTTP 响应数据，清除超时定时器并解析对应的待处理 Promise。
+     *
+     * @param connectionId - 连接唯一标识 ID
+     * @param data - 客户端返回的原始响应消息对象，包含 statusCode, headers, body 等字段
+     */
+    handleClientResponse(connectionId, data) {
+        const pending = this.pendingResponses.get(connectionId);
+        if (pending) {
+            clearTimeout(pending.timeout);
+            this.pendingResponses.delete(connectionId);
+            // 提取需要的响应字段
+            const responseData = {
+                statusCode: data.statusCode || 200,
+                headers: data.headers || {},
+                body: data.body,
+            };
+            pending.resolve(responseData);
+        }
+    }
+    /**
+     * 处理来自穿透客户端的数据
+     *
+     * 将穿透客户端发送的数据转发给对应的外部用户 WebSocket 连接。
+     *
+     * @param connectionId - 连接唯一标识 ID
+     * @param data - 穿透客户端发送的数据
+     */
+    handleClientData(connectionId, data) {
+        const userWs = this.userConnections.get(connectionId);
+        if (userWs && userWs.readyState === WebSocket.OPEN) {
+            userWs.send(data);
+        }
+    }
+    /**
+     * 处理来自穿透客户端的关闭请求
+     *
+     * 当穿透客户端请求关闭某个连接时，关闭对应的外部用户 WebSocket 连接并清理资源。
+     *
+     * @param connectionId - 需要关闭的连接唯一标识 ID
+     * @param code - 可选的 WebSocket 关闭状态码，默认为 1000（正常关闭）
+     */
+    handleClientClose(connectionId, code) {
+        const userWs = this.userConnections.get(connectionId);
+        if (userWs) {
+            userWs.close(code || 1000);
+        }
+        this.cleanupConnection(connectionId);
+    }
+    /**
+     * 清理连接资源
+     *
+     * 从用户连接映射表和会话管理器中移除指定连接的记录。
+     *
+     * @param connectionId - 需要清理的连接唯一标识 ID
+     */
+    cleanupConnection(connectionId) {
+        this.userConnections.delete(connectionId);
+        this.streamingResponses.delete(connectionId);
+        this.sessionManager.removeConnection(connectionId);
+    }
+    /**
+     * 处理来自客户端的流式响应数据
+     *
+     * 将客户端发送的流式数据（如 SSE 事件）转发给对应的外部 HTTP 连接。
+     *
+     * @param connectionId - 连接唯一标识 ID
+     * @param data - 客户端发送的流式数据
+     */
+    handleClientStreamData(connectionId, data) {
+        const res = this.streamingResponses.get(connectionId);
+        if (res && !res.writableEnded) {
+            res.write(data);
+        }
+    }
+    /**
+     * 处理来自客户端的流式响应结束通知
+     *
+     * 当客户端通知流式响应结束时，关闭外部 HTTP 连接并清理资源。
+     *
+     * @param connectionId - 连接唯一标识 ID
+     */
+    handleClientStreamEnd(connectionId) {
+        const res = this.streamingResponses.get(connectionId);
+        if (res && !res.writableEnded) {
+            res.end();
+        }
+        logger.log(`流式响应结束: ${connectionId}`);
+        this.cleanupConnection(connectionId);
+    }
+    /**
+     * 停止指定端口的代理服务器
+     *
+     * 关闭指定端口上的代理服务器并从映射表中移除。
+     *
+     * @param port - 需要停止的代理端口号
+     * @returns 代理服务器关闭完成的 Promise
+     */
+    async stopProxy(port) {
+        const server = this.proxies.get(port);
+        if (server) {
+            return new Promise((resolve) => {
+                server.close(() => {
+                    logger.log(`代理已在端口 ${port} 上停止`);
+                    this.proxies.delete(port);
+                    resolve();
+                });
+            });
+        }
+    }
+    /**
+     * 停止所有代理服务器
+     *
+     * 并行关闭所有已启动的代理服务器。
+     *
+     * @returns 所有代理服务器关闭完成的 Promise
+     */
+    async stopAll() {
+        const stopPromises = [];
+        for (const [port] of this.proxies) {
+            stopPromises.push(this.stopProxy(port));
+        }
+        await Promise.all(stopPromises);
+    }
+    /**
+     * 获取所有活跃代理的端口列表
+     *
+     * @returns 当前正在运行的所有代理端口号数组
+     */
+    getActivePorts() {
+        return Array.from(this.proxies.keys());
+    }
+}
+//# sourceMappingURL=unified-proxy.js.map

package/dist/handlers/unified-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-proxy.js","sourceRoot":"","sources":["../../src/handlers/unified-proxy.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @module index
+ * @description 穿透服务端公共 API 入口模块。
+ * 提供便捷的 start、status、stop 函数，以及核心类和类型的导出。
+ * 外部使用者可直接通过此模块快速启动、查询和停止转发服务器。
+ */
+import { ServerConfig } from '@feng3d/chuantou-shared';
+import { ForwardServer, ServerStatus } from './server.js';
+export { ForwardServer } from './server.js';
+export type { ServerStatus } from './server.js';
+export { SessionManager } from './session-manager.js';
+export type { ServerConfig } from '@feng3d/chuantou-shared';
+/**
+ * 启动转发服务器
+ *
+ * 创建一个 {@link ForwardServer} 实例并启动，是最常用的快捷启动方式。
+ *
+ * @param options - 可选的服务器配置项，未提供的字段将使用默认值
+ * @returns 已启动的 {@link ForwardServer} 实例
+ */
+export declare function start(options?: Partial<ServerConfig>): Promise<ForwardServer>;
+/**
+ * 查询服务器状态
+ *
+ * 获取指定转发服务器的当前运行状态信息。
+ *
+ * @param server - 需要查询状态的 {@link ForwardServer} 实例
+ * @returns 包含服务器运行状态的 {@link ServerStatus} 对象
+ */
+export declare function status(server: ForwardServer): ServerStatus;
+/**
+ * 停止服务器
+ *
+ * 优雅地停止指定的转发服务器，释放所有资源。
+ *
+ * @param server - 需要停止的 {@link ForwardServer} 实例
+ * @returns 服务器完全停止后的 Promise
+ */
+export declare function stop(server: ForwardServer): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,OAAO,GAAE,OAAO,CAAC,YAAY,CAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAIvF;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,CAE1D;AAED;;;;;;;GAOG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D"}

package/dist/index.js

@@ -0,0 +1,45 @@
+/**
+ * @module index
+ * @description 穿透服务端公共 API 入口模块。
+ * 提供便捷的 start、status、stop 函数，以及核心类和类型的导出。
+ * 外部使用者可直接通过此模块快速启动、查询和停止转发服务器。
+ */
+import { ForwardServer } from './server.js';
+export { ForwardServer } from './server.js';
+export { SessionManager } from './session-manager.js';
+/**
+ * 启动转发服务器
+ *
+ * 创建一个 {@link ForwardServer} 实例并启动，是最常用的快捷启动方式。
+ *
+ * @param options - 可选的服务器配置项，未提供的字段将使用默认值
+ * @returns 已启动的 {@link ForwardServer} 实例
+ */
+export async function start(options = {}) {
+    const server = new ForwardServer(options);
+    await server.start();
+    return server;
+}
+/**
+ * 查询服务器状态
+ *
+ * 获取指定转发服务器的当前运行状态信息。
+ *
+ * @param server - 需要查询状态的 {@link ForwardServer} 实例
+ * @returns 包含服务器运行状态的 {@link ServerStatus} 对象
+ */
+export function status(server) {
+    return server.getStatus();
+}
+/**
+ * 停止服务器
+ *
+ * 优雅地停止指定的转发服务器，释放所有资源。
+ *
+ * @param server - 需要停止的 {@link ForwardServer} 实例
+ * @returns 服务器完全停止后的 Promise
+ */
+export async function stop(server) {
+    await server.stop();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAgB,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,UAAiC,EAAE;IAC7D,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,MAAqB;IAC1C,OAAO,MAAM,CAAC,SAAS,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,MAAqB;IAC9C,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC"}