Edge cluster deployment

## Scenario Description:

The main node is located in Beijing, while the rendering nodes are distributed in Beijing, Guangzhou, and Inner Mongolia.

**Overview of Network Structures:**

- Beijing Network Structure: The main node and rendering nodes are in the same LAN, with a router external IP.

- Guangzhou Network Structure: Each rendering node has an external IP.

- Inner Mongolia Network Structure: The rendering nodes are in the same LAN, with a router external IP.

**Beijing Main Node LarkXR Deployment Configuration Requirements:**

1. Follow the [Cluster Intranet (Windows) Deployment Guide](https://docs.paraverse.cc/doc/247/) or [Cluster Intranet (Linux Docker) Deployment Guide](https://docs.paraverse.cc/doc/249/) to deploy the main node program package.

2. Configure using the proxy mode: Refer to [Cluster External Network (Windows) Using Proxy Mode](https://docs.paraverse.cc/doc/248/) or [Cluster External Network (Linux Docker) Using Proxy Mode](https://docs.paraverse.cc/doc/250/), and follow step one for settings.

3. When using local storage applications (system defaults to local storage), the edge nodes need to pull data from the main node, so an externally accessible data pull application interface address needs to be configured. In the `application.properties` file in the deployment directory, configure `pxy.end-point={{http://external-address:8181}}` as shown in the image below:

![](https://docs.paraverse.cc/media/202504/0ea4a6b2641548b5a94f40a5b973ba3d9371.png)

**Beijing Main Node Network Port Configuration Requirements:** Port mapping needs to be done on the router.

|Type | Port Number | Purpose | Modification Method|
|-------- | -------- | -------- |------------|
|TCP | 8181 | Frontend page nginx forwarding and backend interface | [Modify port 8181]( https://www.pingxingyun.com/question/detail?topicId=10078&categoryId=2 Please refer to)|
|TCP | 8182 | Backend page nginx forwarding | [Modify port 8182]( https://www.pingxingyun.com/question/detail?topicId=10114&categoryId=2 Please refer to)|

**Beijing Rendering Node LarkXR Deployment Configuration Requirements:**

1. Refer to the [Cluster Intranet (Windows) Deployment Guide](https://docs.paraverse.cc/doc/247/) or [Cluster Intranet (Linux Docker) Deployment Guide](https://docs.paraverse.cc/doc/249/) to deploy the rendering node program package.

2. Double-click to open `LarkXRLauncher.exe`, click on "Configure Rendering Node":

- Set the "Management Server Address" to the intranet address.

- Set the "Local IP" to the intranet IP.

- Set the "Preferred Public IP" to the external IP (e.g., 112.6.266.11). Example image below:

![](https://docs.paraverse.cc/media/202504/7e95fb64e0604018930ec8328d276ac35151.png)

3. When there is a mismatch in the mapping of audio and video ports, it is necessary to modify the audio and video ports. Please refer to the [modification method](https://www.pingxingyun.com/question/detail?topicId=10122&categoryId=2).

**Beijing Rendering Node Network Port Configuration Requirements:** Port mapping needs to be done on the router.

|Node | Type | Port Number | Purpose|
|-------- | -------- | -------- | --------|
|RenderNode 1 | UDP | 10011-10020 | * * Required * *, audio and video port, where one port represents one concurrent port|
|RenderNode 2 | UDP | 10021-10040 | * * Required * *, audio and video port, where one port represents one concurrent port|
|Rendering node 3 | UDP | 10041-10060 | * * must * *, audio and video port, one port represents one concurrent|

**Guangzhou Rendering Node Deployment Configuration Requirements:**

- Set the "Management Server Address" to the external network address.

- Set the "Local IP" to the external IP.

- Set the "Preferred Public IP" to the external IP (e.g., 122.6.266.1). Example image below:

![](https://docs.paraverse.cc/media/202504/1d201a8cb93146f0b392f5564f4539a72526.png)

**Guangzhou Rendering Node Network Port Configuration Requirements:** Each node needs to have port forwarding set up.

|Type | Port Number | Purpose | Replacement|
|-------- | -------- | -------- | --------|
|TCP | 10002 | * * Required * *, Websocket communication port | [Modify 10002 port]( https://www.pingxingyun.com/question/detail?topicId=10119&categoryId=2 "Modify port 10002")|
|UDP | 10011-10040 | * * Required * *, audio and video port, where one port represents one concurrency | [Modify audio and video port]( https://www.pingxingyun.com/question/detail?topicId=10122&categoryId=2 "Modify audio and video ports")|

**Inner Mongolia Rendering Node Configuration Requirements:**

- Set the "Management Server Address" to the external network address.

- Set the "Local IP" to the intranet IP.

- Set the "Public IP" to the external IP.

- Set the "Preferred Public IP" to the external IP (e.g., 147.6.266.2). Example image below:

![](https://docs.paraverse.cc/media/202504/f229cf99c1aa44a0839579ab2550b2767061.png)

- Change the original port 10002 of the rendering node to 10009 to ensure that each rendering node has a unique port number.

- When setting up external mapping, ensure that the internal and external ports are consistent. For example: Node 1 external port 10009, internal port 10009; Node 2 external port 10008, internal port 10008. Example image below:

![](https://docs.paraverse.cc/media/202504/340950310d934128bc269a5562d1fedc5155.png)

- If there is a mismatch in the mapping of audio and video ports, modify the audio and video ports. For detailed modification methods, please refer to [this link](https://www.pingxingyun.com/question/detail?topicId=10122&categoryId=2).

- After completing the port modifications, follow these steps:

1. Restart the rendering node service.

**Inner Mongolia Rendering Node Network Port Configuration Requirements:** Port mapping needs to be done on the router.

|节点|  Type | 端口号  |用途   |更改   |
| ------------ | ------------ | ------------ | ------------ |------------ |
|渲染节点1| TCP  | 10009  |  **必须**， Websocket通信端口 | [修改Websocket通信端口](https://www.pingxingyun.com/question/detail?topicId=10119&categoryId=2 "修改10002端口")  |
|渲染节点1| UDP  | 10011-10020  |  **必须**，音视频端口，一个端口表示一个并发  | [修改音视频端口](https://www.pingxingyun.com/question/detail?topicId=10122&categoryId=2 "修改音视频端口")  |
|渲染节点2| TCP  | 10008  |  **必须**， Websocket通信端口 | [修改Websocket通信端口](https://www.pingxingyun.com/question/detail?topicId=10119&categoryId=2 "修改10002端口")  |
|渲染节点2| UDP  | 10021-10040  |  **必须**，音视频端口，一个端口表示一个并发  |[修改音视频端口](https://www.pingxingyun.com/question/detail?topicId=10122&categoryId=2 "修改音视频端口")  |