# 应对防火墙限制 (/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 配置声网云代理服务。

## 工作原理 [#工作原理]

下图展示了云代理的工作流程。

![云代理工作原理](https://web-cdn.agora.io/docs-files/1673942497571)

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 地址和端口添加到防火墙白名单。

<a id="api"></a>
### 调用 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]

下图展示了云代理的工作流程。

![云代理工作原理](https://web-cdn.agora.io/docs-files/1673942497571)

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 地址和端口添加到防火墙白名单。

<a id="api"></a>
### 调用 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" />
</_PlatformTabsGroup>