5分钟搭建你的专属文件快递柜 - FileCodeBox 完整教程

"像取快递一样简单,让文件分享回归本质"

还记得那些年我们为了传个文件而绞尽脑汁的日子吗?微信文件大小限制、网盘注册繁琐、邮箱附件太慢... 今天我要给大家推荐一个让我眼前一亮的开源项目 —— FileCodeBox,它彻底改变了我们对文件分享的认知。

📦 什么是FileCodeBox?

FileCodeBox 是一个基于 FastAPI + Vue3 开发的轻量级文件分享工具,由国内开发者 vastsa 精心打造,目前在GitHub上已获得 7.8k+ stars 的认可

它的核心理念非常简单:像取快递一样取文件。想象一下,你把文件"寄存"到一个虚拟的快递柜里,设置一个取件码,然后告诉对方这个取件码,对方就能像取快递一样轻松取出文件

filecodebox2024-1.png

filecodebox2024-2.png

img_10.png

img_9.png

✨ 让人眼前一亮的特性

🎭 匿名使用,零门槛分享

  • 无需注册登录: 上传文件就像扫码取快递一样简单

  • 保护隐私: 不需要暴露个人信息

  • 即用即走: 分享完毕即可离开,干净利落

🔐 安全可靠,防护到位

  • 口令保护: 每个文件都有独特的提取码

  • 防爆破功能: 有效防止恶意猜测密码

  • 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/filecodebox

2.创建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: false

3.访问服务:

打开浏览器访问 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; 
}

📖 使用说明

分享文件

  1. 打开网页,点击"分享文件"

  2. 选择或拖拽文件

  3. 设置过期时间和次数

  4. 获取提取码

获取文件

  1. 打开网页,输入提取码

  2. 点击获取

  3. 下载文件或查看文本

管理面板

  1. 访问 /#/admin

  2. 输入默认管理员密码 FileCodeBox2023

  3. 管理文件和配置

评论