Informationen zur lokalen Sandkastenkonfiguration
Sie können die Einstellungen in GitHub Copilot app oder den Slash-Befehl /sandbox in Copilot CLI verwenden, um zusätzliche Pfade freizugeben, den Netzwerkzugriff anzupassen oder die Sandbox zu aktivieren oder zu deaktivieren.
Das lokale Sandboxing beschränkt den Zugriff auf Dateien, Netzwerkressourcen und Anmeldeinformationen auf Ihrem Computer, wodurch die potenziellen Auswirkungen eines unbeabsichtigten Befehls reduziert werden. Die Einstellungen werden separat in den Copilot app und Copilot CLI konfiguriert. Wenn Sie sie in einem ändern, werden sie im anderen nicht geändert.
Hinweis
Wenn Sie Ihre Copilot Lizenz von einem Unternehmen erhalten, werden einige oder alle Sandkasteneinstellungen möglicherweise von unternehmensverwalteten Einstellungen gesteuert.
Eine konzeptionelle Übersicht über Cloud- und lokale Sandboxes Copilotfinden Sie unter Informationen zum lokalen Sandboxing für GitHub Copilot. Ausführliche Anweisungen zur Verwendung des lokalen Sandboxing finden Sie unter Verwenden einer lokalen Sandbox.
Prerequisites
- Windows: Lokale Sandboxing auf Windows erfordert Windows 11 Version 25H2 mit Update KB5124010 oder höher oder Windows 11 Version 26H1 mit Update KB5124006 oder höher, mit Unterstützung für die BaseContainer-Ebene des ProcessContainer-Back-End.
- Linux: Bubblewrap (
bwrap) Version 0.5.0 oder höher, undslirp4netnsmüssen auf Ihrem PATH installiert und verfügbar sein.
Konfigurieren von Copilot app
Sie konfigurieren lokales Sandboxing separat für jedes Repository oder jeden lokalen Ordner in der GitHub Copilot app. Die Konfiguration gilt für Sitzungen des lokalen Repositorys und des Arbeitsverzeichnisses. Sie gilt nicht für Cloud-Sandkastensitzungen oder Sitzungen, die auf einem Remotehost ausgeführt werden.
Ein Arbeitsverzeichnis hält die Branches und Dateien für parallele Sitzungen getrennt, schränkt jedoch nicht ein, worauf ein Befehl andernorts auf Ihrem Computer zugreifen kann. Lokales Sandboxing bietet diesen zusätzlichen Schutz.
Aktivieren von lokalem Sandboxing für ein Repository
Die lokale Sandkastenfunktion ist standardmäßig deaktiviert, es sei denn, für unternehmensverwaltete Einstellungen ist dies erforderlich. Die Sandkasteneinstellungen sind für nur Remoterepositorys nicht verfügbar. So aktivieren Sie Sandboxing für neue lokale Sitzungen in einem Repository oder einem lokalen Ordner:
- Öffnen Sie in der App-Randleiste "Einstellungen".
- Wählen Sie unter "Repositorys" das Repository oder den Ordner aus, den Sie konfigurieren möchten.
- Aktivieren Sie unter "Sandbox" Sandbox new sessions.
Die Einstellung gilt für neue Sitzungen im Repository oder Ordner. Eine bereits laufende Sitzung wird dadurch nicht geändert. Ausführliche Informationen zum Aktivieren der lokalen Sandbox-Isolierung für die aktuelle Sitzung finden Sie unter Verwenden einer lokalen Sandbox.
Für die meisten Repositorys können Sie mit der standardmäßigen Sandboxing-Richtlinie beginnen. Dies ermöglicht den Zugriff, der für allgemeine Entwicklungsaufgaben wie das Installieren von Abhängigkeiten, das Herstellen einer Verbindung mit einem lokalen Entwicklungsserver, das Pushen einer Verzweigung und das Erstellen eines Pull Requests erforderlich ist. Fügen Sie Einschränkungen hinzu, wenn sich das Repository in der Nähe sensibler Ordner befindet, keinen Netzwerkzugriff benötigt oder Ihre Anmeldeinformationen nicht verwenden sollte.
Konfigurieren der Sandbox-Richtlinie für ein Repository
Eine Sandbox-Richtlinie ist ein Regelwerk, das steuert, auf welche Dateien, Netzwerke und Anmeldeinformationen von einem Agenten ausgeführte Tools zugreifen können. Die Repositoryeinstellungen beschreiben die Richtlinie, die die App anfordert, wenn eine Sandkastensitzung gestartet wird. Die effektive Richtlinie kann restriktiver sein, z. B. wenn vom Unternehmen verwaltete Einstellungen angewendet werden.
Die „Zusammenfassung der konfigurierten Richtlinie“ zeigt die ausgewählten Ordner-, Netzwerk- und Einstellungen für Anmeldeinformationen an. Es bestätigt weder, dass die Sandbox läuft, noch zeigt es jede Einschränkung an, die gilt. Änderungen werden automatisch gespeichert.
In den Repositoryeinstellungen können Sie Folgendes konfigurieren:
- Dateisystemzugriff: Gewähren Sie zusätzlichen schreibgeschützten oder Lese-/Schreibzugriff auf bestimmte Pfade oder verweigern Sie Pfade.
- Netzwerkzugriff: Zulassen oder Blockieren des ausgehenden Internets und des lokalen Netzwerkzugriffs.
- Anmeldeinformationen: Wählen Sie aus, ob Ihre Git- und GitHub CLI Anmeldeinformationen im Sandkasten verfügbar sind.
Konfigurieren des Dateisystemzugriffs
Standardmäßig verfügt eine Sandbox-Sitzung über Lese- und Schreibzugriff auf ihren Arbeitsbereich und ihr aktuelles Arbeitsverzeichnis. Sie können Zugriff auf zusätzliche Ordner gewähren oder den Zugriff auf bestimmte Ordner verhindern.
Konfigurieren Sie im Abschnitt "Sandbox" der Repositoryeinstellungen eine oder mehrere der folgenden Listen:
- Zusätzlicher Lese-/Schreibzugriff: Ordner, die von Agent ausgeführten Tools gelesen und geändert werden können.
- Zusätzlich schreibgeschützt: Ordner, die von Agenten ausgeführte Tools lesen, aber nicht ändern können.
- Verweigert: Ordner, auf die agent-ausgeführte Tools nicht zugreifen können.
Wenn Sie einen Ordner hinzufügen möchten, klicken Sie auf "Ordner hinzufügen " für die entsprechende Liste, und wählen Sie dann den Ordner aus. Um einen Ordner zu entfernen, klicken Sie auf das Löschsymbol neben seinem Pfad.
Ein speziellerer verweigerter Ordner bleibt verweigert, wenn ein breiterer übergeordneter Ordner Lese- oder Schreibzugriff hat.
Unter Windows können Sie in den Repositoryeinstellungen einen blockierten Pfad speichern. Wenn die aktiven Windows-Sandboxfunktionen die Verweigerung nicht garantieren können, schlägt ein Befehl in der Sandbox mit der Meldung „unsupported-policy“ fehl. Der Befehl wird nicht ausgeführt, wenn auf den gesperrten Pfad zugegriffen werden kann oder keine Sandbox vorhanden ist.
Konfigurieren des Netzwerkzugriffs
Standardmäßig sind beide Netzwerkeinstellungen in der App aktiviert. Im Abschnitt "Sandbox" der Repositoryeinstellungen können Sie die folgenden Einstellungen ändern:
- Ausgehender Internetzugriff: Verbindungen zu Internetdiensten wie GitHub und Paketregistrys zulassen.
- Lokales Netzwerk: Zulassen von Loopback- und lokalen Netzwerkverbindungen, einschließlich Verbindungen mit lokalen Entwicklungsservern.
Netzwerkeinschränkungen können sich auf die Paketinstallation, API-Aufrufe, Vorschauserver und andere Tools auswirken, die eine Netzwerkverbindung benötigen.
Unter Linux können sandboxierte Prozesse keine direkte Verbindung mit Servern auf dem Localhost Ihres Computers herstellen. Die Einstellung des lokalen Netzwerks steuert weiterhin Anfragen über den integrierten lokalen Proxy sowie prozessinterne Vorgänge wie Webanforderungen und Remote-MCP-Verbindungen.
Die unter "Konfigurieren von Netzwerkeinstellungen" beschriebenen Betriebssystembeschränkungen gelten auch für die App. Im Gegensatz zur Einstellung des lokalen Netzwerks der App ist die Einstellung " Lokales Netzwerk zulassen " der CLI standardmäßig deaktiviert.
Konfigurieren von Anmeldeinformationen
Standardmäßig sind authentifizierte Git und GitHub CLI Vorgänge im Sandkasten verfügbar. Sie können eine der folgenden Einstellungen deaktivieren:
- Git-Anmeldeinformationen: Authentifizierte HTTPS-Git-Vorgänge zulassen.
- GitHub CLI Anmeldeinformationen: GitHub CLI (
gh, nichtcopilot) zur Authentifizierung zulassen.
Das Deaktivieren des Zugriffs auf Anmeldedaten kann Vorgänge wie das Pushen eines Branches oder das Erstellen eines Pull Requests in der Sandbox verhindern.
Anwenden von Richtlinienänderungen
Änderungen an Dateisystem-, Netzwerk- und Anmeldeinformationeneinstellungen gelten für neue Sitzungen oder beim Neustart einer vorhandenen Sitzung. Sie ändern die Richtlinie einer aktuell laufenden Sitzung nicht.
Um eine Sitzung neu zu starten, während der Verlauf beibehalten wird, geben Sie Folgendes ein:
/restart-session
Die App akzeptiert Sandkasteneinstellungen, bevor Überprüft wird, ob ihr Betriebssystem sie erzwingen kann. Die Unterstützung wird überprüft, wenn die erste Sandkastenshell gestartet wird. Wenn der Host die angeforderte Richtlinie nicht erzwingen kann, schlägt die Shell mit der Meldung „unsupported-platform“ oder „unsupported-policy“ fehl und wird nicht ohne Sandbox ausgeführt. Informationen zu den derzeit unterstützten Windows-Versionen finden Sie unter Windows Betriebssystemunterstützung für Copilot Sandboxing.
Wenn die App Sandkasten nicht verfügbar anzeigt, beheben Sie das gemeldete Problem, und klicken Sie dann auf "Sandkasten wiederholen".
Konfigurieren von Copilot CLI
Verwenden Sie den /sandbox /-Befehl, um lokales Sandboxing in der CLI zu konfigurieren. Eine verwaltete Einstellung ist in der (managed) Oberfläche mit /sandbox gekennzeichnet und kann nicht geändert werden.
Öffnen der Sandkastenkonfiguration
-
Starten Sie eine Copilot CLI Sitzung.
-
Geben Sie den
/sandboxSchrägstrichbefehl ein.Dadurch wird eine interaktive Konfigurationsschnittstelle mit vier Registerkarten geöffnet: Allgemein, Anmeldeinformationen, Dateisystem und Netzwerk. Verwenden Sie TAB , um zwischen Registerkarten zu wechseln. Drücken Sie ESC , um Ihre Änderungen zu speichern und die Konfiguration zu schließen. Wenn Sie sich in einer Pfad-, Hostregel- oder maskierten Variablenliste befinden, drücken Sie zuerst Esc, um zur zugehörigen Registerkarte zurückzukehren.
Konfigurieren allgemeiner Einstellungen
Auf der Registerkarte " Allgemein " wird das Verhalten der Sandbox auf oberster Ebene gesteuert. Wenn vom Unternehmen verwaltete Einstellungen einen Wert erzwingen, beschriftt das Dialogfeld die Einstellung als (managed) und verhindert, dass Sie ihn ändern.
| Setting | Description |
|---|---|
| Aktivieren von Sandkasten | Führen Sie Shellbefehle innerhalb der Sandbox aus. Sie können dies auch mit /sandbox enable und /sandbox disable umschalten. |
| Sandkastenumgehung zulassen | Lassen Sie die Modellanforderung anfordern, dass einzelne Befehle außerhalb der Sandbox ausgeführt werden, vorbehaltlich der Genehmigung. Mit einer Bypass-Aufforderung können Sie auch das Sandboxing für den Rest der aktuellen Sitzung deaktivieren. Standardmäßig aktiviert. Weitere Informationen finden Sie unter Zulassen der Sandkastenumgehung. |
| Sandbox-MCP-Server | Führen Sie MCP-Server innerhalb der Sandbox aus. Standardmäßig aktiviert. |
| Sandbox-LSP-Server | Führen Sie Sprachserver (LSP-Server) innerhalb der Sandbox aus. Standardmäßig aktiviert. |
Zulassen der Sandkastenumgehung
Die Einstellung Sandkastenumgehung zulassen steuert, ob Copilot um Erlaubnis bitten kann, einen blockierten Befehl mit breiterem Zugriff erneut auszuführen.
- Ein (Standard): Bei unterstützten Sandbox-Ablehnungen bietet die CLI eine Bestätigungsaufforderung an, die den Befehl und den vorgeschlagenen Wiederholungsversuch beschreibt. Die Genehmigung gilt für jenen Versuch. Sie können auch das Sandboxing für den Rest der Sitzung deaktivieren, wenn Ihr Unternehmen dies zulässt, oder Copilot eine weitere Anweisung geben.
- Deaktiviert: Der Befehl bleibt blockiert. Sie können die von Ihnen gesteuerten Einstellungen anpassen oder Copilot um einen anderen Ansatz bitten.
Ein Bypass entfernt nur die eigenen Sandbox-Beschränkungen von Copilot, nicht die Ihres Betriebssystems. Der Befehl wird weiterhin unter Ihrem normalen Konto ausgeführt, sodass er keinen Administrator- oder Root-Zugriff erhält und nichts erreichen kann, was Ihr System bereits blockiert.
Auf unterstützten Windows-Hosts kann ein genehmigter erneuter Versuch zunächst Datei- und Prozesseinschränkungen lockern und gleichzeitig Netzwerkeinschränkungen beibehalten. Das Ergebnis wird als „sandbox relaxed“ bezeichnet. Wenn der Befehl weiterhin blockiert ist, kann die CLI die vollständige Umgehung verwenden, die in derselben Genehmigungsaufforderung beschrieben wird. Dieses Ergebnis wird als "Sandbox umgangen" bezeichnet.
Wenn die vom Unternehmen verwalteten Einstellungen auf festgelegt sind sandbox.allowBypass``false, können Sie nicht einzelne Befehle genehmigen, die außerhalb der Sandbox ausgeführt werden sollen, oder die Sandkastenerstellung für die restliche Sitzung deaktivieren. Wenn verwaltete Einstellungen Sandboxing erfordern, die wirksame Richtlinie aber erlaubt, es zu umgehen, können Sie Sandboxing nicht über die normalen Einstellungen deaktivieren. Sie können es jedoch für den Rest der aktuellen Sitzung deaktivieren – entweder über eine aktive Aufforderung zur Erteilung einer Umgehungsberechtigung oder durch Ausführen von /sandbox disable –, ohne die gespeicherte Richtlinie zu lockern.
Konfigurieren von Authentifizierungseinstellungen
Auf der Registerkarte Anmeldeinformationen steuern Sie die Authentifizierung für Git und GitHub CLI, und können maskierte Umgebungsvariablen konfigurieren. In einer Sandbox ausgeführte Prozesse erhalten Platzhalterwerte. Ein lokaler Proxy stellt die tatsächlichen Anmeldeinformationen nur in HTTPS-Anforderungsheadern bereit, die an genehmigte Ziele gesendet werden. Wie auf den anderen Registerkarten wird ein unternehmensseitig verwalteter Wert als (managed) angezeigt und kann nicht geändert werden.
| Setting | Description |
|---|---|
| Git authentifizieren | Authentifizierte HTTPS-Git-Vorgänge mit Platzhalteranmeldeinformationen ohne Anmeldeinformationshilfsprogramm innerhalb der Sandbox zulassen. Der Proxy stellt die tatsächlichen Anmeldeinformationen nur für ihren ursprünglichen Host-, Port- und Repository-Pfad bereit. Standardmäßig aktiviert. |
| Authentifizieren gh | Geben Sie einen Platzhalter an GH_TOKEN , damit GitHub CLI sich (ghnicht copilot) authentifizieren kann, ohne auf die gespeicherten Anmeldeinformationen zuzugreifen. Der Proxy stellt das eigentliche Token nur an github.com, api.github.com und uploads.github.com. Standardmäßig aktiviert. |
| Maskierte Umgebungsvariablen | Wählen Sie zusätzliche Umgebungsvariablen aus, die durch Platzhalter ersetzt werden sollen, und die HTTPS-Hosts, die ihre tatsächlichen Werte empfangen können. |
Auf macOS ist der Schlüsselbundzugriff standardmäßig deaktiviert. Damit Sandbox-Befehle den Systemschlüsselbund verwenden können, setzen Sie settings.json in Ihrer persönlichen true-Datei auf sandbox.userPolicy.seatbelt.keychainAccess. Diese Option ist über /sandbox oder /settings nicht verfügbar.
Maskieren von Umgebungsvariablen
Verwenden Sie maskierte Umgebungsvariablen, damit Sandkastentools sich bei einer API authentifizieren können, ohne das echte Token zu erhalten. Die Maskierung gilt für die ausgewählten Variablen in Befehlen, lokalen MCP-Servern und Sprachservern, die innerhalb der Sandbox ausgeführt werden. Git und gh Authentifizierung verwenden die Maskierung automatisch, wenn ihre Authentifizierungseinstellungen aktiviert sind. Sie müssen keine Einträge für sie hinzufügen.
Bevor Sie die Maskierung konfigurieren, legen Sie die Umgebungsvariable in der Umgebung fest, die zum Starten Copilot CLIverwendet wird. Der Wert muss nicht leer sein. Fehlende Variablen bleiben aus, und leere Werte sind nicht maskiert.
Die Maskierung ist nur aktiv, wenn das lokale Sandboxing aktiviert ist. Das Hinzufügen einer maskierten Variablen aktiviert keine Sandboxing.
- Geben Sie
/sandbox enableein, um die lokale Sandkastenumgebung zu aktivieren. - Geben Sie
/sandbox statusein, und vergewissern Sie sich, dass Sandboxing für die aktuelle Sitzung aktiviert ist, bevor Sie fortfahren. - Drücken Sie
/sandboxdie EINGABETASTE, dann öffnen Sie die Registerkarte Anmeldeinformationen. - Wählen Sie maskierte Umgebungsvariablen aus und drücken Sie Eingabetaste.
- Drücken Sie A , um einen Eintrag hinzuzufügen.
- Geben Sie in Variable den Variablennamen ein, z. B.
EXAMPLE_API_TOKEN, und drücken Sie dann die EINGABETASTE. Geben Sie nicht den geheimen Wert ein. - Geben Sie in Inject hosts eine kommagetrennte Liste von Hosts ein, die den tatsächlichen Wert empfangen können, z. B.
api.example.com, und drücken Sie dann die Eingabetaste. Verwenden Sie Hostnamen oder Wildcard-Unterdomänen wie*.example.com. Geben Sie kein URL-Schema, keinen Pfad, keinen Port oder eine reine Domain*an. - Drücken Sie Esc, um zur Registerkarte Anmeldeinformationen zurückzukehren.
- Bei Windows erfordert die Maskierung von Anmeldeinformationen eine Windows Version, die den lokalen Proxy der Sandbox unterstützt. Wechseln Sie zur Registerkarte Netzwerk, und aktivieren Sie Lokales Netzwerk zulassen. Dies ermöglicht auch den Zugriff auf private Netzwerke, vorbehaltlich der konfigurierten Hosteinschränkungen.
- Drücken Sie ESC , um die Konfiguration zu speichern und zu schließen.
Um einen Eintrag zu bearbeiten, wählen Sie ihn aus und drücken Sie EINGABETASTE. Um es zu entfernen, drücken Sie X. Der Editor speichert nur Variablennamen und Zielhosts. Geheime Werte werden nicht gelesen oder angezeigt.
Sie können Einträge auch unter sandbox.credentials.envVars in Ihrer persönlichen settings.json Datei konfigurieren. Zum Beispiel ermöglicht dieser Eintrag, dass der Proxy EXAMPLE_API_TOKEN nur an api.example.com liefert:
{
"sandbox": {
"enabled": true,
"credentials": {
"envVars": {
"EXAMPLE_API_TOKEN": {
"injectHosts": ["api.example.com"]
}
}
}
}
}
Das Hinzufügen eines Injection-Hosts lässt keinen Netzwerkzugriff darauf zu. Ihre Netzwerkeinstellungen müssen auch die Verbindung zulassen. Genaue Hostnamen stimmen nur mit diesem Host überein.
*.example.com entspricht Unterdomänen, aber nicht example.com selbst.
Die Maskierung setzt voraus, dass eine Variable in der Umgebung des untergeordneten Prozesses verbleibt. Führen Sie keine Variable, die Sie maskieren möchten, in --secret-env-vars auf. Mit dieser Option werden benannte Variablen aus Befehls- und MCP-Serverumgebungen entfernt, anstatt sie als Platzhalter verfügbar zu machen.
Konfigurieren von Dateisystemeinstellungen
Auf der Registerkarte "Dateisystem " wird gesteuert, auf welche Verzeichnisse und Dateien der Sandkastenprozess zugreifen kann.
Standardmäßig wird Copilot Lese-/Schreibberechtigung für alles im aktuellen Arbeitsverzeichnis und darunter gewährt. Wenn Sie sich in einem Git-Repository befinden, wird Copilot ebenfalls gewährt:
- Lese-/Schreibberechtigung für alles im Verzeichnis
.gitdes Repositorys und in dessen Unterverzeichnissen. - Leseberechtigung für alles andere im Repository oberhalb des aktuellen Arbeitsverzeichnisses. Das Arbeitsverzeichnis selbst behält Lese-/Schreibzugriff, da die spezifischere Zuweisung Vorrang hat, wenn sich die beiden überlappen.
| Setting | Description |
|---|---|
| Arbeitsverzeichnis einschließen | Standardmäßig aktiviert. Das aktuelle Arbeitsverzeichnis (und das Verzeichnis des eingeschlossenen Repositorys .git , falls vorhanden) wird automatisch der Liste der Lese-/Schreibpfade hinzugefügt. Deaktivieren Sie diese Option, wenn dem Arbeitsverzeichnis nicht automatisch Lese-/Schreibzugriff gewährt werden soll, und gewähren Sie anschließend manuell Zugriff auf bestimmte Pfade. |
| Zugriff auf Entwicklertools zulassen | Standardmäßig aktiviert. Gewährt Sandkastenbefehlen Lesezugriff auf Entwicklertoolkonfigurationen und -caches – einschließlich Paket-Manager-Registrierungen und der token, die sie speichern – und Lese-/Schreibzugriff auf freigegebene Buildcaches, sodass Installationen und Builds innerhalb der Sandbox funktionieren. Dies wird als Dev-Tool-Zugriff im /sandbox policy Bericht angezeigt. Deaktivieren Sie sie, damit der Zugriff auf diese Speicherorte explizit gewährt werden muss. |
Wichtig
Wenn Sie die Option "Arbeitsverzeichnis einschließen" deaktivieren, wird der Zugriff auf alles in und unterhalb des .git Verzeichnisses eines Git-Repositorys entfernt. Daher treten Git-Vorgänge wie status, add, commit, und diff schlagen fehl, es sei denn, Sie fügen manuell Zugriff für dieses Verzeichnis hinzu.
Hinzufügen von Dateisystempfadregeln
Sie können Pfade angeben, die Sie der Sandbox hinzufügen möchten. Auf diese Weise können Sie Schreibschutz oder Lese-/Schreibzugriff auf Verzeichnisse und Dateien außerhalb des Arbeitsverzeichnisses gewähren. Sie können auch den Zugriff verweigern, um Verzeichnisse und Dateien aus der Sandbox auszuschließen.
-
Wählen Sie auf der Registerkarte Dateisystem****die vom Benutzer konfigurierten Pfade aus, und drücken Sie die EINGABETASTE.
-
Drücken Sie A , um eine neue Pfadregel hinzuzufügen.
-
Geben Sie eine Datei oder einen Verzeichnispfad ein. Verwenden Sie einen absoluten Pfad,
/Users/octocat/projects/appz. B. unter macOS oder Linux oderC:\Users\octocat\projects\appauf Windows. Betätigen Sie anschließend die Eingabetaste.Hinweis
Beim Hinzufügen eines Verzeichnisses wird dessen gesamter Unterverzeichnisbaum eingeschlossen. Wildcards werden nicht unterstützt.
-
Verwenden Sie die Pfeiltasten nach links und rechts auf Ihrer Tastatur, um zwischen den Berechtigungsoptionen zu navigieren: Lese-/Schreibzugriff, Schreibgeschützt, Verweigert. Drücken Sie dann die EINGABETASTE , um eine Option auszuwählen.
Wenn der Pfad selbst ein symbolischer Link ist, fügt die Auswahl von Lese-/Schreibzugriff oder Nur-Lesen auch das aktuelle Ziel hinzu, wenn die CLI ihn auflösen kann. Dies gewährt nicht automatisch Zugriff auf Ziele anderer Links innerhalb eines zulässigen Verzeichnisses.
Nachdem Sie Dateisystempfade hinzugefügt haben, können Sie sie bearbeiten oder löschen.
- Verwenden Sie die NACH-OBEN- und NACH-UNTEN-TASTE, um einen Pfad auszuwählen.
- Drücken Sie die EINGABETASTE , um den Pfad zu bearbeiten, oder X , um ihn zu löschen.
- Drücken Sie ESC , um zur Registerkarte "Dateisystem " zurückzukehren. Drücken Sie esc erneut, um die Konfiguration zu speichern und zu schließen.
Unter Windows erfordern ausgeschlossene Pfade eine Version, die diese Einschränkung unterstützt. Wenn der Host sie nicht erzwingen kann, schlägt der Befehl mit einer Erklärung fehl, anstatt mit schwächerem Schutz ausgeführt zu werden.
Konfigurieren von Netzwerkeinstellungen
Auf der Registerkarte "Netzwerk " wird gesteuert, ob Sandkastenprozesse Netzwerkverbindungen herstellen können.
| Setting | Description |
|---|---|
| Ausgehende Verbindungen zulassen | Standardmäßig aktiviert. Ermöglicht ausgehende Internetverbindungen, vorbehaltlich aller Hostregeln. Durch Das Deaktivieren werden auch Proxyeinstellungen und Hostregeln inaktiv. |
| Lokales Netzwerk zulassen | Standardmäßig deaktiviert. Steuert den lokalen Zugriff, z. B. Verbindungen zu einem Entwicklungsserver auf Ihrem Computer. Der Effekt hängt von Ihrem Betriebssystem ab, wie unten beschrieben. |
| Hostregeln | Verbindungen mit bestimmten Hosts zulassen oder verweigern. Siehe Zulassen oder Blockieren bestimmter Hosts. |
| Remote Proxy | Leiten Sie den ausgehenden Datenverkehr des Sandkastens über einen HTTP-Proxy weiter. Siehe Leiten von Datenverkehr über einen HTTP-Proxy. |
Der lokale Netzwerkzugriff verhält sich in den einzelnen Betriebssystemen anders:
| Betriebssystem | Auswirkung auf Sandbox-Befehle |
|---|---|
| macOS | Bei aktiviertem ausgehendem Zugriff und ohne Proxy, Hostregeln oder Anmeldeinformationsmaskierung aktivieren Sie den lokalen Zugriff, damit ein Befehl eine Verbindung mit einem lokalen Entwicklungsserver herstellen kann. Wenn sie deaktiviert ist, werden localhost-Verbindungen blockiert, einschließlich zu einem Server, den der Befehl selbst startet. Durch das Deaktivieren des ausgehenden Zugriffs werden diese Verbindungen ebenfalls blockiert. |
| Linux | In einer Sandbox ausgeführte Befehle verwenden ihren eigenen privaten Netzwerkraum. Sie können dort gestartete Server erreichen, aber keine direkte Verbindung mit Servern auf dem Localhost Ihres Computers herstellen. Wenn der lokale Zugriff aktiviert ist und kein Remoteproxy konfiguriert ist, können Anforderungen über den integrierten lokalen Proxy den Localhost Ihres Computers erreichen, vorbehaltlich der Hostregeln. |
| Windows | Das Aktivieren des lokalen Zugriffs ermöglicht den Zugriff auf private Netzwerke. Verbindungen mit dem Localhost des Hosts erfordern auch eine Windows Version, die sie unterstützt. Proxy- und Hostregeln erfordern, dass diese Einstellung aktiviert ist. |
Die Einstellung gilt auch für die integrierten Webanfragen der CLI auf jeder Plattform. Wenn Sandbox MCP servers aktiviert ist, gilt dies auch für Remote-MCP-Verbindungen. Durch das Zulassen des lokalen Zugriffs kann das integrierte web_fetch Tool „localhost“ erreichen, hebt jedoch seine separaten Einschränkungen für andere private Netzwerkadressen nicht auf.
Die Maskierung von Anmeldeinformationen verwendet einen lokalen Proxy, auch wenn Sie keinen Remoteproxy oder Hostregeln konfiguriert haben. Dazu gehören die automatische Maskierung für Git- und gh-Authentifizierung, die standardmäßig aktiviert ist, und maskierte Umgebungsvariablen.
Wenn ein lokaler Proxy unter macOS aktiv ist, ermöglicht das Aktivieren des lokalen Zugriffs, dass ein Befehl auf einen Port lauscht, erlaubt es ihm jedoch nicht, sich direkt mit diesem Port zu verbinden. Ein Server, der auf allen Netzwerkschnittstellen lauscht, kann von anderen Geräten in Ihrem Netzwerk erreichbar sein. Gehen Sie bei Windows nicht davon aus, dass ein Server innerhalb eines proxybasierten Sandkastens vom Localhost des Hosts erreichbar ist.
Zulassen oder Blockieren bestimmter Hosts
Verwenden Sie Hostregeln, um einzuschränken, welche Ziele Sandbox-Befehle erreichen können. Hostregeln sind nur aktiv, wenn Sandboxing und ausgehende Verbindungen aktiviert sind.
Sie können Hostnamen, Wildcard-Unterdomänenmuster oder einzelne IPv4- oder IPv6-Adressen angeben. IP-Adressbereiche in CIDR-Notation, wie 203.0.113.0/24, werden nicht unterstützt.
- Wählen Sie auf der Registerkarte Netzwerk****Proxy und Blockierung aus und drücken Sie die Eingabetaste. Wählen Sie dann Hostregeln aus, und drücken Sie EINGABETASTE.
- Drücken Sie a, um eine Regel hinzuzufügen.
- Geben Sie einen Hostnamen, ein Wildcard-Unterdomänenmuster oder eine einzelne IP-Adresse ein. Verwenden Sie z. B.
example.com,*.example.com,203.0.113.10oder2001:db8::10. Geben Sie kein URL-Schema, keinen Pfad und keinen Port an. Drücken Sie die Eingabetaste. - Verwenden Sie die NACH-LINKS- und NACH-RECHTS-TASTE, um "Zulassen" oder "Ablehnen" auszuwählen, und drücken Sie dann die EINGABETASTE, um die Regel zur Liste hinzuzufügen. Neue Regeln werden standardmäßig auf "Ablehnen" gesetzt.
- Drücken Sie ESC, um zu Proxy und Blockierung zurückzukehren, und drücken Sie dann erneut ESC, um zur Registerkarte Netzwerk zurückzukehren. Drücken Sie erneut ESC, um Ihre Änderungen zu speichern und die Konfiguration zu schließen.
Um eine Regel zu ändern, wählen Sie sie aus und drücken Sie Eingabetaste. Um es zu entfernen, drücken Sie x. Mit (managed) markierte Regeln können nicht bearbeitet oder entfernt werden. Änderungen werden gespeichert, wenn Sie die Konfiguration schließen.
Beachten Sie beim Auswählen von Regeln Folgendes:
- Ein zulässiger Hostname stimmt nur mit diesem Hostnamen überein. Verwenden Sie
*.example.com, um seine Unterdomänen einzuschließen, aber nichtexample.comselbst. Verwenden Sie*, um jeden Host abzugleichen. - Eine abgelehnte Domäne lehnt auch ihre Unterdomänen ab. Beispiel: Wenn
example.comverweigert wird, werden sowohlapi.example.comals auchexample.comblockiert. - Deny hat Vorrang vor Allow.
- Nachdem Sie eine Zulassungsregel hinzugefügt haben, werden Hosts, die keinem zulässigen Eintrag entsprechen, blockiert, mit Ausnahme der unten beschriebenen automatischen Localhost-Einträge. Ohne Allow-Regeln bleiben andere Hosts zulässig, es sei denn, eine Deny-Regel oder eine andere Netzwerkeinschränkung blockiert sie.
- Mit mindestens einer Zulassungsregel werden beim Aktivieren von Ausgehende Verbindungen zulassen und Lokales Netzwerk zulassen auch
localhost,127.0.0.1und::1zugelassen. Diese Einträge werden der effektiven Zulassungsliste hinzugefügt, ohne Ihre gespeicherten Regeln zu ändern. Explizite Verweigerungsregeln und Enterprise-Zulassungslisten können sie weiterhin blockieren. - Unternehmensregeln können Ihre Allowlist nur einschränken, sie nie verbreitern. Ein Host ist nur zulässig, wenn sowohl Ihre Regeln als auch die Enterprise-Regeln dies zulassen. Wenn keine der von Ihnen zugelassenen Hosts auch von den Enterprise-Regeln zugelassen wird, bleibt nichts zuzulassen. Jeder Host wird dann abgelehnt. Dies ist der Fall, in dem das Hinzufügen einer Zulassungsregel in einer vollständig geschlossenen Liste endet. Copilot zeigt diesen Zustand im Sandkastendialogfeld und in den Richtliniendetails an.
Hostregeln verwenden einen lokalen Proxy, auch wenn Sie keinen HTTP-Proxy konfiguriert haben. Unter macOS und Linux erzwingt der Sandkasten jede Verbindung über diesen Proxy, sodass ein Programm Ihre Hostregeln nicht vermeiden kann, indem eine direkte Verbindung hergestellt wird. Unter Windows basiert die Sandbox auf Programmen, die die Proxyeinstellungen berücksichtigen. Daher können Programme, die die Proxyeinstellungen in Windows ignorieren, direkt eine Verbindung herstellen und Ihre Hostregeln umgehen.
Routing des Datenverkehrs über einen HTTP-Proxy
So senden Sie den ausgehenden Datenverkehr des Sandkastens über einen Proxyserver:
- Wählen Sie auf der Registerkarte Netzwerk****Proxy und Blockierung aus und drücken Sie die Eingabetaste. Wählen Sie dann Remote Proxy aus und drücken Sie die Eingabetaste.
- Geben Sie die Proxy-URL und optional einen Benutzernamen und ein Kennwort ein.
Um den Proxy zu entfernen, löschen Sie die URL.
Beachten Sie Folgendes:
- Der Proxy gilt nur, wenn ausgehende Verbindungen zulassen aktiviert sind. Wenn Sie ausgehende Verbindungen deaktivieren, wird der Proxy in Ihren Einstellungen beibehalten, bleibt aber inaktiv.
- Verwenden Sie eine HTTP- oder HTTPS-URL ohne eingebettete Anmeldeinformationen. Geben Sie Anmeldeinformationen in die separaten Felder "Benutzername " und "Kennwort " ein. Verwenden Sie unter Linux anstelle einer nur IPv6-Adresse eine IPv4-Adresse oder einen Hostnamen mit IPv4-Unterstützung.
- Die CLI speichert ein Literalkennwort im Anmeldeinformationsspeicher Ihres Betriebssystems, sofern verfügbar, mit einem lokalen Datei-Fallback. Ihre Einstellungsdatei enthält einen Verweis auf das gespeicherte Secret, nicht das Kennwort.
- Sie können
${VAR}oder$VARals den gesamten Kennwort-Wert eingeben, um stattdessen eine Umgebungsvariable zu verwenden. Die Variable muss für die CLI verfügbar sein. Wenn sie nicht festgelegt ist, wird kein Kennwort angegeben, und ein Proxy, der die Authentifizierung erfordert, kann die Anforderung ablehnen. - Die CLI verbindet sich über einen integrierten lokalen Proxy, der die upstream-Proxyanmeldeinformationen aus sandkastenbasierten untergeordneten Prozessen heraushält. Hostregeln gelten auch, wenn Sie einen Upstreamproxy verwenden.
- Unter macOS und Linux können sandboxierte Programme den Proxy nicht umgehen, indem eine direkte Verbindung hergestellt wird. Unter Windows basiert die Sandbox auf Programmen, die die Proxyeinstellungen berücksichtigen. Windows erfordert auch eine unterstützte Version und Lokales Netzwerk zulassen, wodurch auch der Zugriff auf private Netzwerke erlaubt wird.
- Ihre Organisation kann die Proxy-URL über verwaltete Einstellungen erzwingen. In diesem Fall wird die URL als
(managed)angezeigt, Sie können jedoch weiterhin Ihren eigenen Benutzernamen und Ihr Kennwort angeben.
Schnelles Aktivieren und Deaktivieren der Sandbox
Sie können den Sandkasten ein- oder ausschalten, ohne die vollständige Konfigurationsschnittstelle zu öffnen:
- Enable: Geben Sie
/sandbox enablein der Copilot CLI-Sitzung ein. - Deaktivieren: Geben Sie
/sandbox disablein die Copilot CLI-Sitzung ein.
Normalerweise ändern diese Befehle die gespeicherte Einstellung Sandbox aktivieren. Wenn verwaltete Einstellungen Sandboxing erfordern und eine Umgehung zulassen, wird mit /sandbox disable stattdessen das Sandboxing nur für die aktuelle Sitzung deaktiviert. Wird /sandbox enable ausgeführt, wird es für diese Sitzung wiederhergestellt.
Ihre aktuellen Sandbox-Einstellungen anzeigen
Einstellungen werden in settings.json unter dem sandbox-Schlüssel in Ihrem Konfigurationsverzeichnis Copilot CLI gespeichert. Sandkasteneinstellungen werden in Einstellungsdateien auf Repositoryebene nicht unterstützt. Von Unternehmen verwaltete Einstellungen können Ihre Auswahl einschränken. Weitere Informationen zum Konfigurationsverzeichnis finden Sie unter GitHub Copilot CLI-Konfigurationsverzeichnis.
Sie können Ihre aktuellen Sandkasteneinstellungen innerhalb einer Copilot CLI Sitzung anzeigen.
- Geben Sie
/settingsein. - Drücken Sie / , um nach Einstellungen zu suchen.
- Geben Sie den Typ
sandboxein, um die Liste der Einstellungen zu filtern.
In den obigen Schritten werden Ihre gespeicherten Einstellungen angezeigt. Um die effektive Richtlinie anzuzeigen – die Pfade, Netzwerkeinstellungen und Funktionen, die sich ergeben, sobald Ihre Einstellungen, die automatisch gewährten Berechtigungen und alle verwalteten Richtlinien kombiniert werden – geben Sie die Zeichenfolge /sandbox policyein. Sie können einen Befehl wie /sandbox policy npm install hinzufügen, um den Zugriff auf das Entwicklertool zu überprüfen, ohne ihn auszuführen. Weitere Informationen findest du unter Grundlegendes zu Dateisystemrichtlinien für lokale Sandboxing in GitHub Copilot CLI.