LightS4·微光小溪是一款面向个人用户与开发者的 S3 兼容对象存储在线管理器,支持对接任意兼容 S3 协议的存储服务(如阿里云 OSS、Cloudflare R2、缤纷云等),提供现代化的 Web 界面替代繁琐的命令行或官方控制台操作。核心功能模块分为两部分:一是文件管理模块,涵盖目录浏览、模糊搜索与后缀过滤、面包屑导航、文件操作历史记录及使用统计,用户可在浏览器中直观管理存储桶内的全部文件;二是视频站模块,集成自适应在线播放器,支持智能缩略图生成、视频元数据展示与播放历史持久化,将对象存储直接用作个人视频库。整体业务流程为:用户配置 S3 端点与密钥 → 前端调用后端 API 获取文件列表 → 用户在 Web 界面完成文件浏览、搜索与视频播放 → 操作记录写入 MongoDB 供后续统计查阅。此外项目支持 PWA 本地安装与完整移动端适配,可作为轻量 App 日常使用。
项目采用前后端分离架构,前端基于 Next.js 14 + TypeScript 构建,TypeScript 代码占比达 93%,使用 Tailwind CSS 实现响应式布局,支持亮暗主题切换;后端使用 Python FastAPI 搭建 REST API,通过 boto3 对接 S3 兼容协议,MongoDB 负责视频播放记录与统计数据的持久化存储。独立承担从系统设计、前后端开发到部署上线的全流程工作。视频列表接口引入 7200s 服务端缓存策略,有效降低数据库查询频次,提升接口响应速度。主要难点有两处:一是 S3 兼容性适配,不同厂商对 API 的实现存在细微差异,通过统一封装 s3-client 并针对端点差异做兼容处理解决;二是视频缩略图的异步生成,采用懒加载策略在用户首次访问时触发生成并缓存至 CDN,避免阻塞页面渲染。项目配置 GitHub Actions 实现 CI/CD 自动化,通过 Vercel 完成生产环境部署,支持一键 Fork 私有化部署。