Linux C++项目推荐：文件服务器+如何快速上手

原创

程序员老廖

发布于 2026-01-26 20:06:00

1490

1 本次分享的意义

源码地址：https://github.com/shangguanyongshi/WebFileServer.git

学完C++和Linux编程后，可以以WebFileServer文件服务器作为练手项目，比WebServer项目多了文件上传的功能，更加有意义。

这次分享不单只是讲解这个WebFileServer项目如何运行，也能让大家掌握如何快速掌握自己不熟悉的C++项目。

2 项目功能

Web 文件服务器，通过浏览器发送 HTTP 请求管理服务器指定文件夹下的所有文件。主要功能包括：

以 HTML 页面形式返回该文件夹下的所有文件
可以选择本地文件上传到服务器
可以对列表中的文件文件执行下载操作
可以删除服务器中的指定文件

3 整体框架

使用 Reactor 事件处理模型，通过统一事件源，主线程使用 epoll 监听所有的事件，工作线程负责执行事件的逻辑处理
预先创建线程池，当有事件发生时，加入线程池的工作队列中，使用随机选择算法选择线程池中的一个线程处理工作队列的事件
使用 HTTP GET 方法获取文件列表，发起下载文件、删除文件的请求。使用 POST 方法向服务器上传文件
服务端使用有限状态机对请求消息进行解析，根据解析结果执行操作后，向客户端发送页面、发送文件或发送重定向报文
服务端使用 sendfile 函数实现零拷贝数据发送

4 编译和运行

build 项目

sh ./build.sh

默认的编译不支持调试，可以修改makefile增加-g编译选项。

然后再重新编译，以方便调试代码。

启动文件服务器

./main

在浏览器端输入服务端ip:端口号（端口号默认是8888）

serverip:8888

5 如何快速分析代码

5.1 main函数入口

(gdb) b main
Breakpoint 1 at 0x5555555590ad: file main.cpp, line 3.

5.2 分析网络模型

通过info threads可以看到共有五个线程，其中主线程是调用了epoll，再加上README的讲解可以推断出来这个项目是单个epoll +线程池的模式

* 1    Thread 0x7ffff79a9740 (LWP 339328) "main" 0x00007ffff7c1c68e in epoll_wait (epfd=4, events=0x7fffffffaf14, maxevents=1024, timeout=-1) at ../sysdeps/unix/sysv/linux/epoll_wait.c:30
  2    Thread 0x7ffff79a8700 (LWP 339343) "main" futex_abstimed_wait_cancelable ( ) at ../sysdeps/nptl/futex-internal.h:320
  3    Thread 0x7ffff71a7700 (LWP 339344) "main" futex_abstimed_wait_cancelable ( ) at ../sysdeps/nptl/futex-internal.h:320
  4    Thread 0x7ffff69a6700 (LWP 339345) "main" futex_abstimed_wait_cancelable ( ) at ../sysdeps/nptl/futex-internal.h:320
  5    Thread 0x7ffff61a5700 (LWP 339346) "main" futex_abstimed_wait_cancelable ( ) at ../sysdeps/nptl/futex-internal.h:320

5.3 网络数据收发

5.3.1 数据接收

断点 recv

Thread 4 "main" hit Breakpoint 4, __libc_recv (fd=5, buf=0x7ffff69a5600, len=2048, flags=0) at ../sysdeps/unix/sysv/linux/recv.c:24
24      ../sysdeps/unix/sysv/linux/recv.c: No such file or directory.
(gdb) bt
#0  __libc_recv (fd=5, buf=0x7ffff69a5600, len=2048, flags=0) at ../sysdeps/unix/sysv/linux/recv.c:24
#1  0x000055555555df4a in HandleRecv::process (this=0x55555558bb90) at event/myevent.cpp:38
#2  0x000055555555c114 in ThreadPool::run (this=0x55555558b2b0) at threadpool/threadpool.cpp:114
#3  0x000055555555bc5c in ThreadPool::worker (arg=0x55555558b2b0) at threadpool/threadpool.cpp:77
#4  0x00007ffff7f8a609 in start_thread (arg=<optimized out>) at pthread_create.c:477
#5  0x00007ffff7c1c353 in clone () at ../sysdeps/unix/sysv/linux/x86_64/clone.S:95

很明显，这个项目是在线程池的线程里读取socket 数据并解析解析处理。