mirror of
https://github.com/vastsa/FileCodeBox.git
synced 2026-11-22 23:17:09 +08:00
90 lines
2.7 KiB
Markdown
90 lines
2.7 KiB
Markdown
# Getting Started
|
|
|
|
## Introduction
|
|
|
|
FileCodeBox is a simple and efficient file sharing tool that supports temporary file transfer, sharing, and management. This guide will help you quickly deploy and use FileCodeBox.
|
|
|
|
## Features
|
|
|
|
- 🚀 Quick Deployment: Support Docker one-click deployment
|
|
- 🔒 Secure & Reliable: File access requires extraction code
|
|
- ⏱️ Time Control: Support setting file expiration time
|
|
- 📊 Download Limit: Can limit file download times
|
|
- 🖼️ File Preview: Support preview of images, videos, audio, and other formats
|
|
- 📱 Responsive Design: Perfect adaptation for mobile and desktop
|
|
|
|
## Deployment Methods
|
|
|
|
### Docker Deployment (Recommended)
|
|
|
|
```bash
|
|
docker run -d --restart unless-stopped \
|
|
-p 12345:12345 \
|
|
-v fcb-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:latest
|
|
```
|
|
|
|
The named volume persists configuration and uploaded files across container upgrades.
|
|
|
|
| Variable | Default | Description |
|
|
|----------|---------|-------------|
|
|
| `HOST` | `0.0.0.0` | Service listening address |
|
|
| `PORT` | `12345` | Service port |
|
|
| `WORKERS` | `1` | Worker count; keep one worker for SQLite deployments |
|
|
| `APP_ENV` | `production` (Docker) | Runtime environment; production disables HTTP access logs by default |
|
|
| `LOG_LEVEL` | `warning` (Docker) | `debug`, `info`, `warning`, or `error` |
|
|
| `ACCESS_LOG` | `false` (production) | Enable HTTP access logs; set to `true` when debugging requests |
|
|
|
|
Production deployments output only warning, error, and other key events by default. Docker retains at most three 10 MB log files.
|
|
|
|
### 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
|
|
|
|
1. Access the System
|
|
Open browser and visit `http://localhost:12345`
|
|
|
|
2. Upload Files
|
|
- Click upload button or drag files to upload area
|
|
- Set file expiration time and download limit
|
|
- Get share link and extraction code
|
|
|
|
3. Download Files
|
|
- Visit share link
|
|
- Enter extraction code
|
|
- Download file
|
|
|
|
4. Admin Panel
|
|
- Open `http://localhost:12345` on first run and complete setup
|
|
- Visit `http://localhost:12345/#/admin`
|
|
- Enter the admin password set during setup
|
|
- Enter admin panel
|
|
- View system information, files, activity records, and configuration
|
|
|
|
## Next Steps
|
|
|
|
- [Storage Configuration](/en/guide/storage) - Learn how to configure different storage methods
|
|
- [Security Settings](/en/guide/security) - Learn how to enhance system security
|
|
- [API Documentation](/en/api/) - Learn how to integrate through API
|