# 虚谷数据库分布式架构

> XuguDB 分布式架构部署与集群管理，涵盖标准版/企业版/分布式版/安全版四种部署模式

- **Type:** Skill
- **Install:** `agentstack add skill-kourou25-xugudb-dev-skills-xugudb-distributed`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [kourou25](https://agentstack.voostack.com/s/kourou25)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [kourou25](https://github.com/kourou25)
- **Source:** https://github.com/kourou25/xugudb-dev-skills/tree/master/skills/xugudb-distributed

## Install

```sh
agentstack add skill-kourou25-xugudb-dev-skills-xugudb-distributed
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 虚谷数据库分布式架构

## 概述

虚谷数据库（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 自动切片，打散均衡分布到各存储节点
- **多副本机制**：default_copy_num 控制副本数（分布式版建议 3），safely_copy_num 控制安全副本数
- **在线扩展**：按需增加节点，数据自动迁移均衡

## 高可用部署方案

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](https://github.com/kourou25)
- **Source:** [kourou25/xugudb-dev-skills](https://github.com/kourou25/xugudb-dev-skills)
- **License:** Apache-2.0

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-kourou25-xugudb-dev-skills-xugudb-distributed
- Seller: https://agentstack.voostack.com/s/kourou25
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.