User Guide

Getting Started with Cherry Proxy

Global Proxy

IP Whitelist

Using the IP whitelist method does not require a username or password. We will automatically retrieve your whitelist IP list.

Select Supported Type

Choose country-level or city-level targeting based on your business needs.


Country-Level Targeting


1. You must add your local IP and the IP you want to use to the whitelist


a. Auto-add to whitelist – This method does not require a username or password. We will automatically retrieve your device IP and add it by default.


b. Manually add whitelist IP – Enter detailed information in the whitelist list and add it. Once added, it will appear in the whitelist selection based on the enabled/disabled status.


2. Whitelist Selection


Displays the added and enabled country-level whitelist IPs. The configured IP + port will be accessible to the target website.


3. Location Settings


Choose a country to obtain the corresponding location.


4. Select Session Type


a. Sticky Session – This session type allows you to keep the same IP address for up to 120 minutes. You can manually specify a session duration (1-120 minutes).


b. Rotating Session – Each request will return a new IP address.


5. Select Output Format


a. Standard Format – Choose the protocol you want to generate (http, https, socks5) and specify the format and endpoint quantity. Click Generate to get the results. You can copy them individually, in bulk, or download them in TXT or CSV format.


b. API Link – Modify parameters as per the instructions to get the corresponding API endpoint.




City-Level Targeting


1. You must add the IP you want to use to the whitelist


Enter detailed information in the whitelist list and add it. You can select the corresponding configuration, save it, and use it to generate the required IP.



If you have created sub-users, you can switch accounts when selecting city-level targeting to add IP whitelists.


2. Whitelist Selection


Displays all added whitelist IPs. To modify the configuration, select the IP and update the settings.


3. Location Settings


a. Supports ASN – Allows precise targeting at country, state, and city levels.

b. Does not support ASN – Supports only country/ASN-level targeting, suitable for users with specific ASN needs.


4. Select Server


The optimal relay server will be assigned based on the selected country/region. You can also manually change it.


5. Select Session Type


a. Sticky Session – Keep the same IP for 1-120 minutes (manually adjustable).


b. Rotating Session – Each request returns a new IP address.


6. Select Output Format

Standard Format – Choose the protocol (http, https, socks5) and copy the generated IPs directly.

Click the Generate button to save the results. Once generated, you can hover over the corresponding whitelist IP to view details.






If you have any further questions, please contact your account manager or our support team: [email protected].