Live Share 的連線需求

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

登入

您可以使用任何 Azure Active Directory 支援的工作或學校帳戶、 Microsoft 帳戶GitHub 設定檔來登入 Live Share。 這些的登入 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 的雲端轉送不會保存透過其路由傳送的任何流量,也不會以任何方式「探查」流量。

更改连接模式

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

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

若要變更模式:

與:

  1. 移至 [工具選項 >> 即時共用]。
  2. 從 [連線模式] 下拉式清單中選取模式。
  3. 重新開機 VS.

VS Code:

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

連線模式的需求

您位於的連線模式會指定需要供 Live Share 運作的特定埠和 URL。

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

來賓:此相同埠上主機的網路路由和輸出存取權。
確認 VS) 、「程式碼」 (Visual Studio Code) 或「程式碼 - 測試人員」 (Visual Studio Code測試人員) 的「vsls-agent」 (並未受到此埠範圍的桌面防火牆軟體封鎖,而且您可以彼此偵測。 雖然 Windows 和其他桌面軟體應該在第一次啟動代理程式時提示您,但我們看到群組原則防止發生此情況的實例,而您必須 手動新增專案。 您可能也會發生需要解決的 Proxy 問題
轉送 對 的 *.servicebus.windows.net:443 輸出存取。 請確定您的公司或個人網路防火牆可讓您連線到此網域。 您可能也會發生需要解決的 Proxy 問題
任意 對 的 *.online.visualstudio.com 輸出存取。 請確定您的公司或個人網路防火牆可讓您連線到此網域。 在瀏覽器中輸入 https://sts.online.visualstudio.com/api/swagger/index.html ,並確認您進入 swagger 頁面。 您可能也會發生需要解決的 Proxy 問題

手動新增防火牆專案

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

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

VS Code 安裝位置

在 Windows、MacOS 或 Linux 上手動設定 VS CodeVS Code 測試人員 防火牆時,請使用 VS Code 應用程式安裝位置的路徑。

例如: Windows (預設安裝位置)

  • %applocaldata%\Programs\Microsoft VS Code\code.exe
  • %applocaldata%\Programs\Microsoft VS Code Insiders\code - insiders.exe

Visual Studio 代理程式位置

Visual Studio 位置較動態,但您可以遵循下列步驟來尋找可執行檔:

  1. 流覽至您的 Visual Studio 安裝位置。 這通常是 C:\Program Files (x86)\Microsoft Visual Studio\EDITIONEDITION 是 Community、Enterprise 等

  2. IDE\Extensions子資料夾下執行 vsls-agent.exe 搜尋。

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

Proxy

Visual Studio Live Share目前對 Proxy 使用有一些限制。 雖然自動 Proxy 設定應該可在) Windows 上運作,但使用 macOS 或 Linux (以及 Windows 上的特定 Proxy 組態時,HTTP_PROXY和HTTPS_PROXY環境變數必須在 VS Code的應用程式 > Proxy設定中設定全域

注意:如果未在 VS Code 的應用程式 > Proxy 設定中設定 Proxy,則也會繼承自HTTP_proxy和HTTPs_proxy環境變數。

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

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

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

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

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

另請參閱

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