Live Share の接続性要件

この記事では、Visual Studio Live Share の接続性要件、使用可能なオプション、該当する場合の既知の回避策について説明します。

サインイン

Live Share には、Azure Active Directory でサポートされている職場または学校アカウント、Microsoft アカウント、またはGitHub プロファイルを使用してサインインできます。 通常、これらのサインイン URL は、それらを使用する公開製品の数を考えると、ほとんどの組織で公開されているも同然ですが、公開されていない場合は、以下に示すドメインに加えて、login.microsoftonline.com または github.com を開く方法についてネットワーク管理者にお問い合わせください。

注意

オンプレミスの AD (ADFS) アカウントおよびオンプレミスの GitHub Enterprise アカウントは現在サポートされていません (賛成 👍)

接続モード

Visual Studio Live Share では、最適なパフォーマンスを確保するために、既定により、コラボレーション セッション ホスト マシンとゲスト マシンがネットワーク経由で直接通信できるかどうかを自動的に検出し、それらの間にルートがない場合はクラウド経由でのみリレーします。 この混合 "自動" モードは柔軟性が高く、一部のゲストはクラウド経由でリレーでき、他のゲストは同じセッションに対して直接接続できます。

直接接続は、セキュリティを確保するためにクラウド ベースのメカニズムを介して認証されますが、接続を有効にするには 5990 から 5999 の間のポートを開く必要があります。 その結果、初めて共有するときに、デスクトップ ファイアウォールからポートを開くように求めるメッセージが表示される場合があります。 これを無視しても、自動モードのときに Live Share が常にリレーを使用するようになるだけであるため、これを受け入れるかどうかは任意です。

Visual Studio Live Share 内のすべての接続は SSH または SSL で暗号化され、中央サービスに対して認証され、コラボレーション セッション内の接続のみがそのコンテンツにアクセスできます。 さらに、Live Share のクラウド リレーでは、それを介してルーティングされたトラフィックは保持されず、トラフィックが "捜索" されることもありません。

接続モードの変更

直接接続またはリレー接続を無効にするか、単に接続の問題のトラブルシューティングを行う場合は、他の接続モードを強制できます。

モード ホストの動作 ゲストの動作
自動 ホストのコラボレーション セッションでは、セキュリティで保護され、認証された直接接続またはクラウド リレー接続が受け入れられます。 直接接続の使用を試み、これが失敗した場合はクラウド経由のリレーにフォールバックします。
直接 ホストのコラボレーション セッションは、認証されたセキュリティで保護された直接接続のみを受け入れます。 直接接続の使用を試み、接続できない場合は停止します。
リレー ホストのコラボレーション セッションでは、直接接続は許可されません。 ホストのコンピューターでポートは開かれません。 常にクラウド経由で接続します。

モードを変更するには:

VS:

  1. [ツール] > [オプション] > [Live Share] の順に移動します。
  2. [接続モード] ドロップダウンからモードを選択します。
  3. VS を再起動します。

VS Code:

  1. settings.json を編集します ([ファイル] > [ユーザー設定] > [設定])。
  2. 必要に応じて、"liveshare.connectionMode""auto""direct"、または "relay" に設定します。
  3. VS Code を再起動します。

接続モードの要件

使用している接続モードでは、Live Share を機能させるために使用できる必要がある特定のポートと URL が決定されます。

モード クライアント アクセス要件 トラブルシューティング
Any *.liveshare.vsengsaas.visualstudio.com:443 への送信アクセス。 企業または個人のネットワーク ファイアウォールで、このドメインへの接続が許可されている必要があります。 ブラウザーに「https://visualstudio.microsoft.com/services/live-share/」と入力し、Visual Studio Live Share ホーム ページが表示されることを確認します。 また、解決する必要があるプロキシの問題が発生している可能性もあります。
Any (VS Code) download.microsoft.com:443 への送信アクセス。 企業または個人のネットワーク ファイアウォールで、このドメインへの接続が許可されている必要があります。 また、解決する必要があるプロキシの問題が発生している可能性もあります。
自動 自動スイッチ。 ダイレクト モードとリレー モードに関するページを参照してください。 トラブルシューティングを行う場合は、ダイレクト モードまたはリレー モードに切り替えます。
直接 ホスト: 受信ローカル ネットワーク接続を受け入れるには、5990 から 5999 の範囲のポートを開く必要があります。

