📝 项目简介
FileCodeBox 是一个基于 FastAPI + Vue3 开发的轻量级文件分享工具。它允许用户通过简单的方式分享文本和文件，接收者只需要一个提取码就可以取得文件，就像从快递柜取出快递一样简单。
🎯 应用场景
✨ 核心特性
🚀 快速开始
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
示例：http://192.168.1.100:12345
管理面板
访问 /#/admin
输入管理员密码 FileCodeBox2023
DEMO
我们进行了部署供大家免费使用（Qianfan Box-- 千帆文件柜），或在页脚直接跳转.
欢 迎 您 的 订 阅