Skip to main content
Skip to content

Настройка локальных настроек песочницы

Настройте локальную песочницу в GitHub Copilot app файловой системе или Copilot CLI ограничить доступ к файловой системе, сетевое подключение и использование учетных данных.

О локальной конфигурации песочницы

Параметры в GitHub Copilot app команде /sandboxCopilot CLI косой черты можно использовать для предоставления дополнительных путей, настройки сетевого доступа или включения или отключения песочницы.

Локальная песочница ограничивает доступ к файлам, сетевым ресурсам и учетным данным на компьютере, что снижает потенциальное влияние непреднамеренных команд. Параметры настраиваются отдельно в Copilot app и Copilot CLI. Изменение их в одном не изменяет их в другом.

Примечание.

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

Общие сведения об облачных и локальных песочницах Copilotсм. в разделе Сведения об облачных и локальных песочницах для GitHub Copilot. Подробные инструкции по использованию локальной песочницы см. в разделе Использование локальной песочницы.

Prerequisites

  • Windows. Для локальной песочницы в Windows требуется Windows 11 версии 25H2 с обновлением KB5124010 или более поздней или Windows 11 версии 26H1 с обновлением KB5124006 или более поздней версии с поддержкой уровня BaseContainer серверной части ProcessContainer.
  • Linux: Bubblewrap (bwrap) версии 0.5.0 или более поздней версии и slirp4netns должен быть установлен и доступен в path.

Настройка Copilot app

Вы настраиваете локальную песочницу отдельно для каждого проекта в .GitHub Copilot app Конфигурация применяется к локальному репозиторию и рабочим сеансам дерева. Он не применяется к сеансам или сеансам облачной песочницы, которые выполняются на удаленном узле.

Рабочее дерево сохраняет ветви и файлы для параллельных сеансов отдельно, но не ограничивает доступ к команде в другом месте компьютера. Локальная песочница обеспечивает дополнительную защиту.

Включение локальной песочницы для проекта

Локальная песочница отключена по умолчанию, если не требуются корпоративные управляемые параметры. Параметры песочницы недоступны для удаленных проектов. Чтобы включить песочницу для новых локальных сеансов в проекте:

  1. На боковой панели приложения откройте параметры.
  2. В разделе "Проекты" выберите проект, который требуется настроить.
  3. В разделе " Песочница" включите новые сеансы песочницы.

Этот параметр применяется к новым сеансам в проекте. Он не изменяет сеанс, который уже запущен. Дополнительные сведения о включении локальной песочницы для текущего сеанса см. в разделе Использование локальной песочницы.

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

Настройка политики песочницы для проекта

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

В разделе "Сводка по настроенной политике" отображаются выбранные папки, сети и параметры учетных данных. Он не подтверждает, что песочница запущена или отображает все ограничения, которые применяются. Изменения сохраняются автоматически.

В параметрах проекта можно настроить следующее:

  • Доступ к файловой системе: предоставление дополнительного доступа только для чтения или чтения или записи к определенным путям или запрету путей.
  • Сетевой доступ: разрешить или заблокировать исходящий интернет и локальный сетевой доступ.
  • Учетные данные. Выберите, доступны ли Git и GitHub CLI учетные данные в песочнице.

Настройка доступа к файловой системе

По умолчанию изолированный сеанс имеет доступ на чтение и запись к рабочей области и текущему рабочему каталогу. Вы можете предоставить доступ к дополнительным папкам или запретить доступ к определенным папкам.

В разделе "Песочница" параметров проекта настройте любой из следующих списков:

  • Дополнительные операции чтения и записи: папки, которые средства запуска агента могут читать и изменять.
  • Дополнительные доступные только для чтения: папки, которые средства запуска агента могут читать, но не изменять.
  • Запрещено: папки, к которым не могут получить доступ средства запуска агента.

