边缘集群部署：多地案例

# 边缘集群多地部署案例

本案例演示在 **边缘集群** 场景下部署 LarkXR 4.0：渲染节点分布在多个地理位置，且各地网络结构不同。

## 场景概述

主节点位于 **北京**。渲染节点分布在三个地点：

| 地点 | 网络结构 |
|---|---|
| 北京 | 主节点与渲染节点在同一局域网，并通过路由器具备外网 IP |
| 广州 | 各渲染节点具备直连外网 IP |
| 内蒙古 | 渲染节点在同一局域网，并通过路由器具备外网 IP |

---

## 北京：主节点配置

1. 按 [集群内网部署指南（Windows）](https://docs.pingxingyun.com/doc/2009/)  部署主节点安装包。
2. 若使用 **本地应用存储**（系统默认），边缘渲染节点需从主节点拉取应用数据。请在 `application.properties` 中配置对外可访问的数据拉取端点：

```properties
   pxy.end-point=http://<外网地址>:8181
   ```

> 若使用外网 IP 或域名，必须将所有渲染节点的外网 IP / 域名加入系统白名单，否则应用同步会失败。

### 北京主节点：所需端口

必须在路由器上完成端口映射。

| 协议 | 端口 | 用途 |
|---|---|---|
| TCP | 8181 | 前端页面（Nginx）与后端接口 |
| TCP | 8182 | 后台管理页面 Nginx 转发 |

---

## 北京：渲染节点配置

1. 按内网部署指南部署渲染节点安装包。
2. 打开 `LarkXRLauncher.exe`，进入 **配置渲染节点**，设置：
   - **管理服务器 URL**：主节点内网地址（例如 `http://192.168.0.18:8181`）
   - **本机 IP 地址**：本渲染节点的内网 IP
   - **优先外网 IP**：外网 IP（例如 `112.6.266.11`）
3. 若多个渲染节点共用同一路由器，各节点必须使用 **互不冲突的音视频端口范围**，并在渲染节点配置中相应修改。

### 北京渲染节点：所需端口

| 节点 | 协议 | 端口范围 | 用途 |
|---|---|---|---|
| 渲染节点 1 | UDP | 10011-10020 | 音视频 |
| 渲染节点 2 | UDP | 10021-10040 | 音视频 |
| 渲染节点 3 | UDP | 10041-10060 | 音视频 |

---

## 广州：渲染节点配置

广州各渲染节点具备 **直连外网 IP**。打开 `LarkXRLauncher.exe`，进入 **渲染端配置**，设置：

- **管理服务器 URL**：北京主节点的外网地址（例如 `http://www.larkxr.com:8181`）
- **本机 IP 地址**：该节点的外网 IP
- **优先外网 IP**：该节点的外网 IP

### 广州渲染节点：所需端口

| 协议 | 端口 | 用途 |
|---|---|---|
| TCP | 10002 | WebSocket 通信 |
| UDP | 10011-10040 | 音视频 |

---

## 内蒙古：渲染节点配置

内蒙古渲染节点位于路由器之后，各节点必须使用 **互不冲突的 WebSocket 端口**。打开 `LarkXRLauncher.exe`，进入 **渲染端配置**，设置：

- **管理服务器 URL**：北京主节点的外网地址
- **本机 IP 地址**：渲染节点的内网 IP
- **公网 IP**：路由器外网 IP
- **信令端口**：每节点唯一端口（例如节点 1 使用 `10009`，节点 2 使用 `10008`）

> 配置路由器端口映射时，请确保 **内外端口一致**（例如节点 1：外网 `10009` → 内网 `10009`）。

修改端口后，重启渲染节点服务使配置生效。

### 内蒙古渲染节点：所需端口

| 节点 | 协议 | 端口 | 用途 |
|---|---|---|---|
| 渲染节点 1 | TCP | 10009 | WebSocket 通信 |
| 渲染节点 1 | UDP | 10011-10020 | 音视频 |
| 渲染节点 2 | TCP | 10008 | WebSocket 通信 |
| 渲染节点 2 | UDP | 10021-10040 | 音视频 |