📦 小鑫文件快递
🎯 项目定位
小鑫文件快递是基于 Laravel 9开发的轻量级文件上传分享 & 临时传输系统✨
主打快速上传、分享码 / 分享链接生成、临时极速下载、全能后台管理、局域网内网互传五大核心场景
适配个人私有站点、小团队文件中转站、内网临时传文件工具、私有化专属文件快递服务使用
🧩 整体架构
项目沿用 Laravel 标准分层开发架构，目录职责清晰分明
🖥️ app/Http/Controllers/Web：前端网页控制器，承载首页、文件分享页、管理后台、系统安装页等可视化页面
🔌 app/Http/Controllers/Api：接口业务控制器，对接前后端交互，涵盖普通上传、分片大文件上传、文件下载、局域网互传、系统配置调用等接口
🗃️ app/Models：数据模型层，统一管理文件数据、上传下载日志、系统配置、公告、管理员账号、操作审计日志、IP 黑名单、局域网传输会话等全量数据表数据
⚡ app/Jobs：异步任务处理层，后台静默执行文件 Hash 值计算、文件安全扫描、过期文件清理、系统消息推送等耗时操作
🕒 app/Console/Commands：定时任务指令库，自动清理过期文件、闲置局域网会话、运营数据统计、配置自动备份、服务器存储空间巡检
🛠️ app/Support：通用业务工具层，封装系统安装校验、一键安装程序、上传风险检测、操作审计记录、统一标准 API 返回格式、全局配置读取工具
🎨 resources/views：Blade 模板页面，包含后台管理界面、系统安装界面、文件分享页面、用户协议页、全局错误提示页
📄 resources/static-pages：预编译静态页面资源，内置官网首页、系统状态页、局域网互传专属页面、移动端应用介绍页
📂 public/：项目 Web 统一入口目录，正式部署时网站根目录必须定向至此文件夹
📊 database/migrations：数据库迁移文件，一键生成项目所有业务数据表结构
✨ 核心功能一览
双模式文件上传
支持小文件直传 + 大文件分片断点续传，可完成分片初始化、分片分批上传、文件自动合并全套流程，上传成功自动生成专属唯一分享码
智能文件分享
通过/files/{分享码}直达文件分享页面，页面直观展示文件名、文件大小、剩余过期时长、提取码启用状态；开启提取码后，下载必须验证密码，安全防护拉满
全维度下载记录
精准记录下载用户 IP、浏览器设备信息、下载结果、失败原因、实际下载流量，自动累加文件下载次数与总流量数据
全能管理后台
访问/admin或轻量化后台/admin-lite即可登录，支持管理员账号密码修改、上传参数配置、站点公告编辑、用户协议编辑、恶意 IP 拉黑、文件批量管理、违规文件封禁、文件有效期延长等操作，同步展示服务器运行状态、站点运营统计数据
一键可视化安装
全新部署未配置环境时，自动跳转/install安装页面，自动检测服务器运行环境、自动写入环境配置文件、生成安全密钥、执行数据库迁移、一键创建超级管理员账号，同时兼容命令行手动初始化部署
无网局域网互传
依靠传输会话与信令机制搭建内网传输通道，支持创建 / 加入传输房间、WebRTC 信令互通、离线文件互传、纯文本快捷互传，所有局域网会话自带有效期，定时任务自动清理闲置无效会话
可视化系统动态配置
所有站点配置统一存入配置数据表，可后台自由修改：单文件最大上传体积、文件默认过期时长、允许上传文件格式、验证码开关、网站备案信息、移动端下载配置、局域网传输权限限制等，后台修改实时生效
全方位安全防护
配备管理员登录权限校验、系统安装锁保护、网站安全响应头、上传文件风控拦截、IP 黑名单封禁、提取码加密存储、违规文件访问拦截、全后台操作审计日志；可选对接 ClamAV 引擎开启文件病毒查杀功能
📚 核心数据表
files：存储文件核心信息、存储路径、文件哈希、提取码、过期时间、下载统计、风控状态
file_uploads：全程记录用户上传行为与上传失败原因
file_downloads：详细记录每一次下载行为及异常失败原因
chunked_uploads：分片上传专属数据表，记录分片任务、分片总数、已传大小、合并完成状态
settings：全站动态配置数据表
announcements：站点前台公告数据表
users：后台管理员账号数据表
blocked_ips：恶意封禁 IP 数据表
audit_logs：管理员后台所有操作审计日志
lan_sessions、lan_signals：局域网互传会话、通信信令数据表
daily_stats：站点每日上传、下载、存储容量、活跃文件运营统计表
health_checks：服务器服务健康状态巡检记录表
🛣️ 路由接口结构
🌐 网页前端路由
首页/、用户协议页/terms、系统状态页/status、局域网互传页/lan-transfer、应用下载页/app、文件分享页/files/{code}、轻量化管理后台/admin-lite
📡 统一 API 接口
所有接口统一前缀/api/v1，涵盖系统基础配置、前台公告、站点状态、协议内容、文件上传、分片上传、上传记录同步、文件详情查询、文件下载、局域网会话创建 / 加入 / 信令交互等全套业务接口
🎮 整体运行机制
用户提交文件上传请求，系统自动校验文件大小、格式、提取码、人机验证、上传风控规则，校验通过后保存文件并录入数据库，返回专属分享链接与分享码
访客通过分享码进入分享页面，系统自动校验文件是否过期、是否被管理员封禁、是否需要输入提取码，校验通过方可发起下载
用户发起下载请求时再次完成权限核验，同步写入完整下载行为日志
管理员依托后台自由调整站点所有运行规则，灵活管控上传下载权限
系统定时任务后台静默运行，长期维护站点环境，清理冗余数据、生成运营报表、巡检服务器资源
🚀 极简部署特点
项目生产环境无需依赖 Node.js，所有前端静态资源已提前预编译完成
部署仅需基础运行环境：PHP 运行环境、Composer 依赖管理、MySQL 数据库、Nginx/Apache 网页服务
部署核心步骤：安装项目依赖包 → 配置环境变量文件 → 执行数据库迁移 → 创建文件存储软链接 → 网站根目录绑定至 public 文件夹即可完成上线。(内涵部署教程)
🔗 在线演示站点
立即下载
（演示服务器配置偏低，页面加载速度略有延迟，仅供功能体验参考）
下载地址:立即下载
