Protocols

Explore supported Residential Proxy protocols and learn how to configure HTTP, HTTPS, and SOCKS5 connections.

HTTP

Our documentation includes code examples showcasing how to connect to the proxies using HTTP protocol. The protocol is supported by common libraries and third-party software.

HTTPS

You can also use the fully encrypted HTTP connection using HTTPS protocol for an extra layer of security. For that, you have to add https:// to your proxy entry point. For example: https://pr.oxylabs.io:7777 (this also applies to country-specific entry nodes).

Please note that some libraries (or their older versions) and some 3rd party tools may not support HTTPS protocol, so double-check before making changes to your code.

HTTP/3

HTTP3 is supported via proxies that can handle UDP traffic, as it is based on QUIC, a UDP-based transport protocol.

Standard HTTP/HTTPS proxy endpoints are not compatible with HTTP3, so to proxy requests, you need to use a SOCKS5 proxy with UDP traffic support, available through the following dedicated endpoint:

socks.pr.oxylabs.io:7777

Most common tools do not natively support HTTP3 over SOCKS5 with UDP, so custom implementations may be required, such as our custom HTTP/3 Go solution on GitHub.

Note: Make sure your firewall allows UDP traffic on the required ports, as many ports block UDP by default

SOCKS5

SOCKS5 UDP connection is now available in beta. Contact your Account Manager or Customer Success team to enable testing.

Oxylabs Residential Proxies SOCKS5 protocol does not work with Chrome, so we suggest using Firefox instead.

Our Residential Proxies support only TCP connection at the moment. For using SOCKS5 protocol, you have to add socks5h in your request, for example:

curl -x socks5h://pr.oxylabs.io:7777 -U "customer-USERNAME:PASSWORD" ip.oxylabs.io/location

Please note that at the moment, SOCKS5 protocol does not support country specific entry nodes. You can target specific locations by adding additional parameters in your username. Here is a sample of targeting France:

curl -x socks5h://pr.oxylabs.io:7777 -U "customer-USERNAME-cc-FR:PASSWORD" ip.oxylabs.io/location

Note that some websites may identify a proxy IP when using theSOCKS5 protocol. We highly suggest switching to an alternative protocol in such instances.

Ports of proxies

The default configuration of proxy ports includes 80 and 443, which are standard ports designed to accommodate the HTTP and HTTPS protocols, as outlined in the table below. To access other ports, it is necessary to undergo compliance verification, please contact our support.

Protocol	Port
HTTP	80
HTTPS	443