oxylabs-proxies

Oxylabs プロキシ

プロキシタイプの概要

タイプ	ホスト	ポート	最適な用途
レジデンシャル	pr.oxylabs.io	7777	高い匿名性、ジオターゲティング
モバイル	pr.oxylabs.io	7777	モバイル専用コンテンツ、最高レベルの信頼性
データセンター（共有）	dc.oxylabs.io	8000 ローテーション / 8001+ 割り当て済み／静的	高速性、大量処理
ISP（共有）	isp.oxylabs.io	8000 ローテーション / 8001+ 割り当て済み／静的	高速性と匿名性のバランス
専用データセンター	ddc.oxylabs.io	8000 ローテーション / 8001+ 割り当て済み／静的	所有IP、ポートベースのアクセス
専用ISP	disp.oxylabs.io	8000 ローテーション / 8001+ 割り当て済み／静的	所有するISP IP、ASN固定

レジデンシャル／モバイルでは、ユーザー名のセッションパラメーターとともに pr.oxylabs.io:7777 を使用します。データセンター／ISPおよび専用のセルフサービス製品では、割り当て済み／静的IPには 8001 から始まるプロキシリストのポートを、自動ローテーションには 8000 を使用します。

環境変数

該当するプロキシ製品ファミリーの認証情報を使用します。

製品ファミリー	変数	ユーザー名のプレフィックス
レジデンシャル、モバイル	OXY_RES_USERNAME, OXY_RES_PASSWORD	customer-
データセンター、ISP、専用データセンター、専用ISP	OXY_DC_USERNAME, OXY_DC_PASSWORD	セルフサービス／共有の場合は user-

認証形式

customer-USERNAME:PASSWORD    # Residential, Mobile
user-USERNAME:PASSWORD          # Shared Datacenter, Shared ISP

専用プロキシの認証（セルフサービスとエンタープライズ）については、dedicated-datacenter.md と dedicated-isp.md を参照してください。

レジデンシャル／モバイル（OXY_RES_USERNAME、OXY_RES_PASSWORD）とデータセンター／ISP（OXY_DC_USERNAME、OXY_DC_PASSWORD）では、それぞれ別の認証情報を使用します。

パラメーターを指定する場合：

customer-USERNAME-cc-US-city-new_york-sessid-abc123:PASSWORD

クイックスタート

レジデンシャル／モバイルプロキシ：

curl -x "pr.oxylabs.io:7777" \
  -U "customer-$OXY_RES_USERNAME:$OXY_RES_PASSWORD" \
  "https://ip.oxylabs.io/location"

データセンタープロキシ：

curl -x "dc.oxylabs.io:8000" \
  -U "user-$OXY_DC_USERNAME:$OXY_DC_PASSWORD" \
  "https://ip.oxylabs.io/location"

ISPプロキシ：

curl -x "isp.oxylabs.io:8001" \
  -U "user-$OXY_DC_USERNAME:$OXY_DC_PASSWORD" \
  "https://ip.oxylabs.io/location"

データセンター、ISP、専用データセンター、専用ISPのプロキシでは、割り当て済み／静的IP用にダッシュボードのプロキシリストにある 8001 から始まるポートを使用します。最初にリストされたIPには 8001 を使用します。タスクで自動ローテーションが必要な場合にのみ、ポートを 8000 に切り替えてください。

ジオターゲティングパラメーター

レジデンシャル／モバイルでは、特に記載のない限り、ユーザー名にハイフンでつないだパラメーターを追加します。

パラメーター	形式	例
cc	ISO 3166-1 alpha-2	-cc-US、-cc-DE、-cc-GB
city	英語、スペースはアンダースコアに置き換え	-city-new_york、-city-los_angeles
st	us_ プレフィックス付きの米国の州	-st-us_california、-st-us_texas
postalcode	5桁の米国ZIPコード。cc-US と併用	-cc-US-postalcode-90210
ASN	レジデンシャル／モバイルのキャリアASN	-ASN-21928
X-Oxylabs-Geolocation	プロキシヘッダー lat:lon;radius_miles	49.9235:-97.0811;10

ZIPコードによるターゲティングは米国内のみです。座標の半径は10マイル未満にできません。国とASNの両方を指定した場合は、国が適用されます。

ジオターゲティングの例：

curl -x "pr.oxylabs.io:7777" \
  -U "customer-$OXY_RES_USERNAME-cc-US-city-new_york:$OXY_RES_PASSWORD" \
  "https://ip.oxylabs.io/location"

共有データセンター／ISPで国別ローテーションを行う場合は、ローテーション用ポートで user- 認証情報を使用し、-country-US を指定します。

セッション制御

パラメーター	説明	備考
sessid	リクエスト間で同じIPを維持	標準セッションは10分、または非アクティブ状態が最大60秒続くまでです
sessid_oneip	セッションを1つの特定の出口ノードに固定	そのIPが利用できなくなると 502 を返します
sesstime	sessid または sessid_oneip とともに、セッション時間を分単位で設定	レジデンシャルのバックコネクトでは最大1440分をサポートします。一部の接続方式では上限がより低く設定されています

スティッキーセッションの例：

curl -x "pr.oxylabs.io:7777" \
  -U "customer-$OXY_RES_USERNAME-cc-US-sessid-mysession123:$OXY_RES_PASSWORD" \
  "https://example.com"

時間指定セッション（5分）：

curl -x "pr.oxylabs.io:7777" \
  -U "customer-$OXY_RES_USERNAME-sessid-abc123-sesstime-5:$OXY_RES_PASSWORD" \
  "https://example.com"

適切なプロキシタイプの選択

ニーズ	推奨
最高レベルの匿名性	レジデンシャル
モバイルアプリのコンテンツ	モバイル
高速性と処理量	データセンター
高速性と匿名性	ISP
所有する専用IP	専用データセンターまたは専用ISP
地域制限のあるコンテンツ	cc／city／postalcode を指定したレジデンシャル／モバイル、または適切な場合は国別／割り当て済みポートを使用したDC／ISP

デフォルトの動作

• パラメーターなし：リクエストごとにランダムな IP が割り当てられます
• レジデンシャル／モバイルは同じエンドポイントを共有しますが、異なる IP プールを使用します
• セッションは自動的に期限切れになり、新しい IP が割り当てられます

追加リソース

• 共有プロキシの詳細（レジデンシャル、モバイル、データセンター、ISP）：proxy-types.md
• 専用データセンター（セルフサービス＋エンタープライズ）：dedicated-datacenter.md
• 専用 ISP（セルフサービス＋エンタープライズ）：dedicated-isp.md
• コード例（全言語）：examples.md