Чтобы добавить папку, нажмите кнопку "Добавить папку " для соответствующего списка, а затем выберите ее. Чтобы удалить папку, щелкните значок удаления рядом с его путем.

Более конкретная папка отрицается, если более широкая родительская папка имеет доступ на чтение или запись.

В Windows можно сохранить запрещенный путь в параметрах проекта. Если активные Windows возможности песочницы не могут гарантировать отказ, сбой изолированной команды с сообщением о неподдерживаемой политике. Команда не выполняется с запрещенным путем, доступным или без песочницы.

Настройка сетевого доступа

По умолчанию оба параметра сети включены в приложение. В разделе "Песочница" параметров проекта можно изменить следующие параметры:

  • Исходящий интернет: разрешить подключения к интернет-службам, таким как GitHub и реестры пакетов.
  • Локальная сеть: разрешение подключений к циклу и локальных сетевых подключений, включая подключения к локальным серверам разработки.

Ограничения сети могут повлиять на установку пакетов, вызовы API, предварительные версии серверов и другие средства, требующие сетевого подключения.

В Linux изолированные процессы не могут подключаться непосредственно к серверам на локальном узле компьютера. Параметр локальной сети по-прежнему управляет запросами через встроенный локальный прокси-сервер, а также операции внутри процесса, такие как веб-запросы и удаленные подключения MCP.

Ограничения операционной системы, описанные в разделе "Настройка параметров сети ", также применяются к приложению. В отличие от параметра локальной сети приложения, параметр командной строки "Разрешить локальную сеть " отключен по умолчанию.

Настройка учетных данных

По умолчанию в песочнице доступны прошедшие проверку подлинности Git и GitHub CLI операции. Вы можете отключить любой из следующих параметров:

  • Учетные данные Git: разрешены операции httpS Git, прошедшие проверку подлинности.
  • GitHub CLI учетные данные: разрешить GitHub CLI (ghа не copilot) проходить проверку подлинности.

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

Применение изменений политики

Изменения параметров файловой системы, сети и учетных данных применяются к новым сеансам или при перезапуске существующего сеанса. Они не изменяют политику текущего сеанса.

Чтобы перезапустить сеанс при сохранении журнала, введите следующее:

/restart-session

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

Если приложение отображает песочницу недоступно, обратитесь к сообщаемой проблеме, а затем нажмите кнопку "Повторить песочницу".

Настройка Copilot CLI

Используйте команду косой черты, чтобы настроить локальную /sandbox песочницу в интерфейсе командной строки. Управляемый параметр помечен (managed) в интерфейсе /sandbox и не может быть изменен.

Открытие конфигурации песочницы

  1. Начните Copilot CLI сессию.

  2. Введите слэш-команду /sandbox.

    Откроется интерактивный интерфейс конфигурации с четырьмя вкладками: общие, учетные данные, файловая система и сеть. Используйте Tab для переключения между вкладками. Нажмите Esc , чтобы сохранить изменения и закрыть конфигурацию. Если вы находитесь в пути, правиле узла или списке с маской переменных, нажмите клавишу ESC сначала, чтобы вернуться на ее вкладку.

Настройка общих настроек

Вкладка General управляет поведением песочницы верхнего уровня. Если корпоративные управляемые параметры применяют значение, диалоговое окно помечает параметр как (managed) и не позволяет изменять его.

SettingDescription
Включение песочницыВыполните команды оболочки внутри песочницы. Вы также можете переключать это с помощью /sandbox enable и /sandbox disable.
Разрешить обход песочницыПозвольте модели запрашивать отдельные команды, выполняемые вне песочницы, при условии утверждения. Запрос обхода также позволяет отключить песочницу для остальной части текущего сеанса. Включен по умолчанию. Дополнительные сведения см. в разделе "Разрешение обхода песочницы".
Изолированные серверы MCPЗапустите серверы MCP в песочнице. Включен по умолчанию.
Изолированные серверы LSPЗапустите языковые серверы (серверы LSP) в песочнице. Включен по умолчанию.

