# HTTP 转发服务器

**Repository Path**: tudengkui/httpforward-server

## Basic Information

- **Project Name**: HTTP 转发服务器
- **Description**: 这是一个基于 C# 的 HTTP 转发服务器代码，主要功能是监听指定 URL 的 HTTP 请求，并将请求转发到另一个地址
- **Primary Language**: C#
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-12-26
- **Last Updated**: 2025-12-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

这是一个基于 C# 的 HTTP 转发服务器代码，主要功能是监听指定 URL 的 HTTP 请求，并将请求转发到另一个地址（`http://localhost:8765`）。这个 **HTTP 转发服务器** 的主要使用场景包括以下几个方面：

### 主要功能

1. **启动服务**：
   - 从配置文件读取监听地址（`listenerUrl`）
   - 创建 `HttpListener` 并开始监听
   - 启动后台任务处理请求
2. **请求处理**：
   - 支持 `GET` 和 `POST` 方法
   - `GET` 请求直接转发到目标地址
   - `POST` 请求会读取请求体数据并转发
   - 其他 HTTP 方法返回错误信息
3. **日志记录**：
   - 控制台输出日志信息
   - 在 DEBUG 模式下还会记录到日志文件

------

### **1. 本地开发调试（API 转发代理）**

- **场景**：前端开发时，后端 API 尚未部署或需要跨域访问，但直接请求目标 API 存在限制（如 CORS 跨域问题）。

- **用途**：

  - 前端代码请求本地 `http://localhost:8080`，由该服务转发到真实的后端 API（如 `http://api.example.com`）。
  - 可模拟 API 响应，方便前端调试。

- **示例**：

  ```
  // 前端代码直接请求本地代理
  fetch("http://localhost:8080/api/user")
    .then(res => res.json())
    .then(data => console.log(data));
  ```

  - 实际请求会被转发到 `http://localhost:8765/api/user`（或配置的目标地址）。

------

### **2. 跨域请求代理（CORS 解决方案）**

- **场景**：前端页面直接请求远程 API 时，浏览器因 **同源策略（Same-Origin Policy）** 阻止请求。

- **用途**：

  - 通过本地代理服务器转发请求，绕过浏览器的 CORS 限制。
  - 适用于开发阶段调试第三方 API（如微信支付、支付宝回调等）。

- **示例**：

  ```
  // 直接请求会触发 CORS 错误：
  fetch("https://api.weixin.qq.com/pay/notify") // ❌ CORS 错误
  // 改用本地代理：
  fetch("http://localhost:8080/proxy/weixin/pay/notify") // ✅ 由代理转发
  ```

------

### **3. 接口 Mock（模拟数据）**

- **场景**：后端 API 尚未开发完成，前端需要模拟数据进行开发。

- **用途**：

  - 该服务可以拦截特定请求，返回本地 Mock 数据（如 JSON 文件）。
  - 结合 `POST` 请求，可模拟登录、提交表单等交互。

- **示例**：

  ```
  // 在 Startup.cs 中修改，针对特定路径返回 Mock 数据
  if (request.Url.PathAndQuery.StartsWith("/mock/user"))
  {
      responseData = "{ \"name\": \"Mock User\", \"id\": 123 }";
  }
  ```

------

### **4. 内网穿透（临时公网访问本地服务）**

- **场景**：开发时需要让外部服务（如微信回调、支付通知）访问本地环境。

- **用途**：

  - 结合 **Ngrok/FRP** 等工具，将本地 `http://localhost:8080` 暴露到公网。
  - 外部请求 → 公网地址 → 本地代理 → 转发到目标服务。

- **示例**：

  ```
  公网地址：https://xxxx.ngrok.io → 映射到本地 http://localhost:8080
  ```

------

### **5. 请求日志记录 & 调试**

- **场景**：需要监控 HTTP 请求的详细内容（如参数、Headers、响应时间）。

- **用途**：

  - 该服务会打印所有请求的 URL、参数、响应数据，方便排查问题。
  - 可用于分析第三方服务的请求格式。

- **示例输出**：

  ```
  [14:30:45] 请求方式[POST],请求地址[http://localhost:8765/api/login],请求参数[{"user":"admin"}],响应参数[{"token":"abc123"}]
  ```

------

### **6. 协议转换（HTTP → HTTPS）**

- **场景**：本地开发时，某些 API 强制要求 HTTPS，但本地环境是 HTTP。
- **用途**：
  - 通过该服务转发请求，让本地 HTTP 请求变成 HTTPS 请求。
  - 适用于调试 **OAuth2.0 登录** 等强制 HTTPS 的场景。

------

### **适用人群**

1. **前端开发人员**：解决跨域、Mock 数据问题。
2. **后端开发人员**：调试接口、记录请求日志。
3. **测试人员**：拦截和修改请求，模拟异常情况。

------

### **不适用场景**

❌ 高并发生产环境（性能有限，建议用 Nginx/HAProxy）。
❌ 需要复杂路由规则的场景（建议用 **YARP** 或 **Ocelot**）。

------

### **总结**

| 场景              | 用途               | 典型用户  |
| :---------------- | :----------------- | :-------- |
| **本地 API 代理** | 解决跨域、转发请求 | 前端开发  |
| **Mock 数据**     | 模拟未完成的 API   | 全栈开发  |
| **请求日志**      | 记录请求/响应      | 测试/后端 |
| **内网穿透**      | 让外部访问本地服务 | 全端开发  |
| **HTTPS 转换**    | HTTP → HTTPS       | 安全调试  |

如果你的需求是 **简单、轻量级的请求转发和调试**，这个工具非常合适！