🚀 更新计划
- 切片上传，同文件秒传，断点续传
- 适配子目录
- 用户登录重构
- webdav存储
- 存储支持自定义路径
- s3优化，不修改昵称为uuid，新建目录
📝 项目简介
FileCodeBox 是一个基于 FastAPI + Vue3 开发的轻量级文件分享工具。它允许用户通过简单的方式分享文本和文件，接收者只需要一个提取码就可以取得文件，就像从快递柜取出快递一样简单。
🖼️ 功能预览
新版界面
经典界面
🎯 应用场景
📁 临时文件分享快速分享单个文件，无需注册登录 |
📝 文本快速分享分享代码片段、文本内容等 |
🕶️ 匿名文件传输保护隐私的文件传输方式 |
💾 临时文件存储支持设置过期时间的文件存储 |
🔄 跨平台传输在不同设备间快速传输文件 |
🌐 小型分享服务搭建私有的文件分享服务 |
✨ 核心特性
🚀 快速开始
Docker 部署
docker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:beta
手动部署
- 克隆项目
git clone https://github.com/vastsa/FileCodeBox.git
- 安装依赖
cd FileCodeBox
pip install -r requirements.txt- 启动服务
📖 使用说明
分享文件
- 打开网页，点击"分享文件"
- 选择或拖拽文件
- 设置过期时间和次数
- 获取提取码
获取文件
- 打开网页，输入提取码
- 点击获取
- 下载文件或查看文本
管理面板
- 访问
/admin - 输入管理员密码
- 管理文件和配置
🛠 开发指南
项目结构
FileCodeBox/
├── apps/ # 应用代码
│ ├── admin/ # 管理后台
│ └── base/ # 基础功能
├── core/ # 核心功能
├── data/ # 数据目录
└── fcb-fronted/ # 前端代码
开发环境
- Python 3.8+
- Node.js 14+
- Vue 3
- FastAPI
本地开发
- 后端开发
- 前端开发
cd fcb-fronted
npm install
npm run dev🤝 贡献指南
- Fork 本项目
- 创建新分支
git checkout -b feature/xxx - 提交更改
git commit -m 'Add xxx' - 推送到分支
git push origin feature/xxx - 提交 Pull Request
❓ 常见问题
Q: 如何修改上传大小限制？
A: 在管理面板中修改配置项 uploadSize
Q: 如何配置存储引擎？
A: 在管理面板中选择存储引擎并配置相应参数
Q: 如何备份数据？
A: 备份 data 目录即可
更多问题请访问 Wiki
📊 项目统计
📜 免责声明
本项目开源仅供学习使用，不得用于任何违法用途，否则后果自负，与作者无关。使用时请保留项目地址和版权信息。