Разрешение обхода песочницы

Параметр обхода песочницы определяет, может ли Copilot запрашивать разрешение на повторную команду с более широким доступом.

  • В (по умолчанию): для поддерживаемых отказов в песочнице интерфейс командной строки предлагает запрос утверждения, описывающий команду и предложенную попытку. Утверждение применяется к этой попытке. Вы также можете отключить песочницу для остальной части сеанса, если ваше предприятие разрешает его или дать Copilot другую инструкцию.
  • Выкл. Команда остается заблокированной. Вы можете настроить параметры, которые вы управляете или попросите Copilot использовать другой подход.

Обход удаляет Copilotтолько собственные ограничения песочницы, а не операционную систему. Команда по-прежнему выполняется в обычной учетной записи, поэтому она не получает права администратора или корневого доступа и не может получить доступ к системе.

На поддерживаемых узлах Windows утвержденные повторные попытки могут сначала смягчить ограничения файлов и процессов при сохранении ограничений сети. Результатом его является "песочница расслабленная". Если команда по-прежнему заблокирована, интерфейс командной строки может использовать полный обход, описанный в той же строке утверждения. Этот результат помечен как "песочница обошла".

Если для управляемых параметров предприятия задано sandbox.allowBypass``falseзначение, вы не можете утвердить отдельные команды для выполнения за пределами песочницы или отключить песочницу для остальной части сеанса. Если для управляемых параметров требуется песочница, но эффективная политика разрешает обход, вы не можете отключить песочницу с помощью обычных параметров, но ее можно отключить для остальной части текущего сеанса ( либо из запроса на активное обходное разрешение или путем запуска /sandbox disableбез отключения сохраненной политики).

Настройка параметров проверки подлинности

Вкладка "Учетные данные" управляет проверкой подлинности для Git и GitHub CLIпозволяет настроить маскированные переменные среды. Изолированные процессы получают значения заполнителей. Локальный прокси-сервер предоставляет реальные учетные данные только в заголовках запросов HTTPS, отправленных в утвержденные назначения. Как и на других вкладках, значение, управляемое предприятием, отображается как (managed) и не может быть изменено.

SettingDescription
Проверка подлинности GitРазрешить прошедшие проверку подлинности операции HTTPS Git с учетными данными заполнителя без вспомогательной функции учетных данных в песочнице. Прокси-сервер предоставляет реальные учетные данные только в исходном узле, порту и пути репозитория. Включен по умолчанию.
Проверка подлинности ghПредоставьте заполнитель GH_TOKENGitHub CLI так (ghне copilot) может пройти проверку подлинности без доступа к сохраненным учетным данным. Прокси-сервер предоставляет реальный маркер только github.comдля , api.github.comи uploads.github.com. Включен по умолчанию.
Маскированные переменные средыВыберите дополнительные переменные среды, чтобы заменить заполнителями, и узлы HTTPS, которые могут получать свои реальные значения.

В macOS доступ к цепочке ключей отключен по умолчанию. Чтобы разрешить изолированным командам использовать цепочку ключей системы, установите значение sandbox.userPolicy.seatbelt.keychainAccess``true в личном settings.json файле. Этот параметр недоступен или /sandbox``/settingsнедоступен.

Маскирование переменных среды

Используйте маскированные переменные среды, чтобы позволить изолированным средствам проходить проверку подлинности в API без получения реального маркера. Маскирование применяется к выбранным переменным в командах, локальных серверах MCP и языковых серверах, работающих в песочнице. Git и gh аутентификация используют маскирование автоматически при включении параметров проверки подлинности. Для них не нужно добавлять записи.

Перед настройкой маскирования задайте переменную среды в среде, используемой для запуска Copilot CLI. Значение должно быть пустым. Отсутствующие переменные остаются отсутствующими, а пустые значения не маскируются.