ゲスト: この同じポート上のホストへのネットワーク ルートと送信アクセス。
このポート範囲について、デスクトップ ファイアウォール ソフトウェアによって "vsls-agent" がブロックされていないことと、相互に ping を実行できることを確認します。 エージェントを初めて起動したときに Windows やその他のデスクトップ ソフトウェアによってプロンプトが表示されますが、グループ ポリシーによってこれが表示されない場合があり、その場合は、エントリを手動で追加する必要があります。 また、解決する必要があるプロキシの問題が発生している可能性もあります。
リレー *.servicebus.windows.net:443 への送信アクセス。 企業または個人のネットワーク ファイアウォールで、このドメインへの接続が許可されている必要があります。 また、解決する必要があるプロキシの問題が発生している可能性もあります。
Any *.online.visualstudio.com への送信アクセス。 企業または個人のネットワーク ファイアウォールで、このドメインへの接続が許可されている必要があります。 ブラウザーに「https://sts.online.visualstudio.com/api/swagger/index.html」と入力し、Swagger ページが表示されることを確認します。 また、解決する必要があるプロキシの問題が発生している可能性もあります。

ファイアウォール エントリを手動で追加する

上記で説明したように、ダイレクト モードでは、個人用ファイアウォールを使用して vsls-agent でポート範囲 5990 から 5999 の接続を受け入れられるようにする必要があります。 ダイレクト モードを使用するが、ファイアウォールに vsls-agent エントリが存在しないことがわかった場合は、それを手動で追加できます。 これを行う方法はファイアウォール ソフトウェアによって異なりますが、Windows ファイアウォールの構成については、こちらを参照してください。

vsls-agent のエントリが表示されない場合は、次のいずれかの場所にエージェント実行可能ファイルがあります。

VS Code エージェントの場所

次のいずれかのパスで、拡張バージョン番号を VERSION に置き換えます。

  • macOS、Linux

    $HOME/.vscode/extensions/ms-vsliveshare.vsliveshare-VERSION/dotnet_modules/vsls-agent

  • Windows

    %USERPROFILE%\.vscode\extensions\ms-vsliveshare.vsliveshare-VERSION\dotnet_modules\vsls-agent.exe

Visual Studio エージェントの場所

Visual Studio の場所の方が動的ですが、次の手順に従って実行可能ファイルを見つけることができます。

  1. Visual Studio のインストール場所に移動します。 これは、通常、C:\Program Files (x86)\Microsoft Visual Studio\EDITION です。ここで、EDITION は、Community、Enterprise などです

  2. IDE\Extensions サブフォルダーで vsls-agent.exe の検索を実行します。

残念ながら、Visual Studio Live Share を更新するたびにこの手順を実行する必要があります。

プロキシ

現在、Visual Studio Live Share には、プロキシの使用に関していくつの制限があります。 Windows では自動プロキシ設定が機能しますが、macOS または Linux (および Windows 上の特定のプロキシ構成) を使用する場合は、HTTP_PROXY および HTTPS_PROXY 環境変数を "グローバル" に設定する必要があります。

プロキシによって自動的に設定されていない場合は、次の形式で変数を手動で設定できます。

HTTPS_PROXY=http://proxy-ip-address:proxyport

認証プロキシがある場合は、次のようにユーザーとパスワードを追加できます。

HTTPS_PROXY=http://user:password@proxy-ip-address:proxyport

これらの設定でも問題が解決されない場合は、サポートの向上を確認できるよう、プロキシのセットアップの詳細をお知らせください

関連項目

問題が発生していますか? トラブルシューティングまたはフィードバックの送信に関するページをご覧ください。