@feng3d/ctc 0.0.19 → 0.0.20

package/dist/index.js

@@ -1,339 +1,27 @@
 /**
  * @module @feng3d/ctc
  *
- * 穿透（Chuantou）内网穿透客户端主入口模块。
+ * 穿透（Chuantou）内网穿透客户端库。
  *
- * 该模块提供了客户端的核心功能导出和独立运行入口。
- * 作为库使用时，可以导入 {@link Config}、{@link Controller}、{@link ProxyManager} 等核心类；
- * 作为独立程序运行时，会自动加载配置、连接服务器并注册代理隧道。
- */
-import { Config } from './config.js';
-import { Controller } from './controller.js';
-import { ProxyManager } from './proxy-manager.js';
-import { AdminServer } from './admin-server.js';
-import { IpcHandler } from './ipc-handler.js';
-import { logger } from '@feng3d/chuantou-shared';
-import { join } from 'path';
-import { homedir } from 'os';
-import { ForwardProxy } from './forward-proxy.js';
-import { writeFile, readFileSync, writeFileSync, mkdirSync, unlinkSync } from 'fs';
-/** 客户端目录 */
-const CLIENT_DIR = join(homedir(), '.chuantou', 'client');
-/** PID 文件 */
-const PID_FILE = join(CLIENT_DIR, 'client.pid');
-/**
- * 读取 PID 文件
- */
-function readPidFile() {
-    try {
-        return JSON.parse(readFileSync(PID_FILE, 'utf-8'));
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * 写入 PID 文件
- */
-function writePidFile(info) {
-    mkdirSync(CLIENT_DIR, { recursive: true });
-    writeFileSync(PID_FILE, JSON.stringify(info, null, 2));
-}
-/**
- * 检查指定 PID 的进程是否存活
- */
-function isProcessAlive(pid) {
-    try {
-        process.kill(pid, 0); // 发送信号 0 检查进程是否存在
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * 单实例检查
- * @returns true 表示应该继续启动，false 表示已有实例在运行，应该退出
- */
-function checkSingleInstance(serverUrl, adminPort) {
-    const info = readPidFile();
-    if (!info) {
-        // PID 文件不存在，创建新的
-        writePidFile({
-            pid: process.pid,
-            serverUrl,
-            adminPort,
-            startedAt: Date.now(),
-        });
-        return true;
-    }
-    // 检查记录的进程是否存活
-    if (isProcessAlive(info.pid)) {
-        // 进程存活，检查是否是同一个配置
-        if (info.serverUrl === serverUrl && info.adminPort === adminPort) {
-            logger.log('客户端已在运行中，退出当前启动');
-            logger.log(`  现有实例 PID: ${info.pid}`);
-            logger.log(`  服务器: ${info.serverUrl}`);
-            logger.log(`  管理页面: http://127.0.0.1:${info.adminPort}`);
-            return false;
-        }
-        // 配置不同，记录警告但继续启动（覆盖旧实例）
-        logger.warn(`检测到不同配置的实例 (PID: ${info.pid})，将替换为新配置`);
-    }
-    // 旧进程不存在或配置不同，更新 PID 文件
-    writePidFile({
-        pid: process.pid,
-        serverUrl,
-        adminPort,
-        startedAt: Date.now(),
-    });
-    return true;
-}
-/**
- * 更新配置文件中的代理列表
+ * 提供客户端核心功能的纯库导出，可作为依赖引入使用。
+ *
+ * @example
+ * ```ts
+ * import { Controller, ProxyManager } from '@feng3d/ctc';
+ *
+ * const controller = new Controller({
+ *   serverUrl: 'ws://localhost:9000',
+ *   token: 'your-token',
+ * });
+ * await controller.connect();
+ * ```
  */
-async function updateConfigProxies(proxies) {
-    const config = await Config.load();
-    config.proxies = proxies;
-    const configPath = join(homedir(), '.chuantou', 'client', 'config.json');
-    writeFile(configPath, JSON.stringify(config, null, 2), 'utf-8', (err) => {
-        if (err) {
-            logger.error('更新配置文件失败:', err);
-        }
-        else {
-            logger.log('配置文件已更新');
-        }
-    });
-}
 /**
- * 导出核心类和类型，供作为库使用时引用。
+ * 核心类导出
  */
 export { Config } from './config.js';
 export { Controller } from './controller.js';
 export { ProxyManager } from './proxy-manager.js';
-export { AdminServer } from './admin-server.js';
 export { UnifiedHandler } from './handlers/unified-handler.js';
-export { IpcHandler } from './ipc-handler.js';
 export { ForwardProxy } from './forward-proxy.js';
-/**
- * 客户端主入口函数（独立运行模式）。
- *
- * 执行以下步骤：
- * 1. 从配置文件或命令行参数加载配置
- * 2. 验证配置合法性
- * 3. 创建控制器并连接服务器
- * 4. 认证成功后注册所有代理隧道
- * 5. 启动本地 HTTP 管理页面服务器
- * 6. 监听进程信号实现优雅关闭
- *
- * @returns 无返回值的 Promise
- */
-async function main() {
-    logger.log('正在启动穿透客户端...');
-    // 加载配置（从用户目录 .chuantou/client.json 或命令行参数）
-    const config = await Config.load();
-    // 单实例检查：防止多个客户端实例同时运行
-    if (!checkSingleInstance(config.serverUrl, config.adminPort)) {
-        process.exit(0);
-    }
-    // 验证配置
-    config.validate();
-    logger.log('配置已加载:');
-    logger.log(`  服务器地址: ${config.serverUrl}`);
-    logger.log(`  代理数量: 已配置 ${config.proxies.length} 个`);
-    for (const proxy of config.proxies) {
-        logger.log(`    - :${proxy.remotePort} -> ${proxy.localHost || 'localhost'}:${proxy.localPort}`);
-    }
-    // 记录启动时间
-    const startTime = Date.now();
-    // 创建控制器
-    const controller = new Controller(config);
-    // 创建代理管理器
-    const proxyManager = new ProxyManager(controller);
-    // 创建正向穿透代理
-    const forwardProxy = new ForwardProxy(controller);
-    // 已注册的代理配置列表（用于管理页面）
-    const registeredProxies = [];
-    let nextProxyIndex = 1;
-    for (const p of config.proxies) {
-        registeredProxies.push({ ...p, index: nextProxyIndex++ });
-    }
-    // 创建管理页面服务器
-    const adminServerConfig = { port: config.adminPort, host: '127.0.0.1' };
-    // 获取状态回调
-    const getStatusCallback = () => {
-        // 获取实际在 ProxyManager 中注册的端口
-        const actualRegisteredPorts = proxyManager.getRegisteredPorts();
-        // 返回所有配置的代理（去重），并标记注册状态
-        const actualRegisteredProxies = registeredProxies
-            .filter((p, index, self) => {
-            // 去重：只保留第一次出现的端口
-            return index === self.findIndex(other => other.remotePort === p.remotePort);
-        })
-            .map(p => ({ ...p, registered: actualRegisteredPorts.includes(p.remotePort) }));
-        const status = {
-            running: true,
-            serverUrl: config.serverUrl,
-            connected: controller.isConnected(),
-            authenticated: controller.isAuthenticated(),
-            uptime: Date.now() - startTime,
-            proxies: actualRegisteredProxies,
-            reconnectAttempts: controller.getReconnectAttempts(),
-        };
-        // 添加正向穿透相关信息
-        try {
-            const forwardProxies = forwardProxy.getProxies();
-            status.forwardProxies = forwardProxies;
-            status.isRegistered = true; // 假设已注册（实际应从 Controller 获取）
-            status.clientId = controller.getClientId();
-        }
-        catch (e) {
-            // 如果获取失败，返回基础状态
-        }
-        return status;
-    };
-    // 添加代理回调
-    const addProxyCallback = async (proxy) => {
-        await proxyManager.registerProxy(proxy);
-        registeredProxies.push({ ...proxy, index: nextProxyIndex++ });
-        // 同步更新配置文件
-        await updateConfigProxies(registeredProxies.map(p => ({ remotePort: p.remotePort, localPort: p.localPort, localHost: p.localHost })));
-    };
-    // 删除代理回调
-    const removeProxyCallback = async (remotePort) => {
-        await proxyManager.unregisterProxy(remotePort);
-        const index = registeredProxies.findIndex(p => p.remotePort === remotePort);
-        if (index !== -1) {
-            registeredProxies.splice(index, 1);
-        }
-        // 同步更新配置文件
-        await updateConfigProxies(registeredProxies);
-    };
-    // 添加正向穿透回调
-    const addForwardProxyCallback = async (entry) => {
-        await forwardProxy.addProxy(entry);
-    };
-    // 删除正向穿透回调
-    const removeForwardProxyCallback = async (localPort) => {
-        await forwardProxy.removeProxy(localPort);
-    };
-    // 注册客户端回调
-    const registerClientCallback = async (description) => {
-        return await forwardProxy.registerAsClient(description);
-    };
-    // 获取客户端列表回调
-    const getClientListCallback = async () => {
-        return await forwardProxy.getClientList();
-    };
-    // 重连回调
-    const reconnectCallback = async () => {
-        logger.log('收到手动重连请求');
-        // 先断开现有连接
-        controller.disconnect();
-        // 然后重新连接
-        await controller.connect();
-    };
-    // 创建管理页面服务器
-    const adminServer = new AdminServer(adminServerConfig, getStatusCallback, addProxyCallback, removeProxyCallback, addForwardProxyCallback, removeForwardProxyCallback, registerClientCallback, getClientListCallback, undefined, // sendMessage 会在后面设置
-    reconnectCallback);
-    // 设置发送消息回调（用于正向穿透向服务端发送消息）
-    adminServer.setSendMessageCallback(async (message) => {
-        return await controller.sendRequest(message);
-    });
-    // 监听控制器事件
-    controller.on('connected', () => {
-        logger.log('已连接到服务器');
-    });
-    controller.on('disconnected', () => {
-        logger.log('已断开与服务器的连接');
-    });
-    controller.on('authenticated', async () => {
-        logger.log('已认证，正在注册代理...');
-        // 获取实际在 ProxyManager 中注册的端口
-        const actualRegisteredPorts = proxyManager.getRegisteredPorts();
-        // 注册所有代理（只注册尚未实际注册的）
-        for (const proxyConfig of config.proxies) {
-            if (actualRegisteredPorts.includes(proxyConfig.remotePort)) {
-                logger.log(`代理 :${proxyConfig.remotePort} 已注册，跳过`);
-                continue;
-            }
-            try {
-                await proxyManager.registerProxy(proxyConfig);
-            }
-            catch (error) {
-                const errorMessage = error instanceof Error ? error.message : String(error);
-                logger.error(`注册代理失败: ${errorMessage}`);
-            }
-        }
-    });
-    // 设置 IPC 请求监听（用于处理 CLI 添加代理的请求）
-    const ipcHandler = new IpcHandler({
-        requestDir: join(homedir(), '.chuantou', 'proxy-requests'),
-        controller,
-        proxyManager,
-        registeredProxies,
-    });
-    ipcHandler.start();
-    // 启动管理页面服务器（立即启动，不等待认证）
-    try {
-        await adminServer.start();
-    }
-    catch (error) {
-        logger.error('管理页面启动失败:', error);
-    }
-    // 优雅关闭
-    const shutdown = async () => {
-        ipcHandler.stop();
-        logger.log('\n正在关闭...');
-        await adminServer.stop();
-        await proxyManager.destroy();
-        controller.disconnect();
-        // 清理 PID 文件（只有当前进程是 PID 文件中的进程时才清理）
-        const pidInfo = readPidFile();
-        if (pidInfo && pidInfo.pid === process.pid) {
-            try {
-                unlinkSync(PID_FILE);
-            }
-            catch {
-                // ignore
-            }
-        }
-        process.exit(0);
-    };
-    process.on('SIGINT', shutdown);
-    process.on('SIGTERM', shutdown);
-    // 未捕获异常处理 - 崩溃时记录退出码
-    process.on('uncaughtException', (error) => {
-        logger.error('未捕获异常:', error);
-        // 写入非零退出码，让父进程知道是异常退出
-        process.exit(1);
-    });
-    process.on('unhandledRejection', (reason, promise) => {
-        logger.error('未处理的 Promise 拒绝:', reason);
-        // 写入非零退出码
-        process.exit(1);
-    });
-    // 连接到服务器（不会抛出连接失败的异常，会自动重连）
-    await controller.connect();
-}
-// 检查是否作为主模块运行
-// 使用更简单的方式：通过检查是否直接运行此文件
-const isMainModule = process.argv[1] && process.argv[1].endsWith('index.js');
-if (isMainModule) {
-    main().catch((error) => {
-        logger.error('启动客户端失败:', error);
-        // 注意：main() 内部已经处理了资源清理
-        process.exit(1);
-    });
-}
-/**
- * 导出运行函数供 CLI 使用。
- *
- * 该函数是 {@link main} 的公开包装，用于被 CLI 模块调用以启动客户端。
- *
- * @returns 无返回值的 Promise
- */
-export async function run() {
-    return main();
-}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/ipc-handler.d.ts

@@ -4,11 +4,41 @@
  * IPC 请求处理模块。
  *
  * 通过文件系统实现进程间通信（IPC），允许 CLI 向运行中的客户端进程
- * 发送添加代理请求。请求通过 JSON 文件传递，响应通过 .resp 文件返回。
+ * 发送管理请求。请求通过 JSON 文件传递，响应通过 .resp 文件返回。
+ *
+ * 支持的请求类型：
+ * - get-status: 获取客户端状态
+ * - add-proxy: 添加反向代理
+ * - remove-proxy: 删除反向代理
+ * - clear-proxies: 清除所有代理
+ * - forward-list: 正向穿透列表
+ * - forward-add: 添加正向穿透
+ * - forward-remove: 删除正向穿透
+ * - forward-clients: 在线客户端列表
+ * - forward-register: 注册为可发现客户端
  */
-import { ProxyConfig } from '@feng3d/chuantou-shared';
+import { ProxyConfig, type ForwardProxyEntry } from '@feng3d/chuantou-shared';
 import { Controller } from './controller.js';
 import { ProxyManager } from './proxy-manager.js';
+import { ForwardProxy } from './forward-proxy.js';
+/**
+ * 客户端状态接口
+ */
+export interface ClientStatus {
+    running: boolean;
+    serverUrl: string;
+    connected: boolean;
+    authenticated: boolean;
+    uptime: number;
+    proxies: Array<ProxyConfig & {
+        registered?: boolean;
+        index?: number;
+    }>;
+    reconnectAttempts: number;
+    forwardProxies?: ForwardProxyEntry[];
+    isRegistered?: boolean;
+    clientId?: string;
+}
 /**
  * IPC 请求处理器，处理来自 CLI 的文件系统 IPC 请求。
  *
@@ -21,12 +51,18 @@ export declare class IpcHandler {
     private controller;
     private proxyManager;
     private registeredProxies;
+    private forwardProxy;
+    private getStatus;
+    private updateConfigProxies;
     private timer;
     constructor(options: {
         requestDir: string;
         controller: Controller;
         proxyManager: ProxyManager;
         registeredProxies: ProxyConfig[];
+        forwardProxy: ForwardProxy;
+        getStatus: () => ClientStatus;
+        updateConfigProxies: (proxies: ProxyConfig[]) => Promise<void>;
     });
     /**
      * 启动 IPC 请求监听，每 500ms 扫描一次请求目录。
@@ -42,11 +78,47 @@ export declare class IpcHandler {
      */
     checkRequests(): void;
     /**
-     * 处理单个添加代理请求文件。
+     * 处理单个 IPC 请求文件。
      *
-     * 读取请求文件 → 检查认证状态 → 注册代理 → 写入响应文件。
+     * 读取请求文件 → 根据类型分发处理 → 写入响应文件。
      * 无论成功或失败，始终写入响应文件，确保 CLI 不会超时等待。
      */
     handleRequest(requestFilePath: string): Promise<void>;
+    /**
+     * 处理获取状态请求
+     */
+    private handleGetStatus;
+    /**
+     * 处理添加代理请求
+     */
+    private handleAddProxy;
+    /**
+     * 处理删除代理请求
+     */
+    private handleRemoveProxy;
+    /**
+     * 处理清除所有代理请求
+     */
+    private handleClearProxies;
+    /**
+     * 处理正向穿透列表请求
+     */
+    private handleForwardList;
+    /**
+     * 处理添加正向穿透请求
+     */
+    private handleForwardAdd;
+    /**
+     * 处理删除正向穿透请求
+     */
+    private handleForwardRemove;
+    /**
+     * 处理获取在线客户端列表请求
+     */
+    private handleForwardClients;
+    /**
+     * 处理注册为可发现客户端请求
+     */
+    private handleForwardRegister;
 }
 //# sourceMappingURL=ipc-handler.d.ts.map

package/dist/ipc-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ipc-handler.d.ts","sourceRoot":"","sources":["../src/ipc-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,WAAW,EAAU,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,KAAK,CAA+B;gBAEhC,OAAO,EAAE;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,UAAU,CAAC;QACvB,YAAY,EAAE,YAAY,CAAC;QAC3B,iBAAiB,EAAE,WAAW,EAAE,CAAC;KAClC;IAOD;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;;OAGG;IACH,aAAa,IAAI,IAAI;IAiBrB;;;;;OAKG;IACG,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAwC5D"}
+{"version":3,"file":"ipc-handler.d.ts","sourceRoot":"","sources":["../src/ipc-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,WAAW,EAAU,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC,WAAW,GAAG;QAAE,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAuCD;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,mBAAmB,CAA4C;IACvE,OAAO,CAAC,KAAK,CAA+B;gBAEhC,OAAO,EAAE;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,UAAU,CAAC;QACvB,YAAY,EAAE,YAAY,CAAC;QAC3B,iBAAiB,EAAE,WAAW,EAAE,CAAC;QACjC,YAAY,EAAE,YAAY,CAAC;QAC3B,SAAS,EAAE,MAAM,YAAY,CAAC;QAC9B,mBAAmB,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAChE;IAUD;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;;OAGG;IACH,aAAa,IAAI,IAAI;IAuBrB;;;;;OAKG;IACG,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqD3D;;OAEG;YACW,eAAe;IAO7B;;OAEG;YACW,cAAc;IAqB5B;;OAEG;YACW,iBAAiB;IAwB/B;;OAEG;YACW,kBAAkB;IAyBhC;;OAEG;YACW,iBAAiB;IAU/B;;OAEG;YACW,gBAAgB;IAiB9B;;OAEG;YACW,mBAAmB;IAajC;;OAEG;YACW,oBAAoB;IAelC;;OAEG;YACW,qBAAqB;CAcpC"}