vastsa/FileCodeBox

文件快递柜-匿名口令分享文本，文件，像拿快递一样取文件（FileCodeBox - File Express Cabinet - Anonymous Passcode Sharing Text, Files, Like Taking Express Delivery for Files）

FileCodeBox — 像取快递一样取文件

一句话概括：一个轻量、现代、可自托管的文件分享工具。上传文件后获得一个“取件口令”，对方输入口令即可下载，全程无需注册账号。

核心机制

上传即得口令：上传文件或文本，系统生成一个取件码。
凭码取件：接收方输入口令即可获取文件，就像去快递柜取包裹。
无需注册：上传者和取件者都不需要创建账号。

主要能力

能力	说明
即传即取	文件和文本统一分享，支持拖拽、粘贴、批量上传和分片上传
按需失效	可设置按时间过期、按取件次数过期，或永久保存；过期内容自动清理
数据自主	存储后端可选本地磁盘、S3、OneDrive、WebDAV 或 OpenDAL，数据留在自己的基础设施里
管理后台	提供登录、文件管理、系统设置等管理功能
AI 客户端接入	支持 MCP Streamable HTTP 协议，兼容的 AI 客户端可通过 `share_text` 和 `share_file` 工具创建分享

部署方式

一条 Docker 命令即可启动：

docker run -d --restart unless-stopped \
  -p 12345:12345 \
  -v ./data:/app/data \
  -e APP_ENV=production \
  -e LOG_LEVEL=warning \
  --log-opt max-size=10m \
  --log-opt max-file=3 \
  --name filecodebox \
  lanol/filecodebox:2.8.3

启动后访问 http://localhost:12345 完成首次初始化。生产环境建议固定版本号（如 2.8.3），latest 标签指向最新正式版。

技术栈

后端：FastAPI
前端：Vue 3（支持暗色模式）
数据库：SQLite
部署：Docker
存储协议：S3、WebDAV 等

许可与声明

开源协议：LGPL-3.0
项目声明仅供合法的文件与文本分享场景使用，使用者需自行承担部署、数据合规与内容管理责任。