2025-02-12 11:29:22 +08:00
|
|
|
|
# 快速开始
|
|
|
|
|
|
|
|
|
|
|
|
## 简介
|
|
|
|
|
|
|
|
|
|
|
|
FileCodeBox 是一个简单高效的文件分享工具,支持文件临时中转、分享和管理。本指南将帮助您快速部署和使用 FileCodeBox。
|
|
|
|
|
|
|
|
|
|
|
|
## 特性
|
|
|
|
|
|
|
|
|
|
|
|
- 🚀 快速部署:支持 Docker 一键部署
|
|
|
|
|
|
- 🔒 安全可靠:文件访问需要提取码
|
|
|
|
|
|
- ⏱️ 时效控制:支持设置文件有效期
|
|
|
|
|
|
- 📊 下载限制:可限制文件下载次数
|
|
|
|
|
|
- 🖼️ 文件预览:支持图片、视频、音频等多种格式预览
|
|
|
|
|
|
- 📱 响应式设计:完美适配移动端和桌面端
|
|
|
|
|
|
|
|
|
|
|
|
## 部署方式
|
|
|
|
|
|
|
|
|
|
|
|
### Docker 部署(推荐)
|
|
|
|
|
|
|
2026-01-24 11:58:23 +08:00
|
|
|
|
#### 快速启动
|
|
|
|
|
|
|
2025-02-12 11:29:22 +08:00
|
|
|
|
```bash
|
2026-01-24 11:58:23 +08:00
|
|
|
|
docker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:latest
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### 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"
|
|
|
|
|
|
environment:
|
|
|
|
|
|
- WORKERS=4
|
|
|
|
|
|
- LOG_LEVEL=info
|
|
|
|
|
|
volumes:
|
|
|
|
|
|
fcb-data:
|
|
|
|
|
|
external: false
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
#### 环境变量
|
|
|
|
|
|
|
|
|
|
|
|
| 变量 | 默认值 | 说明 |
|
|
|
|
|
|
|------|--------|------|
|
|
|
|
|
|
| `HOST` | `::` | 监听地址,支持 IPv4/IPv6 双栈 |
|
|
|
|
|
|
| `PORT` | `12345` | 服务端口 |
|
|
|
|
|
|
| `WORKERS` | `4` | 工作进程数,建议设置为 CPU 核心数 |
|
|
|
|
|
|
| `LOG_LEVEL` | `info` | 日志级别:debug/info/warning/error |
|
|
|
|
|
|
|
|
|
|
|
|
#### 自定义配置示例
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
docker run -d --restart=always \
|
|
|
|
|
|
-p 12345:12345 \
|
|
|
|
|
|
-v /opt/FileCodeBox/:/app/data \
|
|
|
|
|
|
-e WORKERS=8 \
|
|
|
|
|
|
-e LOG_LEVEL=warning \
|
|
|
|
|
|
--name filecodebox \
|
|
|
|
|
|
lanol/filecodebox:latest
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 配置反向代理(Nginx)
|
|
|
|
|
|
|
|
|
|
|
|
```nginx
|
|
|
|
|
|
location / {
|
|
|
|
|
|
proxy_set_header X-Real-IP $remote_addr;
|
|
|
|
|
|
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
|
|
|
|
|
proxy_pass http://localhost:12345;
|
|
|
|
|
|
}
|
2025-02-12 11:29:22 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 手动部署
|
|
|
|
|
|
|
|
|
|
|
|
1. 克隆项目
|
|
|
|
|
|
```bash
|
|
|
|
|
|
git clone https://github.com/vastsa/FileCodeBox.git
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
2. 安装依赖
|
|
|
|
|
|
```bash
|
2025-02-12 15:12:22 +08:00
|
|
|
|
cd FileCodeBox
|
2025-02-12 11:29:22 +08:00
|
|
|
|
pip install -r requirements.txt
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
3. 启动服务
|
|
|
|
|
|
```bash
|
|
|
|
|
|
python main.py
|
|
|
|
|
|
```
|
|
|
|
|
|
|
2025-02-12 15:12:22 +08:00
|
|
|
|
|
2025-02-12 11:29:22 +08:00
|
|
|
|
## 使用方法
|
|
|
|
|
|
|
|
|
|
|
|
1. 访问系统
|
|
|
|
|
|
打开浏览器访问 `http://localhost:12345`
|
|
|
|
|
|
|
|
|
|
|
|
2. 上传文件
|
|
|
|
|
|
- 点击上传按钮或拖拽文件到上传区域
|
|
|
|
|
|
- 设置文件有效期和下载次数限制
|
|
|
|
|
|
- 获取分享链接和提取码
|
|
|
|
|
|
|
|
|
|
|
|
3. 下载文件
|
|
|
|
|
|
- 访问分享链接
|
|
|
|
|
|
- 输入提取码
|
|
|
|
|
|
- 下载文件
|
|
|
|
|
|
|
|
|
|
|
|
4. 后台管理
|
2025-02-12 15:12:22 +08:00
|
|
|
|
- 访问 `http://localhost:12345/#/admin`
|
2025-02-12 11:29:22 +08:00
|
|
|
|
- 输入管理员密码:`FileCodeBox2023`
|
|
|
|
|
|
- 进入后台管理页面
|
|
|
|
|
|
- 查看系统信息、文件列表、用户管理等
|
|
|
|
|
|
|
|
|
|
|
|
## 下一步
|
|
|
|
|
|
|
|
|
|
|
|
- [存储配置](/guide/storage) - 了解如何配置不同的存储方式
|
|
|
|
|
|
- [安全设置](/guide/security) - 了解如何增强系统安全性
|
|
|
|
|
|
- [API 文档](/api/) - 了解如何通过 API 集成
|