Маскирование активно только во время включения локальной песочницы. Добавление маскированных переменных не включает песочницу.

  1. Введите /sandbox enable , чтобы включить локальную песочницу.
  2. Введите /sandbox status и убедитесь, что песочница включена для текущего сеанса перед продолжением.
  3. Введите /sandbox, а затем откройте вкладку "Учетные данные ".
  4. Выберите переменные среды с маской и нажмите клавишу ВВОД.
  5. Нажмите клавишу A , чтобы добавить запись.
  6. В переменной введите имя переменной, например EXAMPLE_API_TOKEN, нажмите клавишу ВВОД. Не введите значение секрета.
  7. В поле "Внедрение узлов" введите разделенный запятыми список узлов, которые могут получить реальное значение, например api.example.com, а затем нажмите клавишу ВВОД. Используйте имена узлов или поддомены подстановочных знаков, *.example.comнапример. Не включать схему URL-адресов, путь, порт или голую.*
  8. Нажмите клавишу ESC , чтобы вернуться на вкладку "Учетные данные ".
  9. В Windows для маскирования учетных данных требуется версия Windows, поддерживающая локальный прокси-сервер песочницы. Перейдите на вкладку "Сеть " и включите локальную сеть. Это также позволяет получить доступ к частной сети с учетом настроенных ограничений узла.
  10. Нажмите клавишу ESC , чтобы сохранить и закрыть конфигурацию.

Чтобы изменить запись, выберите ее и нажмите клавишу ВВОД. Чтобы удалить его, нажмите клавишу X. Редактор сохраняет только имена переменных и узлы назначения. Он не считывает или не отображает значения секретов.

Вы также можете настроить записи sandbox.credentials.envVars в личном settings.json файле. Например, эта запись позволяет прокси-серверу предоставлять EXAMPLE_API_TOKEN только api.example.comследующие значения:

{
  "sandbox": {
    "enabled": true,
    "credentials": {
      "envVars": {
        "EXAMPLE_API_TOKEN": {
          "injectHosts": ["api.example.com"]
        }
      }
    }
  }
}

Добавление узла внедрения не разрешает сетевой доступ к нему. Параметры сети также должны разрешать подключение. Точные имена узлов совпадают только с этим узлом. *.example.com соответствует поддоменам, но не example.com самому себе.

Маскирование требует, чтобы переменная оставалась в среде дочернего процесса. Не перечисляйте переменную, в --secret-env-varsкоторой вы хотите маскироваться. Этот параметр удаляет именованные переменные из сред команд и серверов MCP вместо того, чтобы сделать их доступными в качестве заполнителей.

Настройка настроек файловой системы

Вкладка «Файловая система» управляет, к каким каталогам и файлам может получить доступ песочница-процесс.

По умолчанию Copilot предоставляется разрешение на чтение и запись для всего в текущем рабочем каталоге и ниже. Если вы находитесь в репозитории Git, Copilot также предоставляется:

  • Разрешение на чтение и запись для всех элементов в каталоге репозитория .git и ниже.
  • Разрешение на чтение для всего остального в репозитории над текущим рабочим каталогом. Рабочий каталог остается чтением и записью, так как более конкретный грант выигрывает, где два перекрываются.
SettingDescription
Включить рабочий каталогВключен по умолчанию. Текущий рабочий каталог (и каталог включающего репозитория .git , если таковой есть) автоматически добавляется в список путей чтения и записи. Отмените выбор этого параметра, если вы не хотите, чтобы рабочий каталог был предоставлен автоматически для чтения и записи, а затем вручную разрешить доступ к определенным путям.
Разрешить доступ к средству разработкиВключен по умолчанию. Предоставляет изолированным командам доступ на чтение к конфигурации и кэшам средств разработчика, включая реестры диспетчера пакетов и маркеры, которые они хранят, и доступ на чтение и запись к общим кэшам сборки, поэтому установки и сборки работают внутри песочницы. Это отображается как доступ к средству разработки в отчете /sandbox policy . Отключите его, чтобы эти расположения были предоставлены явным образом.

