プロキシ IP の変更 / ローテーション

XProxy モバイル プロキシは、動的なエグジット IP アドレスの変更に対応しています。管理ダッシュボードからの手動変更、タイマーによる定期自動ローテーション、クライアント ポータル GUI からの設定、または HTTP API エンドポイントを使用したプログラム制御によってプロキシのパブリック IP アドレスを変更できます。

パート 1 — 管理ダッシュボードからの IP ローテーション

XProxy 管理者として、メインのコントロール パネルから直接モデムの管理および IP ローテーションを行えます。

1. 手動での IP ローテーション（即時変更）

ワンクリックで即座にプロキシ IP を変更します:

1. Proxy Management（プロキシ管理）ページに移動します。
2. テーブル一覧から目的のプロキシを探します。
3. 行の右端にあるオレンジ色の Rotate（ローテーション）ボタンをクリックします。

2. 定期自動ローテーション（タイマー設定）

指定した時間間隔（例: 5分ごと）でプロキシを自動的にローテーションするように設定します:

1. 最初の列のチェックボックスをオンにして、1 つまたは複数のプロキシを選択します。
2. ツールバーの Batch（一括操作）ドロップダウン ボタンをクリックし、Schedule Rotation（ローテーション予約）を選択します。

3. Schedule Rotation モーダルダイアログで設定します:
   • Run on every にローテーション間隔（例: 30 seconds や 5 minutes）を入力します。
   • 24時間365日ローテーションを継続する場合は Forever を選択します。
   • オレンジ色の + Add Job ボタンをクリックして設定を保存・有効化します。

3. ローテーション API リンクの取得

プログラムからローテーションをトリガーするための固有の HTTP GET リクエスト リンクをコピーします:

1. プロキシ テーブルの Rotation 列に移動します。
2. カウントダウン タイマーのすぐ下にある LINK テキストをクリックします。
3. ローテーション API リンクがクリップボードに直接コピーされます。この URL をボットやスクリプトに貼り付けることで、必要に応じて新しい IP を取得できます。

4. API リンクのドメインまたは IP のカスタマイズ

デフォルトでは、コピーした API リンクはローカルの XProxy サーバー IP を使用します。カスタム ドメインやパブリック IP を使用したい場合は、Display Host を設定します:

1. 左側サイドバーの General Settings に移動し、System Setting を選択します。
2. Network タブにある Display Host カードを探します。
3. Proxy Domain 入力フィールドにカスタム ドメイン（例: myproxy.duckdns.org）またはパブリック IP アドレスを入力します。
4. Save をクリックして設定を適用します。

パート 2 — クライアント ポータルからの IP ローテーション（エンドユーザー向け）

XProxy リセラーからモバイル プロキシを購入した場合、サーバーの管理者権限がなくても、個人のクライアント ダッシュボードから直接自動 IP ローテーションを設定できます。

1. クライアント ダッシュボードへのアクセス

プロキシ プロバイダーから、アクセストークンを含む専用の管理 URL が送付されます。任意のブラウザでこの URL を開くと、プロキシの詳細確認やコントロール パネルの操作が行えます。

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

2. 自動ローテーションの設定

1. ページ上の IP Rotation Control セクションを探します。
2. Auto Rotation トグルを ON に切り替えます。
3. Rotation Interval (seconds) フィールドにローテーション間隔の秒数を入力します（例: 5 分ごとの場合は 300）。
4. Save Changes（または Update）ボタンをクリックして設定を保存します。

3. 手動即時ローテーション ＆ API 連携

• 手動ローテーション: 大きな青色の ROTATE IP NOW ボタンをクリックすると、即座に IP が変更されます（所要時間 5〜10 秒）。
• API 連携: Rotation API Link テキスト フィールドの URL をコピーし、スクレイピング スクリプト内に組み込むか、アンチディテクト ブラウザのプロファイルに貼り付けます。

パート 3 — 開発者向け IP ローテーション API リファレンス

開発者向けに、XProxy は手動ローテーションのトリガー、ステータス確認、またはスケジュールのプログラム制御を行うための RAW HTTP エンドポイントを提供しています。

NextGen API (v1) — 手動ローテーション

1. プロキシ ポート指定での IP ローテーション

# パス パラメーター: {proxy} - 対象プロキシの host:port 文字列（例: localhost:4001）

# リクエスト例
curl --location 'http://192.168.1.100/api/v1/rotate_ip/proxy/localhost:4001'

# レスポンス (200 OK)
{
    "status": true,
    "msg": "command_sent"
}

2. デバイス位置（Position）指定での IP ローテーション

# パス パラメーター: {position} - モデムの 1 から始まる位置インデックス数値（例: 1）

# リクエスト例
curl --location 'http://192.168.1.100/api/v1/rotate_ip/position/1'

# レスポンス (200 OK)
{
    "status": true,
    "msg": "command_sent"
}

NextGen API (v2) — ローテーション スケジュール

1. ローテーション スケジュール ジョブの追加

# ヘッダー: Content-Type: application/json
# リクエスト例
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
}'

# レスポンス (200 OK)
{
    "status": true,
    "msg": "Schedule rotation added successfully!"
}

2. 予約済みローテーション ジョブの取得

# ヘッダー: Content-Type: application/json
# リクエスト例
curl --location 'http://192.168.1.100/v2/schedule/rotation_jobs' \
--header 'Content-Type: application/json' \
--data '{
    "positions": [1],
    "page": 1,
    "limit": 5
}'

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

Legacy API — 互換性エンドポイント

1. プロキシ ステータスの確認

# リクエスト例
curl 'http://192.168.1.100/status?proxy=192.168.1.100:4000'

# レスポンス
status = True
msg = MODEM_READY

msg で返されるステータス メッセージ値一覧:

2. プロキシ IP の更新／ローテーション

# リクエスト例
curl 'http://192.168.1.100/reset?proxy=192.168.1.100:4000'

# レスポンス
status = True
msg = command_sent