文章目录
- 前言
- 1.Docker部署
- 2.简单使用演示
- 3. 安装cpolar内网穿透
- 4. 配置公网地址
- 5. 配置固定公网地址
前言
在数字化办公需求日益增长的今天，文件传输已成为职场协作的高频刚需。传统共享方式却饱受诟病："需要安装哪些臃肿客户端？免费版本的传输速度慢得令人抓狂！反复弹出的广告让人怀疑软件安全性！"今天，我将带您了解一款颠覆性文件交互方案——FileCodeBox（智能文件中转站）。
这款开源文件传输平台以极简交互设计和军工级安全防护为核心，重新定义了数据交互标准。其最大的技术亮点在于创新性的部署模式：无需公网IP或云端服务器，通过Docker容器技术即可完成系统部署，结合cpolar内网穿透工具即可实现跨地域访问。现在让我们以Ubuntu操作系统为载体，逐步揭开这个智能文件传输系统的部署奥秘。
【视频教程】
1分钟搭建个人文件快递柜
1.Docker部署
本例使用Ubuntu 22.04进行演示，使用Docker进行部署，如果没有安装Docker，可以查看这篇教程进行安装：《Docker安装教程——Linux、Windows、MacOS》
安装好Docker后，打开终端执行这行命令即可一键安装：
sudo docker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:beta
若国内用户无法安装可以暂时使用下面命令：
sudo docker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox dc.065065.xyz/lanol/filecodebox:beta
2.简单使用演示
容器启动后，我们在Ubuntu中使用浏览器访问 http://localhost:12345 即可打开FileCodeBox的前端Web页面：
而后端地址是：/#/admin
后台密码：FileCodeBox2023，登录后台后可以修改。
在管理后台，我们还可以对存储方式，上传间隔时间，文件大小，保存时间，错误限制等设置进行修改：
我这里简单修改了一下文件大小限制为500M，修改后点击保存设置即可。
此时，我们回到前端界面，点击发送文件：
可以看到文件限制大小更改为了500M，默认为10M：
上传一张照片或其他文件后，点击安全寄送，可以看到右上角有提示上传成功与取件码提示：
如果提示消失过快，也可以点击右侧发件记录中文件右侧的眼睛图标，查看相关信息：
点击眼睛图标左侧的标志，可以复制这个分享文件的链接，在局域网内发给其他人后，使用取件码即可下载文件：
3. 安装cpolar内网穿透
不过我们目前只能在本地局域网内访问刚刚部署的FileCodeBox来分享与下载文件，如果想不在同一局域网内时，也能在外部网络环境使用手机、平板、电脑等设备远程访问与使用它，应该怎么办呢？我们可以使用cpolar内网穿透工具来实现远程访问的需求。无需公网IP，也不用准备云服务器那么麻烦。
下面是安装cpolar步骤：
Cpolar官网地址: https://www.cpolar.com
使用一键脚本安装命令：
sudo curl https://get.cpolar.sh | sh
安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）
sudo systemctl status cpolar
Cpolar安装和成功启动服务后，在浏览器上输入ubuntu主机IP加9200端口即:【http://localhost:9200】访问Cpolar管理界面，使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：
4. 配置公网地址
登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道：
- 隧道名称：可自定义，本例使用了: FileCodeBox，注意不要与已有的隧道名称重复
- 协议：http
- 本地地址：12345
- 域名类型：随机域名
- 地区：选择China Top
点击创建：
创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了两个公网地址，接下来就可以在其他电脑或者移动端设备（异地）上，使用任意一个地址在浏览器中访问即可。
如图所示，现在就已经成功实现使用公网地址异地远程访问本地部署的FileCodeBox来分享与下载文件啦！
如果需要使用这个公网地址登录后台，也是在#后添加/admin，输入后台密码即可：
小结
为了方便演示，我们在上边的操作过程中使用cpolar生成的HTTP公网地址隧道，其公网地址是随机生成的。这种随机地址的优势在于建立速度快，可以立即使用。然而，它的缺点是网址是随机生成，这个地址在24小时内会发生随机变化，更适合于临时使用。
如果有长期使用FileCodeBox，或者异地访问与使用其他本地部署的服务的需求，但又不想每天重新配置公网地址，还想让公网地址好看又好记并体验更多功能与更快的带宽，那我推荐大家选择使用固定的二级子域名方式来配置公网地址。
5. 配置固定公网地址
使用cpolar为其配置二级子域名，该地址为固定地址，不会随机变化。
点击左侧的预留，选择保留二级子域名，地区选择china top，然后设置一个二级子域名名称，我这里演示使用的是myfilebox，大家可以自定义。填写备注信息，点击保留。
保留成功后复制保留的二级子域名地址：
登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道FileCodeBox，点击右侧的编辑。
修改隧道信息，将保留成功的二级子域名配置到隧道中
- 域名类型：选择二级子域名
- Sub Domain：填写保留成功的二级子域名
- 地区: China Top
点击更新
更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。
最后，我们使用固定的公网地址在任意设备的浏览器中访问，可以看到成功访问本地部署的FileCodeBox页面，这样一个永久不会变化的二级子域名公网网址即设置好了。
了解更多项目详情大家可以访问作者github主页进行查看：https://github.com/vastsa/FileCodeBox
本教程完整演示了如何在Ubuntu系统中，通过容器化部署与内网穿透技术构建自主可控的文件传输系统。这种突破传统部署范式的实践，不仅简化了网络配置复杂度，更验证了开源技术在安全性和灵活性方面的双重优势。当处理敏感文档或进行远程协作时，该方案能有效规避第三方平台的潜在风险，同时保障传输过程的端到端加密。对于开发者而言，FileCodeBox的模块化架构仍有许多可拓展的创新方向，欢迎在评论区分享您的应用场景。如需进一步探讨技术细节或获取定制化配置建议，请随时在技术社区发起讨论。您的每一个反馈都将助力开源生态持续优化。
))
