dynapm 1.0.11 → 1.0.13

package/CHANGELOG.md

@@ -5,6 +5,43 @@
 格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [1.0.13] - 2026-02-10
+
+### 🚀 性能优化
+- **重大性能提升**：使用 undici 替代原生 http 模块作为 HTTP 客户端
+  - 吞吐量提升 **28.2%**：4345 → 5571 req/s
+  - 延迟保持 11.4ms（无退化）
+  - 使用 `undici.request()` API 实现流式转发
+  - 避免了 `undici.stream()` + Writable stream 的包装开销
+
+### 🔧 改进
+- 移除不再使用的 http/https 模块相关代码
+- 清理 RouteMapping 中的冗余字段（isHttps、httpModule、httpAgent）
+- 代码更简洁，维护性更好
+
+### 📚 技术细节
+- undici 的 `request()` API 比 `stream()` API 更适合代理场景
+- `stream()` 适用于消费响应（写入文件、解析 JSON）
+- `request()` 返回 Readable stream，可以手动控制流式转发
+- 完全保持流式处理，客户端延迟无增加
+
+---
+
+## [1.0.12] - 2026-02-10
+
+### ✨ 新增
+- 添加 `proxyOnly` 配置项，支持纯反向代理模式
+  - 不管理服务生命周期（启动/停止）
+  - 仅做请求转发，适合已运行的服务
+
+### 🔧 改进
+- WebSocket 代理正确转发客户端请求路径
+- WebSocket 代理完整转发客户端请求头（Cookie、Authorization 等）
+- 改进 WebSocket 错误处理，避免连接重试循环
+- 添加 TypeScript 测试配置支持
+
+---
+
 ## [1.0.11] - 2025-02-10
 
 ### 🔧 修复

package/README.md

@@ -4,9 +4,7 @@
 
 > **Dynamic Process Manager** - A lightweight, universal service management system with serverless-like features.
 
