セッション

デフォルトでは、すべてのリクエストは新しいIPにローテーションします。複数のリクエストにわたって同じIPを使用する必要がある場合は、スティッキーセッションを開始してください。

モード

リクエストごとのローテーション

sidフラグを付けずにリクエストを送信します。各リクエストは異なるIPを使用します。

curl -x customer-USERNAME-country-us:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json
# 72.14.201.44

curl -x customer-USERNAME-country-us:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json
# 98.207.12.9

スティッキーセッション

ユーザー名にsid-<id>を追加します。idは任意に選択できる文字列で、同じidを使った後続のリクエストは、TTLが期限切れになるか上流でIPが切断されるまで同じIPを返します。ttl-<seconds>は任意で、sidと併用する場合のみ有効です。これによりデフォルトの有効期間（120秒、最小1）を上書きできます。パネルのエンドポイントビルダーもデフォルトは120です。

customer-USERNAME-country-us-sid-order42             # default 120s lifetime
customer-USERNAME-country-us-sid-order42-ttl-600     # custom 10-minute lifetime

curl -x customer-USERNAME-sid-order42-ttl-600:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json
# 72.14.201.44

curl -x customer-USERNAME-sid-order42-ttl-600:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json
# 72.14.201.44  (same)

セッションIDの選び方

• ワークフローごとに一意なものを選んでください（order-42、user-a7f3、checkout-2024-11-21-1）。
• 同じidを同時に共有する2つの別々の実行は、1つのスティッキーIP上で衝突します。
• idは任意の値であり、Shifterはそれを解析しません。キャッシュキーとして使用されます。

セッションが期限切れになる場合

• ttl秒が経過すると、マッピングは破棄され、次のリクエストは新しいIPにローテーションします（ターゲティングフラグは保持されます）。
• 基盤となるレジデンシャルIPがそれより早く切断された場合、セッションは早期に終了し、次のリクエストはローテーションします。

ジオターゲティングとの組み合わせ

スティッキーセッションは他のフラグを尊重します。セッションIDは、フィルター内の1つのIPを固定します。

customer-USERNAME-country-us-city-los_angeles-sid-scrape1            # default 120s
customer-USERNAME-country-us-city-los_angeles-sid-scrape1-ttl-300    # custom 5-min

同じidを持つすべてのリクエストは、TTLの期間中、1つのロサンゼルスのIPに留まります。

注意

同じセッションIDを並行するワークフロー間で再利用しないでください。異なるスクリプトからのリクエストが同じIPに集中すると、ほとんどのアンチボットシステムには不審な挙動として認識されます。

複数のマシンやリージョンにまたがるセッション

スティッキーセッションはリージョンごとに保持されます。p.shifter.ioは各マシンを最も近いリージョンに接続するため、異なるリージョンに接続された2台のマシンで同じsidを使うと、2つの異なるIPになります。これは次のような場合に影響します。

• スクレイパーとCAPTCHAソルバーが同じセッションを使う場合（ソルバーは自社のサーバーから接続します）。
• 複数のサーバー、コンテナ、クラウド関数で1つのセッションを共有する場合。
• ブラウザと別のAPIクライアントを同じ訪問者として見せる必要がある場合。

どこからでも同じIPを維持するには、セッションを共有するすべてのツールを同じリージョン別エントリーポイント（例: fra.p.shifter.io）に向けてください。

customer-USERNAME-country-us-sid-order42-ttl-600:PASSWORD@fra.p.shifter.io:443

常にp.shifter.io経由で接続する単一のマシンは、通常は影響を受けません。

次のステップ

• ジオターゲティング、固定する前にプールを絞り込みます。
• インテグレーション、Scrapy、Puppeteer、PlaywrightにおけるセッションID。