Внимание

Отмена выбора " Включить рабочий каталог " удаляет доступ ко всему в каталоге .git репозитория Git и ниже. В результате операции Git, такие как status, add``commitи diff завершаются ошибкой, если вы вручную не добавите доступ к этому каталогу.

Добавление правил пути файловой системы

Можно указать пути, которые нужно добавить в песочницу. Это позволяет предоставлять доступ только для чтения или чтения или записи каталогам и файлам за пределами рабочего каталога. Вы также можете запретить доступ, исключить каталоги и файлы из песочницы.

  1. На вкладке "Файловая система " выберите пути, настроенные пользователем , и нажмите клавишу ВВОД.

  2. Нажмите клавишу A , чтобы добавить новое правило пути.

  3. Введите путь к файлу или каталогу. Используйте абсолютный путь, /Users/octocat/projects/app например в macOS или Linux или C:\Users\octocat\projects\app на Windows. Нажмите клавишу ВВОД.

    Примечание.

    Добавление каталога включает в себя всю поддеревку. Подстановочные знаки не поддерживаются.

  4. Используйте клавиши со стрелками влево и вправо на клавиатуре, чтобы перейти между параметрами разрешений: чтение и запись, только для чтения, отказано. Затем нажмите клавишу ВВОД , чтобы выбрать параметр.

Если путь является символьной ссылкой, при выборе параметра "Только для чтения", "Только для чтения" или " Только для чтения " добавляется текущий целевой объект, когда интерфейс командной строки может разрешить его. Это не позволяет автоматически предоставлять доступ к целевым объектам других ссылок в разрешенном каталоге.

После добавления путей файловой системы их можно изменить или удалить.

  1. Чтобы выбрать путь, используйте клавиши со стрелками вверх и вниз.
  2. Нажмите клавишу ВВОД , чтобы изменить путь или X , чтобы удалить его.
  3. Нажмите клавишу ESC , чтобы вернуться на вкладку Файловой системы . Нажмите клавишу ESC еще раз, чтобы сохранить и закрыть конфигурацию.

В Windows путь отказано в версии, поддерживающей это ограничение. Если узел не может применить их, команда завершается ошибкой с объяснением, а не с более слабой защитой.

Настройка параметров сети

Вкладка «Сеть» управляет, могут ли песочницы процессы устанавливать сетевые соединения.

SettingDescription
Разрешить исходящие соединенияВключен по умолчанию. Разрешает исходящие подключения к Интернету при условии любых правил узла. Отключение также делает параметры прокси-сервера и правила узла неактивными.
Разрешить локальную сетьОтключен по умолчанию. Управляет локальным доступом, например подключения к серверу разработки на компьютере. Его влияние зависит от операционной системы, как описано ниже.
Правила узлаРазрешить или запретить подключения к определенным узлам. См. раздел "Разрешение или блокировка определенных узлов".
Удаленный прокси-серверМаршрутизация исходящего трафика песочницы через прокси-сервер HTTP. См. сведения о маршрутизации трафика через прокси-сервер HTTP.

Доступ к локальной сети работает по-разному в каждой операционной системе:

Операционная системаВлияние на изолированные команды
macOSПри исходящем доступе и отсутствии прокси-сервера, правил узла или маскирования учетных данных включите локальный доступ, чтобы разрешить команде подключаться к локальному серверу разработки. Если он не блокирует подключения localhost, включая сервер, команда запускается самостоятельно. Отключение исходящего доступа также блокирует эти подключения.
LinuxИзолированные команды используют собственное частное сетевое пространство. Они могут подключаться к серверам, запущенным там, но не могут подключаться непосредственно к серверам на локальном узле компьютера. Если локальный доступ включен, а удаленный прокси-сервер не настроен, запросы через встроенный локальный прокси-сервер могут получить доступ к локальному узлу компьютера в соответствии с правилами узла.
WindowsВключение локального доступа к разрешениям доступа к частной сети. Для подключений к локальному хосту узла также требуется Windows версия, которая поддерживает их. Для прокси-сервера и правил узла требуется включить этот параметр.

