FileCodeBox：革命性匿名文件分享平台全面解析

2026-02-04 04:30:10作者：裴麒琰

你还在为文件传输时的隐私泄露担忧吗？还在为大文件分享的复杂流程烦恼吗？FileCodeBox——这款被誉为"文件快递柜"的开源神器，将彻底改变你的文件分享方式。无需注册登录，只需一个提取码，就能像取快递一样安全便捷地收发文件。读完本文，你将全面掌握这款工具的安装部署、核心功能与高级技巧，让匿名文件传输变得前所未有的简单。

📦 项目简介：什么是FileCodeBox？

FileCodeBox是一个基于FastAPI+Vue3开发的轻量级文件分享工具，它允许用户通过简单的方式分享文本和文件，接收者只需要一个提取码就可以取得文件，就像从快递柜取出快递一样简单。该项目采用前后端分离架构，后端使用Python的FastAPI框架提供高效API服务，前端则基于Vue3构建现代化用户界面。

项目核心代码结构清晰，主要分为应用层和核心层：

应用代码：apps/
- 管理后台：apps/admin/
- 基础功能：apps/base/
核心功能：core/
- 数据库配置：core/database.py
- 存储管理：core/storage.py
- 系统设置：core/settings.py

✨ 核心特性：为什么选择FileCodeBox？

FileCodeBox凭借其独特的设计理念和丰富功能，在众多文件分享工具中脱颖而出：

🔒 隐私保护与安全机制

完全匿名：无需注册登录即可使用所有功能
灵活权限：可自定义文件有效期和下载次数
多重防护：IP限制上传次数、错误次数限制、文件自动过期

🚀 便捷高效的操作体验

多种上传方式：支持复制粘贴、拖拽上传
响应式设计：完美适配桌面和移动设备
多语言支持：中文简体、繁体及英文

💾 灵活的存储与扩展能力

多存储支持：本地存储、S3协议、OneDrive等
容器化部署：Docker一键部署，轻松扩展
终端支持：命令行方式下载文件，适合开发者使用

🚀 快速上手：3分钟部署指南

Docker一键部署

最推荐的部署方式是使用Docker，只需一条命令即可启动服务：

docker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:beta

或者使用Docker Compose进行更灵活的配置：

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

手动部署

对于需要自定义配置的用户，可选择手动部署：

克隆项目代码库

git clone https://gitcode.com/GitHub_Trending/fi/FileCodeBox

安装依赖

cd FileCodeBox
pip install -r requirements.txt

启动服务

python main.py

📖 使用教程：从入门到精通

分享文件的简单步骤

打开FileCodeBox网页界面
点击"分享文件"按钮
选择或拖拽文件到上传区域
设置文件过期时间和最大下载次数
获取提取码并分享给接收者

获取文件的方法

访问FileCodeBox网站
在提取码输入框中输入收到的提取码
点击"获取"按钮
下载文件或查看文本内容

管理面板使用

访问 /#/admin 进入管理界面
使用默认管理员密码 FileCodeBox2023 登录
管理文件、配置系统参数、查看统计信息

官方文档：docs/guide/

🛠️ 高级配置：打造个性化文件分享服务

存储配置

FileCodeBox支持多种存储方式，可在管理面板中进行配置：

本地存储：适合单机部署
S3协议：兼容各种云存储服务
OneDrive：微软云存储集成

存储模块实现：core/storage.py

Nginx反向代理配置

为确保正确处理客户端IP和代理请求，推荐添加以下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; 
}