@feng3d/ctc 0.0.10 → 0.0.12

package/README.md

@@ -6,11 +6,11 @@
 
 ## 特性
 
-- WebSocket 控制通道
+- **每个代理端口同时支持 HTTP/WebSocket/TCP/UDP 四种协议**
+- 三通道架构：WebSocket 控制通道 + TCP 二进制数据通道 + UDP 数据通道
 - 自动重连机制
-- **每个端口同时支持 HTTP 和 WebSocket 代理**
 - 多代理支持
-- 单实例模式：支持动态添加代理映射
+- 单实例模式：通过 IPC 机制支持动态添加代理映射
 
 ## 快速开始
 
@@ -20,19 +20,16 @@
 # 启动客户端（连接本地服务器测试）
 npx @feng3d/ctc start -s ws://localhost:9000 -t "my-token" -p "8080:3000:localhost"
 
-# 查询状态
+# 查询状态与代理列表
 npx @feng3d/ctc status
 
-# 列出代理映射
-npx @feng3d/ctc list
-
 # 停止客户端
 npx @feng3d/ctc stop
 ```
 
 ## 命令说明
 
-### `start` - 启动客户端
+### `start` - 启动客户端（别名：`ks`）
 
 ```bash
 npx @feng3d/ctc start [选项]
@@ -66,9 +63,10 @@ npx @feng3d/ctc start -s ws://your-server.com:9000 -t "my-token" -p "8080:3000:l
 | `--reconnect-interval <ms>` | 重连间隔（毫秒） | `5000` | `5000` |
 | `--max-reconnect <number>` | 最大重连次数 | `10` | `10` |
 | `--no-daemon` | 前台运行（不作为后台守护进程） | - | - |
+| `--no-autostart` | 不注册开机启动 | - | - |
 | `-o, --open` | 启动后在浏览器中打开管理页面 | - | - |
 
-### `status` - 查询客户端状态
+### `status` - 查询客户端状态与代理列表（别名：`zt`）
 
 ```bash
 npx @feng3d/ctc status
@@ -78,28 +76,18 @@ npx @feng3d/ctc status
 
 ```
 穿透客户端状态
-  运行中: 是
-  服务器: ws://your-server.com:9000
   PID: 12345
+  服务器: ws://your-server.com:9000
+  管理页面: http://127.0.0.1:9001/
+  开机启动: 已启用
+  连接状态: 已认证
   运行时长: 5分30秒
-  代理数量: 2
-```
-
-### `list` - 列出代理映射
-
-```bash
-npx @feng3d/ctc list
+  代理映射: 2 个
+    :8080 -> localhost:3000
+    :8081 -> localhost:3001
 ```
 
-**输出示例：**
-
-```
-当前代理映射:
-  :8080 -> localhost:3000
-  :8081 -> localhost:3001
-```
-
-### `stop` - 停止客户端
+### `stop` - 停止客户端（别名：`tz`）
 
 ```bash
 npx @feng3d/ctc stop
@@ -151,15 +139,12 @@ remotePort:localPort[:localHost]
 
 **推荐**：本地地址为 localhost 时推荐省略，使用 `8080:3000` 而非 `8080:3000:localhost`。
 
