@feng3d/cts 0.0.6

package/dist/cli.js

@@ -0,0 +1,377 @@
+#!/usr/bin/env node
+/**
+ * @module cli
+ * @description 穿透服务端命令行工具模块。
+ * 提供 `feng3d-cts` CLI 命令，支持通过命令行启动、停止和查询转发服务器状态。
+ * `start` 以后台守护进程方式运行服务器并注册开机自启动。
+ * 使用 PID 文件跟踪运行中的服务器实例，以实现跨进程的状态管理。
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { readFileSync, writeFileSync, mkdirSync, unlinkSync, openSync, closeSync } from 'fs';
+import { join } from 'path';
+import { homedir, platform } from 'os';
+import { request } from 'http';
+import { request as httpsRequest } from 'https';
+import { spawn, execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import { start, stop } from './index.js';
+import { registerBoot, unregisterBoot, isBootRegistered } from './boot.js';
+/** PID 文件存放目录路径 */
+const PID_DIR = join(homedir(), '.chuantou');
+/** PID 文件完整路径 */
+const PID_FILE = join(PID_DIR, 'server.pid');
+/** 日志文件路径 */
+const LOG_FILE = join(PID_DIR, 'server.log');
+/**
+ * 写入 PID 文件
+ *
+ * 将服务器进程信息写入 PID 文件，若目录不存在则自动创建。
+ *
+ * @param info - 需要写入的服务器进程信息
+ */
+function writePidFile(info) {
+    mkdirSync(PID_DIR, { recursive: true });
+    writeFileSync(PID_FILE, JSON.stringify(info, null, 2));
+}
+/**
+ * 读取 PID 文件
+ *
+ * 从磁盘读取并解析 PID 文件内容，获取运行中服务器的进程信息。
+ *
+ * @returns 解析后的 {@link PidInfo} 对象；若文件不存在或解析失败则返回 `null`
+ */
+function readPidFile() {
+    try {
+        const content = readFileSync(PID_FILE, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 删除 PID 文件
+ *
+ * 移除磁盘上的 PID 文件。若文件不存在则静默忽略。
+ */
+function removePidFile() {
+    try {
+        unlinkSync(PID_FILE);
+    }
+    catch {
+        // ignore
+    }
+}
+/**
+ * 发送 HTTP GET 请求
+ *
+ * 向指定地址发送 GET 请求并返回响应内容。支持 HTTP 和 HTTPS。
+ * 当 host 为 `0.0.0.0` 时自动替换为 `127.0.0.1`。
+ *
+ * @param host - 目标主机地址
+ * @param port - 目标端口号
+ * @param path - 请求路径
+ * @param tls - 是否使用 HTTPS
+ * @returns 响应体字符串内容
+ */
+function httpGet(host, port, path, tls) {
+    return new Promise((resolve, reject) => {
+        const doRequest = tls ? httpsRequest : request;
+        const req = doRequest({ hostname: host === '0.0.0.0' ? '127.0.0.1' : host, port, path, method: 'GET', timeout: 5000 }, (res) => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk; });
+            res.on('end', () => resolve(data));
+        });
+        req.on('error', reject);
+        req.on('timeout', () => { req.destroy(); reject(new Error('请求超时')); });
+        req.end();
+    });
+}
+/**
+ * 发送 HTTP POST 请求
+ *
+ * 向指定地址发送 POST 请求并返回响应内容。支持 HTTP 和 HTTPS。
+ * 当 host 为 `0.0.0.0` 时自动替换为 `127.0.0.1`。
+ *
+ * @param host - 目标主机地址
+ * @param port - 目标端口号
+ * @param path - 请求路径
+ * @param tls - 是否使用 HTTPS
+ * @returns 响应体字符串内容
+ */
+function httpPost(host, port, path, tls) {
+    return new Promise((resolve, reject) => {
+        const doRequest = tls ? httpsRequest : request;
+        const req = doRequest({ hostname: host === '0.0.0.0' ? '127.0.0.1' : host, port, path, method: 'POST', timeout: 5000 }, (res) => {
+            let data = '';
+            res.on('data', (chunk) => { data += chunk; });
+            res.on('end', () => resolve(data));
+        });
+        req.on('error', reject);
+        req.on('timeout', () => { req.destroy(); reject(new Error('请求超时')); });
+        req.end();
+    });
+}
+/**
+ * 等待服务器启动完成
+ *
+ * 通过轮询 HTTP 状态端点验证后台服务器是否成功启动。
+ *
+ * @param host - 服务器监听地址
+ * @param port - 控制端口
+ * @param tls - 是否使用 TLS
+ * @param timeoutMs - 最大等待时间（毫秒）
+ * @returns 是否成功启动
+ */
+async function waitForStartup(host, port, tls, timeoutMs) {
+    const startTime = Date.now();
+    const interval = 500;
+    while (Date.now() - startTime < timeoutMs) {
+        await new Promise((r) => setTimeout(r, interval));
+        try {
+            await httpGet(host, port, '/_chuantou/status', tls);
+            return true;
+        }
+        catch {
+            // 未就绪，继续重试
+        }
+    }
+    return false;
+}
+/**
+ * 在浏览器中打开 URL
+ *
+ * 根据操作系统使用相应的命令打开默认浏览器。
+ *
+ * @param url - 需要打开的 URL
+ */
+function openBrowser(url) {
+    const os = platform();
+    try {
+        if (os === 'win32') {
+            execSync(`cmd.exe /c start "" "${url}"`, { stdio: 'ignore' });
+        }
+        else if (os === 'darwin') {
+            execSync(`open "${url}"`, { stdio: 'ignore' });
+        }
+        else {
+            // Linux
+            execSync(`xdg-open "${url}"`, { stdio: 'ignore' });
+        }
+    }
+    catch {
+        // 忽略错误，浏览器打开失败不影响服务
+    }
+}
+/** 服务器选项的 CLI 选项定义，供 start 和 _serve 共用 */
+const serverOptions = [
+    ['-p, --port <port>', '控制端口', '9000'],
+    ['-a, --host <address>', '监听地址', '0.0.0.0'],
+    ['-t, --tokens <tokens>', '认证令牌（逗号分隔）'],
+    ['--tls-key <path>', 'TLS 私钥文件路径'],
+    ['--tls-cert <path>', 'TLS 证书文件路径'],
+    ['--heartbeat-interval <ms>', '心跳间隔（毫秒）', '30000'],
+    ['--session-timeout <ms>', '会话超时（毫秒）', '60000'],
+];
+const program = new Command();
+program
+    .name('feng3d-cts')
+    .description(chalk.blue('穿透 - 内网穿透服务端'))
+    .version('0.0.5');
+// ====== _serve 命令（隐藏，前台运行，供 start 和开机启动调用）======
+const serveCmd = program.command('_serve', { hidden: true }).description('前台运行服务器（内部命令）');
+for (const opt of serverOptions) {
+    if (opt.length === 3) {
+        serveCmd.option(opt[0], opt[1], opt[2]);
+    }
+    else {
+        serveCmd.option(opt[0], opt[1]);
+    }
+}
+serveCmd.action(async (options) => {
+    const tls = (options.tlsKey && options.tlsCert)
+        ? { key: readFileSync(options.tlsKey, 'utf-8'), cert: readFileSync(options.tlsCert, 'utf-8') }
+        : undefined;
+    const opts = {
+        host: options.host,
+        controlPort: parseInt(options.port, 10),
+        authTokens: options.tokens ? options.tokens.split(',') : [],
+        heartbeatInterval: parseInt(options.heartbeatInterval, 10),
+        sessionTimeout: parseInt(options.sessionTimeout, 10),
+        tls,
+    };
+    const server = await start(opts);
+    writePidFile({
+        pid: process.pid,
+        host: opts.host,
+        controlPort: opts.controlPort,
+        tls: tls !== undefined,
+    });
+    console.log(chalk.green('服务器启动成功'));
+    console.log(chalk.gray(`  主机: ${opts.host}`));
+    console.log(chalk.gray(`  端口: ${opts.controlPort}`));
+    console.log(chalk.gray(`  TLS: ${tls ? '已启用' : '已禁用'}`));
+    const shutdown = async () => {
+        console.log(chalk.yellow('\n正在关闭...'));
+        await stop(server);
+        removePidFile();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+});
+// ====== start 命令（后台守护进程 + 开机启动）======
+const startCmd = program.command('start').description('启动服务器（后台运行并注册开机自启动）');
+for (const opt of serverOptions) {
+    if (opt.length === 3) {
+        startCmd.option(opt[0], opt[1], opt[2]);
+    }
+    else {
+        startCmd.option(opt[0], opt[1]);
+    }
+}
+startCmd.option('--no-boot', '不注册开机自启动');
+startCmd.option('-o, --open', '启动后在浏览器中打开状态页面');
+startCmd.action(async (options) => {
+    // 1. 检测是否已在运行
+    const existing = readPidFile();
+    if (existing) {
+        try {
+            await httpGet(existing.host, existing.controlPort, '/_chuantou/status', existing.tls);
+            console.log(chalk.yellow('服务器已在运行中'));
+            console.log(chalk.gray(`  PID: ${existing.pid}`));
+            console.log(chalk.gray(`  端口: ${existing.controlPort}`));
+            return;
+        }
+        catch {
+            // PID 文件残留，清理后继续
+            removePidFile();
+        }
+    }
+    // 2. 确保数据目录存在
+    mkdirSync(PID_DIR, { recursive: true });
+    // 3. 解析路径
+    const scriptPath = fileURLToPath(import.meta.url);
+    const nodePath = process.execPath;
+    // 4. 构建 _serve 参数
+    const serveArgs = [];
+    serveArgs.push('--port', options.port);
+    serveArgs.push('--host', options.host);
+    if (options.tokens)
+        serveArgs.push('--tokens', options.tokens);
+    if (options.tlsKey)
+        serveArgs.push('--tls-key', options.tlsKey);
+    if (options.tlsCert)
+        serveArgs.push('--tls-cert', options.tlsCert);
+    serveArgs.push('--heartbeat-interval', options.heartbeatInterval);
+    serveArgs.push('--session-timeout', options.sessionTimeout);
+    // 5. 打开日志文件
+    const logFd = openSync(LOG_FILE, 'a');
+    // 6. 启动后台守护进程
+    const child = spawn(nodePath, [scriptPath, '_serve', ...serveArgs], {
+        detached: true,
+        stdio: ['ignore', logFd, logFd],
+    });
+    child.unref();
+    closeSync(logFd);
+    // 7. 等待服务器启动
+    const controlPort = parseInt(options.port, 10);
+    const host = options.host;
+    const tls = !!(options.tlsKey && options.tlsCert);
+    const started = await waitForStartup(host, controlPort, tls, 10000);
+    if (!started) {
+        console.log(chalk.red('服务器启动失败，请查看日志文件:'));
+        console.log(chalk.gray(`  ${LOG_FILE}`));
+        process.exit(1);
+    }
+    console.log(chalk.green('服务器已在后台启动'));
+    console.log(chalk.gray(`  PID: ${child.pid}`));
+    console.log(chalk.gray(`  主机: ${host}`));
+    console.log(chalk.gray(`  端口: ${controlPort}`));
+    console.log(chalk.gray(`  TLS: ${tls ? '已启用' : '已禁用'}`));
+    console.log(chalk.gray(`  日志: ${LOG_FILE}`));
+    // 8. 打开浏览器
+    if (options.open) {
+        const protocol = tls ? 'https' : 'http';
+        const url = host === '0.0.0.0'
+            ? `${protocol}://127.0.0.1:${controlPort}/`
+            : `${protocol}://${host}:${controlPort}/`;
+        openBrowser(url);
+    }
+    // 9. 注册开机启动
+    if (options.boot !== false) {
+        try {
+            registerBoot({
+                nodePath,
+                scriptPath,
+                args: serveArgs,
+            });
+            console.log(chalk.green('已注册开机自启动'));
+        }
+        catch (err) {
+            console.log(chalk.yellow(`注册开机自启动失败: ${err instanceof Error ? err.message : err}`));
+        }
+    }
+});
+// ====== status 命令 ======
+program
+    .command('status')
+    .description('查询服务器状态')
+    .action(async () => {
+    const pidInfo = readPidFile();
+    if (!pidInfo) {
+        console.log(chalk.red('未找到正在运行的服务器（PID 文件不存在）'));
+        process.exit(1);
+    }
+    try {
+        const data = await httpGet(pidInfo.host, pidInfo.controlPort, '/_chuantou/status', pidInfo.tls);
+        const status = JSON.parse(data);
+        console.log(chalk.blue.bold('穿透服务器状态'));
+        console.log(chalk.gray(`  运行中: ${status.running ? chalk.green('是') : chalk.red('否')}`));
+        console.log(chalk.gray(`  主机: ${status.host}:${status.controlPort}`));
+        console.log(chalk.gray(`  TLS: ${status.tls ? '已启用' : '已禁用'}`));
+        console.log(chalk.gray(`  运行时长: ${Math.floor(status.uptime / 1000)}秒`));
+        console.log(chalk.gray(`  客户端: ${status.authenticatedClients}`));
+        console.log(chalk.gray(`  端口: ${status.totalPorts}`));
+        console.log(chalk.gray(`  连接数: ${status.activeConnections}`));
+        console.log(chalk.gray(`  开机自启: ${isBootRegistered() ? chalk.green('已注册') : '未注册'}`));
+    }
+    catch {
+        console.log(chalk.red('无法连接到服务器，服务器可能未在运行。'));
+        removePidFile();
+        process.exit(1);
+    }
+});
+// ====== stop 命令 ======
+program
+    .command('stop')
+    .description('停止服务器并取消开机自启动')
+    .action(async () => {
+    const pidInfo = readPidFile();
+    if (!pidInfo) {
+        console.log(chalk.red('未找到正在运行的服务器（PID 文件不存在）'));
+        process.exit(1);
+    }
+    try {
+        await httpPost(pidInfo.host, pidInfo.controlPort, '/_chuantou/stop', pidInfo.tls);
+        removePidFile();
+        console.log(chalk.green('服务器已停止'));
+    }
+    catch {
+        console.log(chalk.red('无法连接到服务器，服务器可能未在运行。'));
+        removePidFile();
+    }
+    // 取消开机启动
+    try {
+        if (isBootRegistered()) {
+            unregisterBoot();
+            console.log(chalk.green('已取消开机自启动'));
+        }
+    }
+    catch (err) {
+        console.log(chalk.yellow(`取消开机自启动失败: ${err instanceof Error ? err.message : err}`));
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/handlers/control-handler.d.ts

@@ -0,0 +1,158 @@
+/**
+ * @module control-handler
+ * @description 控制通道处理器模块，负责处理客户端通过 WebSocket 控制通道发送的各类控制消息。
+ * 包括认证、端口注册/注销、心跳以及断开连接等消息的处理逻辑。
+ */
+import { WebSocket } from 'ws';
+import { ServerConfig } from '@feng3d/chuantou-shared';
+import { SessionManager } from '../session-manager.js';
+import { UnifiedProxyHandler } from './unified-proxy.js';
+/**
+ * 控制通道处理器
+ *
+ * 处理客户端通过 WebSocket 控制通道发送的各类控制消息，包括：
+ * - 客户端认证（AUTH）
+ * - 端口注册（REGISTER）与注销（UNREGISTER）
+ * - 心跳保活（HEARTBEAT）
+ * - 连接断开的清理工作
+ */
+export declare class ControlHandler {
+    /** 会话管理器实例 */
+    private sessionManager;
+    /** 服务器配置 */
+    private config;
+    /** 统一代理处理器（同时支持 HTTP 和 WebSocket） */
+    private proxyHandler;
+    /**
+     * 创建控制通道处理器实例
+     *
+     * @param sessionManager - 会话管理器，用于管理客户端会话
+     * @param config - 服务器配置，包含认证令牌等信息
+     * @param proxyHandler - 统一代理处理器，用于启停代理服务器
+     */
+    constructor(sessionManager: SessionManager, config: ServerConfig, proxyHandler: UnifiedProxyHandler);
+    /**
+     * 处理新的 WebSocket 控制通道连接
+     *
+     * 为新连接创建会话，设置消息处理、关闭处理和错误处理回调，
+     * 并启动 30 秒认证超时计时器。
+     *
+     * @param socket - 新建立的 WebSocket 连接
+     */
+    handleConnection(socket: WebSocket): void;
+    /**
+     * 处理收到的控制消息
+     *
+     * 解析 JSON 消息并根据消息类型分发到对应的处理方法。
+     * 支持的消息类型包括：AUTH、REGISTER、UNREGISTER、HEARTBEAT。
+     *
+     * @param clientId - 发送消息的客户端 ID
+     * @param socket - 客户端的 WebSocket 连接
+     * @param data - 收到的原始消息数据
+     */
+    private handleMessage;
+    /**
+     * 处理认证消息
+     *
+     * 验证客户端提供的令牌是否在配置的有效令牌列表中。
+     * 认证成功后清除认证超时计时器；认证失败则关闭连接。
+     *
+     * @param clientId - 客户端唯一标识 ID
+     * @param socket - 客户端的 WebSocket 连接
+     * @param message - 收到的认证消息
+     */
+    private handleAuth;
+    /**
+     * 处理端口注册消息
+     *
+     * 验证客户端认证状态和端口范围（1024-65535），检查端口是否已被占用，
+     * 然后注册端口并启动代理服务器（同时支持 HTTP 和 WebSocket）。
+     * 若启动失败则自动回滚端口注册。
+     *
+     * @param clientId - 客户端唯一标识 ID
+     * @param socket - 客户端的 WebSocket 连接
+     * @param message - 收到的端口注册消息
+     */
+    private handleRegister;
+    /**
+     * 处理端口注销消息
+     *
+     * 验证客户端认证状态和端口归属，停止代理服务器并注销端口。
+     *
+     * @param clientId - 客户端唯一标识 ID
+     * @param socket - 客户端的 WebSocket 连接
+     * @param message - 收到的端口注销消息
+     */
+    private handleUnregister;
+    /**
+     * 处理心跳消息
+     *
+     * 更新客户端的最后心跳时间并回复心跳响应。
+     *
+     * @param clientId - 客户端唯一标识 ID
+     * @param socket - 客户端的 WebSocket 连接
+     * @param message - 收到的心跳消息
+     */
+    private handleHeartbeat;
+    /**
+     * 处理客户端断开连接
+     *
+     * 停止该客户端注册的所有代理服务器，并移除其会话。
+     *
+     * @param clientId - 断开连接的客户端唯一标识 ID
+     */
+    private handleDisconnect;
+    /**
+     * 通过 WebSocket 发送消息
+     *
+     * 将消息对象序列化为 JSON 字符串后发送，仅在连接处于 OPEN 状态时发送。
+     *
+     * @param socket - 目标 WebSocket 连接
+     * @param message - 需要发送的消息对象
+     */
+    private sendMessage;
+    /**
+     * 发送错误消息
+     *
+     * 构造并发送一条 CONNECTION_ERROR 类型的错误消息给客户端。
+     *
+     * @param socket - 目标 WebSocket 连接
+     * @param error - 错误描述信息
+     */
+    private sendError;
+    /**
+     * 处理客户端返回的 HTTP 响应数据
+     *
+     * @param connectionId - 连接唯一标识 ID
+     * @param data - 客户端返回的 HTTP 响应数据
+     */
+    handleClientResponse(connectionId: string, data: any): void;
+    /**
+     * 处理来自客户端的 WebSocket 数据
+     *
+     * @param connectionId - 连接唯一标识 ID
+     * @param data - 客户端发送的数据
+     */
+    handleClientData(connectionId: string, data: Buffer): void;
+    /**
+     * 处理来自客户端的连接关闭请求
+     *
+     * @param connectionId - 需要关闭的连接唯一标识 ID
+     * @param code - 可选的关闭状态码
+     */
+    handleClientClose(connectionId: string, code?: number): void;
+    /**
+     * 处理来自客户端的流式响应数据
+     *
+     * @param connectionId - 连接唯一标识 ID
+     * @param data - 客户端发送的流式数据
+     */
+    handleClientStreamData(connectionId: string, data: Buffer): void;
+    /**
+     * 处理来自客户端的流式响应结束通知
+     *
+     * @param connectionId - 连接唯一标识 ID
+     */
+    handleClientStreamEnd(connectionId: string): void;
+}
+//# sourceMappingURL=control-handler.d.ts.map

package/dist/handlers/control-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-handler.d.ts","sourceRoot":"","sources":["../../src/handlers/control-handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,EAOL,YAAY,EAEb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,cAAc;IACd,OAAO,CAAC,cAAc,CAAiB;IACvC,YAAY;IACZ,OAAO,CAAC,MAAM,CAAe;IAC7B,qCAAqC;IACrC,OAAO,CAAC,YAAY,CAAsB;IAE1C;;;;;;OAMG;gBAED,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,mBAAmB;IAOnC;;;;;;;OAOG;IACH,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAqCzC;;;;;;;;;OASG;YACW,aAAa;IA4D3B;;;;;;;;;OASG;YACW,UAAU;IA2CxB;;;;;;;;;;OAUG;YACW,cAAc;IA+D5B;;;;;;;;OAQG;YACW,gBAAgB;IA2B9B;;;;;;;;OAQG;YACW,eAAe;IAO7B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;IAMnB;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAOjB;;;;;OAKG;IACH,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI;IAI3D;;;;;OAKG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1D;;;;;OAKG;IACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5D;;;;;OAKG;IACH,sBAAsB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhE;;;;OAIG;IACH,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;CAGlD"}