FileCodeBox：像取快递一样分享文件！高颜值、极简的私有化“文件快递柜”部署指南

在互联网高度发达的今天，分享一个文件依然充满槽点：网盘限速、社交软件扫描隐私、跨平台登录账号繁琐。

FileCodeBox (文件快递柜) 是一款基于 FastAPI 框架开发的开源轻量级文件分享系统。它的设计灵感直接来源于现实生活中的快递柜模式：

存件人：上传文件/文本，系统自动生成一个唯一的“取件码”。 取件人：无需注册，输入 5 位取件码，瞬间完成提取。

这不仅仅是一个文件上传工具，它更像是一个跨设备的数据中转站。无论是代码片段、安装包还是私密文档，它都能以最优雅的方式在你的电脑、手机、服务器之间流转。

---

✨ 核心功能亮点

• 🚀 极简交互：五位数取件码，跨设备传输只需几秒钟。
• 🎨 高颜值 UI：基于 Vue3 + Naive UI 打造，支持暗黑模式，响应式适配手机端。
• 🔒 隐私保护：支持设置过期时间、下载次数限制，甚至可以给文件加锁。
• 📂 多端存储：默认本地存储，同时完美对接 S3、阿里云 OSS、腾讯云 COS 等对象存储。
• 🛠️ 后台管理：自带强大的管理面板，支持文件管理、系统设置及公告发布。
• ⚡ 高性能：基于 FastAPI 异步框架，占用极低，哪怕是 1核512M 的小鸡也能流畅运行。

---

🛠️ 部署前准备

在开始安装之前，请确保你的服务器环境满足以下要求：

需求项目	最低配置 / 要求	推荐配置
操作系统	Linux (Ubuntu/CentOS/Debian)	Docker 环境 (任意 OS)
内存	256 MB	512 MB+
磁盘	视存储需求而定	建议 10GB 以上
依赖环境	Docker & Docker Compose	Docker 20.10+

---

🚀 全方案部署教程

方案一：Docker 一键部署（推荐 ⭐️）

这是最简单、最不容易出错的方式，适合大部分用户。

docker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:beta

一键更新命令

docker pull lanol/filecodebox:beta && docker stop filecodebox && docker rm filecodebox && docker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:beta

方案二：Docker Compose 部署（进阶推荐）

如果你需要配合 Nginx Proxy Manager 等工具使用，Docker Compose 更加优雅。

1. 在目录下创建 docker-compose.yml：

version: '3'
services:
  filecodebox:
    image: vastsa/filecodebox:latest
    container_name: filecodebox
    restart: always
    ports:
      - "12345:12345"
    volumes:
      - ./data:/app/data

2. 执行启动命令：

docker-compose up -d

方案三：源码手动部署（适合二次开发）

如果你希望在 Python 环境下直接运行：

# 克隆仓库
git clone https://github.com/vastsa/filecodebox.git
cd filecodebox

# 安装依赖
pip install -r requirements.txt

# 启动服务
python3 main.py

---

⚙️ 初始配置说明

1. 访问地址：部署完成后，访问 http://你的服务器IP:12345。
2. 管理后台：点击页面上的“管理”或直接访问 /admin。
3. 默认密码：初始管理密码通常为 FileCodeBox2023 (请务必在第一时间进入后台修改密码)。
4. 反向代理：建议使用 Nginx 进行反向代理并开启 HTTPS，确保传输安全。

---

📝 总结与评价

✅ 优点

1. 轻量化：镜像极小，启动速度极快。
2. 零门槛：取件人不需要任何学习成本，输入 5 位数字即可。
3. 扩展性强：支持各种云存储，不用担心服务器硬盘被撑爆。

❌ 缺点

1. 安全性平衡：取件码机制虽然方便，但如果不设置复杂的后缀或管理权限，容易被暴力破解取件码（建议在后台设置取件码位数及有效期）。

💡 适用建议

• 个人/家庭：作为跨设备的“剪贴板”和文件转运站。
• 小微企业/团队：局域网内分发软件安装包、技术文档。
• 开发者：作为临时静态资源的托管方案。

---

🔗 项目相关资源

资源类型	地址
GitHub 仓库	vastsa/FileCodeBox
官方文档	https://fcb-docs.aiuo.net/
Demo	https://share.lanol.cn/#/

---

希望这篇教程能帮你搭建起属于自己的私有“快递柜”！如果你在部署过程中遇到任何问题，欢迎在下方留言讨论。