📝 项目简介
FileCodeBox 是一个基于 FastAPI + Vue3 开发的轻量级文件分享工具。它允许用户通过简单的方式分享文本和文件，接收者只需要一个提取码就可以取得文件，就像从快递柜取出快递一样简单。
🎯 应用场景
📝 文本快速分享分享代码片段、文本内容等 | 🕶️ 匿名文件传输保护隐私的文件传输方式 |
🔄 跨平台传输在不同设备间快速传输文件 | 🌐 小型分享服务搭建私有的文件分享服务 |
✨ 核心特性
🚀 轻量简洁基于 FastAPI + SQLite3 + Vue3 + ElementUI，部署简单，性能出色 | 📤 便捷上传支持复制粘贴、拖拽上传，操作简单直观 | 📦 多种类型支持文本和各类文件的分享 |
🔒 安全机制
| 🎫 提取码分享随机提取码，可自定义次数及有效期 | 🌍 多语言支持支持中文简体、繁体及英文 |
🎭 匿名分享无需注册登录，保护隐私 | 🛠 管理面板文件管理和系统配置 | 🐳 容器部署支持 Docker 一键部署 |
💾 存储扩展支持本地存储、S3 协议、OneDrive 等 | 📱 响应式设计支持移动端访问 | 💻 终端支持支持命令行下载 |
🚀 快速开始
Docker 部署
1.1docker run 快速安装（推荐新手）
创建持久化数据目录
# 创建 /opt/BOX 目录（核心：数据持久化的目录）
sudo mkdir -p /opt/BOX
# 设置目录权限（避免容器无写入权限）
sudo chmod -R 777 /opt/BOX
启动 FileCodeBox 容器
sudo docker run -d \
--restart=always \ # 容器崩溃/服务器重启后自动重启
-p 12345:12345 \ # 端口映射：宿主机12345 → 容器12345
-v /opt/BOX:/app/data \ # 数据持久化：/opt/BOX 绑定到容器数据目录
--name filecodebox \ # 容器命名（方便管理）
lanol/filecodebox:latest # 使用最新稳定版镜像
1.2docker-compose 规范安装（推荐长期维护）
创建配置文件和数据目录
# 1. 创建工作目录（可选，用于存放 compose 配置文件）
sudo mkdir -p /opt/FileCodeBox
cd /opt/FileCodeBox
# 2. 创建数据目录（和方式一一致，确保数据持久化到 /opt/BOX）
sudo mkdir -p /opt/BOX
sudo chmod -R 777 /opt/BOX
# 3. 创建 docker-compose.yml 配置文件
sudo vim docker-compose.yml
写入配置内容
version: "3"
services:
file-code-box:
image: lanol/filecodebox:latest # 镜像版本
volumes:
- /opt/BOX:/app/data:rw # 核心：/opt/BOX 挂载到容器数据目录，rw=读写权限
restart: always # 自动重启策略
ports:
- "12345:12345" # 端口映射
container_name: filecodebox # 显式指定容器名，避免自动生成
privileged: true # 提升权限，避免目录读写问题（可选但推荐）
启动容器
# 启动容器（-d 后台运行）
sudo docker compose up -d
# 若提示 docker-compose: 未找到命令，改用旧版命令：
# sudo docker-compose up -d
验证安装是否成功
# 查看容器是否运行（状态为 Up 则正常）
sudo docker ps | grep filecodebox
# 若状态异常，查看日志排查问题
sudo docker logs filecodebox
访问 Web 界面
在浏览器中访问：http://你的服务器IP:12345
管理面板
访问 /#/admin
输入管理员密码 FileCodeBox2023
DEMO
我们进行了部署供大家免费使用（Qianfan Box–千帆文件柜），或在页脚直接跳转.
欢 迎 您 的 订 阅