Changer / faire pivoter l'IP du proxy

Les proxys mobiles XProxy prennent en charge le changement dynamique de l'IP de sortie. Vous pouvez renouveler l'adresse IP publique de votre proxy manuellement depuis le tableau de bord administrateur, automatiquement selon une planification par minuterie, via l'interface du portail client, ou par programmation à l'aide des points de terminaison HTTP bruts de l'API.

Partie 1 — Rotation d'IP depuis le tableau de bord administrateur

En tant qu'administrateur XProxy, vous pouvez gérer les modems et renouveler leur IP directement depuis votre panneau de contrôle principal.

1. Rotation d'IP manuelle (immédiate)

Changez immédiatement l'IP de votre proxy en un seul clic :

1. Accédez à la page Gestion des proxys.
2. Trouvez votre proxy dans la liste du tableau.
3. Cliquez sur le bouton orange Rotation à l'extrémité droite de la ligne.

2. Rotation automatique planifiée (minuterie)

Configurez vos proxys pour qu'ils se renouvellent automatiquement à intervalles réguliers (par ex. toutes les 5 minutes) :

1. Sélectionnez un ou plusieurs proxys en cochant leurs cases dans la première colonne.
2. Cliquez sur le bouton déroulant Traitement par lot dans la barre d'outils et sélectionnez Planifier la rotation.

3. Dans la fenêtre modale Planifier la rotation :
   • Saisissez votre intervalle de rotation (par ex. 30 secondes ou 5 minutes) sous Exécuter toutes les.
   • Choisissez Pour toujours pour une rotation 24 h/24 et 7 j/7.
   • Cliquez sur le bouton orange + Ajouter une tâche pour enregistrer et activer la planification.

3. Obtenir le lien API de rotation

Copiez un lien de requête HTTP GET unique pour déclencher les rotations par programmation :

1. Accédez à la colonne Rotation du tableau des proxys.
2. Cliquez sur le texte LINK situé directement sous le minuteur de compte à rebours.
3. Le lien API de rotation sera copié directement dans votre presse-papiers. Vous pouvez coller cette URL dans votre bot ou votre script pour déclencher une nouvelle IP à la demande.

4. Personnaliser le domaine ou l'IP du lien API

Par défaut, le lien API copié utilise l'IP locale de votre serveur XProxy. Si vous souhaitez que le lien utilise votre domaine personnalisé ou votre IP publique, configurez l'hôte d'affichage :

1. Accédez à Paramètres généraux dans la barre latérale gauche, puis sélectionnez Paramètres système.
2. Sous l'onglet Réseau, localisez la carte Hôte d'affichage.
3. Dans le champ de saisie Domaine du proxy, saisissez votre domaine personnalisé (par ex. myproxy.duckdns.org) ou votre adresse IP publique.
4. Cliquez sur Enregistrer pour appliquer les paramètres.

Partie 2 — Rotation d'IP du portail client (utilisateur final)

Si vous achetez des proxys mobiles auprès d'un revendeur XProxy, vous pouvez configurer la rotation automatique d'IP directement depuis votre tableau de bord client personnel, sans avoir besoin d'accéder au serveur administrateur.

1. Accéder à votre tableau de bord client

Votre fournisseur de proxys vous enverra une URL de gestion unique contenant votre jeton d'accès. Ouvrez cette URL dans n'importe quel navigateur web pour afficher les détails de votre proxy et votre panneau de contrôle.

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

2. Configurer la rotation automatique

1. Repérez la section Contrôle de la rotation d'IP sur la page.
2. Basculez le commutateur Rotation automatique sur ON.
3. Dans le champ Intervalle de rotation (secondes), saisissez le délai entre deux rotations (par ex. 300 pour 5 minutes).
4. Cliquez sur le bouton Enregistrer les modifications (ou Mettre à jour) pour sauvegarder la configuration.

3. Rotation instantanée manuelle et liens API

• Rotation manuelle : cliquez sur le grand bouton bleu RENOUVELER L'IP MAINTENANT pour changer l'IP immédiatement (cela prend 5 à 10 secondes).
• Intégration API : copiez l'URL du champ de texte Lien API de rotation et appelez-la dans vos scripts de scraping ou collez-la dans le profil de votre navigateur anti-détection.

Partie 3 — Référence de l'API de rotation d'IP pour les développeurs

Pour les développeurs, XProxy expose des points de terminaison HTTP bruts permettant de déclencher des rotations manuelles, d'interroger l'état de santé ou de gérer les planifications par programmation.

API NextGen (v1) — Rotation manuelle

1. Renouveler l'IP par port de 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. Renouveler l'IP par position d'appareil

# 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) — Planifications de rotation

1. Ajouter une tâche de rotation planifiée

# 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. Récupérer les tâches de rotation planifiées

# 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 héritée — Points de terminaison de compatibilité

1. Vérifier l'état du proxy

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

# Response
status = True
msg = MODEM_READY

Valeurs possibles des messages d'état renvoyées dans msg :

2. Renouveler / changer l'IP du proxy

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

# Response
status = True
msg = command_sent