基于 FileCodeBox 的安全加固增强版（前后端分离 + 19项安全修复）Security-Enhanced Edition

[lichangfeng-1]

中文版

前言

感谢作者开发了 FileCodeBox 这个优秀的项目！我在实际使用中借助 AI 编程助手（Qoder）做了一些安全加固和功能增强，分享出来供社区参考。

项目地址

👉 https://github.com/lichangfeng-1/FileCodeBox-Enhanced

主要改进

🔒 安全加固（19项修复）

• 路径穿越漏洞修复
• CORS 凭证跨域风险修复
• 文件类型 magic bytes 深度校验（防扩展名伪造）
• 管理员登录防暴力破解（可配置）
• Docker 容器非 root 运行
• 下载 Token 时间窗口竞态修复
• 云存储 session 泄漏修复
• 多数据库 SQL 占位符兼容（PostgreSQL/MySQL）
• 等（完整列表见仓库 CHANGELOG）

✨ 功能增强

• 前后端分离架构（Nginx + FastAPI + Vue 3）
• 审计日志系统（IP 归属地 + UA 解析）
• 秒传去重（SHA256 哈希匹配，支持 3GB 大文件）
• Webhook 事件通知（SSRF 防护 + 指数退避重试）
• 存储配额管理
• 文件健康状态分析
• 毛玻璃 UI + 暗色模式

📦 部署方式

• Docker Compose 一键部署（推荐）
• 源码部署（免 Docker，SQLite 零配置）

与原版的关系

• 基于 FileCodeBox v2.5.0 二次开发
• 已向上游提交安全修复 PR：[Security] 安全漏洞修复合集（6项 Critical/High） #494
• 独立分支演进，不强制合并

测试

• 183 个自动化测试用例，全部通过
• 覆盖安全攻击向量、边界条件、多数据库兼容

开发工具

本项目的安全审计、代码修复、测试编写、文档生成全程由 AI 编程助手辅助完成：

🤖 Qoder（阿里巴巴出品的智能编程助手，集成于 IDE 中）
邀请链接：https://qoder.com.cn/referral?referral_code=UJ9dmUSYAzA61kXO5sCmCDSS2LZg4eQn
注册即领 2,000 积分，完成学生/教师认证再领 4,000 积分。

---

English Version

Introduction

Thanks to the author for creating FileCodeBox! With the help of an AI coding assistant (Qoder), I've made security hardening and feature enhancements for real-world use. Sharing with the community for reference.

Repository

👉 https://github.com/lichangfeng-1/FileCodeBox-Enhanced

Key Improvements

🔒 Security Hardening (19 fixes)

• Path traversal vulnerability fix
• CORS credentials misconfiguration fix
• File type magic bytes deep validation (anti extension spoofing)
• Admin login brute-force protection (configurable)
• Docker non-root container execution
• Download token time-window race condition fix
• Cloud storage session leak fix (S3/OneDrive/WebDAV)
• Multi-database SQL placeholder compatibility (PostgreSQL/MySQL)
• And more (see CHANGELOG for full list)

✨ Feature Enhancements

• Separated frontend/backend architecture (Nginx + FastAPI + Vue 3)
• Audit logging system (IP geolocation + UA parsing)
• Instant upload / deduplication (SHA256 hash, supports 3GB files)
• Webhook event notifications (SSRF protection + exponential backoff)
• Storage quota management
• File health status analysis
• Glassmorphism UI + dark mode

📦 Deployment

• Docker Compose one-click deploy (recommended)
• Source deploy (no Docker required, SQLite zero-config)

Relationship to Upstream

• Based on FileCodeBox v2.5.0
• Security fix PR submitted upstream: [Security] 安全漏洞修复合集（6项 Critical/High） #494
• Independent branch evolution

Testing

• 183 automated test cases, all passing
• Covers security attack vectors, boundary conditions, multi-DB compatibility

Development Tool

This project's security audit, code fixes, test writing, and documentation were all assisted by an AI coding assistant:

🤖 Qoder (AI coding assistant by Alibaba, integrated in IDE)
Referral: https://qoder.com.cn/referral?referral_code=UJ9dmUSYAzA61kXO5sCmCDSS2LZg4eQn
Sign up to get 2,000 credits, plus 4,000 more with student/teacher verification.

---

如有任何问题或建议，欢迎在增强版仓库提 Issue。再次感谢原作者的工作！🙏