Live Share 的連線需求

本文摘要說明 Visual Studio Live Share、可用連線選項以及已知因應措施的連線需求(適用時)。

登入

您可以使用任何Azure Active Directory支援的工作或學校帳戶、 Microsoft 帳戶GitHub 設定檔登入 Live Share。 這些帳戶的登入 Url 通常會在大部分的組織中開啟,並提供使用它們的公開產品數目,但如果沒有,請洽詢您的網路系統管理員,以瞭解 login.microsoftonline.com 如何開啟及/或 github.com 加入 login.microsoftonline.com網域。

注意

目前不支援在內部部署 AD (ADFS) 帳戶和內部內部部署 GitHub Enterprise 帳戶 (向上投票 ) 。

連接模式

為了確保最佳效能,預設 Visual Studio Live Share 會自動偵測共同作業工作階段主機機器和來賓電腦是否可以直接透過網路進行通訊,而且如果兩者之間沒有路由,則只會透過雲端轉送。 這種混合的「自動」模式相當有彈性,甚至可讓某些來賓透過雲端轉送,而其他來賓則直接連接至相同的會話。

直接連線是透過以雲端為基礎的機制進行驗證,以確保安全性,但需要在5990和5999之間開啟埠才能啟用連線。 因此,當您第一次共用時,您的桌面防火牆可能會提示您開啟埠。 接受這項功能是選擇性的,因為略過它只會導致 Live Share 在自動模式下一律使用轉送。

Visual Studio Live Share 中的所有連線都是透過 SSH 或 SSL 進行加密,並針對中央服務進行驗證,以確保只有共同作業會話中的連線可以取得其內容的存取權。 此外,Live Share 的雲端轉送不會保存透過該流量路由傳送的任何流量,也不會以任何方式「窺探」流量。

變更連接模式

如果您想要停用直接或轉送連接,或只是針對連線問題進行疑難排解,您可以強制執行其他連接模式。

[模式] 主機行為 來賓行為
自動 主機的共同作業會話會接受安全、已驗證的直接連線或雲端轉送連接。 嘗試使用直接連線,並在發生失敗時,透過雲端切換回轉送。
直接 主機的共同作業會話只接受已驗證的安全直接連接。 嘗試使用直接連接,並在無法連接時停止。
轉送 主機的共同作業會話不允許直接連接。 主機的電腦上未開啟任何埠。 一律透過雲端連接。

若要變更模式:

與:

  1. 移至 [工具 > 選項] > Live Share。
  2. 從 [連接模式] 下拉式清單中選取模式。
  3. 重新開機與

VS Code:

  1. 編輯設定. json (檔案 > 喜好設定 > 設定) 。
  2. 設定 "liveshare.connectionMode""auto""direct" 或, "relay" 取決於您的喜好設定。
  3. 重新開機 VS Code。

連接模式的需求

您所使用的連線模式將會指定必須可供 Live Share 運作的特定埠和 url。

[模式] 用戶端存取需求 疑難排解
任意 輸出存取 *.liveshare.vsengsaas.visualstudio.com:443 確定您的公司或個人網路防火牆可讓您連接到此網域。 https://insiders.liveshare.vsengsaas.visualstudio.com在瀏覽器中輸入,並確認您居住在 Visual Studio Live Share 首頁。 您也可能遇到需要解決的 proxy 問題
任何 (VS Code) 輸出存取 download.microsoft.com:443 確定您的公司或個人網路防火牆可讓您連接到此網域。 您也可能遇到需要解決的 proxy 問題
自動 自動切換。 請參閱 direct 和轉送模式。 切換至 direct 或轉送模式以進行疑難排解。
直接 主機:必須開啟範圍為 5990-5999 的埠,才能接受輸入的區域網路連線。

來賓:對此相同埠上的主機進行網路路由和輸出存取。
確認您的桌面防火牆軟體未封鎖此埠範圍的「vsls 代理程式」,且您可以 ping 另一個。 雖然 Windows 和其他桌面軟體應該會在代理程式第一次啟動時提示您,但我們已看到群組原則防止這種情況發生的情況,因此您將需要手動新增專案。 您也可能遇到需要解決的 proxy 問題
轉送 的輸出存取 *.servicebus.windows.net:443 確定您的公司或個人網路防火牆可讓您連接到此網域。 您也可能遇到需要解決的 proxy 問題
任意 的輸出存取 *.online.visualstudio.com 確定您的公司或個人網路防火牆可讓您連接到此網域。 https://sts.online.visualstudio.com/api/swagger/index.html在瀏覽器中輸入,並確認您居住在 swagger 頁面上。 您也可能遇到需要解決的 proxy 問題

手動新增防火牆專案

如上所述,直接模式要求您的個人防火牆允許 vsls 代理程式 接受埠範圍5990-5999 中的連接。 如果您想要使用直接模式,但發現您的防火牆沒有 vsls 代理程式專案,您可以手動新增它。 這樣做的方式會因防火牆軟體而異,但您可以在這裡找到設定Windows 防火牆的相關資訊。

如果您沒有看到 vsls 代理程式的專案,您可以在下列其中一個位置找到代理程式可執行檔。

VS Code 代理程式位置

以下列其中一個路徑中的延伸模組版本號碼取代 版本

  • 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\EDITIONC:\Program Files (x86)\Microsoft Visual Studio\EDITIONCommunity、Enterprise 等等

  2. vsls-agent.exe [ vsls-agent.exe ] 子資料夾下執行搜尋。

可惜的是,您可能需要在每次更新 Visual Studio Live Share 時執行此步驟。

Proxy

Visual Studio Live Share 目前在 proxy 使用方面有一些限制。 雖然自動 proxy 設定應該適用于 Windows,但在使用 macOS 或 Linux (,以及 Windows) 的特定 proxy 設定時,必須全域設定HTTP_PROXYHTTPS_PROXY環境變數。

如果您的 proxy 不會自動為您設定這些變數,您可以手動設定下列格式的變數:

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

如果您有驗證 proxy,您可以新增使用者和密碼,如下所示:

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

如果這些設定無法為您解決問題, 請讓我們知道 您 proxy 設定的詳細資訊,讓我們看看如何改進支援。

另請參閱

有問題嗎? 請參閱疑難排解提供意見反應