Cloud Blox 架构文档#

文档说明#

本目录从产品、部署和运维视角说明 Cloud Blox 的整体架构、关键数据流、可靠性边界与安全能力，帮助你在部署前理解系统由哪些部分组成、数据如何流动、哪些环节需要重点保护。

不同发行版和后续版本可能调整功能，实际能力以安装包、授权信息和管理控制台为准；各版本的功能变化见 服务端更新日志。

这些文档不包含源码编译步骤、内部文件路径或代码实现说明，也不替代生产环境压测、渗透测试和恢复演练。

文档地图#

1. 系统上下文与产品边界

   • 适合第一次了解平台；
   • 说明参与者、外部系统、四个产品平面和责任边界。

2. 服务拓扑与节点角色

   • 适合部署人员和架构负责人；
   • 说明四类入口、共享端口、主节点、区域节点和部署层级。

3. 数据职责与对象生命周期

   • 适合存储、计费和客户端集成人员；
   • 说明 MySQL、Redis、ClickHouse、缓存、上传、读取、删除、同步和计费。

4. 异步任务与可靠性

   • 适合运维和故障处理人员；
   • 说明七类队列、任务状态、租约、重试、区域路由和计划任务。

5. 管理控制台与桌面客户端

   • 适合管理员与终端用户支持人员；
   • 说明两类客户端的职责、上传、同步、冲突、认证和平台边界。

6. 部署与运维架构

   • 适合安装、运维和 SRE；
   • 说明标准安装、端口、持久化、容量、健康、备份、升级和高可用演进。

7. 安全与可观测性

   • 适合安全、运维和技术负责人；
   • 说明认证、授权、秘密、日志、探针、指标、追踪和 SLO。

推荐阅读路径#

首次了解#

01 → 02 → 03 → 05

先理解平台边界和对象生命周期，再选择管理控制台或桌面客户端专题。

安装与运维#

02 → 04 → 06 → 07

重点关注依赖、队列、磁盘、探针、备份、告警和故障恢复。安装操作步骤见 安装教程。

安全与合规#

01 → 03 → 07 → 06

重点关注认证方式、访问控制、密钥与日志脱敏、备份与恢复要求。

存储与计费#

03 → 04 → 07

重点关注物理引用、最终一致性、计费事件、小时快照和恢复能力。

客户端集成#

03 → 05 → 07

重点关注客户端协议、断点续传、同步修订、冲突处理和凭据安全。

核心术语#

• Admin：管理控制台、管理 API 和客户端协议所在的控制入口。
• S3：面向标准 S3 客户端的协议入口。
• Access：资源域名访问、缓存、回源和媒体处理入口。
• WebDAV：面向 WebDAV 客户端的挂载入口。
• 主通道：对象最终内容的主要存储位置。
• 副本通道：为容灾保存冗余内容的存储位置。
• 临时文件：请求已接收、尚未完成最终通道同步的本地内容。
• 业务事实：能够决定对象、任务、余额和账单真实状态的持久数据。
• 最终一致性：业务事实先提交，队列、存储、缓存和分析数据随后通过重试达到一致。
• 修订号：桌面同步用于判断远端变化和冲突的单调版本标识。
• 结算水位：计费系统最后完成结算的日期边界。

事实状态#

文档中的描述分为两类：

• 当前能力：可从当前产品行为和配置确认；
• 版本相关：受免费版、商业版或源码版影响，见 版本说明。

整体结构#

Cloud Blox 由「多协议入口 + 业务数据库 + Redis 异步平面 + ClickHouse 分析平面 + 插件化存储 + 桌面 / 移动客户端同步」组成：

1. 管理端、S3、资源访问、WebDAV 四类入口共享同一套存储桶与对象语义；
2. 上传、删除、回源、备份等长耗时操作都以持久任务方式异步执行，可重试、可恢复；
3. 对象内容可分布在多种存储通道并保留副本，主通道故障时仍可读取；
4. 访问日志、计费事件与业务数据相互隔离，互不阻塞；
5. 多区域节点共享同一套数据库，就近处理数据。

生产部署的默认拓扑、端口、备份与升级建议见 部署与运维架构。