简介本资源是南京信息工程大学计算机网络课程设计的完整实践项目面向高校计算机及相关专业学生聚焦Socket编程在局域网通信中的典型应用解决TCP连接管理、多线程并发处理、文件分包传输等核心实践难点。压缩包为ZIP格式大小5.09MB含客户端/服务器源码、可执行程序、课程设计报告含需求分析、系统设计、测试记录与性能讨论等关键内容代码以Java或Python实现依据常见教学实践推断报告详述了一对一私聊、群聊广播机制及文件收发的实现逻辑与优化思路。已有327人学习下载适合开展网络编程实训、课程设计参考或毕业设计基础复用。读者可直接部署运行深入理解Socket底层通信模型、线程池管理策略及文件流在网络传输中的分块重组机制同时获得结构清晰、文档完备的工程级学习范例。1. 这不是“写个聊天框”就能交差的课设Socket局域网通信软件必须直面真实网络约束南京信息工程大学计算机网络课程设计要求实现一个具备一对一、群聊、文件传输能力的局域网通信软件——这远不止是调用socket.socket()然后send()recv()的练习。学生常在验收时卡在「服务端启动失败」「客户端连不上」「发中文乱码」「传大文件卡死」根本原因在于忽略了局域网通信的真实约束IPv4地址绑定策略、TCP连接生命周期管理、多客户端并发模型选择、应用层协议边界定义、文件分块与校验机制。本项目本质是 TCP Socket 编程的完整闭环实践覆盖从 socket 创建、bind/listen/accept 到 send/recv 阻塞控制、心跳保活、消息粘包拆包、文件流式传输的全链路。适合已完成《计算机网络》前六章物理层到传输层、熟悉 Python 或 C 语言基础、但尚未独立完成过跨进程网络通信的学生。它不依赖公网或云服务所有功能在宿舍同一 WiFi 下的两台笔记本之间即可验证但每一步都必须经得起netstat -an | grep :端口号和tcpdump -i any port 端口号的检验。2. 用 Python socket 在本地跑通最小可运行的一对一通信链路要让课设不卡在第一步必须先剥离 UI 和多用户逻辑构建一个可调试、可抓包、可复现的最小通信单元。核心不是“能发消息”而是“能精确控制连接状态、数据流向和错误路径”。2.1 服务端显式绑定本机局域网 IP拒绝 127.0.0.1 的陷阱很多学生直接s.bind((127.0.0.1, 8080))结果客户端从另一台电脑连不上——这是最典型的错误。127.0.0.1是回环地址仅限本机通信。局域网通信必须绑定本机真实 IPv4 地址如192.168.3.105或0.0.0.0监听所有接口。获取本机局域网 IP 的可靠方式不是ifconfig手动抄而是用 Python 动态解析import socket def get_local_ip(): 获取本机默认路由对应的局域网IP避免硬编码 try: # 创建一个 UDP socket 并连接到一个外部地址不实际发送数据 s socket.socket(socket.AF_INET, socket.SOCK_DGRAM) s.connect((8.8.8.8, 80)) # Google DNS仅用于触发路由查找 ip s.getsockname()[0] s.close() return ip except Exception: return 127.0.0.1 # 失败时降级但需在日志中警告 SERVER_IP get_local_ip() SERVER_PORT 8080 print(f服务端将监听于: {SERVER_IP}:{SERVER_PORT}) # 创建 TCP socket server_socket socket.socket(socket.AF_INET, socket.SOCK_STREAM) server_socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) # 关键允许端口重用 try: server_socket.bind((SERVER_IP, SERVER_PORT)) server_socket.listen(1) print(f[服务端] 已启动等待客户端连接...) client_socket, client_addr server_socket.accept() print(f[服务端] 接收到来自 {client_addr} 的连接) # 简单收发一次文本 data client_socket.recv(1024).decode(utf-8) print(f[服务端] 收到: {data}) client_socket.send(f服务端已收到: {data}.encode(utf-8)) except OSError as e: if Address already in use in str(e): print(f错误: 端口 {SERVER_PORT} 已被占用请检查是否重复运行或使用 netstat -an | grep {SERVER_PORT}) elif Cannot assign requested address in str(e): print(f错误: 绑定地址 {SERVER_IP} 无效请确认本机局域网IP是否正确运行 ipconfig/ifconfig 查看) else: print(f其他 socket 错误: {e}) finally: server_socket.close()提示SO_REUSEADDR是关键参数它允许 TIME_WAIT 状态的 socket 端口被立即重用避免修改代码后频繁遇到Address already in use错误。get_local_ip()函数比socket.gethostbyname(socket.gethostname())更可靠后者在某些系统上会返回127.0.0.1。2.2 客户端主动连接服务端 IP而非 localhost客户端必须明确指定服务端的局域网 IP不能写localhost或127.0.0.1import socket CLIENT_IP 192.168.3.105 # 此处填服务端机器的实际局域网IP CLIENT_PORT 8080 client_socket socket.socket(socket.AF_INET, socket.SOCK_STREAM) try: client_socket.connect((CLIENT_IP, CLIENT_PORT)) print(f[客户端] 已连接至 {CLIENT_IP}:{CLIENT_PORT}) msg Hello from Client! client_socket.send(msg.encode(utf-8)) response client_socket.recv(1024).decode(utf-8) print(f[客户端] 收到响应: {response}) except ConnectionRefusedError: print(f错误: 无法连接到 {CLIENT_IP}:{CLIENT_PORT}请确认服务端已运行且防火墙未阻止) except socket.timeout: print(错误: 连接超时请检查IP地址和端口是否正确以及两台机器是否在同一局域网) except Exception as e: print(f连接异常: {e}) finally: client_socket.close()2.2.1 验证通信是否真正走局域网用 tcpdump 抓包确认在服务端机器上执行sudo tcpdump -i any port 8080 -w chat_debug.pcap然后运行客户端。停止抓包后用 Wireshark 打开chat_debug.pcap应看到源 IP 是客户端局域网地址如192.168.3.106目的 IP 是服务端局域网地址如192.168.3.105而不是127.0.0.1。若看到127.0.0.1说明客户端或服务端仍绑定了回环地址必须修正。2.2.2 常见错误error: listen tcp 127.0.0.1:11434: bind: only one usage of each socket address深度解析该错误对应热词中的error: listen tcp 127.0.0.1:11434: bind: only one usage of each socket addre本质是端口被占用。但学生常误以为是“程序没关干净”其实更深层原因是同一端口被另一个进程如上次未退出的服务端、IDE 的调试进程、甚至 Docker 容器占用服务端程序崩溃退出但 socket 处于TIME_WAIT状态Linux 默认 60 秒此时SO_REUSEADDR可解绑定地址错误bind((127.0.0.1, 8080))成功但客户端却试图连192.168.3.105:8080导致连接被拒绝而错误信息被误读为 bind 失败。诊断命令# 查看谁占用了8080端口 lsof -i :8080 # macOS / Linux netstat -ano | findstr :8080 # Windows # 查看本机所有监听的TCP端口及状态 netstat -tuln | grep :80803. 从一对一到群聊用 select 实现单线程多客户端并发模型课程设计要求“群聊”意味着一个服务端需同时处理多个客户端连接。学生易陷入两个误区一是用多线程/多进程增加复杂度且非网络课设重点二是用阻塞accept()recv()导致新连接被挂起。select是最契合本科教学的方案——它不引入新线程清晰展示 I/O 多路复用本质且完全基于标准库。3.1 select 模型核心逻辑一个循环三类 socket 集合select允许程序同时监控多个 socket 的可读、可写、异常状态。服务端需维护三个集合inputs: 所有需要监听“可读事件”的 socket包括server_socket等待新连接和所有已建立的client_socket等待接收数据outputs: 所有需要监听“可写事件”的 socket即有数据待发送的客户端连接message_queues: 为每个客户端维护一个queue.Queue缓存待发送的消息。import socket import select import queue import sys # 初始化服务端 socket server_socket socket.socket(socket.AF_INET, socket.SOCK_STREAM) server_socket.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1) server_socket.bind((0.0.0.0, 8080)) # 监听所有接口 server_socket.listen(5) print([群聊服务端] 启动成功等待连接...) # 初始化 select 所需的数据结构 inputs [server_socket] outputs [] message_queues {} while inputs: # 阻塞等待任一 socket 就绪 readable, writable, exceptional select.select(inputs, outputs, inputs) # 处理可读 socket for s in readable: if s is server_socket: # 新连接请求 client_socket, client_address s.accept() print(f[新连接] {client_address}) client_socket.setblocking(0) # 设为非阻塞配合 select inputs.append(client_socket) message_queues[client_socket] queue.Queue() else: # 已有连接发来数据 try: data s.recv(1024) if data: # 解析消息约定格式为 TO:all|user123|user456;MSG:hello msg_str data.decode(utf-8).strip() if msg_str.startswith(TO:): # 提取目标和内容 parts msg_str.split(;, 1) to_part parts[0][3:] # 去掉 TO: msg_part parts[1][4:] if len(parts) 1 else # 广播给所有在线用户除自己 for target_socket in inputs[1:]: # 跳过 server_socket if target_socket is not s and target_socket in message_queues: full_msg f[{client_address[0]}]: {msg_part} message_queues[target_socket].put(full_msg.encode(utf-8)) if target_socket not in outputs: outputs.append(target_socket) else: # 默认广播 for target_socket in inputs[1:]: if target_socket is not s and target_socket in message_queues: full_msg f[{client_address[0]}]: {msg_str} message_queues[target_socket].put(full_msg.encode(utf-8)) if target_socket not in outputs: outputs.append(target_socket) else: # 客户端关闭连接 print(f[断开连接] {s.getpeername()}) if s in outputs: outputs.remove(s) inputs.remove(s) s.close() del message_queues[s] except ConnectionResetError: print(f[强制断开] {s.getpeername()}) if s in outputs: outputs.remove(s) inputs.remove(s) s.close() if s in message_queues: del message_queues[s] # 处理可写 socket发送队列中的消息 for s in writable: try: next_msg message_queues[s].get_nowait() except queue.Empty: outputs.remove(s) else: s.send(next_msg) # 处理异常 socket for s in exceptional: print(f[异常] {s.getpeername()}) inputs.remove(s) if s in outputs: outputs.remove(s) s.close() if s in message_queues: del message_queues[s]3.2 客户端群聊逻辑发送带目标标识的消息客户端需支持向“all”或指定用户发送。消息格式必须严格约定这是应用层协议的基础# 客户端发送函数示例 def send_message(sock, target, content): target: all 或具体用户名此处简化为IP实际可用昵称映射 content: 文本内容 msg fTO:{target};MSG:{content} sock.send(msg.encode(utf-8)) # 使用示例 send_message(client_socket, all, 大家好我是新同学) send_message(client_socket, 192.168.3.106, 私聊消息) # 发送给特定IP注意select模型下recv()必须是非阻塞的setblocking(0)否则会阻塞整个循环。message_queues是核心它解耦了“接收”和“发送”避免send()阻塞导致无法处理新消息。3.3 群聊的关键参数与边界处理参数/场景推荐值/做法为什么select超时时间select.select(inputs, outputs, inputs, 1.0)中设为1.0秒避免无限阻塞保证服务端能定期检查连接状态、清理僵尸连接单次recv缓冲区大小1024字节UTF-8 下约 300 中文字符过小导致频繁系统调用过大可能一次读取多条消息粘包需后续拆包逻辑客户端断线检测依赖recv()返回空字节b或ConnectionResetError异常TCP 连接关闭时对端close()会触发此信号是唯一可靠的断线标志消息长度限制应用层限制单条消息 ≤ 4096 字节超长则截断并返回错误提示防止恶意客户端发送超长消息耗尽服务端内存符合课设稳健性要求4. 发送文件用定长头部 流式传输解决大文件阻塞与校验问题“发送文件”是课设中最易出错的部分。学生常把整个文件read()进内存再send()导致 100MB 文件直接 OOM或忽略 TCP 的流式特性导致接收端recv(1024)无法判断文件何时结束。必须采用“定长头部 分块传输”模式。4.1 文件传输协议设计4 字节长度头 原始文件流定义一个极简但可靠的协议头部Header4 字节无符号整数struct.pack(!I, file_size)表示后续文件内容的总字节数主体Body原始文件二进制流按4096字节分块发送。import struct def send_file(sock, filepath): 发送文件先发4字节长度头再发文件流 try: with open(filepath, rb) as f: file_data f.read() # 构造头部文件大小大端序4字节 file_size len(file_data) header struct.pack(!I, file_size) # 发送头部 sock.sendall(header) print(f[发送文件] 头部已发送文件大小: {file_size} 字节) # 发送文件主体 sock.sendall(file_data) print(f[发送文件] 文件发送完成) except FileNotFoundError: print(f错误: 文件 {filepath} 不存在) sock.sendall(struct.pack(!I, 0)) # 发送0大小表示错误 except Exception as e: print(f发送文件异常: {e}) sock.sendall(struct.pack(!I, 0)) # 客户端调用示例 # send_file(client_socket, ./report.pdf)4.2 服务端接收文件严格按头部长度读取避免粘包接收端必须严格遵循协议先读 4 字节头再按头中长度读取主体def recv_file(sock, save_path): 接收文件先收4字节头再按长度收主体 try: # 接收头部4字节 header_bytes b while len(header_bytes) 4: chunk sock.recv(4 - len(header_bytes)) if not chunk: raise ConnectionError(连接意外关闭) header_bytes chunk # 解析文件大小 file_size struct.unpack(!I, header_bytes)[0] if file_size 0: print([接收文件] 服务端返回错误文件不存在或读取失败) return False print(f[接收文件] 将接收 {file_size} 字节的文件...) # 接收文件主体 received 0 with open(save_path, wb) as f: while received file_size: # 每次最多读 4096 字节 chunk_size min(4096, file_size - received) chunk sock.recv(chunk_size) if not chunk: raise ConnectionError(连接中断文件接收不完整) f.write(chunk) received len(chunk) print(f[接收文件] 文件已保存至: {save_path}) return True except struct.error as e: print(f[接收文件] 头部解析错误: {e}) return False except Exception as e: print(f[接收文件] 接收异常: {e}) return False # 服务端在 select 循环中调用当收到特殊指令如 FILE:report.pdf 时 # recv_file(client_socket, ./received_report.pdf)4.2.1 为什么必须用sendall()和循环recv()send()不保证一次发送全部数据尤其大文件时会返回已发送字节数需循环调用recv(n)最多返回n字节但可能少于n如网络延迟、缓冲区满必须循环直到收满指定字节数sendall()和手动循环recv()是处理大数据的基石课设报告中必须体现此细节。4.2.2 文件传输的健壮性增强点课设加分项增强点实现方式课设价值文件名传递在头部后增加一个变长字符串头如!I!Hfilename_bytes先读长度再读文件名解决接收端不知道保存为何名的问题体现协议设计能力MD5 校验发送端计算文件 MD5随文件一起发送如追加在文件尾接收端边写边计算最后比对防止传输过程损坏是网络通信可靠性的核心指标报告中可画校验流程图断点续传简化版记录已接收字节数下次从该位置继续seek()读取需客户端发送RESUME:offset指令展示对 TCP 字节流特性的深入理解远超基础要求进度反馈服务端每接收1024*1024字节1MB向客户端发一条PROGRESS:50消息客户端 UI 更新进度条提升用户体验是群聊软件实用性的体现报告中可截图展示进度条效果5. 课设报告撰写与答辩核心聚焦协议设计、错误处理与抓包验证课程设计报告不是代码说明书而是你作为网络工程师解决问题的思维记录。评审老师最关注三点你是否理解 TCP 的本质约束、是否设计了可验证的应用层协议、是否用工具证实了通信真实发生。以下为报告核心章节建议与答辩话术。5.1 报告必须包含的三大技术图表5.1.1 应用层消息协议格式表必写字段名长度类型说明MSG_TYPE1 字节ASCIIT(Text),F(File),P(Private)TARGET变长UTF-8目标标识all或客户端 IP以;结尾CONTENT变长UTF-8文本内容或文件路径FILE:./a.txt或文件数据F类型时CHECKSUM4 字节HexCRC32 校验值可选但强烈建议加入以体现可靠性设计答辩话术“我们没有使用 JSON 或 XML因为课设要求轻量高效。这个纯文本协议用;分隔字段用首字母标识类型既便于人工调试telnet 可直连测试又可通过split(;)快速解析符合 Socket 编程‘简单即可靠’的原则。”5.1.2select事件循环状态转换图手绘扫描件更佳用方框和箭头描述inputs集合变化server_socket→accept()→client_socket加入outputs集合变化message_queues非空 →client_socket加入 →send()后清空 → 移出exceptional处理recv()报错 →client_socket从inputs/outputs移除。答辩话术“select不是魔法它只是操作系统提供的 I/O 通知机制。我们的循环里每一个append和remove操作都对应真实的网络事件比如客户端拔网线recv()会立刻返回空我们就在readable分支里把它从所有集合中干净地移除——这才是真正的连接管理。”5.1.3 tcpdump 抓包分析截图关键截取三张图图1tcpdump -i any port 8080 and tcp[tcpflags] tcp-syn ! 0—— 显示三次握手图2tcpdump -i any port 8080 -A -s 0 | grep TO:all—— 显示明文消息协议图3tcpdump -i any port 8080 -x | head -20—— 显示十六进制头部圈出00 00 00 64十进制 100即文件大小。答辩话术“这些不是教科书上的示意图是我们在宿舍实测时用tcpdump抓下的真实数据包。您看这张图00 00 00 64就是我们协议里定义的 4 字节文件长度头它证明了我们的程序没有把文件当普通文本发而是严格遵循了二进制协议——这正是计算机网络课的核心让比特流按你的意志流动。”5.2 答辩高频问题预判与回答要点问题回答要点简洁、技术、不绕弯“为什么不用多线程”“select单线程模型更清晰暴露 TCP 连接状态机避免线程安全和锁竞争问题符合本科网络课‘理解本质’的目标。多线程是工程优化不是协议学习。”“粘包怎么解决的”“我们不依赖recv(1024)的返回长度而是用协议定义边界文本消息用;分隔文件传输用 4 字节定长头。select循环确保每次只处理一个完整消息单元。”“如果客户端发超长消息怎么办”“服务端recv(1024)后先解析;找到完整MSG:字段剩余数据缓存在临时 buffer下次recv()继续拼接。报告第 3.2 节有详细 buffer 管理伪代码。”“如何保证文件不损坏”“发送端计算文件 CRC32追加在文件数据末尾接收端边写边计算最后比对。我们提供了verify_file_crc()函数报告附录有校验结果截图。”“防火墙阻止了怎么办”“课设明确要求局域网我们测试环境关闭了 Windows Defender 防火墙的‘专用网络’规则。若必须开启只需在防火墙设置中放行 TCP 端口 8080——这恰恰是网络管理员的真实工作场景。”提示答辩时把tcpdump截图、netstat输出、lsof结果打印出来放在手边。当老师问“你确定连上了吗”直接递上截图说“您看这是实时抓的包源 IP 和目的 IP 都是真实的局域网地址不是 127.0.0.1。”本文还有配套的精品资源点击获取