Требования к подключению для Live Share

В этой статье приведены общие сведения о требованиях к подключению для Visual Studio Live Share, доступных вариантах подключения и известных обходных решениях при необходимости.

Вход

Вы можете войти в Live Share с помощью любой рабочей или учебной учетной записи Azure Active Directory , учетной записи Майкрософт или профиля GitHub. Как правило, URL-адреса входа для них открыты в большинстве организаций, учитывая количество общедоступных продуктов, которые используют их, но если нет, обратитесь к администратору сети о открытии login.microsoftonline.com и/или github.com в дополнение к доменам , перечисленным ниже.

Примечание.

Локальные учетные записи AD (ADFS) и учетные записи GitHub Enterprise не поддерживаются (в настоящее время не поддерживаются (up-vote 👍).

Режимы подключения

Чтобы обеспечить оптимальную производительность, по умолчанию Visual Studio Live Share автоматически определяет, может ли компьютер узла сеанса совместной работы и гостевой компьютер взаимодействовать непосредственно через сеть и только ретрансляторы через облако, если между ними нет маршрута. Этот смешанный "автоматический" режим гибкий, и даже позволяет некоторым гостям ретрансляции через облако, а другие подключаются непосредственно к одному сеансу.

Прямые подключения проходят проверку подлинности через облачный механизм, чтобы обеспечить безопасность, но для включения подключения необходимо открыть порт от 5990 до 5999. В результате при первом предоставлении общего доступа к брандмауэру рабочего стола может потребоваться открыть порт. Принятие этого является необязательным, так как игнорировать его просто приведет к тому, что Live Share всегда будет использовать ретранслятор при автоматическом режиме.

Все подключения в Visual Studio Live Share — это протокол SSH или SSL, зашифрованные и прошедшие проверку подлинности в центральной службе, чтобы гарантировать, что только те, кто находится в сеансе совместной работы, могут получить доступ к его содержимому. Кроме того, облачное ретранслятор Live Share не сохраняет трафик, перенаправленный через него, и не «слежка» трафика каким-либо образом.

Изменение режима подключения

Если вы предпочитаете отключить прямые или ретрансляционные подключения или просто устранять проблемы с подключением, вы можете принудительно применить другие режимы подключения.

Режим Поведение узла Поведение гостя
Авто Сеанс совместной работы узла принимает защищенные, прошедшие проверку подлинности прямые подключения или облачные ретрансляционные подключения. Пытается использовать прямое подключение и возвращается к ретрансляции через облако, если это не удается.
Напрямую Сеанс совместной работы узла принимает только прошедшие проверку подлинности, безопасные прямые подключения. Пытается использовать прямое подключение и останавливается, если он не может подключиться.
Ретрансляция Сеанс совместной работы узла не разрешает прямые подключения. На компьютере узла не открывается порт. Всегда подключается через облако.

Чтобы изменить режим:

VS:

  1. Перейдите в раздел " > Параметры > live Share".
  2. Выберите режим в раскрывающемся списке "Режим Подключение ion".
  3. Перезапустите VS.

VS Code:

  1. Изменение settings.json (параметры > файла > Параметры).
  2. "auto"Задайте значение "liveshare.connectionMode" , "direct"или "relay" в зависимости от вашего предпочтения.
  3. Перезапустите VSCode.

Требования к режимам подключения

Режим подключения, в который вы находитесь, будет диктовать определенные порты и URL-адреса, которые должны быть доступны для работы Live Share.

Режим Требование к клиентскому доступу Устранение неполадок
Любое Исходящий доступ к *.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" (для VS), "code" (для Visual Studio Code) или "code - insiders" (для программы предварительной оценки Visual Studio Code) не блокируется программным обеспечением брандмауэра для этого диапазона портов и что можно проверить связь друг с другом. Хотя windows и другое классическое программное обеспечение должны запрашивать вас при первом запуске агента, мы видели экземпляры, в которых групповые политики не позволяют это происходит, и вам потребуется вручную добавить запись. Вы также можете столкнуться с проблемами прокси-сервера, которые необходимо устранить.
Ретрансляция Исходящий доступ к *.servicebus.windows.net:443. Убедитесь, что корпоративный или личный брандмауэр сети позволяет подключаться к этому домену. Вы также можете столкнуться с проблемами прокси-сервера, которые необходимо устранить.
Любое Исходящий доступ к *.online.visualstudio.com. Убедитесь, что корпоративный или личный брандмауэр сети позволяет подключаться к этому домену. Введите https://sts.online.visualstudio.com/api/swagger/index.html в браузере и убедитесь, что вы приземлились на странице swagger. Вы также можете столкнуться с проблемами прокси-сервера, которые необходимо устранить.

Добавление записи брандмауэра вручную

Как описано выше, прямой режим требует, чтобы личный брандмауэр разрешал vsls-agent, код или код — инсайдерские пользователи принимать подключения в диапазоне портов 5990-5999. Если вы хотите использовать прямой режим, но обнаружили, что брандмауэр не имеет записи vsls-agent, его можно добавить вручную. Как это будет зависеть от программного обеспечения брандмауэра, но здесь можно найти сведения о настройке брандмауэра Windows.

Если запись для vsls-agent отсутствует, можно найти исполняемый файл агента в одном из следующих расположений.

Расположение установки VS Code

При настройке брандмауэра вручную для VS Code или программы предварительной оценки VS Code в Windows, MacOS или Linux используйте путь к расположению установки приложения VS Code.

Ex: 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\EDITION место, где EDITION — Community, Enterprise и т. д.

  2. Выполните поиск vsls-agent.exe в под папке IDE\Extensions .

К сожалению, этот шаг может потребоваться каждый раз, когда вы обновляете Visual Studio Live Share.

Прокси

Visual Studio Live Share в настоящее время имеет некоторые ограничения для использования прокси-сервера. Хотя автоматические параметры прокси-сервера должны работать в Windows, при использовании macOS или Linux (и с определенными конфигурациями прокси-сервера в Windows)HTTP_PROXY и HTTPS_PROXY переменных среды необходимо задать глобально для VS или в параметрах прокси приложения > для VS Code.

Примечание. Если прокси-сервер не настроен в параметрах прокси приложения > VS Code, он также будет унаследован от переменных среды http_proxy и https_proxy среды.

Если прокси-сервер не настраивает их автоматически, можно вручную задать переменные в следующей форме:

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

Если у вас есть прокси-сервер проверки подлинности, вы можете добавить пользователя и пароль следующим образом:

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

Если эти параметры не устраняют проблему, сообщите нам о специфике настройки прокси-сервера, чтобы мы могли ознакомиться с улучшением поддержки.

См. также

Возникли проблемы? Ознакомьтесь с разделом по устранению неполадок или отправьте отзыв.