Live Share 的連線需求
本文摘要說明 Visual Studio Live Share 的連線需求、可用的連線選項,以及適用的已知因應措施。
登入
您可以使用任何 Azure Active Directory 支援的工作或學校帳戶、 Microsoft 帳戶或 GitHub 配置檔登入 Live Share。 在大部分組織中,通常會針對使用這些 URL 的公開產品數目開啟,但若非如此,請連絡您的網路管理員,了解開啟login.microsoftonline.com
和/或github.com
下列網域。
連線 ion 模式
為了確保最佳效能,根據預設,Visual Studio Live Share 會自動偵測共同作業會話主計算機和客體計算機是否可以透過網路直接通訊,而且如果兩者之間沒有路由,則只能透過雲端轉送。 這種混合的「自動」模式具有彈性,甚至允許某些來賓透過雲端轉接,而其他來賓則直接連線到相同的會話。
直接聯機會透過雲端式機制進行驗證,以確保安全性,但需要開啟介於 5990 到 5999 之間的埠,才能啟用連線。 因此,第一次共用桌面防火牆時,可能會提示您開啟埠。 接受這是選擇性的,因為忽略它只會造成 Live Share 在自動模式時一律使用轉播。
Visual Studio Live Share 中的所有連線都會透過 SSH 或 SSL 加密,並針對中央服務進行驗證,以確保只有共同作業會話中的連線可以存取其內容。 此外,Live Share 的雲端轉送不會保存透過其路由傳送的任何流量,也不會以任何方式「窺探」流量。
變更連線模式
如果您想要停用直接或轉接連線,或只是針對連線問題進行疑難解答,您可以強制其他連線模式。
[模式] | 主機行為 | 來賓行為 |
---|---|---|
自動 | 主機的共同作業會話接受安全、已驗證的直接連線或雲端轉接連線。 | 嘗試使用直接連線,並在失敗時回復為透過雲端轉送。 |
直接 | 主機的共同作業會話只接受已驗證且安全的直接連線。 | 嘗試使用直接連線,並在無法連線時停止。 |
轉送 | 主機的共同作業會話不允許直接連線。 主機的電腦上未開啟任何埠。 | 一律透過雲端連線。 |
若要變更模式:
與:
- 移至 [工具選項>>實時共用]。
- 從 [連線 模式] 下拉式清單中選取模式。
- 重新啟動 VS。
VS Code:
- 編輯 settings.json (檔案>喜好>設定 設定)。
- 依您的喜好設定, 會設定
"liveshare.connectionMode"
為"auto"
、"direct"
或"relay"
。 - 重新啟動 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 問題 。 |
自動 | 自動切換。 請參閱直接和轉接模式。 | 切換至直接或轉接模式以進行疑難解答。 |
直接 | 主機:必須開啟範圍 5990 - 5999 的埠,才能接受輸入局域網路連線。 來賓:此相同埠上主機的網路路由和輸出存取權。 |
確認 「vsls-agent」(適用於 VS)、「程式代碼」(適用於 Visual Studio Code)或「程式代碼 - 測試人員」(適用於 Visual Studio Code Insiders)未封鎖桌面防火牆軟體用於此埠範圍,而且您可以互相偵測。 雖然 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 Code 或 VS Code 測試人員 防火牆時,請使用 VS Code 應用程式安裝位置的路徑。
例如: Windows(預設安裝位置)
%applocaldata%\Programs\Microsoft VS Code\code.exe
%applocaldata%\Programs\Microsoft VS Code Insiders\code - insiders.exe
Visual Studio 代理程式位置
Visual Studio 位置較動態,但您可以遵循下列步驟來尋找可執行檔:
流覽至您的 Visual Studio 安裝位置。 這通常是
C:\Program Files (x86)\Microsoft Visual Studio\EDITION
EDITION 是 Community、Enterprise 等在 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 設定的詳細數據,讓我們看看改善支援。