Nginx 反向代理：将 LarkXR4.0 集群暴露到外网

## 概述

本指南介绍如何使用 Nginx 作为反向代理，将 LarkXR 4.0 集群暴露到外网。适用于渲染服务器无法从互联网直接访问、但在同一局域网内可达的场景。

### 使用场景

- 渲染服务器位于私有局域网（例如 `192.168.0.229`、`192.168.0.230`、`192.168.0.231`）
- 中央调度服务器位于 `192.168.0.171`
- Nginx 服务器桥接局域网（`192.168.1.172`）与互联网（`192.168.20.19`）
- 外部客户端通过 Nginx 访问系统

> **注意：** Nginx 服务器必须运行在 Linux 上，以支持 UDP 端口反向代理。

## 前置条件

1. 使用内网集群方式完成部署。请参阅 [集群内网部署指南](https://docs.pingxingyun.com/doc/2036/)。
2. 内网部署完成后，在桥接外网与局域网的服务器上安装 Nginx。

## 配置步骤

### 步骤 1：配置 Nginx 的 TCP 与 UDP 反向代理

#### 1. 为 8181 端口添加 TCP 反向代理

1. 下载 [out.conf](https://pxy-showdoc.oss-cn-beijing.aliyuncs.com/out.conf)
2. 将其放到 `nginx/conf/conf.d` 目录
3. 编辑 `out.conf` 第 2 行，将地址改为中央管理节点的实际 IP

#### 2. 为 UDP 端口添加反向代理

1. 下载 [udp.conf](https://pxy-showdoc.oss-cn-beijing.aliyuncs.com/udp.conf)
2. 将其放到 `nginx/conf` 目录

`udp.conf` 中的 UDP 端口号必须与渲染节点启动管理器中配置的 UDP 端口范围一一对应。

例如：若渲染服务管理器使用端口 `10011-10020`，则需配置 10 条 UDP 反向代理条目。

#### 3. 更新 Nginx 主配置

编辑 `nginx/conf/nginx.conf`，添加 `include` 指令以加载 UDP 配置文件。

### 步骤 2：开放防火墙端口并验证

在 Nginx 服务器上开放以下端口：

| 协议 | 端口 | 用途 |
|---|---|---|
| TCP | 8033 | 主应用访问端口 |
| UDP | 与渲染节点匹配的端口范围 | 音视频通信 |

通过访问 Nginx 服务器外网 IP 的 `8033` 端口验证配置：

```text
http://222.12.20.19:8033
```

验证通过后，应能看到应用概览，并可正常启动渲染会话。

> 端口 `8033` 可在 `out.conf` 第 7 行修改。