Этот параметр также применяется к встроенным веб-запросам ИНТЕРФЕЙСА командной строки на каждой платформе. Если серверы ПЕСОчницы MCP включены, он также применяется к удаленным подключениям MCP. Разрешение локального доступа позволяет встроенному web_fetch инструменту достичь localhost, но не удаляет отдельные ограничения на другие частные сетевые адреса.

Маскирование учетных данных использует локальный прокси-сервер, даже если вы не настроили правила удаленного прокси-сервера или узла. Это включает автоматическую маскировку для Git и gh проверки подлинности, которая включена по умолчанию и маскированные переменные среды.

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

Разрешение или блокировка определенных узлов

Используйте правила узла, чтобы ограничить доступ к изолированным командам назначения. Правила узла активны только при включении песочницы и исходящих подключений.

Можно указать имена узлов, поддомен поддомена подстановочных знаков или отдельные адреса IPv4 или IPv6. Диапазоны IP-адресов в нотации CIDR, например 203.0.113.0/24, не поддерживаются.

  1. На вкладке "Сеть" выберите прокси-сервер и нажмите клавишу ВВОД. Затем выберите правила узла и нажмите клавишу ВВОД.
  2. Нажмите клавишу, чтобы добавить правило.
  3. Введите имя узла, шаблон поддомена поддомена подкардии или отдельный IP-адрес. Например, используйте example.com, *.example.com``203.0.113.10или 2001:db8::10. Не включать схему URL-адреса, путь или порт. Нажмите Enter.
  4. Используйте клавиши со стрелками влево и вправо, чтобы выбрать "Разрешить " или " Запретить", а затем нажмите клавишу ВВОД , чтобы добавить правило в список. Новые правила по умолчанию — "Запретить".
  5. Нажмите клавишу ESC , чтобы вернуться к прокси-серверу и блокировать, а затем снова нажмите клавишу ESC , чтобы вернуться на вкладку "Сеть ". Нажмите клавишу ESC еще раз, чтобы сохранить изменения и закрыть конфигурацию.

Чтобы изменить правило, выберите его и нажмите клавишу ВВОД. Чтобы удалить его, нажмите клавишу X. Правила, помеченные (managed) как не могут быть изменены или удалены. Изменения сохраняются при закрытии конфигурации.

При выборе правил помните следующее:

  • Разрешенное имя узла соответствует только имени узла. Используется *.example.com для сопоставления его поддоменов, но не example.com сам по себе. Используется * для сопоставления каждого узла.
  • Запрещенный домен также отрицает его поддомены. Например, запретить блоки example.com и example.com``api.example.com.
  • Запрет имеет приоритет над allow.
  • После добавления правила allow узлы, которые не соответствуют разрешенной записи, блокируются, за исключением автоматических записей localhost, описанных ниже. Если правила не допускаются, другие узлы остаются разрешенными, если правило запрета или другое ограничение сети не блокирует их.
  • Если включить хотя бы одно правило allow, включите как разрешенные исходящие подключения, так и разрешить локальную сеть, 127.0.0.1а также разрешает localhostи::1. Эти записи добавляются в действующий список разрешений, не изменяя сохраненные правила. Явные правила запрета и списки разрешений предприятия по-прежнему могут блокировать их.
  • Корпоративные правила могут только сузить список разрешений, никогда не расширяя его. Узел разрешен только в том случае, если правила и корпоративные правила разрешают его. Если ни один из разрешенных узлов также не разрешен корпоративными правилами, ничего не будет разрешено. Затем каждый узел отклоняется. Это один из случаев, когда добавление правила allow заканчивается в полностью закрытом списке. Copilot отображает это состояние в диалоговом окне песочницы и в сведениях о политике.

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

