5分钟搭建你的专属文件快递柜 - FileCodeBox 完整教程
"像取快递一样简单,让文件分享回归本质"
还记得那些年我们为了传个文件而绞尽脑汁的日子吗?微信文件大小限制、网盘注册繁琐、邮箱附件太慢... 今天我要给大家推荐一个让我眼前一亮的开源项目 —— FileCodeBox,它彻底改变了我们对文件分享的认知。
📦 什么是FileCodeBox?
FileCodeBox 是一个基于 FastAPI + Vue3 开发的轻量级文件分享工具,由国内开发者 vastsa 精心打造,目前在GitHub上已获得 7.8k+ stars 的认可
它的核心理念非常简单:像取快递一样取文件。想象一下,你把文件"寄存"到一个虚拟的快递柜里,设置一个取件码,然后告诉对方这个取件码,对方就能像取快递一样轻松取出文件








✨ 让人眼前一亮的特性
🎭 匿名使用,零门槛分享
无需注册登录: 上传文件就像扫码取快递一样简单
保护隐私: 不需要暴露个人信息
即用即走: 分享完毕即可离开,干净利落
🔐 安全可靠,防护到位
口令保护: 每个文件都有独特的提取码
防爆破功能: 有效防止恶意猜测密码
IP限制: 可设置访问限制,提升安全性
过期机制: 文件可设置有效期,自动清理
📁 多格式支持,应有尽有
文本分享: 支持纯文本、代码片段等
文件上传: 各种格式文件都能轻松分享
批量处理: 支持同时分享多个文件
大文件友好: 相比传统聊天工具,限制更宽松
💾 灵活存储,按需选择
本地存储: 默认使用本地存储,简单可靠
云存储支持: 集成阿里云OSS等云存储服务
可扩展性: 根据需求选择合适的存储方案
🛠️ 快速部署指南
方式一:Docker CLI部署
docker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:beta方式二:Docker Compose部署(推荐)
1.创建文件夹以方便管理并进入
mkdir -p /docker/filecodebox && cd /docker/filecodebox2.创建docker-compose.yml文件并写入
ports:12345:12345 前面为宿主机对外端口,可自行根据需求修改,例:50000:12345
version: "3"
services:
file-code-box:
image: lanol/filecodebox:latest
volumes:
- fcb-data:/app/data:rw
restart: unless-stopped
ports:
- "12345:12345"
volumes:
fcb-data:
external: false3.访问服务:
打开浏览器访问 http://localhost:12345
配置反向代理(Nginx示例)
location / {
proxy_set_header X-Real-IP $remote_addr; # 设置真实客户端IP
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://localhost:12345;
}📖 使用说明
分享文件
打开网页,点击"分享文件"
选择或拖拽文件
设置过期时间和次数
获取提取码
获取文件
打开网页,输入提取码
点击获取
下载文件或查看文本
管理面板
访问
/#/admin输入默认管理员密码
FileCodeBox2023管理文件和配置
评论