# CppNet

**Repository Path**: zklmiao/CppNet

## Basic Information

- **Project Name**: CppNet
- **Description**: Easy TCP/UDP cross platform servers program base on cplusplus
- **Primary Language**: C++
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 3
- **Created**: 2021-04-09
- **Last Updated**: 2025-04-01

## Categories & Tags

**Categories**: web-dev-toolkits

**Tags**: None

## README

# CppNet

## CppNet介绍
> 这是一个简易跨平台TCP/UDP服务器程序，仓库会同步每个版本的迭代进度。

- EasyTcpClientGO、1.0-1.2 版本：简易 一对一 winsocket 服务器程序.

- 1.3-1.4 版本：加入跨平台特性,引入 select I/O 多路复模型,服务端加入接收缓冲区,客户端加入接收缓冲区和消息缓冲区,提升服务器客户端整体性能,Windows下服务器可以处理最多64(Linux最大连接数1024)个客户端连接和数据收发.单个客户端可以在Windows下最高可以有64(Linux最大连接数1024)个Socket批量链接服务器并进行简单数据的收发.
- 1.5:突破 Windows 下 select 最大连接数限制,封装服务端/客户端 客户端支持并发连接.
- 1.6 版本: 调整了服务器架构,引入生产者-消费者模型,分离接受连接,数据收发模块.服务端加入多线程和连接缓冲区,提高连接受理速度,引入高精度计时器,服务端可以实时显示当前已连入客户端数量和每秒处理数据包的的数量.
- [BUG:客户端离开时 服务器客户端数量没有及时更新.]
- 1.7 引入事件代理机制,当有客户端离开时,消息处理线程会通知主线程有客户端离开并及时更新客户端列表和客户端计数. 
- Future: 服务端增加发送消息缓冲区. 业务解耦,分离消息发送和消息接收业务. 
- 1.8.0 添加消息发送换缓冲区 定量发送消息(接收到的消息大于大于自定义的发送消息缓冲区时则发送消息,接收到的消息大于大于自定义的发送消息缓冲区时则发送消息).
- [ BUG:没有超时发送功能,若服务端不在接收到消息,且累计接收到的消息中大小小于发送缓冲区大小,则会出现已经接收到的消息无限期滞留在消息发送缓冲区中]
- Futrue:增加超时发送功能,定时发送数据,消息缓冲区未满也会在超时后发送.
- 1.8.1 添加发送任务类、发送任务缓冲队列、发送任务队列和发送线程, 分离发送业务. 
- 1.8.3 加入心跳检测,默认超时时间是300秒,若无数据接收则会自动下线客户端.
- 1.8.5 支持字节流.
- 1.8.6 - 2.0 调整优化代码结构 Select 支持C10K.
- 2.1 自定义数据缓冲区.
- 2.2 加入轻量级日志系统.
- 2.3 完善日志系统.
- 2.4 支持命令脚本启动程序,优化Select 自定义FD_SET.
- 2.5 引入Epoll 支持Epoll 下的C10k.
- 2.6 引入IOCP 支持IOCP 下的C10k.

## 使用教程

1.  下载
2.  解压
3.  启动EasyTcpServer
4.  启动EasyTcpClient

## 使用说明

1.  默认端口:4567
2.  服务端默认Ip:127.0.0.1
3.  命令行启动:
- windows: server.exe/client.exe ip port n [n: 1.服务端可承载连接数量 2.客户端连接数量]
- Linux/Unix: ./server./client ip port n [n: 1.服务端可承载连接数量 2.客户端连接数量]

## 演示程序说明
1."演示程序"文件夹下的EasyTCP 是网络引擎的测试测试程序,双击"EasyTcpServer.exe","EasyTcpClient" 即可启动.

- 默认 ip 127.0.0.1
- 默认端口 4567
- 程序默认配置为客户端"EasyTcpClient" 只发数据,"EasyTcpServer"只收数据.
- 默认发送数据大小为 100字节
- 默认发送频次为 10 pakge/s
- 默认开启日志系统
- 默认开启线程数 4 
- 默认模拟链接客户端数量 4 * 2500


2.通过脚本启动
双击"EasyTcpServer.bat" 启动服务器

双击"EasyTcpClient.bat" 启动模拟客户端.

- 默认 ip 127.0.0.1
- 默认端口 4567
- 程序默认配置为客户端、服务端双向收发数据.
- 默认发送数据大小为 100字节
- 默认发送频次为 10 pakge/s
- 默认开启日志系统
- 默认开启线程数 4 
- 默认模拟链接客户端数量 4 * 2500

> Tip: 详细配置见脚本注释,Windows下用notepad/或其他文本编辑器右键打开即可.

## 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


## 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)