高级集群部署

LarkXR架构如下图所示：
![](https://docs.pingxingyun.com/media/202503/fe53ad40f5d44669a11a35a2bf4c92b87685.png)
系统采用分布式微服务架构，包括中心管理服务、同步/代理服务、核心渲染服务、缓存服务、对象存储和数据存储等多个服务组件。这种架构既支持单机部署，也支持集群部署，灵活多样。根据实际生产环境的需求，可以对服务进行拆分和组合，以满足不同的使用场景。

系统提供了单机部署和简易集群部署的程序包。单机部署将所有服务部署在一台GPU服务器上，而简易集群部署则将核心渲染服务和同步/代理服务部署在单独的GPU服务器上，将管理程序和存储相关服务部署在非GPU服务器上。通过增加GPU服务节点数量，可以增加系统的并发处理能力。

为了满足高并发和高可用性的需求，可以进一步将管理节点上的服务拆分并部署到独立的服务器上，同时每个服务都可以进行高可用的冗余部署。本章节将介绍如何拆分服务组件以及如何修改配置文件来实现这些部署方案。
# 服务器准备
| 功能  |  版本 | 配置  | 系统版本  | 台数  | 备注  |
| ------------ | ------------ | ------------ | ------------ | ------------ | ------------ | 
| redis  | 6.0.8  |  8核16G | Ubuntu20.04   | 1  |   |   
| nginx  | 1.21.0  | 8核16G  | Ubuntu20.04   | 1  | 官网下载简易集群版的程序包， |   
| 数据库  | Mysql8.0  | 8核16G  | Ubuntu20.04   |  1 | 需手动创建larkxr_center数据库，编码字符集为utf8  |  
| LarkXR管理服务  | 3.2.8.2 + |  8核16G | Ubuntu20.04 <br/>或者Windows  | 1  | 需安装JDK-17 |   
| LarkXR渲染服务  | 3.2.8.2 +  | 8核16G  | Windows Server2019  | n  |   |   |
# LarkXR程序安装与配置指南

为了安装简易集群版的LarkXR程序，请访问[https://www.pingxingyun.com/devCenter.html](https://www.pingxingyun.com/devCenter.html) 下载程序包。

### 针对管理节点使用Windows版本（使用larkxr-center-windows文件夹）：

**步骤一：配置本地IP地址**

- 在部署目录下的`application.properties`文件中，设置`server.node-ip`为本地IP地址，并按照下图所示进行其他服务组件的禁用，只保留`admin`组件。

![](https://docs.pingxingyun.com/media/202503/f48c91d97cfa4545b6e8db625fd17a143519.png)

**步骤二：修改Redis和数据库配置地址**

- 打开部署目录下`admin\application.yaml`文件，根据需要修改Redis和数据库的配置地址。

![](https://docs.pingxingyun.com/media/202503/3b8ae56137ea4a3182eb8e12d63038cb3436.png)

**步骤三：修改Nginx配置项**

- 将下载的简易集群版Nginx文件夹中的配置文件（包括`conf->conf.d`、`admin-back`、`admin-front`）放到Nginx服务器部署目录下。确保`nginx.conf`引入`include conf.d/*.conf;`。如果在Windows部署，保持与程序包相同的目录结构。如果在Linux部署，需要根据实际路径进行调整，确保能够找到这些文件夹以用于静态页面映射。

![](https://docs.pingxingyun.com/media/202503/0ddfe60406e64dd581372f937d625fde5302.png)

- 修改后台接口的反向代理地址，将其配置为主节点IP地址。

![](https://docs.pingxingyun.com/media/202503/612d4b13c3f4472a834f5b138989618c1757.png)

### 针对多个主节点的配置要求：

**步骤一：配置另一个admin服务**

- 按照上述方法配置，启动另一个admin服务。

**步骤二：修改Nginx配置项**

- 增加一个server的配置项，如下图所示。

![](https://docs.pingxingyun.com/media/202503/8f7efd058e96484bbf605c6a87eaced13162.png)

**步骤三：更改应用存储为对象存储**

- 在后台管理页面的系统设定-存储方式中，将存储方式改为对象存储。具体如何更改，请参考[如何更改成对象存储？](https://docs.pingxingyun.com/doc/686/)

**步骤四：配置多个主节点的`application.properties`文件**

- 在`application.properties`文件中，分别为多个主节点配置`pxy.id-generator.workerId`为0、1、2等，以避免主键冲突。

### 公有云使用镜像，批量启动渲染程序

- 参考[此地址](https://www.pingxingyun.com/contribute/detail?topicId=10103&categoryId=3) 进行公有云使用镜像，批量启动渲染程序。