336 lines
7.6 KiB
Markdown
336 lines
7.6 KiB
Markdown
# 变更日志
|
||
|
||
本文档记录rhttpd项目的所有重要变更。
|
||
|
||
格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
|
||
并且本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
|
||
|
||
## [未发布]
|
||
|
||
### 修复
|
||
- ✅ 修复ForwardProxy的Clone trait实现
|
||
- ✅ 修复TcpProxyManager的Clone trait实现
|
||
- ✅ 确保项目编译通过
|
||
- ✅ 验证所有测试通过（7个测试）
|
||
- ✅ 通过clippy代码检查
|
||
|
||
### 计划中
|
||
- [ ] TCP代理协议检测
|
||
- [ ] WebSocket消息解析和转发
|
||
- [ ] 完整SSL/TLS支持
|
||
- [ ] 完整JavaScript运行时集成
|
||
|
||
## [0.2.0] - 2025-01-15
|
||
|
||
### 新增
|
||
- 🌊 **TCP代理支持**
|
||
- 原始TCP流量转发
|
||
- WebSocket协议代理框架
|
||
- 协议检测和路由
|
||
- 🔄 **连接池管理**
|
||
- HTTP连接复用
|
||
- 连接保活机制
|
||
- 连接数限制
|
||
- 空闲连接清理
|
||
- ⚖️ **负载均衡**
|
||
- 轮询 (Round Robin) 算法
|
||
- 最少连接 (Least Connections) 算法
|
||
- 加权轮询 (Weighted Round Robin) 算法
|
||
- IP哈希 (IP Hash) 算法
|
||
- 随机选择 (Random) 算法
|
||
- 🏥 **健康检查机制**
|
||
- HTTP健康检查端点
|
||
- TCP连接健康检查
|
||
- 后端服务状态监控
|
||
- 故障检测和恢复
|
||
- 响应时间统计
|
||
- 🛠️ **配置增强**
|
||
- 连接池配置选项
|
||
- 健康检查配置选项
|
||
- 多种负载均衡策略配置
|
||
|
||
### 变更
|
||
|
||
#### 新增模块
|
||
- `proxy/tcp_proxy.rs` - TCP和WebSocket代理实现
|
||
- `proxy/connection_pool.rs` - HTTP连接池管理
|
||
- `proxy/load_balancer.rs` - 负载均衡策略实现
|
||
- `proxy/health_check.rs` - 健康检查系统
|
||
|
||
#### 配置增强
|
||
```toml
|
||
# 新增连接池配置
|
||
[connection_pool]
|
||
max_connections = 100
|
||
idle_timeout = 90 # 秒
|
||
|
||
# 新增健康检查配置
|
||
[health_check]
|
||
interval = 30 # 秒
|
||
timeout = 5 # 秒
|
||
path = "/health"
|
||
expected_status = 200
|
||
|
||
# 增强的负载均衡配置
|
||
[[sites."example.com".routes]]
|
||
type = "reverse_proxy"
|
||
path_pattern = "/api/*"
|
||
target = "http://backend:3000"
|
||
|
||
[sites."example.com".routes.load_balancer]
|
||
strategy = "round_robin" # round_robin, least_connections, weighted_round_robin, ip_hash, random
|
||
upstreams = ["http://backend1:3000", "http://backend2:3000"]
|
||
weights = [1, 2] # 可选的权重配置
|
||
```
|
||
|
||
#### API增强
|
||
- `ConnectionPool` - HTTP连接池管理
|
||
- `LoadBalancer` - 负载均衡器
|
||
- `HealthChecker` - 健康检查器
|
||
- `TcpProxyManager` - TCP代理管理器
|
||
|
||
#### 测试覆盖
|
||
- 新增连接池测试 (1个测试)
|
||
- 新增负载均衡测试 (1个测试)
|
||
- 现有测试7个全部通过
|
||
|
||
### 技术细节
|
||
|
||
#### 新增依赖
|
||
- `tokio-tungstenite` - WebSocket支持
|
||
- `base64` - WebSocket握手支持
|
||
- `sha1` - WebSocket认证支持
|
||
- `rand` - 负载均衡随机选择
|
||
|
||
#### 性能优化
|
||
- 连接池减少连接建立开销
|
||
- 负载均衡提高后端利用率
|
||
- 健康检查快速故障转移
|
||
- 异步架构保证高并发性能
|
||
|
||
#### 安全增强
|
||
- 连接数限制防止资源耗尽
|
||
- 超时机制防止连接堆积
|
||
- 健康检查确保服务可用性
|
||
|
||
### 文档更新
|
||
- README.md - 新增v0.2.0功能介绍
|
||
- AGENTS.md - 更新开发指南
|
||
- roadmap.md - 新增详细实现计划
|
||
- CHANGELOG.md - 版本变更记录
|
||
|
||
### 配置示例
|
||
|
||
#### TCP代理配置
|
||
```toml
|
||
[[sites."ws.example.com".routes]]
|
||
type = "tcp_proxy"
|
||
path_pattern = "/ws/*"
|
||
target = "ws://websocket-server:8080"
|
||
protocol = "websocket" # tcp, websocket, http
|
||
```
|
||
|
||
#### 负载均衡配置
|
||
```toml
|
||
[[sites."api.example.com".routes]]
|
||
type = "reverse_proxy"
|
||
path_pattern = "/api/*"
|
||
target = "http://primary-backend"
|
||
|
||
[sites."api.example.com".routes.load_balancer]
|
||
strategy = "least_connections"
|
||
upstreams = [
|
||
"http://backend1:3000",
|
||
"http://backend2:3000",
|
||
"http://backend3:3000"
|
||
]
|
||
weights = [3, 2, 1] # 权重配置
|
||
```
|
||
|
||
#### 健康检查配置
|
||
```toml
|
||
[health_check]
|
||
interval = 30 # 检查间隔（秒）
|
||
timeout = 5 # 超时时间（秒）
|
||
path = "/health" # 健康检查路径
|
||
expected_status = 200 # 期望的状态码
|
||
```
|
||
|
||
## [0.1.0] - 2025-01-15
|
||
|
||
### 新增
|
||
- 🏗️ **基础HTTP服务器框架**
|
||
- 基于axum的异步服务器
|
||
- 支持多站点托管
|
||
- 基于Host头的路由
|
||
- 📁 **静态文件服务**
|
||
- 自动MIME类型检测
|
||
- 索引文件支持
|
||
- 目录访问控制
|
||
- 🔀 **反向代理**
|
||
- HTTP请求转发
|
||
- 头部重写和传递
|
||
- 请求/响应体转发
|
||
- ⚙️ **配置系统**
|
||
- TOML格式支持
|
||
- JSON格式支持
|
||
- 配置验证机制
|
||
- 🧙 **JavaScript配置基础**
|
||
- JS配置文件解析 (简化版)
|
||
- 与TOML/JSON配置集成
|
||
|
||
### 技术细节
|
||
|
||
#### 依赖
|
||
- `tokio` - 异步运行时
|
||
- `axum` - HTTP框架
|
||
- `hyper` - HTTP实现
|
||
- `reqwest` - HTTP客户端
|
||
- `serde` - 序列化/反序列化
|
||
- `toml` - TOML解析
|
||
- `mime_guess` - MIME类型检测
|
||
- `tower-http` - HTTP服务工具
|
||
- `tracing` - 日志记录
|
||
|
||
#### 项目结构
|
||
```
|
||
rhttpd/
|
||
├── src/
|
||
│ ├── main.rs # 应用程序入口
|
||
│ ├── lib.rs # 库根
|
||
│ ├── config/ # 配置管理
|
||
│ ├── server/ # 服务器实现
|
||
│ ├── proxy/ # 代理功能
|
||
│ └── js_engine/ # JavaScript集成
|
||
├── tests/ # 集成测试
|
||
├── doc/ # 文档和需求
|
||
├── public/ # 静态文件示例
|
||
├── static/ # 静态文件示例
|
||
├── config.toml # TOML配置示例
|
||
├── config.js # JavaScript配置示例
|
||
├── README.md # 项目文档
|
||
├── AGENTS.md # 开发者指南
|
||
├── roadmap.md # 开发路线图
|
||
└── CHANGELOG.md # 变更日志
|
||
```
|
||
|
||
#### 测试结果
|
||
- ✅ 3个单元测试通过
|
||
- ✅ 2个集成测试通过
|
||
- ✅ 所有代码符合clippy规范
|
||
- ✅ 项目可正常构建和运行
|
||
|
||
### 配置示例
|
||
|
||
#### 基本配置
|
||
```toml
|
||
port = 8080
|
||
|
||
[sites."example.com"]
|
||
hostname = "example.com"
|
||
|
||
[[sites."example.com".routes]]
|
||
type = "static"
|
||
path_pattern = "/*"
|
||
root = "./public"
|
||
index = ["index.html"]
|
||
|
||
[[sites."example.com".routes]]
|
||
type = "reverse_proxy"
|
||
path_pattern = "/api/*"
|
||
target = "http://localhost:3000"
|
||
```
|
||
|
||
#### JavaScript配置示例
|
||
```javascript
|
||
export default {
|
||
port: 8080,
|
||
sites: {
|
||
"api.example.com": {
|
||
hostname: "api.example.com",
|
||
routes: [
|
||
{
|
||
type: "reverse_proxy",
|
||
path_pattern: "/v1/*",
|
||
target: "http://localhost:3001",
|
||
rewrite: {
|
||
"^/v1": "/api/v1"
|
||
}
|
||
}
|
||
]
|
||
},
|
||
"static.example.com": {
|
||
hostname: "static.example.com",
|
||
routes: [
|
||
{
|
||
type: "static",
|
||
path_pattern: "/*",
|
||
root: "./static",
|
||
index: ["index.html"]
|
||
}
|
||
]
|
||
}
|
||
},
|
||
|
||
// JavaScript中间件示例
|
||
middleware: async function(req) {
|
||
console.log(`Request: ${req.method} ${req.url}`);
|
||
return null; // 返回null继续处理，或返回Response直接响应
|
||
}
|
||
};
|
||
```
|
||
|
||
### 使用示例
|
||
|
||
#### 启动服务器
|
||
```bash
|
||
# 使用默认配置
|
||
cargo run
|
||
|
||
# 使用指定配置文件
|
||
cargo run -- config.toml
|
||
|
||
# 使用JavaScript配置
|
||
cargo run -- config.js
|
||
```
|
||
|
||
#### 测试
|
||
```bash
|
||
# 运行所有测试
|
||
cargo test
|
||
|
||
# 运行单个测试
|
||
cargo test test_name
|
||
|
||
# 代码检查
|
||
cargo clippy
|
||
|
||
# 代码格式化
|
||
cargo fmt
|
||
|
||
# 文档生成
|
||
cargo doc --open
|
||
```
|
||
|
||
---
|
||
|
||
## 版本说明
|
||
|
||
### 版本号规则
|
||
- **主版本号**: 不兼容的API修改
|
||
- **次版本号**: 向下兼容的功能性新增
|
||
- **修订号**: 向下兼容的问题修正
|
||
|
||
### 发布周期
|
||
- **主版本**: 根据需要发布
|
||
- **次版本**: 每季度发布
|
||
- **修订版**: 根据需要发布
|
||
|
||
### 分支策略
|
||
- **main**: 稳定版本
|
||
- **develop**: 开发版本
|
||
- **feature/***: 功能分支
|
||
|
||
---
|
||
|
||
*最后更新: 2025年1月15日* |