Маршрутизация трафика через прокси-сервер HTTP

Чтобы отправить исходящий трафик песочницы через прокси-сервер:

  1. На вкладке "Сеть" выберите прокси-сервер и нажмите клавишу ВВОД. Затем выберите удаленный прокси-сервер и нажмите клавишу ВВОД.
  2. Введите URL-адрес прокси-сервера и при необходимости имя пользователя и пароль.

Чтобы удалить прокси-сервер, снимите URL-адрес.

Помните о перечисленных ниже моментах.

  • Прокси применяется только во время включения исходящих подключений . Если вы отключите исходящие подключения, прокси-сервер хранится в параметрах, но остается неактивным.
  • Используйте URL-адрес HTTP или HTTPS без внедренных учетных данных. Введите учетные данные в отдельных полях имени пользователя и пароля . В Linux используйте IPv4-адрес или имя узла с поддержкой IPv4, а не адрес только IPv6.
  • Интерфейс командной строки сохраняет литеральный пароль в хранилище учетных данных операционной системы при наличии локального резервного файла. Файл параметров содержит ссылку на сохраненный секрет, а не пароль.
  • Вместо этого можно ввести ${VAR} или $VAR в качестве всего значения пароля использовать переменную среды. Переменная должна быть доступна интерфейсу командной строки. Если он не задан, пароль не указан, а прокси-сервер, требующий проверки подлинности, может отклонить запрос.
  • Интерфейс командной строки подключается через встроенный локальный прокси-сервер, который сохраняет учетные данные вышестоящего прокси-сервера из изолированных дочерних процессов. Правила узла также применяются при использовании вышестоящего прокси-сервера.
  • В macOS и Linux изолированные программы не могут обойти прокси-сервер напрямую. В Windows песочница зависит от программ с учетом параметров прокси-сервера. Windows также требует поддерживаемую версию и разрешить локальную сеть, которая также разрешает доступ к частной сети.
  • Ваша организация может применить URL-адрес прокси-сервера с помощью управляемых параметров. В этом случае URL-адрес отображается как (managed), но вы по-прежнему можете указать собственное имя пользователя и пароль.

Быстрое включение и отключение песочницы

Вы можете включить или выключить песочницу, не открывая полный интерфейс конфигурации:

  • Включить: Войдите /sandbox enable в Copilot CLI сессию.
  • Отключить: Войти /sandbox disable в Copilot CLI сессию.

Обычно эти команды изменяют сохраненный параметр песочницы. Если для управляемых параметров требуется песочница и обход разрешений, /sandbox disable вместо этого отключается песочница только для текущего сеанса. Выполнение /sandbox enable восстанавливает его для этого сеанса.

Просмотр текущих параметров песочницы

Настройки хранятся settings.json под ключом sandbox в вашей Copilot CLI директории конфигурации. Параметры песочницы не поддерживаются в файлах параметров уровня репозитория. Управляемые параметры предприятия могут ограничить выбор. Для получения дополнительной информации о каталоге конфигурации см. Каталог конфигурации CLI GitHub Copilot.

Текущие параметры песочницы можно просмотреть из сеанса Copilot CLI .

  1. Введите /settings.
  2. Нажмите, / чтобы найти параметры.
  3. Введите sandbox для фильтрации списка параметров.

Описанные выше действия показывают сохраненные параметры. Чтобы увидеть эффективную политику — пути, параметры сети и возможности, которые приводят после настройки, автоматических грантов и любой управляемой политики— введите /sandbox policy. Вы можете добавить команду, например /sandbox policy npm install, чтобы проверить доступ к средству разработчика, не выполняя его. Дополнительные сведения см. в разделе Общие сведения о политиках файловой системы для локальной песочницы GitHub Copilot CLI.

Дополнительные материалы