Residential Proxies

Descubre todo sobre los Residential Proxies de Oxylabs, ejemplos de código, parámetros de segmentación por ubicación y recursos de resolución de problemas.

Oxylabs Residential Proxies usan direcciones IP reales proporcionadas por proveedores de servicios de Internet (ISP) conectadas a dispositivos físicos en todo el mundo. Estos proxies rotan automáticamente con cada solicitud y admiten segmentación detallada por país, ciudad, estado, código postal, ASN y sesión.

¿Conectándote mediante IPs en lista blanca? Si prefieres autenticarte mediante lista blanca de IP en lugar de nombre de usuario/contraseña credenciales, sigue nuestra guía de autenticación por lista blanca de IP y subdominios.

Consulta básica

Nuestros Residential Proxies admiten HTTP, HTTPS, HTTP/3 (MASQUE), y SOCKS5 protocolos. Puede obtener más información sobre cómo usarlos aquí.

Hacer una solicitud básica solo requiere proporcionar tus credenciales de usuario del proxy (nombre de usuario y contraseña) al nodo de entrada backconnect (pr.oxylabs.io:7777). Cada solicitud se enruta automáticamente a través de una dirección IP aleatoria.

cURL

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

PHP

<?php
$username = 'USERNAME';
$password = 'PASSWORD';
$proxy = 'pr.oxylabs.io:7777';
$query = curl_init('https://ip.oxylabs.io/location');
curl_setopt($query, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($query, CURLOPT_PROXY, "http://$proxy");
curl_setopt($query, CURLOPT_PROXYUSERPWD, "customer-$username:$password");
$output = curl_exec($query);
curl_close($query);
if ($output)
    echo $output;
?>

Python

import urllib.request

username = 'USERNAME'
password = 'PASSWORD'
entry = f'http://customer-{username}:{password}@pr.oxylabs.io:7777'

query = urllib.request.ProxyHandler({
    'http': entry,
    'https': entry,
})
execute = urllib.request.build_opener(query)
print(execute.open('https://ip.oxylabs.io/location').read())

Java

package example;

import org.apache.http.HttpHost;
import org.apache.http.client.fluent.*;

public class Example {
    public static void main(String[] args) throws Exception {
        HttpHost entry = new HttpHost("pr.oxylabs.io", 7777);
        String query = Executor.newInstance()
            .auth(entry, "customer-USERNAME", "PASS")
            .execute(Request.Get("http://ip.oxylabs.io/location").viaProxy(entry))
            .returnContent().asString();
        System.out.println(query);
    }
}

C#

using System;
using System.Net;

class Example
{
    static void Main()
    {
        var client = new WebClient();
        client.Proxy = new WebProxy("pr.oxylabs.io:7777");
        client.Proxy.Credentials = new NetworkCredential("customer-USERNAME", "PASSWORD");
        Console.WriteLine(client.DownloadString("https://ip.oxylabs.io/location"));
    }
c

Ruby

require 'uri'
require 'net/http'

uri = URI.parse('https://ip.oxylabs.io/location')
proxy = Net::HTTP::Proxy('pr.oxylabs.io', 7777, 'customer-USERNAME', 'PASSWORD')

req = Net::HTTP::Get.new(uri.path)

result = proxy.start(uri.host,uri.port) do |http|
    http.request(req)
end

puts result.body

Respuesta de ejemplo

Probando tu conexión contra https://ip.oxylabs.io/location devuelve datos de MaxMind, IP2Location, DB-IP e IPinfo.io. Los parámetros incluyen dirección IP, proveedor, país, ciudad, código postal, ASN, nombre de la organización y zona horaria.

{
  "ip": "185.220.101.5",
  "provider": "Comcast Cable",
  "country": "United States",
  "country_code": "US",
  "city": "New York",
  "zip": "10001",
  "asn": 7018,
  "organization": "ATT-INTERNET4",
  "timezone": "America/New_York"
}

Personalización de tus solicitudes

Una vez verificada una conexión básica, personaliza tus solicitudes según tus necesidades específicas:

Ubicación y geolocalización	Aplica parámetros de país, ciudad, estado, continente, código postal, ASN o coordenadas.
Control de sesión	Sesiones persistentes (sessid), duración de sesión (sesstime), vinculación a una sola IP (sessid_oneip), y rangos de puertos persistentes.
Protocolos y puertos	Configura HTTP, HTTPS, HTTP/3, y SOCKS5 conexiones.
Filtros avanzados	Dirige a sistemas operativos específicos (platform) o versiones del protocolo IP.
Lista blanca de IP	Conéctate sin contraseñas usando autenticación basada en IP.

Parámetros de consulta

Un único proxy backconnect (pr.oxylabs.io:7777) te permite personalizar tu proxy mediante parámetros adicionales en el nombre de usuario (geolocalización, sesiones persistentes, etc.). Aquí tienes una muestra de credenciales con un desglose:

Parámetro	Tipo	Descripción
customer	Obligatorio	Prefijo de cadena del nombre de usuario (p. ej., customer-USERNAME).
cc	Ubicación	Código de país ISO 3166-1 de 2 letras, sin distinción entre mayúsculas y minúsculas (p. ej., cc-DE, cc-US).
ciudad	Ubicación	Nombre de ciudad en inglés; requiere cc (p. ej., cc-US-city-los_angeles).
st	Ubicación	Nombre del estado de EE. UU. con us_ prefijo (p. ej., st-us_california).
cn	Ubicación	Código de continente de 2 letras (p. ej., cn-EU, cn-AS).
postalcode	Ubicación	Código postal de EE. UU. de 5 dígitos; requiere cc-US (p. ej., postalcode-90210).
ASN	Ubicación	Número de Sistema Autónomo (p. ej., ASN-21928).
geohash	Ubicación	Objetivo de celdas de la cuadrícula Geohash de nivel 1–4 (p. ej., geohash-u09 para París).
sessid	Sesión	Cadena aleatoria para mantener la IP entre solicitudes (predeterminado: 10 min).
sesstime	Sesión	Amplía la duración de la sesión en minutos hasta 1440 min (p. ej., sesstime-30).
sessid_oneip	Sesión	Vincula la sesión estrictamente a un único nodo de salida; falla con 502 si se cae.
platform	Filtrar	Huella digital del SO objetivo (windows, macos, linux, android, ios).
ipversion	Filtrar	Restringe el pool de Proxies a ipversion-4 o ipversion-6.

Formatos comunes de cadenas de proxy

Según tu flujo de trabajo, software de terceros o scripts personalizados, las credenciales del proxy pueden formatearse de varias maneras:

Formato	Caso de uso
HOST:PORT:USER:PASS (pr.oxylabs.io:7777:customer-john:pass123)	Formato de puerta de enlace de entrada backconnect usado en herramientas de automatización estándar.
USER:PASS@HOST:PORT (customer-john:[e-mail]:7777)	Formato URI estándar usado por cURL, Python requests, Node.js axios, etc.
IP:PORT:USER:PASS (185.220.101.5:8000:john:pass123)	Formato de IP directa usado comúnmente en herramientas de botting y scrapers de escritorio.
USER:PASS:IP:PORT (john:pass123:185.220.101.5:8000)	Formato de cadena invertida usado por herramientas heredadas que requieren análisis personalizado.
IP:PORT (185.220.101.5:8000)	Formato con IP en la lista blanca (no se requiere nombre de usuario ni contraseña).

Panel y gestión de cuenta

• Accede a tu Panel de Oxylabs para ver el uso de tráfico en tiempo real, estadísticas de solicitudes y administrar subusuarios.
• Usa el generador automatizado Endpoint Generator para generar y exportar listas personalizadas de proxies en cURL, Python, PHP, Node.js, GO, Java o detalles personalizados para integraciones.
• Administra subusuarios y realiza seguimiento del uso programáticamente mediante Public API.

¿Necesitas asistencia técnica?

Contacta a tu gestor de cuenta o a nuestro equipo de soporte 24/7 usando una de las opciones siguientes:

• Chat en vivo. Accede al chat en vivo a través de tu panel o en el sitio web de Oxylabs para preguntas rápidas o informes de errores.
• Correo electrónico. Puedes contactarnos a través de [e-mail]. Recomendamos este método para preguntas o sugerencias menos urgentes.