基于 C++ 的本地文件共享工具 DirectoryServer 使用指南

安装与使用指南

快捷使用：Windows 系统下下载 exe 即可使用。

一键构建（推荐给开发者）

# 克隆仓库
git clone https://github.com/Jarrettluo/DirectoryServer.git
cd DirectoryServer
# 运行构建脚本
build.bat
# 自动编译并启动应用！

使用步骤

1. 选择目录
   • 点击'浏览...'按钮
   • 选择要共享的文件夹
2. 启动服务器
   • 点击'▶ 启动服务器'按钮
   • 系统自动分配端口（默认 8080）
3. 访问文件
   • 在浏览器中输入显示的 URL（如：http://192.168.1.100:8080）
   • 开始浏览和下载文件！
4. 停止服务
   • 点击'⏹ 停止服务器'
   • 安全关闭连接

实际应用场景

📱 移动设备访问电脑文件

• 在沙发上用手机查看电脑里的电影
• 用平板预览设计稿，实时反馈修改意见
• 会议中快速分享演示文稿给所有参会者

👥 团队协作与文件共享

1. 项目负责人共享项目目录
2. 组员通过浏览器访问最新文件
3. 实时下载需要的资源
4. 无需反复传输文件，提高效率

🏠 家庭媒体中心

• 共享家庭照片和视频库
• 建立个人音乐服务器
• 共享电子书和文档
• 孩子的学习资料共享

技术细节解析

HTTP 服务器核心

// 精简高效的服务器循环
while (running) {
    // 接受客户端连接
    // 解析 HTTP 请求
    // 生成目录列表或提供文件下载
    // 发送 HTTP 响应
}

安全特性

• 本地网络限制：默认仅限局域网访问
• 端口可配置：避免端口冲突
• 无外部依赖：所有代码透明可控

性能优化

• 零拷贝文件传输：高效的内存管理
• 事件驱动架构：低资源占用
• 智能缓存策略：快速响应重复请求

与同类工具对比

开发故事与初衷

该工具旨在解决多设备间同步代码和文档的需求。现有解决方案要么太复杂（如 FTP），要么有速度限制（如网盘），要么需要互联网连接。目标是做一个既简单又高效，而且完全免费的本地文件共享工具。

经过开发，DirectoryServer 诞生了。它完全用 C++ 编写，使用 Windows 原生 API，保证了最佳的性能和系统兼容性。

未来规划

虽然目前版本已经足够实用，后续计划包括：

短期计划（v1.1.0）

• 密码保护功能
• 上传文件支持
• 搜索功能
• 主题自定义

长期愿景

• 多目录同时共享
• 访问日志记录
• 带宽限制控制
• 移动端优化界面

如何获取与贡献

获取代码

git clone https://github.com/Jarrettluo/DirectoryServer.git

反馈与建议

如果您有任何建议或发现了 bug，欢迎在 GitHub 提交 Issue 或 Pull Request，特别是新功能开发、界面改进、性能优化及文档完善。