FileCodeBox - 开源轻量级文件快递柜

项目介绍

FileCodeBox 是一个轻量级的文件分享工具,就像现实生活中的快递柜一样 - 你可以存入文件,然后将取件码分享给他人。这个项目特别适合临时文件分享、代码片段传递等场景。

核心特性

基础功能

• 🚀 即时分享: 无需注册登录,拖拽上传即可分享
• 📦 多种类型: 支持文本和各类文件的上传分享
• 🔑 安全可控: 支持自定义提取次数和有效期
• 🌏 多语言支持: 内置中文简体、繁体及英文界面

安全特性

• ⚔️ 访问控制: 错误次数限制,防止暴力破解
• 🛡️ 防滥用: IP限制上传频率
• 🔒 随机口令: 确保分享安全性

技术特点

• 💡 轻量架构: 基于 Fastapi + Sqlite3 + Vue3 + ElementUI
• 🔌 存储灵活: 支持本地存储和S3协议存储
• 🎯 简单部署: 提供Docker一键部署方案

快速部署指南

Docker安装命令

docker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:beta

参数说明:

• -d: 后台运行容器
• --restart=always: 容器自动重启
• -p 12345:12345: 端口映射,前面是主机端口,后面是容器端口
• -v /opt/FileCodeBox/:/app/data: 数据持久化,将容器内/app/data目录映射到主机的/opt/FileCodeBox/
• --name filecodebox: 容器名称
• lanol/filecodebox:beta: 使用的镜像版本

更新命令

docker pull lanol/filecodebox:beta && docker stop filecodebox && docker rm filecodebox && docker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:beta

系统配置

管理后台

• 访问地址: /#/admin
• 默认密码: FileCodeBox2023
• 功能: 仪表盘、文件管理、系统设置

存储配置

• 默认采用本地存储
• 支持配置S3协议存储(如MinIO、阿里云OSS等)

使用指南

上传分享

1. 拖拽文件或复制粘贴到上传区
2. 设置分享参数:

• 按次数生效: 打开指定次数后失效
• 按时间生效: 可设置天/小时期限

1. 获取分享码并发送给接收方

文件管理

• 查看上传历史
• 管理分享文件
• 查看分享详情

开发者相关

• 开源地址: GitHub - vastsa/FileCodeBox
• 技术架构: 前后端分离设计

特色亮点

这个项目特别适合:

• 临时文件分享场景
• 代码片段传递
• 个人/小团队文件中转
• 学习FastAPI和Vue3的实践项目

如果你正在寻找一个轻量级的文件分享解决方案,或者想要一个练手的全栈项目,FileCodeBox都是一个不错的选择。