局域网文件分享工具

一个功能强大、界面美观、安全可靠的局域网文件分享解决方案

🌟 功能特色

核心功能

• 📁 文件分享 - 在局域网内快速分享文件和文件夹
• 🔒 密码保护 - 支持设置访问密码，保护隐私文件
• 📱 移动适配 - 完美适配手机、平板等移动设备
• ⚡ 即开即用 - 一键启动，无需复杂配置

界面特色

• 🎨 现代UI - 采用渐变背景、毛玻璃效果、动态粒子等现代设计元素
• 📱 响应式 - 自动适配不同屏幕尺寸，移动端体验优秀
• 🌙 视觉效果 - 悬浮动画、粒子特效、平滑过渡动画
• 📊 二维码 - 自动生成访问二维码，手机扫码即可访问

安全特性

• 🛡️ 防暴力破解 - IP锁定机制，防止密码暴力破解
• 🔐 会话管理 - 安全的会话机制，支持自动过期
• 🚫 路径保护 - 防止目录遍历攻击，确保文件安全
• 🌐 局域网限制 - 仅允许局域网内访问，拒绝外网请求

高级功能

• 📢 公告系统 - 支持在页面显示重要通知或说明
• ⏰ 自动关闭 - 可设置服务运行时间，到期自动关闭
• 🛣️ 自定义路径 - 支持自定义访问路径前缀
• 👀 隐藏文件 - 可选择是否显示隐藏文件
• 🔄 多线程 - 支持多用户同时访问和下载

📋 系统要求

运行环境

• 操作系统: Windows 11 (推荐)
• Python版本: 3.11.0+

依赖库

• qrcode - 二维码生成
• pillow - 图像处理

🚀 快速开始

1. 基础使用

1. 运行脚本，在kuai客户端中配置参数
2. 选择分享目录 - 选择要分享的本地文件夹
3. 设置访问密码 (可选) - 为访问设置密码保护
4. 点击启动，服务器将自动运行

2. 访问方式

• 电脑访问: 直接在浏览器中输入显示的IP地址
• 手机访问: 扫描二维码或手动输入地址
  • ⚠️ 微信用户: 扫码后需点击右上角"用浏览器打开"

⚙️ 参数配置

基础参数

参数名	类型	默认值	说明
分享目录	目录选择	-	要分享的本地目录路径
服务端口	数字输入	18001	HTTP服务器端口号 (1024-65535)
访问密码	密码输入	-	访问文件时需要的密码

高级参数

参数名	类型	默认值	说明
自定义路径	文本输入	share	自定义访问路径前缀
公告通知	多行文本	无	在主页显示的公告信息
显示隐藏文件	开关	关闭	是否显示以.开头的隐藏文件
会话有效期	数字输入	24小时	密码登录后的会话持续时间
服务运行时间	数字输入	120分钟	服务自动关闭时间

参数说明

🛣️ 自定义路径

• 格式: 只能包含字母、数字、下划线和横线
• 示例: 输入 files 后，访问地址变为 http://ip:port/files/
• 用途: 增加访问路径的随机性，提高安全性

📢 公告通知

• 支持: 纯文本，最多500字符
• 显示: 在登录页面和主页顶部显示
• 用途: 发布使用说明、注意事项或重要通知

⏰ 运行时间控制

• 会话有效期: 1-168小时，密码登录后的有效时长
• 服务运行时间: 1-1440分钟，服务自动关闭时间
• 目的: 防止服务长期运行造成安全风险

🔒 安全机制

访问控制

• 局域网限制: 自动识别并拒绝外网IP访问
• 密码保护: 可选的访问密码，支持强密码验证
• 会话管理: 基于签名的安全会话机制

防攻击机制

• 暴力破解防护:
  • 最多允许5次密码错误
  • 错误达到上限后IP被锁定5分钟
  • 自动清理过期的尝试记录
• 路径安全:
  • 防止 ../ 目录遍历攻击
  • 严格的路径验证机制
  • 禁止访问系统关键目录
• CSRF防护: 内置CSRF令牌验证

连接安全

• HTTPS支持: 虽然是HTTP，但在局域网环境相对安全
• 连接监控: 实时监控异常连接和请求
• 错误处理: 完善的异常处理，避免信息泄露

🎨 界面展示

登录页面

• 渐变背景 + 动态粒子效果
• 二维码展示 + 复制链接功能
• 服务状态 + 剩余时间显示
• 公告弹窗 + 使用提示

主页界面

• 3D卡片效果 + 悬浮动画
• 文件浏览入口 + 快捷操作
• 二维码分享 + 访问统计

文件浏览

• 面包屑导航 + 文件图标
• 一键下载 + 目录预览
• 移动端优化 + 触摸友好

📱 移动端优化

自动适配

• 检测设备: 自动识别移动设备并优化显示
• 快速跳转: 移动端直接跳转到文件浏览页面
• 触摸优化: 按钮大小和间距适配触摸操作

微信支持

• 二维码扫描: 支持微信扫码访问
• 外部浏览器: 自动提示使用外部浏览器打开
• 下载支持: 兼容微信浏览器的文件下载

🚨 注意事项

安全提醒

1. 仅限局域网: 此工具仅供局域网内使用，不要暴露到公网
2. 密码保护: 分享敏感文件时务必设置强密码
3. 及时关闭: 使用完毕后及时关闭服务
4. 文件权限: 确保分享的文件有适当的访问权限

使用建议

1. 端口选择: 避免使用常见端口，推荐使用10000-65535范围
2. 防火墙: 确保防火墙允许选择的端口通信
3. 网络环境: 确保所有设备在同一局域网内
4. 文件大小: 超大文件下载时注意网络稳定性

故障排除

1. 端口被占用: 更换端口号或重启计算机
2. 无法访问: 检查防火墙设置和网络连接
3. 下载中断: 检查网络稳定性，重新开始下载
4. 密码错误: 注意密码大小写，避免输入法影响

🛠️ 技术实现

架构设计

• HTTP服务器: 基于Python标准库的ThreadingHTTPServer
• 多线程处理: 支持并发请求处理
• 安全机制: HMAC签名、CSRF防护、暴力破解防护
• 前端技术: 现代CSS3动画、响应式设计、JavaScript交互

核心特性

• 零配置: 无需安装额外软件，使用Python标准库
• 跨平台: 支持Windows、Linux、macOS
• 轻量级: 代码简洁，资源占用少
• 可扩展: 易于修改和扩展功能

📄 许可证

本项目基于开源协议，仅供学习和个人使用。

---

🎉 享受便捷的局域网文件分享体验！

如有问题或建议，欢迎反馈交流。