# Connect with Cloud Proxy (/en/realtime-media/broadcast-streaming/build/optimize-quality-and-connection/cloud-proxy/web)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

Large enterprises, hospitals, universities, banks, and other institutions commonly deploy firewalls to meet their stringent security requirements. To ensure uninterrupted access to its services for enterprise users behind firewalls, Agora offers firewall whitelist and Cloud proxy services.

Admins enable users to use Video SDK in network-restricted environments by adding specific IP addresses and ports to the firewall whitelist. Users make API calls to configure the Cloud proxy service.

## Understand the tech

Cloud proxy works as follows:

1. Video SDK initiates a request to Cloud proxy.
2. Cloud proxy returns the corresponding proxy information.
3. Agora SDK sends data to Cloud proxy. Cloud proxy receives the data and transmits it to Agora SDRTN®.
4. SDRTN® returns data to Cloud proxy. Cloud proxy receives the data and sends it to the SDK.

**Cloud proxy workflow**

![image](https://assets-docs.agora.io/images/video-sdk/cloud-proxy-tech.svg)

## Prerequisites

Ensure that you have implemented the [SDK quickstart](../../index) in your project.

## Implement Cloud Proxy

      
  
      
  
      
  
      
Since Web SDK v4.3.0, Agora has optimized the Cloud proxy architecture, enhanced the connectivity of the SDK in environments with restricted network access, and supports restricted access areas. Agora recommends that you upgrade to v4.3.0 or above.

Depending on the Web SDK version you are using, refer to the corresponding implementation method:

**v4.3.0 or above**

1. In [Agora Console](https://console.agora.io), select **RTC Services** from the sidebar, then locate the **Cloud Proxy** card and turn on its toggle.

2. Call the `startProxyServer` method and set the `mode` parameter before joining the channel:

   * **Force UDP cloud proxy mode**: Set `mode` to `3`. Cloud proxy using UDP protocol. In this mode, the SDK always transmits data using UDP protocol.

   * **Force TCP cloud proxy mode: Set `mode` to `5`**. (Supported since v4.9.0) Cloud proxy using TCP (encryption) protocol. In this mode, the SDK always transmits data over TLS 443.

3. Test if you can initiate audio and video calls or live broadcasts normally.

4. Video SDK provides a `client.on("is-using-cloud-proxy")` event that triggers the callback after the media stream is successfully published locally, to inform whether the current media stream is forwarded by the cloud proxy service.

   ```javascript
   const client = AgoraRTC.createClient({mode: 'live',codec: 'vp8'});
   // Enable cloud proxy
   client.startProxyServer(3);
   // Join channel
   client.join("<YOUR TOKEN>", "<YOUR CHANNEL>").then(() => );

   ```

5. To stop using the proxy server, call `stopProxyServer` after leaving the channel.

   ```javascript
   // Leave channel
   client.leave();

   // Turn off the cloud proxy service
   client.stopProxyServer();

   // Rejoin channel
   client.join("<YOUR TOKEN>", "<YOUR CHANNEL>").then(() => );

   ```

**v4.0.0-v4.2.1**

1. In [Agora Console](https://console.agora.io), select **RTC Services** from the sidebar, then locate the **Cloud Proxy** card and turn on its toggle.

2. Configure the firewall whitelist

Add the following test IP addresses and ports to your corporate firewall whitelist. The source address is the client integrated with the Web SDK.

**Domestic testing**

| Protocol | Target Address | Port                   | Port Usage                                     |
| -------- | -------------- | ---------------------- | ---------------------------------------------- |
| TCP      | 150.138.153.78 | 443, 4000, 3433 - 3460 | Message data transmission, media data exchange |
| TCP      | 47.74.211.17   | 443                    | Edge node communication                        |
| TCP      | 52.80.192.229  | 443                    | Edge node communication                        |
| TCP      | 52.52.84.170   | 443                    | Edge node communication                        |
| TCP      | 47.96.234.219  | 443                    | Edge node communication                        |
| UDP      | 150.138.153.78 | 3478-3500              | media data exchange                            |

**Overseas testing**

| Protocol | Target Address | Port                   | Port Usage                                     |
| -------- | -------------- | ---------------------- | ---------------------------------------------- |
| TCP      | 23.236.115.138 | 443, 4000, 3433 - 3460 | Message data transmission, media data exchange |
| TCP      | 148.153.66.218 | 443, 4000, 3433 - 3460 | Message data transmission, media data exchange |
| TCP      | 47.74.211.17   | 443                    | Edge node communication                        |
| TCP      | 52.80.192.229  | 443                    | Edge node communication                        |
| TCP      | 52.52.84.170   | 443                    | Edge node communication                        |
| TCP      | 47.96.234.219  | 443                    | Edge node communication                        |
| UDP      | 23.236.115.138 | 3478-3500              | media data exchange                            |
| UDP      | 148.153.66.218 | 3478-3500              | media data exchange                            |

<CalloutContainer type="info">
  <CalloutDescription>
    The above IPs are only meant for debugging during the test phase. Before official launch, apply for custom cloud proxy service resources from Agora.
  </CalloutDescription>
</CalloutContainer>

3. To turn on cloud proxy server before joining the channel, call:

`client.startProxyServer();`

4. To turn off cloud proxy server after leaving the channel, call:

`client.stopProxyServer();`

## Reference

This section contains content that completes the information on this page, or points you to documentation that explains other aspects to this product.

### Pricing

Agora charges for use of Cloud Proxy as follows.

### Duration-based pricing

Duration-based pricing is based on the total number of minutes used per month across all users.

| Duration                   | Price per 1000 minutes/month |
| :------------------------- | ---------------------------: |
| UDP Audio Duration         |                        $0.99 |
| UDP video HD Duration      |                        $3.99 |
| UDP video Full HD Duration |                        $8.99 |
| UDP video 2K Duration      |                       $15.99 |
| UDP video 2K+ Duration     |                       $35.99 |
| TCP Audio Duration         |                        $0.99 |
| TCP video HD Duration      |                        $3.99 |
| TCP video Full HD Duration |                        $8.99 |
| TCP video 2K Duration      |                       $15.99 |
| TCP video 2K+ Duration     |                       $35.99 |

For volume pricing discount, contact [Agora support](mailto\:support@agora.io).

#### PCU-based pricing

PCU is the maximum number of simultaneous users connected to the Cloud Proxy service at any point during the billing cycle. For PCU-based usage, Agora charges $500.00 for each VID.

For volume pricing discount, contact [Agora support](mailto\:support@agora.io).

### IP addresses for Cloud Proxy

To use Agora Cloud Proxy, your end users must first configure their firewalls to trust the following [IP address and port ranges](../../reference/cloud-proxy-allowed-ips).

### Firewall whitelist

Alternatively, you can whitelist the following domains and ports to ensure seamless communication with Agora's services

* **v4.4.0 and above**

  ```text
  .agora.io
  .edge.agora.io
  .sd-rtn.com
  .edge.sd-rtn.com
  .ap.sd-rtn.com
  .statscollector.sd-rtn.com
  .webrtc-cloud-proxy.sd-rtn.com
  ```

* **v4.0.0 - v4.4.0**

  ```text
  .agora.io
  .edge.agora.io
  .agoraio.cn
  .edge.agoraio.cn
  ```

| Target Ports                                                                                         | Protocol | Action |
| :--------------------------------------------------------------------------------------------------- | -------- | ------ |
| 80; 443; 3433; 4700 - 5000; 5668; 5669; 6080; 6443; 8667; 9667; 30011 - 30013 (for bypass push flow) | TCP      | allow  |
| 3478; 4700 - 5000 (version 2.9.0 and later); 10000 - 65535 (version before 2.9.0)                    | UDP      | allow  |

### API reference

* [`startProxyServer`](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/iagorartcclient.html#startproxyserver)
* [`stopProxyServer`](https://api-ref.agora.io/en/video-sdk/web/4.x/interfaces/iagorartcclient.html#stopproxyserver)

    
  
      
  
      
  
      
  
      
  
      
  
      
  
      
  
