### [FileCodeBox：像取快递一样分享文件！高颜值、极简的私有化“文件快递柜”部署指南](https://www.qiqiwa.com/article/441)

**Published:** 2026-03-06T14:45:28

**Author:** Hello

**Excerpt:** 在互联网高度发达的今天，分享一个文件依然充满槽点：网盘限速、社交软件扫描隐私、跨平台登录账号繁琐。 FileCodeBox (文件快递柜) 是一款基于 FastAPI 框架开发的开源轻量级文件分享系统。它的设计灵感直接来源于现实生活中的快递

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

![FileCodeBox Logo](https://www.qiqiwa.com/wp-content/uploads/2026/03/68747470733a2f2f666173746c792e6a7364656c6976722e6e65742f67682f7661737473612f46696c65436f6465426f784056312e362f7374617469632f62616e6e6572732f696d675f312e706e67.png)

**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://github.com/vastsa/FileCodeBox) |
| **官方文档** | [https://fcb-docs.aiuo.net/](https://fcb-docs.aiuo.net/) |
| **Demo** | [https://share.lanol.cn/#/](https://share.lanol.cn/#/) |

* * *

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

**Tags:** 开源项目, 网盘程序

**Categories:** 网盘程序

---