ここから始めましょう · ターゲティングとセッション
出口に必要なものすべてがユーザー名に書き込まれます。
国、米国の州、都市、プロバイダー、セッション ID、および有効期間。両方の共有ゲートウェイに 6 つのパラメータ (任意の順序)。
構文#
ユーザー名で始めて追加します -key-value ペア。キーと値は小文字です。順序は関係ありません。パスワードは変更されません。パラメーターをまったく指定しない場合、出口はどの国からも選択され、接続ごとに変わります。
USER-cc-us-state-tx-city-austin-sid-a1b2c3-ttl-30m:PASS
│ │ │ │ │ │
│ │ │ │ │ └─ hold it for 30 minutes
│ │ │ │ └─ session id: same id, same IP
│ │ │ └─ city (letters and digits only)
│ │ └─ US state (United States only)
│ └─ country, ISO 3166-1 alpha-2
└─ your usernameパラメータ#
| パラメータ | 価値観 | 意味 |
|---|---|---|
| -cc- | 2 文字の国コード: us, de, br, jp | その国から出て行きなさい。住宅に関しては 199 か国。モバイル プールは、チェックアウト時にリストされた国をカバーします。 |
| -状態- | 米国の州コード: tx, ca, ny | その状態から抜け出します。必要なもの -cc-us;他の国では利用できません。 |
| -市- | 都市名、小文字、文字と数字のみ: newyork, berlin, saopaulo | その街から出てください。必要なもの -cc-。それぞれ 国のページ は、利用可能な都市を正確な値とともにリストします。 |
| -asn- | 自律システム番号 ( AS 接頭辞: 7922, 3320 | そのプロバイダーによって通知された終了。と組み合わせる -cc-。モバイル プールでは、これが通信事業者を選択する方法です。 |
| -サイド- | 文字と数字、最大 32 文字: a1b2c3, job42 | 粘着セッション。同じ ID を持つリクエストは、有効期間が終了するかデバイスがオフラインになるまで 1 つの出口を共有します。新しい ID は新しい IP を意味します。 |
| -ttl- | 数分または数時間から 1m に 24h: 10m, 2h | 最初のリクエストからカウントされたスティッキー セッションの存続期間。デフォルト 10m いつ -sid- なしで存在します -ttl-. |
ローテーションとセッション#
なし -sid- ゲートウェイは新しい出口を選択します 新しい接続ごとに それは受け取ります。接続を維持するクライアント、または 1 つの接続を介して多くのリクエストを送信するクライアント CONNECT トンネルの場合、接続が存続する限り同じ出口を維持します。リクエストごとにローテーションするには、キープアライブを無効にするか、呼び出しごとに接続を閉じます。複数の接続にわたって 1 つの IP を維持するには、セッション ID を使用します。
- 同じ
-sid-値、同じ IP、任意の数の並列接続上。必要な数のセッションを一度に実行します。キャップはありません。 - 有効期限が切れるか、世帯が切断されると、その ID を持つ次のリクエストは 新しい 他のパラメータと一致する IP。このための設計: フロー中の IP 変更は、どの住宅用ネットワークでも可能です。
- すぐに変更を強制するには、ID を変更します。 ID の範囲はアカウントに限定され、費用はかかりません。
- スティッキー セッションは、レジデンシャル プールとモバイル プールに存在します。専用 ISP、データセンター、およびモバイル デバイス プロキシは 1 つの固定 IP であり、無視されます
-sid-そして-ttl-.
例#
| あなたが欲しいのは | ユーザー名 |
|---|---|
| どの国のどの接続でも新しい IP | USER |
| すべての接続に新しい米国の IP | USER-cc-us |
| テキサス州の家庭 | USER-cc-us-state-tx |
| ベルリンのあらゆる IP | USER-cc-de-city-berlin |
| 1 つのベルリン IP が 10 分間保持される | USER-cc-de-city-berlin-sid-7f3a9 |
| 1つの日本のIPを2時間保持 | USER-cc-jp-sid-tokyo1-ttl-2h |
| Comcast 加入者 (AS7922) | ユーザー-cc-us-asn-7922 |
| ドイツテレコムのモバイル顧客、15 分間保留 | USER-cc-de-asn-3320-sid-m1-ttl-15m |
| 20の並行ブラジルセッション | USER-cc-br-sid-w01 … USER-cc-br-sid-w20 |
都市名#
都市の値は、スペース、ハイフン、アポストロフィ、アクセントを削除した小文字の ASCII 都市名です。 New York になる newyork, São Paulo になる saopaulo, Düsseldorf になる dusseldorf, Frankfurt am Main としてリストされています frankfurt。推測ではなく、国のページに印刷されている値を使用してください。これはゲートウェイが一致する正確な文字列です。
パラメータが受け入れられない場合に何が起こるか#
| ケース | 応答 | 何をすべきか |
|---|---|---|
不明なキーまたは不正な値 (-country-us, -ttl-90x) | 400 Bad Request | 文字列を修正します。応答本文ではパラメータに名前を付けます。 |
-city- または -state- なしで -cc-、または -state- 米国外 | 400 Bad Request | 追加 -cc-us またはパラメータを削除します。 |
| 現在オンラインの出口はありません (たとえば、小さな都市と 1 つの ASN) | 502 Bad Gateway | 再試行してから拡張します: ドロップ -asn-、その後 -city-. |
| 専用アドレスに送信されるパラメータ | 無視されました | 何もありません。 IPは固定です。 |