FileCodeBox文件分享系统快速入门指南

FileCodeBox文件分享系统快速入门指南

FileCodeBox FileCodeBox - 一个匿名口令分享文本和文件的服务，用户可以通过口令像取快递一样获取文件，适合需要匿名文件共享的开发者和用户。 项目地址: https://gitcode.com/gh_mirrors/fi/FileCodeBox

项目概述

FileCodeBox是一款轻量级的文件分享系统，专为需要临时中转或分享文件的用户设计。它采用了简洁的架构和直观的操作界面，让文件分享变得简单而高效。无论是个人用户还是小型团队，都可以快速部署并使用这套系统来管理文件分享需求。

核心功能详解

1. 文件分享机制

FileCodeBox采用"链接+提取码"的双重验证机制，确保文件分享的安全性。上传文件后，系统会生成一个唯一的分享链接和对应的提取码，接收方需要同时拥有这两项信息才能下载文件。

2. 时效性控制

系统支持为每个文件设置有效期，支持以下时间单位：

• 分钟（m）
• 小时（h）
• 天（d）
• 周（w）
• 月（M）

例如，设置"7d"表示文件将在7天后自动删除。

3. 下载次数限制

上传文件时可以设置最大下载次数，当下载次数达到设定值后，文件将自动失效。这一功能特别适合需要控制文件传播范围的场景。

系统部署方案

推荐方案：Docker部署

Docker部署是最简单快捷的方式，适合大多数用户：

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

参数说明：

• --restart=always：确保容器意外退出后自动重启
• -p 12345:12345：将容器内12345端口映射到主机
• -v /opt/FileCodeBox/:/app/data：挂载数据卷，确保文件持久化存储

手动部署方案

适合需要自定义配置的开发环境：

1. 获取项目源代码
2. 安装Python依赖：pip install -r requirements.txt
3. 启动服务：python main.py

使用指南

1. 文件上传流程

1. 访问系统首页（默认地址：http://localhost:12345）
2. 点击上传按钮或直接拖拽文件到指定区域
3. 设置文件参数：
   • 有效期（如：1h、3d等）
   • 最大下载次数（0表示无限制）
4. 获取系统生成的分享链接和提取码

2. 文件下载流程

1. 访问分享链接
2. 输入正确的提取码
3. 点击下载按钮获取文件

3. 后台管理

管理员可以通过以下方式访问后台：

1. 访问 /admin 路径
2. 使用默认密码登录（首次部署后请立即修改）

后台功能包括：

• 系统运行状态监控
• 所有文件管理
• 用户访问日志查看
• 系统参数配置

最佳实践建议

1. 安全建议：

   • 部署后立即修改默认管理员密码
   • 定期检查系统日志
   • 对敏感文件设置较短的时效和下载次数限制

2. 性能优化：

   • 对于大文件分享，建议使用外部存储方案
   • 高并发场景下可考虑增加缓存层

3. 维护建议：

   • 定期备份挂载卷中的数据
   • 关注系统更新，及时升级到最新版本

常见问题解答

Q：文件上传大小有限制吗？ A：默认情况下，系统支持最大100MB的文件上传，可通过配置调整。

Q：如何修改服务端口？ A：在Docker运行时修改-p参数，如-p 8080:12345表示外部使用8080端口访问。

Q：文件存储在哪里？ A：Docker部署时，文件存储在挂载的卷中（示例中为/opt/FileCodeBox）。

通过本指南，您应该已经掌握了FileCodeBox的基本部署和使用方法。这套系统设计简洁但功能实用，特别适合需要临时文件分享的场景。如需更高级的功能配置，可以参考系统的详细文档进行进一步设置。

FileCodeBox FileCodeBox - 一个匿名口令分享文本和文件的服务，用户可以通过口令像取快递一样获取文件，适合需要匿名文件共享的开发者和用户。 项目地址: https://gitcode.com/gh_mirrors/fi/FileCodeBox