# Reactor-CppServer

**Repository Path**: wwwcyyy/reactor-cpp-server

## Basic Information

- **Project Name**: Reactor-CppServer
- **Description**: No description available
- **Primary Language**: C++
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-17
- **Last Updated**: 2026-03-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Reactor C++ Server

基于 Reactor 模式的高性能 TCP/HTTP 服务器框架。

---

## 🚀 快速开始

### 一键编译启动

```bash
./build.sh        # 编译
./bin/server      # 启动
```

**访问：** http://localhost:10000

**详细运行说明：** [bin/README.md](bin/README.md)

---

## 📦 项目简介

**核心特性：**
- 🎯 Reactor 模式 - 主从多线程架构
- ⚡ IO 多路复用 - epoll/poll/select支持
- 🧵 线程池 - 可配置工作线程数
- 🌐 HTTP 协议 - 完整 HTTP 请求处理

**技术栈：**
- C++11、Linux、TCP/IP、HTTP/1.1

---

## 📁 目录结构

```
reactor-cpp-server/
├── src/           # C++ 源代码
├── include/       # 头文件
├── obj/           # 编译对象
├── bin/           # 可执行文件
│   └── server     # 服务器程序
│   └── README.md  # 运行说明 ⭐
├── www/           # Web 根目录
├── docs/          # 文档资料
├── build.sh       # 编译脚本
└── Makefile       # 构建配置
```

---

## 🛠️ 常用命令

| 命令 | 功能 |
|------|------|
| `./build.sh` | 编译项目 |
| `./build.sh clean` | 清理编译 |
| `./build.sh rebuild` | 重新编译 |
| `./bin/server` | 启动服务器（默认端口） |
| `./bin/server 8080` | 启动服务器（自定义端口） |

**详细说明：** [bin/README.md](bin/README.md)

---

## 📖 文档导航

### 新手入门
- **[bin/README.md](bin/README.md)** - 运行说明 ⭐
- **[docs/QUICKSTART.md](docs/QUICKSTART.md)** - 5 分钟快速开始

### 深入学习
- **[ARCHITECTURE.md](ARCHITECTURE.md)** - 架构设计
- **[docs/STRUCTURE.md](docs/STRUCTURE.md)** - 项目结构
- **[docs/PUBLIC_ACCESS.md](docs/PUBLIC_ACCESS.md)** - 公网访问指南

### 故障排除
- **[docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)** - 故障排除
- **[docs/FIREWALL.md](docs/FIREWALL.md)** - 防火墙手册

---

## ☁️ 云服务器配置

要在云服务器上运行并允许外部访问：

1. **配置云安全组**（必须！）
   - 登录云控制台
   - 添加入站规则：TCP 端口 10000
   - 来源：0.0.0.0/0

2. **启动服务器**
   ```bash
   ./bin/server
   ```

3. **测试访问**
   ```bash
   curl http://<你的公网IP>:10000
   ```

**完整指南：** [docs/PUBLIC_ACCESS.md](docs/PUBLIC_ACCESS.md)

⚠️ **注意：** 项目脚本不会自动配置防火墙，以避免影响其他项目。

---

## 🎨 浏览器演示

启动服务器后访问：http://localhost:10000

展示内容包括：
- 📊 实时状态栏
- 🏗️ 架构图解
- ✨ 核心特性卡片
- 📈 性能指标

**详情：** [docs/DEMO.md](docs/DEMO.md)

---

## 📊 性能指标

| 指标 | 数值 |
|------|------|
| 代码行数 | ~1.5K |
| 默认线程 | 4 |
| 事件分发器 | epoll |
| C++ 标准 | C++11 |
| 平均响应 | <20ms |

---

## 📄 许可证

MIT License

---

**🎉 享受你的 Reactor C++ Server！**