区域设置

# 区域设置

> **说明：** 该功能在 **V3.3.3.0** 版本中 **默认禁用**。要启用，请在 `larkxr-admin/application.properties` 中添加以下配置项并重启服务：
```properties
pxy.dispatch-policy.enable-multi-region-dispatch=true
```
## 概述
区域设置功能可将渲染服务器划分为具名分区（区域），并根据地理邻近度或网络延迟配置智能客户端调度。
## 在渲染服务器上配置分区
每台渲染服务器可通过管理配置面板分配 **区域 ID** 和 **区域名称**。这些字段位于渲染配置窗口的 **常规** 选项卡下。
![](https://docs.pingxingyun.com/media/202503/1c4b4fecc20b484390c110b0305c8ed95928.png)
渲染服务成功启动后，分区信息会自动注册并显示在区域设置界面中。随后可将每个区域分配到具体城市。
![](https://docs.pingxingyun.com/media/202503/3e4b2611005c48f6a42d750ec481800e2414.png)
## 客户端调度策略
系统支持两种调度模式：
- **基于距离（默认）：** 当 RTT 检测禁用时，客户端会被分配到地理上最近城市所属的分区。
- **基于 RTT：** 当 RTT 检测启用时，将跳过基于距离的分配。客户端浏览器会通过前端概览页面对所有可用区域进行 RTT（往返时延）检测。系统随后选择网络延迟最低的分区，并优先分配到该区域。
若目标区域资源已满，系统会自动回退到全局资源池，并将客户端分配到下一个可用区域。
> **说明：** 当站点使用 **HTTPS** 协议时，RTT 检测必须使用 **WSS** 协议。每个检测节点必须配置有效的 SSL 证书和对应域名；否则 RTT 检测将无法正常工作。
## 定向分区
**定向分区** 是显式绑定到特定工作区的分区。当应用使用 **半主动同步** 时，只能同步到所选工作区内的定向分区。
### 设置定向分区
要配置定向分区，请修改渲染 agent 的配置文件：
1. 将 `pxy.host.region-type` 设置为 `1`。
2. 重启 agent 服务。
服务器重新注册成功后，将自动被视为定向分区。