# TinyWebServer **Repository Path**: dekao_nous/tiny-web-server ## Basic Information - **Project Name**: TinyWebServer - **Description**: cppweb服务器 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-12-07 - **Last Updated**: 2025-12-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: Cpp ## README # TinyWebServer #### 介绍 TinyWebServer 是基于 Windows 平台 WinSock2 实现的轻量级多线程 Web 服务器,核心采用线程池模型处理客户端并发请求,仅面向本地学习、调试和性能测试场景设计,未适配外网部署,可快速验证多线程网络编程、HTTP 协议基础及并发性能。 #### 软件架构 1. **核心分层** - 网络层:基于 WinSock2 实现套接字生命周期管理(初始化、创建、绑定、监听、接受连接、数据收发),绑定 `127.0.0.1:8080` 仅提供本地访问; - 并发层:线程池(ThreadPool)预创建固定工作线程(默认4个),避免频繁线程创建/销毁开销,将客户端连接封装为异步任务处理; - 业务层:读取本地 HTML 文件、动态替换页面状态变量(连接数、服务器启动时间)、构造符合 HTTP/1.1 规范的响应内容。 2. **核心流程** ``` 初始化WinSock2 → 创建监听套接字 → 绑定IP/端口 → 监听连接 → 主循环accept接收客户端连接 → 连接任务丢入线程池 → 读取HTML/构造HTTP响应 → 发送响应 → 优雅关闭套接字 ``` 3. **依赖组件** - 系统库:ws2_32.lib(Windows 套接字库); - 自定义模块:readHtml.h(HTML 文件读取)、http_res.h(HTTP 响应构造)、thread_pool.h(线程池实现)。 #### 安装教程 1. 环境准备 - 操作系统:Windows 10; - 编译器:MSVC(Visual Studio 2026+); - 依赖文件:将 `index.html`(静态页面)、自定义头文件(readHtml.h/http_res.h/thread_pool.h)置于项目根目录。 2. 编译步骤(MSVC) - 打开 Visual Studio,创建空项目,添加 `main.cpp` 及所有自定义头文件/源文件; - 右键项目 → 属性 → 链接器 → 输入 → 附加依赖项,添加 `ws2_32.lib`; - 选择 Debug/Release 模式,点击“生成”完成编译。 3. 编译步骤(MinGW) - 打开终端,进入项目根目录,执行编译命令: ```bash g++ main.cpp -o TinyWebServer.exe -lws2_32 -std=c++11 ``` #### 使用说明 1. 启动服务器 - 双击编译生成的 `TinyWebServer.exe`,控制台输出 `服务器启动成功!正在监听 127.0.0.1:8080...` 即启动完成; - 本地验证:打开浏览器访问 `http://127.0.0.1:8080`,可查看 `index.html` 页面内容。 2. 压力测试(ab测试) - 安装 Apache Bench 工具(或集成 Apache 环境); - 打开终端,执行测试命令(示例:1000总请求,10并发): ```bash ab -n 1000 -c 10 http://127.0.0.1:8080/ ``` - 查看测试结果:重点关注吞吐量(Requests per second)、失败请求数,验证并发处理能力。 3. 注意事项 - 确保 `index.html` 与可执行文件同目录,否则会返回HTML读取失败提示; - 测试失败请求数非0时,需检查 HTTP 响应头 `Content-Length` 与实际响应体长度是否一致。 #### 参与贡献 1. Fork 本仓库 2. 新建 Feat_xxx 分支 3. 提交代码 4. 新建 Pull Request ## 许可证 本项目基于 **MIT License** 开源,[查看完整许可证文本](LICENSE)。 **授权范围**: - ✅ 允许商用、修改、分发、私人使用 - ❗ 无责任担保,使用本项目产生的风险由使用者自行承担 - ⚠️ 分发或修改后的衍生项目,需保留原版权声明和许可证文件