ログインして接続・ターゲット設定
Updated:
セッションの固定、GEO/ASN/ISP/ZIPによる出口IPの制限、ターゲティングの組み合わせ——これらすべてを、プロキシのログインにサフィックスを追加するだけで実現できます。
仕組み
居住用プロキシのログイン名は「login_targetingSuffixes」のような形式になります。ベースとなる「xxx」が認証情報です。その後に、アンダースコアで区切って、ターゲティングおよびセッションのサフィックスを追加してください。
base country city session ttl xxx_c_US_city_New-York_s_100_ttl_30s
接続情報
プロキシホスト（地域別）
ホスト
場所
res.proxy-seller.com
NL
us.res.proxy-seller.com
米国
asia.res.proxy-seller.com
JP-東京
asia2.res.proxy-seller.com
JP-東京
移植
10000
種類
HTTPS/ SOCKS5（自動検出）。SOCKS5はUDPも伝送し、これにはウェブサイトへのHTTP/3も含まれます — 詳細はHTTP/3 および SOCKS5 経由の UDP. HTTPS経由でのプロキシへの接続はサポートされていません。
ログインとパスワード
メインパッケージ向けに、以下を通じて提出してください。
PUT/ja-JP/resident/list/toolsまたはサブユーザー向け
PUT/ja-JP/residentsubuser/list/tools
同時リクエストの場合は、ポート10000～10999を使用してください。各ポートは個別の送信元IPに割り当てられます。つまり、1.2.3.4:10005と1.2.3.4:10006は異なるIPとなります。
対象となる接尾辞
ログインIDに任意の組み合わせを追加することで、アクセス元のIPアドレスを制限できます。接尾辞を付けない場合、リクエストごとにグローバルプールから新しいIPアドレスが割り当てられます。
対象 | 接尾辞 | 注記 |
|---|---|---|
国 |
| ISO 3166-1の2文字コード（大文字小文字を区別）。国一覧 → |
細分化 |
| 地域／州ID。サブカテゴリ一覧 → |
都市 |
| スペースは「-」に置き換えてください（例：New-York）。多くの場合、国名と組み合わされます。 |
ISP |
| 数値によるISP ID。ISP一覧 → |
ASN |
| 自律システム番号。 |
郵便番号 |
| 国名を指定してください（ |
複数の接尾辞は連結して表記してください：xxx_c_US_city_New-York_asn_12271
セッション制御
セッションIDを追加し、必要に応じてTTLを設定することで、リクエスト間で同じ出口IPを再利用してください。
制御 | 接尾辞 | 注記 |
|---|---|---|
セッションID |
| 任意の英数字の文字列。セッションが有効な間は、同一のID＝同一の出口IPとなります。非アクティブなセッションは60分後に失効します。 |
セッションのTTL |
| カスタムセッションの有効期間。接尾辞：s（秒）、m（分）、h（時間）。以下のルールに従うこと |
# pinned for 10 seconds curl -x xxx_s_100_ttl_10s:[email protected]:10000 https://example.com
# pinned for 15 minutes curl -x xxx_s_100_ttl_15m:[email protected]:10000 https://example.com
# pinned for 1 hour curl -x xxx_s_100_ttl_1h:[email protected]:10000 https://example.comまとめ
接尾辞はすべて連結して記述してください — 国 + 都市 + ISP + セッション + TTL をまとめて記載します。
# country + city + ASN + session curl -x xxx_c_US_city_New-York_asn_12271_s_100:[email protected]:10000 https://example.com
# country + city + session curl -x xxx_c_US_city_New-York_s_100:[email protected]:10000 https://example.com
# country + ASN curl -x xxx_c_US_asn_12271:[email protected]:10000 https://example.comチートシート
_c_{country} → _c_US _sd_{subdivision} → _sd_1906 _city_{city} → _city_New-York _isp_{ispId} → _isp_51811 _asn_{asn} → _asn_12389 _zip_{zip} → _zip_10001 (with _c_) _s_{sessionId} → _s_100 _ttl_{duration} → _ttl_30s | _ttl_15m | _ttl_1hよくある質問（FAQ）
文書化における制約事項：_ttl_ 必ず遵守すること_s_ — セッション ID なしでは、セッション TTL は意味を成しません。仕様書にはまた、次のように記載されています。_zip_ 必須条件_c_。ドキュメント内のすべての例では、一定の順序で記述されています —_c_ →_city_/_sd_ →_isp_/_asn_/_zip_ →_s_ →_ttl_。任意の順序での動作は規定されていないため、テストリクエストで別段の確認がなされていない限り、文書化された順序に従うこと。
はい、ただしIPアドレスの候補範囲が狭まります。それらの共通部分が空の場合、接続は確立されません（タイムアウト）。以下の条件と照合して検証してください。get-all-isp-codes 展開する前に。
いいえ。郵便番号には常にペアとなる_c_<country> — これがないとコードが曖昧となり、却下されます。
_ttl_0 明示的なTTLを無効化 → デフォルトの60分間の非アクティブ状態にフォールバックします。負の値は拒否されます。
トラフィックプール内に上限は設けません。
はい。セッションが有効な間（TTL／非アクティブ期間内）であれば、たとえ一時的に接続が切断された後でも、同じIDを再利用すれば同じ出口IPが返されます。
はい。_C_US は失敗します。小文字を使用してください_c_US (値US （ISO 3166-1 に基づき、これ自体は大文字表記となります）。以下についても同様です。_isp_,_asn_,_zip_.