Share text and files anonymously with a passcode, like picking up a package
[](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)
[็ฎไฝไธญๆ](./readme.md) | [Deployment Guide](https://github.com/vastsa/FileCodeBox/wiki/Deployment-Guide) | [FAQ](https://github.com/vastsa/FileCodeBox/wiki/FAQ)
## ๐ Introduction
FileCodeBox is a lightweight file sharing tool developed with FastAPI + Vue3. It allows users to share text and files
easily, where recipients only need a passcode to retrieve the files, just like picking up a package from a delivery
locker.
## ๐ผ๏ธ Preview
๐ Lightweight
Based on FastAPI + SQLite3 + Vue3 + ElementUI
|
๐ค Easy Upload
Support copy-paste and drag-drop
|
๐ฆ Multiple Types
Support text and various file types
|
๐ Security
- IP upload limits
- Error attempt limits
- File expiration
|
๐ซ Passcode Sharing
Random codes with customizable limits
|
๐ Multi-language
Support for Simplified Chinese, Traditional Chinese, and English
|
๐ญ Anonymous
No registration required
|
๐ Admin Panel
File and system management
|
๐ณ Docker
One-click deployment
|
๐พ Storage Options
Local, S3, OneDrive support
|
๐ฑ Responsive
Mobile-friendly design
|
๐ป CLI Support
Command-line download
|
## ๐ Quick Start
### Docker Deployment
#### Docker CLI
```bash
docker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:beta
```
#### Docker Compose
```ymlfix
version: "3"
services:s
file-code-box:
image: lanol/filecodebox:latest
volumes:
- fcb-data:/app/data:rw
restart: unless-stopped
ports:
- "12345:12345"
volumes:
fcb-data:
external: false
```
### Configure reverse proxy (Nginx example)
Please note that the following configurations must be added to ensure proper handling of client IP and proxy requests:
```nginx
location / {
proxy_set_header X-Real-IP $remote_addr; #Set real client IP
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://localhost:12345 ;
}
```
### Manual Deployment
1. Clone the repository
```bash
git clone https://github.com/vastsa/FileCodeBox.git
```
2. Install dependencies
```bash
cd FileCodeBox
pip install -r requirements.txt
```
3. Start the service
```bash
python main.py
```
## ๐ Usage Guide
### Share Files
1. Open the website, click "Share File"
2. Select or drag files
3. Set expiration time and count
4. Get the passcode
### Retrieve Files
1. Open the website, enter passcode
2. Click retrieve
3. Download file or view text
### Admin Panel
1. Visit `/admin`
2. Enter admin password
3. Manage files and settings
## ๐ Development Guide
### Project Structure
```
FileCodeBox/
โโโ apps/ # Application code
โ โโโ admin/ # Admin backend
โ โโโ base/ # Base functions
โโโ core/ # Core functions
โโโ data/ # Data directory
โโโ fcb-fronted/ # Frontend code
```
### Development Environment
- Python 3.8+
- Node.js 14+
- Vue 3
- FastAPI
### Local Development
1. Backend development
```bash
python main.py
```
2. Frontend development
```bash
cd fcb-fronted
npm install
npm run dev
```
## ๐ค Contributing
1. Fork the project
2. Create your feature branch `git checkout -b feature/xxx`
3. Commit your changes `git commit -m 'Add xxx'`
4. Push to the branch `git push origin feature/xxx`
5. Open a Pull Request
## โ FAQ
### Q: How to modify upload size limit?
A: Change `uploadSize` in admin panel
### Q: How to configure storage engine?
A: Select storage engine and configure parameters in admin panel
### Q: How to backup data?
A: Backup the `data` directory
For more questions, visit [Wiki](https://github.com/vastsa/FileCodeBox/wiki/ๅธธ่ง้ฎ้ข)
## ๏ฟฝ๏ฟฝ Project Statistics and Analytics
