agent-publish-server 1.0.16 → 1.0.18

package/README.md

@@ -63,6 +63,12 @@ agent-publish-server init
         "^/api": ""
       }
     }
+  },
+  "staticProxy": {
+    "/sub_page": {
+      "target": "http://localhost:3000",
+      "changeOrigin": true
+    }
   }
 }
 ```
@@ -231,7 +237,7 @@ interface AgentConfig {
   dir?: string; // 静态文件目录（默认："./"）
   log?: boolean; // 启用访问日志（默认：true）
   proxy?: {
-    // 代理配置
+    // API代理配置
     [path: string]: {
       target: string; // 目标URL
       changeOrigin?: boolean; // 更改源头
@@ -241,9 +247,67 @@ interface AgentConfig {
       };
     };
   };
+  staticProxy?: {
+    // 静态网页代理配置
+    [path: string]: {
+      target: string; // 目标URL
+      changeOrigin?: boolean; // 更改源头（默认：true）
+    };
+  };
+}
+```
+
+### 静态网页代理
+
+除了API代理外，还支持静态网页代理功能，用于代理整个网站或应用。
+
+#### 配置示例
+
+```json
+{
+  "staticProxy": {
+    "/sub_page": {
+      "target": "http://localhost:3000",
+      "changeOrigin": true
+    }
+  }
 }
 ```
 
+#### 功能特性
+
+- **路径代理**：访问 `/sub_page` 会代理到目标服务器的根路径
+- **自动路径重写**：自动移除代理路径前缀，确保目标服务器收到正确请求
+- **优先级处理**：静态代理优先于静态文件服务，避免路径冲突
+- **跨域支持**：默认启用 `changeOrigin` 选项
+
+#### 与API代理组合使用
+
+`staticProxy` 可以与 `proxy` 配置同时使用：
+
+```json
+{
+  "proxy": {
+    "/api": {
+      "target": "http://localhost:3000",
+      "changeOrigin": true,
+      "pathRewrite": { "^/api": "" }
+    }
+  },
+  "staticProxy": {
+    "/app": {
+      "target": "http://localhost:3001",
+      "changeOrigin": true
+    }
+  }
+}
+```
+
+这样配置后：
+- 访问 `/api/*` 会代理到 `http://localhost:3000/*`（API服务）
+- 访问 `/app/*` 会代理到 `http://localhost:3001/*`（前端应用）
+- 其他路径会访问本地静态文件
+
 ### 访问日志
 
 访问日志默认启用，显示内容包括：
@@ -277,9 +341,12 @@ agent-publish-server --log false
 - **前端测试**：快速静态文件服务，处理跨域问题
 - **本地开发**：代理 API 调用到后端服务
 - **SPA 部署**：为单页应用提供正确的路由支持
+- **微前端架构**：通过静态代理整合多个前端应用
+- **开发环境整合**：将多个本地服务统一到一个端口访问
 
 ### 版本历史
 
+- **v1.0.17**: 新增静态网页代理功能（staticProxy），支持与API代理同时使用
 - **v1.0.16**: 新增交互式配置、访问日志、路径验证功能
 - **v1.0.15**: 基础代理和静态文件服务功能
 

package/dist/server.js

@@ -30,12 +30,24 @@ function createServer(config) {
             next();
         });
     }
-    // 配置代理
+    // 配置API代理
     if (config.proxy) {
         Object.entries(config.proxy).forEach(([path, proxyConfig]) => {
             app.use(path, (0, http_proxy_middleware_1.createProxyMiddleware)(proxyConfig));
         });
     }
+    // 配置静态网页代理
+    if (config.staticProxy) {
+        Object.entries(config.staticProxy).forEach(([path, staticProxyConfig]) => {
+            app.use(path, (0, http_proxy_middleware_1.createProxyMiddleware)({
+                target: staticProxyConfig.target,
+                changeOrigin: staticProxyConfig.changeOrigin !== false, // 默认为true
+                pathRewrite: {
+                    [`^${path}`]: '' // 移除代理路径前缀
+                }
+            }));
+        });
+    }
     // 配置静态文件服务
     app.use(express_1.default.static(staticDir));
     // 添加SPA应用的回退路由处理
@@ -45,6 +57,14 @@ function createServer(config) {
         if (req.path.startsWith('/api/')) {
             return next();
         }
+        // 排除静态代理路径
+        if (config.staticProxy) {
+            for (const proxyPath of Object.keys(config.staticProxy)) {
+                if (req.path.startsWith(proxyPath)) {
+                    return next();
+                }
+            }
+        }
         const filePath = path_1.default.join(process.cwd(), staticDir, req.path);
         // 检查是否为目录
         if (fs_1.default.existsSync(filePath) && fs_1.default.statSync(filePath).isDirectory()) {

package/dist/types.d.ts

@@ -3,10 +3,15 @@ export interface ProxyConfig {
     changeOrigin?: boolean;
     pathRewrite?: Record<string, string>;
 }
+export interface StaticProxyConfig {
+    target: string;
+    changeOrigin?: boolean;
+}
 export interface AgentConfig {
     port?: number;
     dir?: string;
     proxy?: Record<string, ProxyConfig>;
+    staticProxy?: Record<string, StaticProxyConfig>;
     log?: boolean;
 }
 export interface CommandOptions {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-publish-server",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "基于 nodejs+express+http-proxy-middleware 的前端服务启动插件",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/test-static-proxy.json

@@ -0,0 +1,11 @@
+{
+  "port": 8080,
+  "dir": "./",
+  "staticProxy": {
+    "/sub_page": {
+      "target": "http://localhost:3000",
+      "changeOrigin": true
+    }
+  },
+  "log": true
+}