高级集群部署：高可用与多主节点

## 架构概述
LarkXR 4.0 采用分布式微服务架构，包含以下服务层：
- **接入层：** Nginx（反向代理与负载均衡）
- **管理节点集群：** 多个 Admin 实例共享 MySQL 8.0、Redis 与对象存储（Local/OSS/OBS/S3/MinIO）
- **渲染节点集群：** 多个 Agent+Render 实例通过 OkHttp 连接
该架构同时支持单机与集群部署。可根据生产需求拆分与组合服务，以优化并发能力与高可用性。
**单机部署：** 全部服务运行在一台 GPU 服务器上。
**简易集群部署：** 渲染与代理服务运行在 GPU 服务器上；管理与存储服务运行在非 GPU 服务器上。增加更多 GPU 节点可提升并发处理能力。
**高级集群部署：** 将管理节点服务进一步拆分到独立服务器，并通过冗余部署实现高可用。
## 服务器要求
| 组件 | 版本 | 规格 | 操作系统 | 数量 | 备注 |
|---|---|---|---|---|---|
| Redis | 6.0.8 | 8 核 16GB | Ubuntu 20.04 | 1 | - |
| Nginx | 1.21.0 | 8 核 16GB | Ubuntu 20.04 | 1 | 从官网下载简易集群安装包 |
| MySQL | 8.0 | 8 核 16GB | Ubuntu 20.04 | 1 | 手动创建 UTF-8 编码的 `larkxr_center` 数据库 |
| LarkXR 4.0 管理服务 | 3.2.8.2+ | 8 核 16GB | Ubuntu 20.04 或 Windows | 1 | 需要 JDK 17 |
| LarkXR 4.0 渲染服务 | 3.2.8.2+ | GPU 服务器 | Windows Server 2019 | n | - |
## 安装指南
从 [https://www.pingxingyun.com/devCenter.html#devDL](https://www.pingxingyun.com/devCenter.html#devDL) 下载简易集群版安装包。
### Windows 管理节点（`larkxr-center-win`）
#### 步骤 1：设置本机 IP 地址
在 `application.properties` 中，将 `server.node-ip` 设为本机 IP 地址。除 `admin` 外，禁用其余服务组件。
#### 步骤 2：配置 Redis 与数据库
打开 `admin/application.yaml`，更新 Redis 与 MySQL 连接地址。
#### 步骤 3：配置 Nginx
将下载的简易集群 Nginx 文件夹中的配置文件（`conf/conf.d`、`admin-back`、`admin-front`）复制到 Nginx 部署目录。
确保 `nginx.conf` 包含：
```nginx
include conf.d/*.conf;
```
将反向代理地址设置为管理节点的 IP 地址。
## 多主节点配置
为实现高可用，在 Nginx 后方部署多个 admin 服务实例。
### 步骤 1：配置额外的 Admin 服务
对每台额外的 admin 服务器重复单节点配置步骤并启动服务。
#### 步骤 2：更新 Nginx 配置
添加 upstream 服务器块，并更新反向代理以在所有 admin 实例间负载均衡。
#### 步骤 3：将应用存储切换为对象存储
在后台管理门户的系统设置中，将存储方式改为对象存储。详情见 [How to Change to Object Storage?](https://docs.pingxingyun.com/doc/1980/)。
#### 步骤 4：配置 Worker ID 以避免主键冲突
在每个 admin 节点的 `application.properties` 中设置唯一的 worker ID：
```properties
# Set to 0, 1, 2, ... for each respective admin node
pxy.id-generator.workerId=0
```
## 云部署：批量启动渲染服务
对于使用云镜像并批量启动渲染程序的公有云部署，请参阅 [batch startup guide](https://docs.pingxingyun.com/doc/2048/)。