虚谷数据库分布式架构

虚谷数据库分布式架构

概述

虚谷数据库（XuguDB）采用原生 Shared-Nothing（完全无共享） 分布式架构，支持从单机到多节点集群的灵活部署。通过 License 控制不同版本功能，提供五种产品形态：

| 版本 | 节点规模 | 定位 | |------|----------|------| | 个人版 | 单机/多机 | 免费试用（360 天），功能受限 | | 标准版 | 单机 | 中小规模业务，可无损扩展至分布式 | | 企业版 | 双节点 | 双机热备，自动故障切换 | | 分布式版 | 3~N 节点 | 水平扩展，大规模数据处理与高并发 | | 安全版 | 单机/双机 | 增强安全审计，满足涉密要求 |

五类节点角色

集群中按功能职责划分为五类角色（通过 cluster.ini 的 ROLE 参数配置）：

| 角色标识 | 名称 | 职责 | |----------|------|------| | M | 主控管理角色 | 集群管理、心跳检测、全局锁仲裁（必须配置 2 个，构成主备） | | Q | 查询角色 | 建立 TCP 监听端口，对外服务入口；只有含 Q 角色的节点才能接受外部客户端连接 | | W | 工作计算角色 | 并发并行任务调度与计算处理，生成执行计划，与存储角色交互完成数据读写 | | S | 存储管理角色 | 数据持久化，多副本冗余，8MB CHUNK 自动切片 | | G | 变更收集角色 | 收集事务级数据变更信息（最多 2 个节点，可选部署） |

> 重要规则：Q 和 W 必须组合部署（QW），不存在单独的 Q 或单独的 W。 Q 负责建立 TCP 监听端口对外提供服务入口，W 负责并发并行任务调度与计算处理，两者配合实现完整的请求接入与任务执行。所有 QW 节点完全对等，用户连接任一 QW 节点即可访问其权限内的所有数据。

> 一台物理服务器可部署一个或多个角色（存算融合部署）。合法的 ROLE 组合示例：ROLE=M、ROLE=QW、ROLE=S、ROLE=MQWS、ROLE=SQW、ROLE=SQWG。

架构特性

• QW 组合部署：Q（TCP 监听/对外服务入口）和 W（并发并行任务调度/计算处理）始终联合部署，不可单独配置；只有含 Q 的节点才能对外服务，不含 Q 的节点仅参与集群内部通信
• 节点对等处理：所有 QW 节点均可接收用户请求，无需访问特定服务端
• 存算分离/融合：支持存储与计算分开部署，也支持单节点多角色融合
• 切片化存储：以 8MB 物理 CHUNK 自动切片，打散均衡分布到各存储节点
• 多副本机制：defaultcopynum 控制副本数（分布式版建议 3），safelycopynum 控制安全副本数
• 在线扩展：按需增加节点，数据自动迁移均衡

高可用部署方案

XuguDB 支持多级高可用部署：

1. 数据中心部署：存算分离 + 管理节点双活冗余
2. 同城双活部署：两个对称数据中心实时双向同步，RPO=0
3. 同城灾备部署：基于 Binlog 增量同步，RPO=0，RTO<30s
4. 两地三中心部署：同城灾备 + 异地灾备（异步复制），防范区域级灾难

参考文档

• [部署指南](references/deployment.md) - 各版本部署步骤、cluster.ini 参数、目录结构
• [集群管理](references/cluster-management.md) - 节点管理、在线扩缩容、故障切换、数据均衡

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: kourou25
• Source: kourou25/xugudb-dev-skills
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.