快速开始

简介

FileCodeBox 是一个简单高效的文件分享工具，支持文件临时中转、分享和管理。本指南将帮助您快速部署和使用 FileCodeBox。

特性

• 🚀 快速部署：支持 Docker 一键部署
• 🔒 安全可靠：文件访问需要提取码
• ⏱️ 时效控制：支持设置文件有效期
• 📊 下载限制：可限制文件下载次数
• 🖼️ 文件预览：支持图片、视频、音频等多种格式预览
• 📱 响应式设计：完美适配移动端和桌面端

部署方式

Docker 部署（推荐）

快速启动

docker run -d --restart unless-stopped \
  -p 12345:12345 \
  -v fcb-data:/app/data \
  --name filecodebox \
  lanol/filecodebox:latest

Docker Compose

version: "3"
services:
  file-code-box:
    image: lanol/filecodebox:latest
    volumes:
      - fcb-data:/app/data:rw
    restart: unless-stopped
    ports:
      - "12345:12345"
    environment:
      - WORKERS=1
      - LOG_LEVEL=info
volumes:
  fcb-data:
    external: false

环境变量

变量	默认值	说明
HOST	0.0.0.0	服务监听地址
PORT	12345	服务端口
WORKERS	1	工作进程数；SQLite 部署建议保持单进程
LOG_LEVEL	info	日志级别：debug/info/warning/error

自定义配置示例

docker run -d --restart=always \
  -p 12345:12345 \
  -v fcb-data:/app/data \
  -e WORKERS=1 \
  -e LOG_LEVEL=warning \
  --name filecodebox \
  lanol/filecodebox:latest

配置反向代理（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;
}

手动部署

1. 克隆项目

git clone https://github.com/vastsa/FileCodeBox.git

2. 安装依赖

cd FileCodeBox
pip install -r requirements.txt

3. 启动服务

python main.py

使用方法

1. 访问系统 打开浏览器访问 http://localhost:12345

2. 上传文件

   • 点击上传按钮或拖拽文件到上传区域
   • 设置文件有效期和下载次数限制
   • 获取分享链接和提取码

3. 下载文件

   • 访问分享链接
   • 输入提取码
   • 下载文件

4. 后台管理

   • 首次访问 http://localhost:12345 完成初始化
   • 访问 http://localhost:12345/#/admin
   • 输入初始化时设置的管理员密码
   • 进入后台管理页面
   • 查看系统信息、文件列表、活动记录和系统配置

下一步

• 存储配置 - 了解如何配置不同的存储方式
• 安全设置 - 了解如何增强系统安全性
• API 文档 - 了解如何通过 API 集成