puniyu_server

puniyu Web服务器模块

概述

puniyu_server 是 puniyu 项目中的 Web 服务器核心库，基于 actix-web 框架构建。它提供了 HTTP 服务器的启动、日志记录、访问日志中间件等核心功能。

核心功能

服务器启动

• run_server: 启动 HTTP 服务器的主函数
• run_server_spawn: 在后台线程中启动 HTTP 服务器

服务器配置：

• 默认监听地址：127.0.0.1:33720
• 可通过环境变量 HTTP_HOST 和 HTTP_PORT 自定义
• 支持通过参数指定监听地址和端口

日志系统

• log_init: 初始化日志系统
• 支持环境变量配置日志级别
• 提供统一的日志宏：info!、warn!、error!、debug!

日志配置：

• 默认日志级别：info
• 可通过 LOGGER_LEVEL 环境变量设置
• 日志前缀统一为 Server

中间件

AccessLog 中间件

记录 HTTP 请求访问日志：

• 记录请求方法、路径、响应状态码
• 记录请求处理耗时（毫秒）
• 记录客户端 IP 地址
• 支持从 HTTP 头部解析真实客户端 IP（X-Forwarded-For、X-Real-IP、True-Client-Ip）

NormalizePath 中间件

标准化请求路径：

• 自动处理尾部斜杠
• 统一路径格式

项目结构

src/
├── lib.rs          # 库导出模块
├── main.rs         # 主程序入口
├── server.rs       # 服务器核心逻辑
├── logger.rs       # 日志系统
├── middleware/     # 中间件模块
│   └── logger.rs   # 访问日志中间件

环境变量配置

• HTTP_HOST: 服务器监听地址（默认：127.0.0.1）
• HTTP_PORT: 服务器监听端口（默认：33720）
• LOGGER_LEVEL: 日志级别（默认：info）
• LOGGER_ENABLE: 日志启用开关（默认：info）

特性

• 异步支持: 基于 tokio 异步运行时
• 高性能: 使用 actix-web 框架提供高性能 HTTP 服务
• 可配置: 支持环境变量和参数配置
• 日志记录: 完整的访问日志和应用日志
• IP 解析: 智能解析真实客户端 IP 地址
• 路径标准化: 自动处理 URL 路径格式

示例响应

服务器启动后，默认在根路径 / 返回 "Hello World!" 响应。

许可证

本项目采用 LGPL 许可证。