Alterar / rodar IP de proxy

Os proxies móveis XProxy suportam alterações dinâmicas do IP de saída. Pode rodar o endereço IP público do seu proxy manualmente a partir do painel de administração, automaticamente num agendamento por temporizador, através da GUI do portal do cliente ou programaticamente com pontos de extremidade HTTP diretos da API.

Parte 1 — Rotação de IP no Painel de Administração

Como administrador do XProxy, pode gerir e rodar modems diretamente a partir do seu painel de controlo principal.

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

Altere o IP do seu proxy imediatamente com um clique:

1. Vá para a página Gestão de proxies.
2. Encontre o seu proxy na lista da tabela.
3. Clique no botão laranja Rodar, na extremidade direita da linha.

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

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

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

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

3. Obter a ligação de API de rotação

Copie uma ligação de pedido HTTP GET exclusiva para acionar rotações programaticamente:

1. Vá para a coluna Rotação na tabela de proxies.
2. Clique no texto LINK localizado imediatamente abaixo do temporizador de contagem decrescente.
3. A ligação de API de rotação será copiada diretamente para a área de transferência. Pode colar este URL no seu bot ou script para acionar um novo IP a pedido.

4. Personalizar o domínio ou o IP da ligação de API

Por predefinição, a ligação de API copiada utiliza o IP local do seu servidor XProxy. Se quiser que a ligação utilize o seu domínio personalizado ou IP público, configure o Anfitrião de exibição:

1. Vá para Definições gerais na barra lateral esquerda e selecione Definições do sistema.
2. No separador Rede, localize o cartão Anfitrião de exibição.
3. No campo de introdução Domínio do proxy, introduza o seu domínio personalizado (por exemplo, myproxy.duckdns.org) ou o seu endereço IP público.
4. Clique em Guardar para aplicar as definições.

Parte 2 — Rotação de IP no Portal do Cliente (utilizador final)

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

1. Aceder ao seu painel do cliente

O seu fornecedor de proxies enviar-lhe-á um URL de gestão exclusivo que contém o seu token de acesso. Abra este URL em qualquer navegador web para ver os detalhes do seu proxy e o painel de controlo.

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 secção Controlo de rotação de IP na página.
2. Coloque o interruptor Rotação automática na posição ON.
3. No campo Intervalo de rotação (segundos), introduza o tempo de espera entre rotações (por exemplo, 300 para 5 minutos).
4. Clique no botão Guardar alterações (ou Atualizar) para guardar a configuração.

3. Rotação instantânea manual e ligações de API

• Rotação manual: Clique no grande botão azul RODAR IP AGORA para alterar o IP imediatamente (demora 5-10 segundos).
• Integração com a API: Copie o URL no campo de texto Ligação de API de rotação e invoque-o nos seus scripts de scraping ou cole-o no perfil do seu navegador anti-deteção.

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

Para programadores, o XProxy expõe pontos de extremidade HTTP diretos para acionar rotações manuais, consultar o estado de funcionamento ou gerir agendamentos programaticamente.

API NextGen (v1) — Rotação manual

1. Rodar o 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. Rodar o 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"
}

API NextGen (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. Obter 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 — Pontos de extremidade de compatibilidade

1. Verificar o estado do proxy

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

# Response
status = True
msg = MODEM_READY

Valores possíveis da mensagem de estado devolvidos em msg:

2. Renovar / rodar 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