高性能文件/文本匿名分享平台(Go + Hertz + GORM 后端,Vue3 前端),按角色拆分的多仓库结构。
| 仓库 | 角色 | 说明 |
|---|---|---|
| contracts | 契约层 | 统一错误码 + Thrift 生成类型,纯类型零业务依赖,所有实现方的单一真相源 |
| core | 业务核心库 | 10 个域服务 + repo/storage + bootstrap 库入口,Bootstrap() 一次调用拉起全部业务 |
| server | 独立部署应用 | 薄壳入口 + 前端静态资源 + Dockerfile,自托管标准形态 |
| frontend | Web 前端 | Vue3 + TS + Vite + Element Plus,API 类型由 openapi.json 自动生成 |
| filecodebox-fnos | 飞牛 fnOS 应用 | 单容器库式复用 core,接入飞牛 SSO/共享目录/通知/内网穿透 |
| FileCodeBox | 装配仓(umbrella) | 入口仓库:make setup 一键拉齐全部模块并统一构建/测试/部署;拆分前完整版本在 legacy 分支 |
frontend ─┐
server ───┼──► core ──► contracts
fnos ─────┘
单向依赖,CI 强制守护(contracts 零项目内依赖;core 不依赖任何下游)。
📐 完整架构图集:生态全景 / 仓库依赖 / core 分层 / 请求流 / 数据流 / 部署形态 / 发布流水线。
git clone https://github.com/filescodebox/FileCodeBox.git && cd FileCodeBox
make setup && make smoke # 一键拉齐模块 + 冒烟
# 或纯 Docker:
docker run -d -p 12345:12345 \
-e FCB_JWT_SECRET=$(openssl rand -hex 32) \
ghcr.io/filescodebox/server:latest默认管理员 admin / admin123(生产务必修改并注入 FCB_ADMIN_PASSWORD)。
各仓库独立语义化版本,镜像经 GitHub Actions 打 tag 自动发布至 ghcr.io/filescodebox。