-每个代理端口同时支持 HTTP 和 WebSocket 协议。
+每个代理端口同时支持 HTTP/WebSocket/TCP/UDP 协议。
 
 **示例：**
 
 ```
-# HTTP 代理
-8080:3000:localhost
-
-# WebSocket 代理（同一端口）
+# 单个代理（同时支持 HTTP/WebSocket/TCP/UDP）
 8080:3000:localhost
 
 # 完整格式

package/dist/admin-server.d.ts

@@ -2,8 +2,10 @@
  * @module admin-server
  * @description 客户端管理页面 HTTP 服务器模块。
  * 提供一个本地 HTTP 服务，用于查看客户端状态和管理代理映射。
+ * 支持反向代理模式和正向穿透模式。
  */
-import { ProxyConfig } from '@feng3d/chuantou-shared';
+import { ProxyConfig, ForwardProxyEntry } from '@feng3d/chuantou-shared';
+export type { ForwardProxyEntry };
 /**
  * 客户端状态信息接口
  */
@@ -18,10 +20,22 @@ export interface ClientStatus {
     authenticated: boolean;
     /** 运行时长（毫秒） */
     uptime: number;
-    /** 已注册的代理列表 */
-    proxies: ProxyConfig[];
+    /** 代理列表（包含注册状态） */
+    proxies: (ProxyConfig & {
+        registered?: boolean;
+    })[];
     /** 重连次数 */
     reconnectAttempts: number;
+    /** 正向穿透代理列表 */
+    forwardProxies?: Array<{
+        localPort: number;
+        targetClientId: string;
+        targetPort: number;
+    }>;
+    /** 客户端是否已注册到服务器（正向穿透模式） */
+    isRegistered?: boolean;
+    /** 当前客户端ID */
+    clientId?: string;
 }
 /**
  * 管理页面服务器配置接口
@@ -53,19 +67,50 @@ export declare class AdminServer {
     private addProxyCallback;
     /** 删除代理回调函数 */
     private removeProxyCallback;
+    /** 正向穿透代理列表（用于存储运行时的正向穿透配置） */
+    private forwardProxies;
+    /** 发送消息到服务端的回调（用于正向穿透操作） */
+    private sendMessageCallback?;
+    /** 触发重连的回调函数 */
+    private reconnectCallback?;
+    /** 添加正向穿透代理回调函数 */
+    private addForwardProxyCallback?;
+    /** 删除正向穿透代理回调函数 */
+    private removeForwardProxyCallback?;
+    /** 注册客户端回调函数 */
+    private registerClientCallback?;
+    /** 获取客户端列表回调函数 */
+    private getClientListCallback?;
     /**
-     * 状态页面 HTML 模板
+     * 静态文件路径常量
      */
-    private static readonly STATUS_HTML;
+    private static readonly STATIC_DIR;
+    /**
+     * HTML 模板文件路径
+     */
+    private static readonly TEMPLATE_PATH;
     /**
      * 创建管理服务器实例
      *
      * @param config - 服务器配置
      * @param getStatus - 获取状态的回调函数
-     * @param addProxy - 添加代理的回调函数
-     * @param removeProxy - 删除代理的回调函数
+     * @param addProxy - 添加反向代理的回调函数
+     * @param removeProxy - 删除反向代理的回调函数
+     * @param addForwardProxy - 添加正向穿透的回调函数
+     * @param removeForwardProxy - 删除正向穿透的回调函数
+     * @param registerClient - 注册客户端的回调函数
+     * @param getClientList - 获取客户端列表的回调函数
+     * @param reconnect - 触发重连的回调函数
+     */
+    constructor(config: AdminServerConfig, getStatus: () => ClientStatus, addProxy: (proxy: ProxyConfig) => Promise<void>, removeProxy: (remotePort: number) => Promise<void>, addForwardProxy?: (entry: ForwardProxyEntry) => Promise<void>, removeForwardProxy?: (localPort: number) => Promise<void>, registerClient?: (description?: string) => Promise<void>, getClientList?: () => Promise<any>, sendMessage?: (message: any) => Promise<any>, reconnect?: () => Promise<void>);
+    /**
+     * 设置发送消息的回调
+     */
+    setSendMessageCallback(callback: (message: any) => Promise<any>): void;
+    /**
+     * 设置重连回调
      */
-    constructor(config: AdminServerConfig, getStatus: () => ClientStatus, addProxy: (proxy: ProxyConfig) => Promise<void>, removeProxy: (remotePort: number) => Promise<void>);
+    setReconnectCallback(callback: () => Promise<void>): void;
     /**
      * 启动服务器
      *
@@ -76,10 +121,18 @@ export declare class AdminServer {
      * 处理 HTTP 请求
      *
      * 提供以下端点：
-     * - `GET /` - 管理页面
-     * - `GET /_ctc/status` - 获取状态
-     * - `POST /_ctc/proxies` - 添加代理
-     * - `DELETE /_ctc/proxies/:port` - 删除代理
+     * 反向代理：
+     *   - `GET /` - 管理页面
+     *   - `GET /_ctc/status` - 获取状态
+     *   - `POST /_ctc/proxies` - 添加反向代理
+     *   - `DELETE /_ctc/proxies/:port` - 删除反向代理
+     *   - `POST /_ctc/test-proxy?port=xxx` - 测试反向代理连接
+     * 正向穿透：
+     *   - `GET /_ctc/forward/list` - 获取正向穿透列表
+     *   - `POST /_ctc/forward/add` - 添加正向穿透
+     *   - `POST /_ctc/forward/remove` - 删除正向穿透
+     *   - `GET /_ctc/forward/clients` - 获取客户端列表
+     *   - `POST /_ctc/forward/register` - 注册到服务器
      */
     private handleRequest;
     /**

package/dist/admin-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin-server.d.ts","sourceRoot":"","sources":["../src/admin-server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY;IACZ,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf,eAAe;IACf,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,WAAW;IACX,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,iBAAiB;IACjB,OAAO,CAAC,MAAM,CAAkC;IAChD,WAAW;IACX,OAAO,CAAC,IAAI,CAAS;IACrB,WAAW;IACX,OAAO,CAAC,IAAI,CAAS;IACrB,WAAW;IACX,OAAO,CAAC,SAAS,CAAS;IAC1B,eAAe;IACf,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,eAAe;IACf,OAAO,CAAC,gBAAgB,CAAwC;IAChE,eAAe;IACf,OAAO,CAAC,mBAAmB,CAAwC;IAEnE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAqiBnC;IAEA;;;;;;;OAOG;gBAED,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,YAAY,EAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,EAC/C,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;IAYpD;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAgErB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ5B"}
+{"version":3,"file":"admin-server.d.ts","sourceRoot":"","sources":["../src/admin-server.ts"],"names":[],"mappings":"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"}