-[![npm version](https://badge.fury.io/js/dynapm.svg)](https://www.npmjs.com/package/dynapm)
-![Tests](https://img.shields.io/badge/tests-12%2F12 passing-green)
-![Performance](https://img.shields.io/badge/overhead-25ms-brightgreen)
+[![npm version](https://badge.fury.io/js/dynapm.svg)](https://www.npmjs.com/package/dynapm) ![Tests](https://img.shields.io/badge/tests-12%2F12%20passing-green) ![Performance](https://img.shields.io/badge/overhead-25ms-brightgreen)
 
 DynaPM is a **lightweight alternative** to complex container orchestration platforms (like Knative, Sablier) for private deployments. It helps you manage hundreds of low-frequency services on resource-constrained servers by starting them on-demand and stopping them when idle.
 
@@ -183,6 +181,13 @@ const config: DynaPMConfig = {
   port: 3000,
   host: '127.0.0.1',
 
+  // Logging configuration (optional, disable for better performance in production)
+  logging: {
+    enableRequestLog: false,      // Enable request/response logging (high frequency, affects performance)
+    enableWebSocketLog: false,    // Enable WebSocket lifecycle logging
+    // Error logging is always enabled
+  },
+
   services: {
     'app.example.com': {
       name: 'my-app',

package/README_zh.md

@@ -4,9 +4,7 @@
 
 > **动态进程管理器** - 具有类 serverless 特性的轻量级通用服务管理系统
 
-[![npm version](https://badge.fury.io/js/dynapm.svg)](https://www.npmjs.com/package/dynapm)
-![Tests](https://img.shields.io/badge/tests-12%2F12 passing-green)
-![Performance](https://img.shields.io/badge/overhead-25ms-brightgreen)
+[![npm version](https://badge.fury.io/js/dynapm.svg)](https://www.npmjs.com/package/dynapm) ![Tests](https://img.shields.io/badge/tests-12%2F12%20passing-green) ![Performance](https://img.shields.io/badge/overhead-25ms-brightgreen)
 
 DynaPM 是**复杂容器编排平台（如 Knative、Sablier）的轻量级替代方案**，专为私有化部署设计。它通过按需启动和闲置自动停止的方式，帮助你在资源受限的服务器上管理数百个低频访问的服务。
 
@@ -182,6 +180,13 @@ const config: DynaPMConfig = {
   port: 3000,
   host: '127.0.0.1',
 
+  // 日志配置（可选，生产环境建议关闭以提升性能）
+  logging: {
+    enableRequestLog: false,      // 是否启用请求日志（高频，影响性能）
+    enableWebSocketLog: false,    // 是否启用 WebSocket 生命周期日志
+    // 错误日志始终启用，不受此开关控制
+  },
+
   services: {
     'app.example.com': {
       name: 'my-app',

package/dist/src/config/types.d.ts

@@ -30,6 +30,15 @@ export interface ServiceCommands {
     /** 环境变量（可选） */
     env?: Record<string, string>;
 }
+/** 路由配置 */
+export interface RouteConfig {
+    /** 路由类型 */
+    type: 'host' | 'port';
+    /** 路由值：网关端的 hostname 或端口号 */
+    value: string | number;
+    /** 目标后端地址：转发到的实际服务地址 */
+    target: string;
+}
 /** 服务配置 */
 export interface ServiceConfig {
     /** 服务标识 */
@@ -44,16 +53,54 @@ export interface ServiceConfig {
     commands: ServiceCommands;
     /** 健康检查配置 */
     healthCheck?: HealthCheckConfig;
+    /** 纯代理模式：只做反向代理，不启动/停止服务 */
+    proxyOnly?: boolean;
+    /** Hostname 映射（可选）：配置后可通过此 hostname 访问 */
+    host?: string;
+    /** 专属端口（可选）：配置后网关会监听此端口 */
+    port?: number;
+    /** 路由配置（可选）：配置多个访问地址 */
+    routes?: RouteConfig[];
     /** 运行时状态（内部使用） */
     _state?: ServiceState;
 }
 /** 服务运行状态 */
 export interface ServiceState {
-    status: 'offline' | 'starting' | 'online';
+    status: 'offline' | 'starting' | 'online' | 'stopping';
     lastAccessTime: number;
     /** 当前活动连接数（HTTP/SSE/WebSocket） */
     activeConnections: number;
     pid?: number;
+    /** 服务启动时间戳 */
+    startTime?: number;
+    /** 累计启动次数 */
+    startCount: number;
+    /** 累计运行时长（毫秒） */
+    totalUptime: number;
+}
+/** 管理 API 配置 */
+export interface AdminApiConfig {
+    /** 是否启用管理 API */
+    enabled?: boolean;
+    /** 管理 API 端口（独立监听） */
+    port?: number;
+    /** 管理 API hostname（可选，使用主端口时需配置） */
+    host?: string;
+    /** API 认证令牌（可选） */
+    authToken?: string;
+    /** 允许访问的 IP 白名单 */
+    allowedIps?: string[];
+}
+/** 日志配置 */
+export interface LoggingConfig {
+    /** 是否启用请求日志（每个请求响应记录） */
+    enableRequestLog?: boolean;
+    /** 是否启用 WebSocket 生命周期日志 */
+    enableWebSocketLog?: boolean;
+    /** 是否启用错误日志（始终启用，不受此开关控制） */
+    enableErrorLog?: boolean;
+    /** 是否启用性能分析日志（用于性能优化调试） */
+    enablePerformanceLog?: boolean;
 }
 /** DynaPM全局配置 */
 export interface DynaPMConfig {
@@ -63,4 +110,8 @@ export interface DynaPMConfig {
     host?: string;
     /** 服务映射：hostname -> 服务配置 */
     services: Record<string, ServiceConfig>;
+    /** 管理 API 配置 */
+    adminApi?: AdminApiConfig;
+    /** 日志配置 */
+    logging?: LoggingConfig;
 }

package/dist/src/core/admin-api.d.ts

@@ -0,0 +1,72 @@
+import type { ServiceConfig } from '../config/types.js';
+import type { HttpResponse, HttpRequest } from 'uWebSockets.js';
+import type { Logger } from 'pino';
+import type { ServiceManager } from './service-manager.js';
+/**
+ * 路由映射信息
+ */
+interface RouteMapping {
+    /** 服务配置 */
+    service: ServiceConfig;
+    /** 目标后端地址 */
+    target: string;
+}
+/**
+ * 管理处理器
+ * 处理所有管理 API 请求
+ */
+export declare class AdminApiHandler {
+    private config;
+    private logger;
+    private hostnameRoutes;
+    private portRoutes;
+    private serviceManager;
+    constructor(config: DynaPMConfig, logger: Logger, hostnameRoutes: Map<string, RouteMapping>, portRoutes: Map<number, RouteMapping>, serviceManager: ServiceManager);
+    /**
+     * 检查客户端 IP 是否在允许列表中
+     */
+    private isIpAllowed;
+    /**
+     * 检查认证令牌是否有效
+     */
+    private isAuthenticated;
+    /**
+     * 获取服务运行时长
+     */
+    private getServiceUptime;
+    /**
+     * 处理管理 API 请求
+     */
+    handleAdminApi(res: HttpResponse, req: HttpRequest): void;
+    /**
+     * 获取服务列表
+     */
+    private getServicesList;
+    /**
+     * 获取服务详情
+     */
+    private getServiceDetail;
+    /**
+     * 停止服务
+     */
+    stopService(res: HttpResponse, serviceName: string): Promise<void>;
+    /**
+     * 启动服务
+     */
+    startService(res: HttpResponse, serviceName: string): Promise<void>;
+    /**
+     * 处理事件流（SSE）
+     */
+    private handleEventStream;
+}
+/**
+ * DynaPM 配置类型导入
+ */
+interface DynaPMConfig {
+    adminApi?: {
+        enabled?: boolean;
+        authToken?: string;
+        allowedIps?: string[];
+    };
+}
+export {};

package/dist/src/core/gateway.d.ts

@@ -7,27 +7,51 @@ import type { Logger } from 'pino';
 export declare class Gateway {
     private config;
     private serviceManager;
-    /** 服务映射：hostname -> 服务配置 */
-    private services;
+    /** 主机名路由：hostname -> 路由映射信息 */
+    private hostnameRoutes;
+    /** 端口路由：端口 -> 路由映射信息 */
+    private portRoutes;
     /** 日志记录器 */
     private logger;
+    /** 日志配置 */
+    private logging;
+    /** 管理 API 处理器 */
+    private adminApi;
     constructor(config: DynaPMConfig, logger: Logger);
     /**
-     * 初始化服务映射
+     * 初始化服务映射和端口绑定
      */
     private initServices;
     /**
      * 初始化闲置检查器
      * 定期检查并停止闲置的服务
      *
-     * 注意：只有当服务没有活动连接且超过闲置时间时才会停止
-     * 这样可以避免 SSE/WebSocket 长连接被意外断开
+     * 注意：
+     * - 纯代理模式（proxyOnly）不会被停止
+     * - 只有当服务没有活动连接且超过闲置时间时才会停止
+     * - 这样可以避免 SSE/WebSocket 长连接被意外断开
      */
     private initIdleChecker;
+    /**
+     * 检查单个服务是否闲置
+     */
+    private checkIdleService;
+    /**
+     * 处理端口绑定请求（直接路由，无需 Host 头）
+     */
+    private handlePortBindingRequest;
     /**
      * 处理传入的 HTTP 请求
      */
     private handleRequest;
+    /**
+     * 启动服务并代理请求
+     */
+    private startServiceAndProxy;
+    /**
+     * 处理需要等待服务停止完成的场景
+     */
+    private handleServiceWithWait;
     /**
      * 处理需要启动服务的场景
      */
@@ -40,7 +64,7 @@ export declare class Gateway {
      * 发起代理请求并流式转发响应
      *
      * @param res - uWS HttpResponse 对象
-     * @param service - 目标服务配置
+     * @param mapping - 路由映射信息（包含缓存的目标 URL）
      * @param path - 请求路径（包含查询字符串）
      * @param startTime - 请求开始时间（用于日志）
      * @param method - HTTP 方法
@@ -52,4 +76,17 @@ export declare class Gateway {
      * 启动网关
      */
     start(): Promise<void>;
+    /**
+     * 为管理 API 创建监听器
+     */
+    private createAdminApiListener;
+    /**
+     * 为指定端口创建监听器
+     */
+    private createPortBindingListener;
+    /**
+     * 清理所有正在运行的服务
+     * 在网关退出时调用
+     */
+    cleanup(): Promise<void>;
 }