# 应对防火墙限制 (/zh-CN/realtime-media/rtc-server-sdk/build/cloud-proxy)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
<_PlatformTabsGroup>
<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="cpp" platform="cpp" />
为允许你的服务端应用在有网络访问限制的环境中使用 RTC 服务端 SDK,声网提供云代理服务。你只需在防火墙上将特定的 IP 地址和端口加入白名单,并调用 API 配置声网云代理服务。
## 工作原理 [#工作原理]
下图展示了云代理的工作流程。

1. 声网 SDK 向声网云代理发起请求。声网云代理返回相应代理信息。
2. 声网 SDK 向声网云代理发送数据。声网云代理接收数据并将数据透传给声网 [SD-RTN™](/zh-CN/introduction/glossary#sd-rtn)(Software Defined Real-time Network)。
3. 声网 SD-RTN™ 向声网云代理返回数据。声网云代理接收数据并将数据发送给声网 SDK。
## 实现方法 [#实现方法]
### 准备工作 [#准备工作]
1. 参考[跑通 RTC 服务端 SDK 示例项目](/zh-CN/realtime-media/rtc-server-sdk/get-started/run-example)文档下载 RTC 服务端 SDK 并完成开发环境准备。
2. 联系 sales@shengwang.cn,提供以下信息申请开通云代理服务。
- App ID
- 代理服务使用区域
- 并发规模
- 网络运营商等信息
### 添加白名单 [#添加白名单]
收到申请后,声网会提供用于云代理的 IP 地址和端口。请确保将声网提供的 IP 地址和端口添加到防火墙白名单。
### 调用 API [#调用-api]
调用 `agora::base::IAgoraParameters::setParameters`,通过私有参数开启云代理。
1. 添加白名单后,请参考如下示例代码开启云代理:
```cpp
// 先在调用 connect 前开启云代理服务
setParameters("{\"rtc.enable_proxy\": true}");
// 然后从以下两种云代理配置方式中选择一种
// 方式一:TCP(加密)协议的云代理,即 Force TCP 云代理模式。在该模式下,SDK 始终通过 TLS 443 传输数据
setParameters("{\"rtc.proxy_server\":[13,\"\",0]}");
// 方式二:UDP 协议的云代理,即 Force UDP 云代理模式。在该模式下,SDK 始终通过 UDP 协议传输数据
setParameters("{\"rtc.proxy_server\":[1,\"\",0]}");
```
2. 测试是否能正常实现音视频通话或直播。
<_PlatformProcessedMarker close="true" />
<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="cpp" platform="java" />
为允许你的服务端应用在有网络访问限制的环境中使用 RTC 服务端 SDK,声网提供云代理服务。你只需在防火墙上将特定的 IP 地址和端口加入白名单,并调用 API 配置声网云代理服务。
## 工作原理 [#工作原理-1]
下图展示了云代理的工作流程。

1. 声网 SDK 向声网云代理发起请求。声网云代理返回相应代理信息。
2. 声网 SDK 向声网云代理发送数据。声网云代理接收数据并将数据透传给声网 [SD-RTN™](/zh-CN/introduction/glossary#sd-rtn)(Software Defined Real-time Network)。
3. 声网 SD-RTN™ 向声网云代理返回数据。声网云代理接收数据并将数据发送给声网 SDK。
## 实现方法 [#实现方法-1]
### 准备工作 [#准备工作-1]
1. 参考[跑通 RTC 服务端 SDK 示例项目](/zh-CN/realtime-media/rtc-server-sdk/get-started/run-example)文档下载 RTC 服务端 SDK 并完成开发环境准备。
2. 联系 sales@shengwang.cn,提供以下信息申请开通云代理服务。
- App ID
- 代理服务使用区域
- 并发规模
- 网络运营商等信息
### 添加白名单 [#添加白名单-1]
收到申请后,声网会提供用于云代理的 IP 地址和端口。请确保将声网提供的 IP 地址和端口添加到防火墙白名单。
### 调用 API [#调用-api-1]
调用 `io.agora.rtc.AgoraParameter.setParameters`,通过私有参数开启云代理。
1. 添加白名单后,请参考如下示例代码开启云代理:
```java
// 先在调用 connect 前开启云代理服务
mAgoraParameter.setParameters("{\"rtc.enable_proxy\": true}");
// 然后从以下两种云代理配置方式中选择一种
// 方式一:TCP(加密)协议的云代理,即 Force TCP 云代理模式。在该模式下,SDK 始终通过 TLS 443 传输数据
mAgoraParameter.setParameters("{\"rtc.proxy_server\":[13,\"\",0]}");
// 方式二:UDP 协议的云代理,即 Force UDP 云代理模式。在该模式下,SDK 始终通过 UDP 协议传输数据
mAgoraParameter.setParameters("{\"rtc.proxy_server\":[1,\"\",0]}");
```
2. 测试是否能正常实现音视频通话或直播。
<_PlatformProcessedMarker close="true" />