ネットワークプロキシ
サブスクリプション アカウントにワークスペースに固定送信プロキシを与えます。
サブスクリプション アカウントがプロバイダーへの特定のアウトバウンド ルートを必要とする場合は、ネットワーク プロキシを使用します。プロキシは 1 つのワークスペースに属し、別のワークスペースになります。 リソースグループ、メンバーが使用できるアカウントを制御します。アカウントには 1 つのプロキシ バインディングを含めることも、インスタンスのデフォルトのネットワーク ルートを使用することもできます。
プロキシを追加する
- ワークスペース管理者として開きます 管理 → ネットワークプロキシ そして選択します プロキシの追加.
- 認識可能な名前と完全なプロキシ URL を入力します。例えば、
http://proxy.example.test:8080またはsocks5://user:pass@proxy.test:1080. - 保存してください。リストには、名前、プロトコル、ホスト、ポート、およびバインドされたアカウントの数が表示されます。ユーザー名やパスワードは決して表示されません。
URL には次のものを使用する必要があります http://, https://、 または socks5:// 明示的なホストとポートを含めます。認証を使用する場合は、ユーザー名とパスワードの両方が必要です。資格情報内の予約文字をパーセントエンコードします。 @ として %40。パス、クエリ、フラグメントは受け入れられません。ワークスペースには最大 32 個のプロキシを保持できます。
プロキシを保存すると、その URL は検証されますが、接続は行われません。アカウントの使用 接続を確認する バインド後のアクションでプロバイダーへの実際のルートを確認します。
複数のプロキシをインポートする
選択 プロキシのインポート 1 行に 1 つのエントリを貼り付けます。 1 行には完全な URL を指定できます。 host:port (HTTPとして扱われます)、または Name | URL カスタム名の場合。例えば：
http://proxy-a.test:8080
Backup exit | socks5://user:pass@proxy-b.test:1080
proxy-c.test:8081カスタム名を使用しない場合、SubLane はホストとポートを使用し、必要に応じてサフィックスを追加します。空白行は無視されます。バッチ全体が残りの 32 プロキシ ワークスペース制限に対して検証され、1 つのトランザクションで保存されます。 1 つのエントリが無効であるか、明示的な名前がすでに使用されている場合、 そのバッチからは何もインポートされません。インポートされた認証情報は、個別に追加されたプロキシと同じ暗号化と編集を受けます。
出口をテストしてその位置を確認する
選択 テストプロキシ プロキシ行にあります。 SubLane は、そのプロキシを通じて 1 つの制限された HTTPS リクエストを作成し、 IPinfo のパブリック IP エンドポイント。成功した応答では、観察された出口 IP、提供されたときの国/地域/都市、応答時間、およびチェック時間が記録されます。の検索です ネットワーク出口、プロキシ サーバーの物理アドレスではありません。 IP 地理位置情報はおおよそのものです。テストは、管理者が要求した場合にのみ実行されます。
選択 すべてのプロキシをテストする 保存されているすべてのプロキシを 1 つのアクションでチェックします。一度に最大 4 つのチェックが実行され、チェックが失敗しても残りのチェックは停止されません。このページには、進行状況と、接続されたプロキシ、接続の失敗、その他のエラーの概要が表示されます。このアクションでは、プロキシごとに 1 つの IPinfo リクエストが作成されるため、パブリック エンドポイントの共有制限もバッチに適用されます。
パブリック IPinfo エンドポイントには、 1 日あたりの共有制限。ルックアップ エラーまたはレート制限は、接続エラーとは別に表示され、プロキシ バインディングは変更されません。プロキシ URL を編集すると、古いチェック結果が消去されます。 IPinfo に対するチェックでは、サブスクリプション プロバイダーに到達できることは証明されません。アカウントをバインドして使用する 接続を確認する そのために。
アカウントをバインドする
- 新しいアカウント: まずプロキシを作成し、次にそれを選択します ネットワークプロキシ で アカウント → アカウントを追加 ブラウザの認証または JSON インポートの前に。選ぶ デフォルトのネットワークルート アカウントをバインドされていない状態のままにします。
- 既存のアカウント: で アカウント、アカウントのアクションを開き、選択します ネットワークプロキシをクリックし、プロキシを選択して保存します。カードには、バインドされたプロキシの名前が表示されます。再認証により、アカウントの現在のバインドが維持されます。
このバインディングは、SubLane のサーバー側 OAuth トークン交換、資格情報の更新、モデル検出、サポートされている場合のクォータ読み取り、およびモデル トラフィックをカバーします。プロバイダーのブラウザーのサインイン ページが開きます。 あなたのブラウザ SubLane のプロキシは使用しません。輸入品 proxy_url フィールドは無視されます。ワークスペース管理者によって構成されたプロキシのみがバインディングになれます。
新しいリクエストはそれぞれ、アカウントの現在のバインディングを使用します。プロキシ URL またはアカウント バインドを変更しても、アクティブなストリームが移動したり、リクエストが再生されたりすることはありません。また、会話で選択されたサブスクリプション アカウントも変更されません。 SubLane は、リクエストごとにプロキシをローテーションしたり、別のプロキシに自動的にフェイルオーバーしたりしません。バインドされていないアカウントは、プロセスでプロキシ環境変数が構成されている場合は、それを含むインスタンスのデフォルトの送信トランスポートを引き続き使用します。
プロキシを変更または削除する
で ネットワークプロキシ、選択します プロキシの編集 をクリックして名前を変更するか、URL を置き換えます。離れる プロキシ URL 保存されたアドレスを維持するには、編集中は空白にしてください。変更されたアドレスは、そのプロキシにバインドされているすべてのアカウントからのその後のリクエストに対して有効になり、以前の終了チェックがクリアされます。プロキシを削除するには、まずバインドされた各アカウントを デフォルトのネットワークルート または別の場所にバインドします。バインドされたアカウントを持つプロキシは削除できません。
行のテスト、編集、および削除のアクションでは、説明的なツールチップが付いたアイコンが使用されます。 失敗したプロキシを削除する 確認を開き、最新のチェックで過去 30 分以内に接続失敗が報告されたバインドされていないプロキシを削除します。バインドされたプロキシ、未テストのプロキシ、または場所検索エラーのプロキシは削除されません。サーバーは確認時にこれらの条件を再度適用するため、削除された数は確認前に表示された数と異なる場合があります。
失敗したルートの後でアカウントがクールダウンしている場合は、そのアカウントを開きます スケジュール設定、クールダウンをクリアするには アカウントを再開する、実行します 接続を確認する。アカウントが代わりに次のように言った場合 再認証が必要です、再認証します。プロキシのみを変更しても、その資格情報は置き換えられません。コンテナーのデプロイメントの場合、 127.0.0.1 プロキシ URL ではコンテナ自体を参照するため、SubLane プロセスから到達可能なアドレスを使用します。
セキュリティと API
プロキシ URL は、インスタンス ボールト キーを使用して SQLite で暗号化されます。データベースとキーを一緒にバックアップします。管理エンドポイントには、有効な管理者セッションと書き込みの同一オリジン チェックが必要です。プロキシ リストの応答では、エンドポイントと最新のチェック結果のみが公開され、資格情報は公開されません。手動チェックでは、プロキシのパブリック出口 IP が IPinfo と共有されます。位置情報リクエストはバックグラウンドで実行されません。成功した変更は監査されます。個々のプロキシとアカウント バインディングではリソース ID が使用されますが、バッチ インポートと失敗したプロキシの削除ではそれぞれ項目 ID なしで 1 つのイベントが作成されます。生の URL とパスワードは監査フィールドではありません。見る 経営監査.
| 終点 | 目的 |
|---|---|
GET /api/proxies | このワークスペースのプロキシとバインドされたアカウント数を一覧表示します。 |
POST /api/proxies | で作成する {"name":"...","url":"..."}. |
POST /api/proxies/import | 改行で区切られたエントリをアトミックにインポートします。 {"text":"..."}. |
POST /api/proxies/prune | 最近接続に失敗したバインドされていないプロキシを削除します。返品 deleted_count 空の JSON オブジェクトを受け入れます ({}). |
POST /api/proxies/{id}/check | 手動の出口 IP と場所のチェックを実行します。空の JSON オブジェクトを送信します ({}). |
PUT /api/proxies/{id} | 名前と URL を更新します。空のメッセージを送る url 保存したアドレスを保持します。 |
DELETE /api/proxies/{id} | バインドされていないプロキシを削除します。空の JSON オブジェクトを送信します ({}). |
PUT /api/accounts/{id}/proxy | バインド {"proxy_id":"..."} またはバインドを解除します {"proxy_id":""}. |
POST /api/accounts/import そして POST /api/accounts/oauth オプションも受け付けます proxy_id アカウントを作成するとき。無効な URL またはインポート行は HTTP 400 を返します。欠落しているプロキシまたはクロスワークスペースのプロキシは 404 を返します。名前の重複、ワークスペースの制限、バインドされたプロキシの削除、編集によるチェックの置き換えは 409 を返します。
自動ルーティング チェックでは、HTTPS CONNECT トンネルを含む合成プロキシが使用されます。これらは、特定のプロキシまたはライブプロバイダーアカウントが展開内で機能することを確立するものではありません。それを確認してください 接続を確認する.