像取快递一样传输文件：免费工具FileCodeBox极简部署教程

哈喽大家好，我是飘雷！

在日常生活和工作中，我们经常会需要在不同设备之间临时传个文件，那怎样才能最快？

可能有朋友第一时间会说，用微信/QQ传就行了。

但我自己就遇到过，想把一段刚渲染好的视频素材从电脑传到手机，微信传输会压缩画质；也遇到过用微信给同事发送安卓的APP安装包时，会被强制修改*.apk后缀名，烦人得很。

更别说，扫码登录之类的操作也挺闹心。

今天，咱们就来解决这个问题，利用NAS部署一款极轻量、极好用的开源项目——FileCodeBox（文件快递柜），让跨设备传文件像取快递一样简单。

https://github.com/vastsa/FileCodeBox

一、 什么是 FileCodeBox？它有什么优势？

FileCodeBox顾名思义，就是一个属于你自己的文件快递柜。

它的核心交互逻辑非常简单，发件人上传文件后， 生成一个专属取件码 ，收件人输入取件码即可下载文件或者直接读取文本。

FileCodeBox这款免费开源的小工具有不少优势。

首先是轻量高效。后端采用FastAPI+SQLite3，前端是Vue3，整个系统极其轻量，对硬件资源占用微乎其微，部署流程也是异常简单。而且支持多种存储方案，不仅可以直接存在NAS的本地硬盘，如果你有需要，还可以轻松接入S3兼容对象存储、OneDrive等云端策略。

其次是可以做到匿名安全。FileCodeBox不用注册账号，支持直接拖拽、复制粘贴，甚至可以用命令行curl上传，即传即走。安全性方面也不用担心，它支持管理员认证，有IP上传频率和提取码错误次数限制，还能自动清理过期文件。

最后是全平台适配。FileCodeBox拥有自适应的响应式设计和深色模式，无论是在PC这类笔电的宽屏上，还是在手机、平台的浏览器中，体验都如丝般顺滑。

二、NAS部署流程

这里我们来展示如何在威联通NAS上使用Docker形式部署FileCodeBox，用到的设备是威联通最新的8盘位旗舰新品Qu805。

这里比较推荐大家使用Docker Compose的方式来部署，一键复制粘贴代码即可，非常方便。

在使用前，我们需要先在NAS给FileCodeBox创建用于临时保存文件的文件夹，比如这里我使用的地址是/share/Container/filecodebox/data。

接下来，打开威联通 Container Station，点击左侧的「应用程序」，然后点击右侧黑色「创建」按钮，粘贴以下代码：

services: filecodebox: image: lanol/filecodebox:latest container_name: filecodebox restart: unless-stopped ports: - "12345:12345" # 左侧为外部访问端口，若与NAS已有服务冲突可自行修改，如改为 "8899:12345" volumes: # 冒号左侧为你NAS上的绝对路径，请根据NAS的实际卷标修改 - /share/Container/filecodebox/data:/app/data environment: - WORKERS=4 - LOG_LEVEL=info

部署完成后，可以在Contain Station中看到正在运行的应用程序和容器：

三、使用方法

部署完成后，我们只要在PC或者手机浏览器中输入 http://:<端口号>，比如我家是http://192.168.10.70:12345，就可以直接访问项目页面了，界面非常清爽。

移动端浏览器访问的界面也是同样美观简洁：

1.发送文件

以PC端为例，如果要发送文件，那么点击下图箭头指向位置：

然后点击或者拖放需要上传的文件即可，同时这里还可以选择文件的过渡时间：

上传完毕后，点击「安全寄送」，即可生成取件码和相应的二维码：

2.接收文件

FileCodeBox接收文件的操作同样很方便，在首页中输入取件码，然后直接就会弹出文件下载页面，点击下载即可：

在手机端也是同样的操作流程：

3.后台管理

有些细心的朋友可能已经发现了，在刚才的演示中，FileCodeBox默认支持最大传输10MB的文件，这显然有些太小了。

幸好作者提供了进一步的设置选项，我们可以根据自己需要进行修改。

首先在FileCodeBox首页点击下图中箭头指向的小人图标，或者输入http://:<端口号>/#/admin/settings：

当前版本中，FileCodeBox的默认管理密码是FileCodeBox2023，登录后即可进入后台，有「仪表盘」、「文件管理」、「系统设置」等模块：

这里我们重点关注下系统设置模块，在这里为了增强安全性，我们可以对默认的管理员密码进行修改：

继续向下拉，可以按需修改上传设置以及访问保护等选项，修改完成后点击「保存设置」即刻生效。

最后提醒一下，如果大家需要给FileCodeBox配置Nginx等反向代理的话，可以去GitHub项目主页查看配置方式。

就我个人而言，还是更喜欢结合上一篇分享过的EasyTier异地组网方案来使用，感觉也很省心。

四、总结

FileCodeBox这个小工具，是开源软件“小而美”的典范，它部署起来非常简单，也没有花里胡哨的社交功能，只是专注于本职功能，在后期维护和数据迁移等方面也很易用。

对于经常需要跨设备传输文件的朋友来说，这NAS上相当值得常驻的Docker服务，而且也占用不了多少系统资源，很建议大家动手部署体验一下。

如果你在部署或配置网络的过程中遇到任何问题，欢迎在评论区留言交流。

最后提醒下，威联通的618活动依然在生效，分享活动页面和购买NAS都能抽奖，有兴趣朋友别忘了去试试手气~