Alterar / rotacionar IP de proxy

Os proxies móveis do XProxy suportam alterações dinâmicas de IP de saída. Você pode rotacionar o endereço IP público do seu proxy manualmente no painel do administrador, automaticamente por agendamento com temporizador, pela GUI do portal do cliente ou de forma programática usando endpoints HTTP de API brutos.

Parte 1 — Rotação de IP no painel do administrador

Como administrador do XProxy, você pode gerenciar e rotacionar modems diretamente pelo seu painel de controle principal.

1. Rotação manual de IP (instantânea)

Altere o IP do seu proxy imediatamente com um clique:

1. Acesse a página Gerenciamento de Proxy.
2. Encontre o seu proxy na lista da tabela.
3. Clique no botão laranja Rotacionar na extremidade direita da linha.

2. Rotação automática agendada (temporizador)

Configure seus proxies para rotacionar automaticamente em intervalos regulares (por exemplo, a cada 5 minutos):

1. Selecione um ou mais proxies marcando as caixas de seleção na primeira coluna.
2. Clique no botão suspenso Lote na barra de ferramentas e selecione Agendar Rotação.

3. No modal Agendar Rotação:
   • Informe o intervalo de rotação (por exemplo, 30 seconds ou 5 minutes) em Executar a cada.
   • Escolha Para sempre para rotacionar 24/7.
   • Clique no botão laranja + Adicionar Tarefa para salvar e ativar o agendamento.

3. Obter o link de API de rotação

Copie um link de requisição HTTP GET exclusivo para acionar rotações de forma programática:

1. Acesse a coluna Rotação na tabela de proxies.
2. Clique no texto LINK localizado logo abaixo do temporizador de contagem regressiva.
3. O link de API de rotação será copiado diretamente para a sua área de transferência. Você pode colar essa URL no seu bot ou script para acionar um novo IP sob demanda.

4. Personalizar o domínio ou IP do link de API

Por padrão, o link de API copiado usa o IP local do seu servidor XProxy. Se você quiser que o link use seu domínio personalizado ou IP público, configure o Host de Exibição:

1. Acesse Configurações Gerais na barra lateral esquerda e selecione Configuração do Sistema.
2. Na guia Rede, localize o cartão Host de Exibição.
3. No campo de entrada Domínio do Proxy, informe seu domínio personalizado (por exemplo, myproxy.duckdns.org) ou seu endereço IP público.
4. Clique em Salvar para aplicar as configurações.

Parte 2 — Rotação de IP no portal do cliente (usuário final)

Se você comprar proxies móveis de um revendedor do XProxy, poderá configurar a rotação automática de IP diretamente no seu painel de cliente pessoal, sem precisar de acesso ao servidor do administrador.

1. Acessar o seu painel de cliente

O seu provedor de proxy enviará uma URL de gerenciamento exclusiva contendo o seu token de acesso. Abra essa URL em qualquer navegador web para visualizar os detalhes do seu proxy e o painel de controle.

http://<proxy-provider-domain>/client/<your-unique-token>
# Or:
http://<proxy-provider-domain>/selling/info?token=<your-token>

2. Configurar a rotação automática

1. Localize a seção Controle de Rotação de IP na página.
2. Alterne o botão Rotação Automática para ON.
3. No campo Intervalo de Rotação (segundos), informe o tempo de espera entre as rotações (por exemplo, 300 para 5 minutos).
4. Clique no botão Salvar Alterações (ou Atualizar) para salvar a configuração.

3. Rotação manual instantânea e links de API

• Rotação Manual: clique no grande botão azul ROTACIONAR IP AGORA para alterar o IP imediatamente (leva de 5 a 10 segundos).
• Integração de API: copie a URL no campo de texto Link de API de Rotação e chame-a nos seus scripts de scraping ou cole-a no perfil do seu navegador anti-detecção.

Parte 3 — Referência da API de rotação de IP para desenvolvedores

Para desenvolvedores, o XProxy expõe endpoints HTTP brutos para acionar rotações manuais, consultar o status de integridade ou gerenciar agendamentos de forma programática.

NextGen API (v1) — Rotação manual

1. Rotacionar IP por porta do proxy

# Path parameters: {proxy} - The host:port string of the target proxy (e.g. localhost:4001)

# Example Request
curl --location 'http://192.168.1.100/api/v1/rotate_ip/proxy/localhost:4001'

# Response (200 OK)
{
    "status": true,
    "msg": "command_sent"
}

2. Rotacionar IP por posição do dispositivo

# Path parameters: {position} - The 1-based integer position index of the modem (e.g. 1)

# Example Request
curl --location 'http://192.168.1.100/api/v1/rotate_ip/position/1'

# Response (200 OK)
{
    "status": true,
    "msg": "command_sent"
}

NextGen API (v2) — Agendamentos de rotação

1. Adicionar uma tarefa de agendamento de rotação

# Headers: Content-Type: application/json
# Example Request
curl --location 'http://192.168.1.100/v2/schedule/rotation_add_job' \
--header 'Content-Type: application/json' \
--data '{
    "run_per_day": "forever",
    "positions": [1],
    "interval": 5,
    "unit": "minutes",
    "specific_time": "00:00",
    "start_time": null,
    "end_time": null
}'

# Response (200 OK)
{
    "status": true,
    "msg": "Schedule rotation added successfully!"
}

2. Consultar as tarefas de rotação agendadas

# Headers: Content-Type: application/json
# Example Request
curl --location 'http://192.168.1.100/v2/schedule/rotation_jobs' \
--header 'Content-Type: application/json' \
--data '{
    "positions": [1],
    "page": 1,
    "limit": 5
}'

# Response (200 OK)
{
    "status": true,
    "data": {
        "data": [
            {
                "id": 3,
                "position": 1,
                "interval": 5,
                "unit": "minutes",
                "enabled": 1,
                "next_run": 1741690800
            }
        ],
        "total": 1
    }
}

API legada — endpoints de compatibilidade

1. Verificar o status do proxy

# Example Request
curl 'http://192.168.1.100/status?proxy=192.168.1.100:4000'

# Response
status = True
msg = MODEM_READY

Possíveis valores de mensagem de status retornados em msg:

2. Renovar / Rotacionar o IP do proxy

# Example Request
curl 'http://192.168.1.100/reset?proxy=192.168.1.100:4000'

# Response
status = True
msg = command_sent