文件分享不求网盘：8700星开源文件快递柜FileCodeBox自架指南

给客户传一份报价单，给朋友发一个安装包，把一套素材回传给同事——这些小事碰上公共网盘，体验往往一言难尽：不限速套餐要开会员，对方没登录就下不动，链接放几天就悄悄失效，隐私敏感的文件还得担心被扫内容。

开源社区给了一个很干脆的答案。GitHub 上的 FileCodeBox（中文名"文件快递柜"）把文件分享做成取快递：你把文件传到自己的服务器，系统生成一个取件口令；对方打开网页，输入口令，文件到手。全程不需要注册账号，不需要装客户端，数据躺在你自己掌控的机器里。

项目由开发者 vastsa 维护，目前在 GitHub 拿到 8700 星，开源协议 LGPL-3.0，最新版本 2.8.5 于 10 月底发布，迭代相当活跃。官方仓库地址：https://github.com/vastsa/FileCodeBox ，文档站：https://fcb-docs.aiuo.net ，部署好之前可以先在官方演示站 share.lanol.cn 感受一遍流程。

它到底解决了什么

先看一次典型的使用流程。发送方打开网页，拖入文件，选择有效期，点"安全寄送"，得到一个取件码；接收方打开同一个网址，切换到取件页，输入取件码，直接下载。整个过程没有第三方服务器中转，也不存在"对方打不开链接"的尴尬。

细节功能比想象中厚实：

1. 即传即取：文件和文本统一处理，支持拖拽、粘贴、批量与分片上传，大文件不用怕断网重来。
2. 按需失效：过期时间可以按天设置，也可以按取件次数限制，取够次数自动作废，到期自动清理磁盘，不留垃圾。
3. 存储后端可选：本地磁盘、S3、OneDrive、WebDAV 都能对接，后面还抽象了 OpenDAL 多存储层，家有 NAS 的人可以直接把柜子挂到 NAS 上。
4. 管理后台：仪表盘能看到总文件数、存储占用、今日分享、累计取件，文件健康模块还会提示"即将过期""未取件"的记录，批量续期或清理都在一个页面完成。
5. MCP 支持：新版内置 MCP Streamable HTTP 端点，AI 客户端可以直接调用 share_text、share_file 两个工具生成分享，这是比较少见的前瞻设计。

一条命令部署起来

项目用 FastAPI 加 Vue 3 构建，部署门槛极低，官方推荐 Docker 方式，一条命令即可跑起来：

1. 在服务器上安装 Docker（宝塔面板用户可以在软件商店直接装 Docker 管理器）。
2. 执行官方提供的运行命令：docker run -d --restart unless-stopped -p 12345:12345 -v ./data:/app/data -e APP_ENV=production -e LOG_LEVEL=warning --log-opt max-size=10m --log-opt max-file=3 --name filecodebox lanol/filecodebox:2.8.5 。注意镜像标签固定到 2.8.5，比 latest 更稳妥，升级时心里有数。
3. 浏览器访问 http://服务器IP:12345 ，首次进入会引导初始化，设置站点名称与管理凭据。
4. 进入后台完成基础配置：单文件大小上限、默认有效期、游客是否允许上传、存储后端切换。演示站默认 20MB 单文件上限，自己部署时按磁盘预算放宽即可。
5. 建议在 Nginx 层加一层反代绑定域名并配置 HTTPS，公网传输的文件走加密连接是底线。

几个真实的落地场景

按使用频率排一下，你可以对号入座：

• 工作室与团队：把成品文件回传给客户，口令即发即用，配合"取件一次后失效"，避免成品文件被无限转发。
• 个人站长：博客读者需要某个配置文件或补丁时，不必再挂网盘链接，一个口令搞定，还能统计取件次数。
• 家庭 NAS 用户：Docker 部署进 NAS，出门在外给家人传照片，不用把照片上传到任何公有云。
• 开发联调：临时给同事传日志、抓包文件、构建产物，文本分享模式直接贴内容，比开临时群传文件快得多。

两点提醒

一是安全责任自担。公共部署请务必开启管理后台保护、限制上传类型、设置限流，项目近几个版本修复过 SSRF 与存储型 XSS 问题，保持更新到最新版是硬要求。二是默认口令别用弱码，取件码本质是唯一凭证，站点公开时建议调高口令长度。

写在最后

FileCodeBox 的走红并不意外：它把"文件分享"这个被网盘垄断多年的基础需求，用极低的部署成本还给了个人。一条 Docker 命令、几百 MB 内存占用，换来的是数据的完全自主。对常年折腾建站的人来说，这可能是最近值得一试的最轻量自托管项目；对还在为网盘限速买单的人，不妨先在演示站走一遍流程，体验过了再决定要不要搬回自己服务器。