FastAPI实现局域网文件共享与剪贴板同步工具

1. 为什么我们需要局域网文件共享工具每次用数据线传输文件时我都忍不住想这都2023年了为什么还要用这么原始的方式特别是当我在办公室和家里多台设备间频繁切换时数据线插拔不仅麻烦还经常遇到驱动不兼容的问题。直到我用FastAPI开发了这个局域网文件共享工具才真正体会到无线传输的便捷。这个工具的核心价值在于完全摆脱数据线束缚同一局域网内的设备自由互传支持文件传输和剪贴板同步两大核心功能基于Python的FastAPI框架开发部署极其简单跨平台支持Windows/Mac/Linux/手机都能用2. 工具整体架构设计2.1 技术选型考量选择FastAPI作为后端框架主要基于以下考虑异步特性适合处理文件上传下载这类IO密集型操作自动生成交互式API文档方便调试和对接性能优异实测单机可轻松支持20设备同时传输前端采用纯HTMLJS实现避免复杂框架带来的依赖问题。剪贴板同步则通过WebSocket实现实时推送。2.2 功能模块划分整个系统包含三个核心模块文件传输服务处理文件的上传、下载和列表查看剪贴板同步服务实时同步文本内容到所有客户端设备发现服务自动识别局域网内运行本工具的设备3. 详细实现步骤3.1 环境准备首先安装必要的Python包pip install fastapi uvicorn python-multipart websockets3.2 文件服务实现核心API路由设计from fastapi import FastAPI, UploadFile, File from fastapi.staticfiles import StaticFiles app FastAPI() # 挂载静态文件目录 app.mount(/files, StaticFiles(directoryshared_files), namefiles) app.post(/upload) async def upload_file(file: UploadFile File(...)): file_location fshared_files/{file.filename} with open(file_location, wb) as file_object: file_object.write(await file.read()) return {filename: file.filename} app.get(/list) async def list_files(): return {files: os.listdir(shared_files)}3.3 剪贴板同步实现WebSocket服务端代码from fastapi import WebSocket from typing import List clients: List[WebSocket] [] app.websocket(/ws) async def websocket_endpoint(websocket: WebSocket): await websocket.accept() clients.append(websocket) try: while True: data await websocket.receive_text() # 广播给所有客户端 for client in clients: await client.send_text(data) except: clients.remove(websocket)客户端JavaScript代码const socket new WebSocket(ws://${location.host}/ws); // 监听剪贴板变化 document.addEventListener(copy, (e) { const text window.getSelection().toString(); socket.send(text); }); // 接收剪贴板更新 socket.onmessage (event) { navigator.clipboard.writeText(event.data); };4. 部署与使用技巧4.1 启动服务使用UVicorn运行服务uvicorn main:app --host 0.0.0.0 --port 8000注意必须指定host为0.0.0.0才能被局域网其他设备访问4.2 设备发现实现通过ARP扫描实现自动发现局域网设备import subprocess def scan_network(): result subprocess.run([arp, -a], capture_outputTrue, textTrue) devices [] for line in result.stdout.split(\n): if ( in line and ) in line: ip line.split(()[1].split())[0] devices.append(ip) return devices4.3 性能优化建议大文件传输时启用分块上传app.post(/upload/chunk) async def upload_chunk(file: UploadFile File(...), chunk_number: int 0): # 实现分块上传逻辑 ...使用内存缓存频繁传输的小文件对剪贴板内容进行差分更新减少网络传输5. 常见问题排查5.1 连接问题问题其他设备无法访问服务解决检查防火墙设置开放8000端口确认设备处于同一局域网尝试使用IP地址直接访问5.2 剪贴板同步延迟问题剪贴板内容同步有延迟解决检查WebSocket连接状态减少剪贴板内容大小建议1MB网络拥堵时优先保障文件传输5.3 文件权限问题问题上传文件失败解决确保shared_files目录有写入权限检查磁盘空间是否充足文件名避免使用特殊字符6. 进阶功能扩展在实际使用中我还添加了这些实用功能传输历史记录记录所有传输过的文件和时间文件预览支持图片、文本的在线预览传输速度限制避免影响其他网络应用密码保护简单的基础认证功能这个工具我已经在团队内部使用半年多完全替代了之前的各种文件传输工具。最让我惊喜的是剪贴板同步功能现在在不同设备间复制粘贴代码片段变得异常方便。对于想要自己部署的朋友建议从基础版本开始逐步添加需要的功能。整个项目代码不到300行但带来的效率提升是实实在在的。