https://github.com/vastsa/FileCodeBox
文件快递柜-匿名口令分享文本，文件，像拿快递一样取文件（FileCodeBox - File Express Cabinet - Anonymous Passcode Sharing Text, Files, Like Taking Express Delivery for Files）
https://github.com/vastsa/FileCodeBox
anonymous fastapi filecodebox python tool vue
Last synced: 21 days ago
JSON representation
文件快递柜-匿名口令分享文本，文件，像拿快递一样取文件（FileCodeBox - File Express Cabinet - Anonymous Passcode Sharing Text, Files, Like Taking Express Delivery for Files）
- Host: GitHub
- URL: https://github.com/vastsa/FileCodeBox
- Owner: vastsa
- License: lgpl-3.0
- Created: 2022-12-09T11:10:08.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2025-03-16T15:06:46.000Z (29 days ago)
- Last Synced: 2025-03-18T23:40:44.334Z (27 days ago)
- Topics: anonymous, fastapi, filecodebox, python, tool, vue
- Language: Python
- Homepage: https://fcb-docs.aiuo.net/
- Size: 28.1 MB
- Stars: 6,043
- Watchers: 27
- Forks: 706
- Open Issues: 39
-
Metadata Files:
- Readme: readme.md
- Contributing: docs/contributing.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
- Awesome-GitHub-Repo - FileCodeBox - 文件快递柜，接收方无需注册登录，输入口令即可提取文件。[<img src="https://tva1.sinaimg.cn/large/008i3skNly1gxlhtmg11mj305k05k746.jpg" alt="微信" width="18px" height="18px" />](https://mp.weixin.qq.com/s/rFzDGSIrd3t1ABwgtmqRKA) (好玩项目 / 宝藏项目)
- StarryDivineSky - vastsa/FileCodeBox - 匿名口令分享文本，文件，像拿快递一样取文件。主要特色： 轻量简洁： 项目基于Fastapi + Sqlite3 + Vue3 + ElementUI。轻松上传： 支持复制粘贴和拖拽选择。多种类型： 支持文本和文件。防止爆破： 错误次数限制。防止滥用： IP限制上传次数。口令分享： 随机口令，存取文件，自定义次数及有效期。国际化： 支持中文简体、繁体以及英文等。匿名分享： 无需注册，无需登录。管理面板： 查看和删除文件。一键部署： 支持Docker一键部署。自由拓展： 支持S3协议和本地文件流，可根据需求在storage文件中新增存储引擎。简单明了： 适合新手练手项目。 终端下载： 终端命令wget https://share.lanol.cn/share/select?code=83432 (网络服务 / 网络服务_其他)
- awesomeLibrary - FileCodeBox - 文件快递柜-匿名口令分享文本，文件，像拿快递一样取文件（FileCodeBox - File Express Cabinet - Anonymous Passcode Sharing Text, Files, Like Taking Express Delivery for Files） (语言资源库 / python)
README
# FileCodeBox - 文件快递柜
匿名口令分享文本和文件，像拿快递一样取文件
[](https://github.com/vastsa/FileCodeBox/stargazers)
[](https://github.com/vastsa/FileCodeBox/network)
[](https://github.com/vastsa/FileCodeBox/issues)
[](https://github.com/vastsa/FileCodeBox/blob/master/LICENSE)
[](https://qm.qq.com/q/PemPzhdEIM)
[](https://www.python.org)
[](https://fastapi.tiangolo.com)
[](https://v3.vuejs.org)
[English](./readme_en.md) | [部署教程](https://github.com/vastsa/FileCodeBox/wiki/部署教程) | [常见问题](https://github.com/vastsa/FileCodeBox/wiki/常见问题)
## 🚀 更新计划
- [ ] 切片上传，同文件秒传，断点续传
- [x] 适配子目录
- [x] 用户登录重构
- [x] webdav存储
- [x] 存储支持自定义路径
- [x] s3优化，不修改昵称为uuid，新建目录
## 📝 项目简介
FileCodeBox 是一个基于 FastAPI + Vue3 开发的轻量级文件分享工具。它允许用户通过简单的方式分享文本和文件，接收者只需要一个提取码就可以取得文件，就像从快递柜取出快递一样简单。
## 🖼️ 功能预览
### 新版界面
### 经典界面
## 🎯 应用场景
📁 临时文件分享
快速分享单个文件，无需注册登录
📝 文本快速分享
分享代码片段、文本内容等
🕶️ 匿名文件传输
保护隐私的文件传输方式
💾 临时文件存储
支持设置过期时间的文件存储
🔄 跨平台传输
在不同设备间快速传输文件
🌐 小型分享服务
搭建私有的文件分享服务
## ✨ 核心特性
🚀 轻量简洁
基于 FastAPI + SQLite3 + Vue3 + ElementUI，部署简单，性能出色
📤 便捷上传
支持复制粘贴、拖拽上传，操作简单直观
📦 多种类型
支持文本和各类文件的分享
🔒 安全机制
- IP 限制上传次数
- 错误次数限制
- 文件过期机制
🎫 提取码分享
随机提取码，可自定义次数及有效期
🌍 多语言支持
支持中文简体、繁体及英文
🎭 匿名分享
无需注册登录，保护隐私
🛠 管理面板
文件管理和系统配置
🐳 容器部署
支持 Docker 一键部署
💾 存储扩展
支持本地存储、S3 协议、OneDrive 等
📱 响应式设计
支持移动端访问
💻 终端支持
支持命令行下载
## 🚀 快速开始
### Docker 部署
#### Docker CLI
```bash
docker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:beta
```
#### Docker Compose
```yml
version: "3"
services:
file-code-box:
image: lanol/filecodebox:latest
volumes:
- fcb-data:/app/data:rw
restart: unless-stopped
ports:
- "12345:12345"
volumes:
fcb-data:
external: false
```
### 手动部署
1. 克隆项目
```bash
git clone https://github.com/vastsa/FileCodeBox.git
```
2. 安装依赖
```bash
cd FileCodeBox
pip install -r requirements.txt
```
3. 启动服务
```bash
python main.py
```
## 📖 使用说明
### 分享文件
1. 打开网页，点击"分享文件"
2. 选择或拖拽文件
3. 设置过期时间和次数
4. 获取提取码
### 获取文件
1. 打开网页，输入提取码
2. 点击获取
3. 下载文件或查看文本
### 管理面板
1. 访问 `/#/admin`
2. 输入管理员密码 `FileCodeBox2023`
3. 管理文件和配置
## 🛠 开发指南
### 项目结构
```
FileCodeBox/
├── apps/ # 应用代码
│ ├── admin/ # 管理后台
│ └── base/ # 基础功能
├── core/ # 核心功能
├── data/ # 数据目录
└── fcb-fronted/ # 前端代码
```
### 开发环境
- Python 3.8+
- Node.js 14+
- Vue 3
- FastAPI
### 本地开发
1. 后端开发
```bash
python main.py
```
2. 前端开发
```bash
cd fcb-fronted
npm install
npm run dev
```
## 🤝 贡献指南
1. Fork 本项目
2. 创建新分支 `git checkout -b feature/xxx`
3. 提交更改 `git commit -m 'Add xxx'`
4. 推送到分支 `git push origin feature/xxx`
5. 提交 Pull Request
## ❓ 常见问题
### Q: 如何修改上传大小限制？
A: 在管理面板中修改配置项 `uploadSize`
### Q: 如何配置存储引擎？
A: 在管理面板中选择存储引擎并配置相应参数
### Q: 如何备份数据？
A: 备份 `data` 目录即可
更多问题请访问 [Wiki](https://github.com/vastsa/FileCodeBox/wiki/常见问题)
## 📊 项目统计
[](https://star-history.com/#vastsa/FileCodeBox&Date)
## 📜 免责声明
本项目开源仅供学习使用，不得用于任何违法用途，否则后果自负，与作者无关。使用时请保留项目地址和版权信息。