小鹿快传 - 高效P2P文件传输完整使用指南

🚀 项目概览与技术亮点

小鹿快传（DeerShare） 是一款创新的Web端P2P文件共享工具，通过先进的WebRTC技术实现浏览器间的直接文件传输。该项目完美融合了现代Web开发技术栈，为文件分享提供了全新的体验。

核心技术架构

• 🌐 WebRTC直连传输 - 实现端到端加密传输，无需服务器中转
• ⚡ WebSocket实时通信 - 确保传输状态实时同步
• 🎨 React现代化界面 - 提供流畅的用户交互体验
• 🔧 Node.js后端支持 - 稳定可靠的服务端处理

📦 快速安装部署指南

环境准备

在开始前，请确保您的系统已安装：

• Node.js 14.x 或更高版本
• Git版本控制工具
• Yarn包管理工具（推荐）

一键式安装步骤

1. 获取项目源码

git clone https://gitcode.com/gh_mirrors/de/deershare
cd deershare

2. 安装服务端依赖

cd server
yarn install

3. 安装客户端依赖

cd ../client
yarn install

4. 启动应用服务

# 启动服务端
cd ../server && npm start

# 启动客户端（新终端）
cd ../client && npm start

5. 访问应用 打开浏览器访问 https://localhost:3000 即可体验

应用界面展示

⚙️ 个性化配置说明

服务端配置

配置文件位置：server/config/

• 服务端口设置（默认3001）
• 静态资源路径配置
• 日志格式定制

客户端配置

配置文件位置：client/src/config/

• Webpack构建配置
• 开发和生产环境配置
• 模块解析路径设置

🎯 核心功能特性

文件传输组件

• FileChunker - 文件分块处理
• Peer连接管理 - P2P连接建立和维护
• 实时状态监控 - 传输进度实时更新

用户界面组件

• 发送文件面板 - 简洁的文件选择界面
• 接收文件面板 - 清晰的传输状态显示
• 模态对话框 - 友好的用户交互体验

💡 使用技巧与最佳实践

• 使用最新版本浏览器获得最佳性能
• 确保网络环境允许P2P连接
• 大文件传输建议使用稳定网络环境
• 定期清理传输记录保持应用性能

🛠️ 开发与调试

项目采用模块化架构设计，主要代码结构：

deershare/
├── server/          # 服务端代码
│   ├── config/      # 配置文件
│   ├── src/         # 源代码
│   └── public/      # 静态资源
└── client/          # 客户端代码
    ├── src/         # React组件
    └── config/      # 构建配置

📊 性能优化建议

• 启用gzip压缩提升传输效率
• 配置合适的WebSocket心跳间隔
• 优化文件分块大小平衡传输性能
• 使用CDN加速静态资源加载

🔒 安全注意事项

• 传输过程中文件采用端到端加密
• 定期更新依赖包修复安全漏洞
• 配置合适的CORS策略
• 监控WebSocket连接状态

🎉 现在您已经掌握了小鹿快传的完整使用方法！开始享受安全、高效的文件传输体验吧！