Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

Diese Seite beschreibt bekannte Probleme bei der Verwendung von Devin Desktop mit Windows Subsystem for Linux (WSL) sowie die empfohlenen Korrekturen.

​
Leistungsprobleme oder Verbindungsabbrüche (Überlastung des 9P-Dateisystems)

Bei der Verwendung von Devin Desktop in WSL (über Remote - WSL) kann der Editor langsam werden, nicht mehr reagieren oder wiederholt die Verbindung zum WSL-Backend verlieren. Die häufigste Ursache sind Erweiterungen, die das WSL-Dateisystem durch aggressives Überwachen von Dateien und Indizierung stark belasten und dadurch das Plan 9 (9P)-Protokoll auslasten – die Dateisystembrücke zwischen Windows und der WSL-Linux-Umgebung. Das tritt besonders häufig bei großen Repositorys auf und wenn mehrere Language Server gleichzeitig laufen.

​
Symptome

  • Devin Desktop ist bei der Verbindung mit WSL merklich langsam oder reagiert verzögert
  • Der Editor verliert häufig die Verbindung zum WSL-Backend und versucht, sie wiederherzustellen
  • Verbindungsabbrüche treten sowohl während der aktiven Entwicklung (z. B. bei der Verwendung von Cascade) als auch im Leerlauf des Editors auf
  • Devin Desktop stürzt ab oder reagiert nicht mehr, sodass sowohl die IDE als auch WSL neu gestartet werden müssen (wsl --shutdown)
  • Die Speichernutzung von WSL steigt mit der Zeit an, selbst auf Systemen mit 32 GB+ RAM
  • WSL-Diagnoseprotokolle zeigen eine große Anzahl von P9 Reply_Rlerror-Ereignissen (Datei nicht gefunden)
  • Die Leistung ist normal, wenn Devin Desktop außerhalb von WSL verwendet wird (z. B. beim Öffnen eines lokalen Windows-Ordners)
  • Gängige Behelfslösungen (Neustart von WSL, Neuinstallation von Devin Desktop, Erhöhen des Speichers in .wslconfig) beheben das Problem nicht zuverlässig

​
Grundursache

Die Kommunikation zwischen Windows und dem WSL-Linux-Dateisystem erfolgt über das Plan 9 (9P)-Protokoll, das im Vergleich zum nativen Dateisystemzugriff nur einen begrenzten Durchsatz bietet. Wenn Erweiterungen in der WSL-Umgebung installiert sind, überwachen und indexieren manche aggressiv Dateien im gesamten Workspace. In großen Repositorys (z. B. 250.000+ Dateien, 5+ GB) erzeugt das ein enormes Volumen an Dateisystemoperationen über die 9P-Bridge, was zu Folgendem führen kann:
  • Die Kapazität des Protokolls ausreizen
  • Tausende Datei-nicht-gefunden-Fehler (Reply_Rlerror) verursachen
  • Die Verbindung zwischen Devin Desktop und dem WSL-Backend zum Abbruch bringen
  • Mit der Zeit den Speicherdruck innerhalb von WSL erhöhen
Das verschärft sich zusätzlich, wenn mehrere Language Server laufen (z. B. Sorbet, Ruby LSP, TypeScript usw.), da sie weiteren Overhead durch Dateiüberwachung verursachen. Die kombinierte Dateisystemaktivität von Erweiterungen und Language Servern kann die 9P-Bridge selbst auf Systemen mit 32 GB+ RAM überlasten. Ein bekanntes Beispiel ist die Vue (Volar)-Erweiterung, bei der beobachtet wurde, dass sie in WSL-Umgebungen übermäßige Dateiindexierung verursacht, selbst wenn der Workspace keine Vue-Dateien enthält. Dieses Problem ist im VS Code-Ökosystem dokumentiert: microsoft/vscode-remote-release#11091 Das ist besonders wahrscheinlich, wenn Sie eine große Anzahl von Erweiterungen aus VS Code oder einem anderen Editor übernommen haben, die für Ihr aktuelles Projekt nicht benötigt werden.

​
Lösungen

Viele Verbindungsabbrüche und Leistungsprobleme in WSL lassen sich oft schon beheben, indem Sie einfach WSL selbst aktualisieren. Neuere WSL-Versionen enthalten Verbesserungen bei der Stabilität des 9P-Dateisystems und der Zuverlässigkeit von Verbindungen. Öffnen Sie PowerShell (oder die Eingabeaufforderung) auf Ihrem Windows-Host und führen Sie Folgendes aus: 
wsl --update
Starten Sie anschließend WSL neu: 
wsl --shutdown
Öffnen Sie Devin Desktop erneut und stellen Sie die Verbindung zu WSL wieder her. Ihre WSL-Version können Sie mit Folgendem überprüfen: 
wsl --version
WSL ab 2.7.3.0 enthält Korrekturen, die anhaltende Verbindungsabbrüche für Nutzer auch ohne weitere Konfigurationsänderungen beheben.

​
2. Saubere Neuinstallation des Devin Desktop-Servers in WSL

Löschen Sie das Verzeichnis des Devin Desktop-Servers in WSL, damit Devin Desktop es bei der nächsten Verbindung neu installiert: 
rm -rf ~/.windsurf-server
Verbinden Sie dann Devin Desktop erneut mit WSL. Der Server wird automatisch neu installiert.

​
3. Installierte Erweiterungen minimieren (größter Einfluss)

Installieren Sie nur Erweiterungen, die Sie für das Repo, in dem Sie arbeiten, tatsächlich benötigen.
  • Öffnen Sie in Devin Desktop bei bestehender WSL-Verbindung den Bereich „Erweiterungen“
  • Prüfen Sie, welche Erweiterungen in der WSL-Umgebung installiert sind (nicht nur lokal)
  • Deaktivieren oder deinstallieren Sie Erweiterungen, die Sie nicht benötigen – insbesondere solche, die intensive Dateiüberwachung oder Indexierung durchführen
Bekanntermaßen problematische Erweiterungen in WSL:
  • Vue (Volar) — verursacht nachweislich übermäßige Dateiindexierung über die 9P-Bridge, selbst in Nicht-Vue-Projekten. Allein die Deinstallation dieser Erweiterung hat bei mehreren Nutzern Verbindungsabbrüche behoben.
  • Andere frameworkspezifische Spracherweiterungen (Angular, Svelte usw.) können sich ähnlich verhalten, wenn sie installiert sind, aber für den aktuellen Workspace nicht benötigt werden.
Gehen Sie nicht davon aus, dass Erweiterungen, die in einem lokalen Setup (ohne WSL) problemlos funktionieren, sich in WSL genauso verhalten. Die 9P-Dateisystem-Bridge ist der Engpass – Erweiterungen, die lokal unproblematisch sind, können instabil machen, wenn jeder Dateivorgang die Protokollgrenze überschreiten muss. Weniger durch Erweiterungen verursachte Dateisystemaktivität reduziert direkt die Last auf der 9P-Bridge.

​
4. WSL-Ressourcenlimits optimieren

Erstellen oder bearbeiten Sie die Datei %USERPROFILE%\.wslconfig auf Ihrem Windows-Host (z. B. C:\Users\<YourUser>\.wslconfig) und legen Sie Ressourcenlimits fest, die für Ihr System geeignet sind: 
[wsl2]
memory=16GB
swap=4GB
processors=4
autoMemoryReclaim=gradual
Hinweis: Die Einstellung autoMemoryReclaim wurde in WSL 2.7.3.0 und später entfernt. Wenn Sie WSL 2.7.3.0+ verwenden, lassen Sie diese Zeile weg. Sie können Ihre WSL-Version mit wsl --version überprüfen.
Passen Sie die Werte an die auf Ihrem System verfügbaren Ressourcen an. Nachdem Sie die Datei gespeichert haben, starten Sie WSL neu: 
wsl --shutdown
Öffnen Sie dann Devin Desktop erneut und stellen Sie die Verbindung zu WSL wieder her.

​
Fehlerdiagnose

​
WSL-Diagnoseprotokolle auf 9P-Fehler überprüfen

Um zu bestätigen, dass die Ursache in einer 9P-Sättigung liegt, sammeln Sie WSL-Diagnoseprotokolle: 
wsl --debug-shell
Oder erstellen Sie ein vollständiges Diagnosepaket: 
Invoke-WebRequest -UseBasicParsing "https://aka.ms/wsldiag" -OutFile wsldiag.ps1
.\wsldiag.ps1
Achten Sie in den 9P-/Dateisystemprotokollen auf eine hohe Anzahl von Reply_Rlerror-Ereignissen. Tausende oder mehr deuten in der Regel darauf hin, dass Erweiterungen oder Prozesse innerhalb von WSL übermäßig viele Dateisystemanfragen erzeugen, mit denen die 9P-Bridge nicht Schritt halten kann.

​
Wann welche Maßnahme sinnvoll ist

  • WSL zuerst aktualisieren – viele Probleme lassen sich schon durch wsl --update beheben. WSL 2.7.3.0+ enthält erhebliche Stabilitätsverbesserungen. (Einfachste Lösung.)
  • Erweiterungen minimieren, wenn in WSL viele Erweiterungen installiert sind, die Sie nicht aktiv benötigen, oder wenn Sie Erweiterungen aus einem anderen Editor migriert haben. (Änderung mit der größten Wirkung.)
  • Server sauber neu installieren, wenn der Serverstatus von Devin Desktop beschädigt oder veraltet sein könnte (z. B. nach einem fehlgeschlagenen Update oder einem früheren Absturz).
  • .wslconfig optimieren, wenn WSL übermäßig viele Host-Ressourcen verbraucht oder wenn Sie bisher keine Ressourcenlimits konfiguriert haben. (Allgemeine Verbesserung der WSL-Stabilität.)
Für optimale Ergebnisse aktualisieren Sie zuerst WSL und wenden Sie die übrigen Maßnahmen dann bei Bedarf an. Die Kombination aus einer aktuellen WSL-Version, einem sauberen Server, wenigen Erweiterungen und abgestimmten Ressourcenlimits behebt sowohl die Grundursache (9P-Sättigung durch Erweiterungsaktivität) als auch begünstigende Faktoren (Ressourcenerschöpfung).

​
Keine Verbindung zu WSL bei Verwendung von VPN- oder Zero-Trust-Software

Devin Desktop kann keine Verbindung zu WSL herstellen und zeigt den Fehler Couldn't install vscode server on remote server, install script returned non-zero exit status an, wenn VPN- oder Zero-Trust-Software (Twingate, Tailscale, Zscaler, Cloudflare WARP, GlobalProtect usw.) den ausgehenden Netzwerkverkehr innerhalb von WSL blockiert.

​
Symptome

  • Devin Desktop meldet beim Herstellen einer Verbindung mit WSL Error resolving authority / install script returned non-zero exit status
  • WSL selbst funktioniert (wsl -d Ubuntu -- echo hello ist erfolgreich), aber curl läuft innerhalb von WSL in einen Timeout
  • Das Problem trat auf, nachdem VPN- oder Zero-Trust-Software installiert oder aktualisiert wurde

​
Ursache

WSL 2 leitet den Datenverkehr standardmäßig über ein NAT-basiertes virtuelles Netzwerk. VPN- und Zero-Trust-Software leitet den Datenverkehr aus diesem virtuellen Netzwerk häufig nicht weiter, sodass der Download des Devin-Desktop-Servers unbemerkt fehlschlägt.

​
Lösung

​
1. Gespiegeltes Netzwerk aktivieren

Bearbeiten Sie die WSL-Konfigurationsdatei, um gespiegeltes Netzwerk zu aktivieren (normalerweise C:\Users\<YourUser>\.wslconfig). Fügen Sie Folgendes hinzu: 
[wsl2]
networkingMode=mirrored
dnsTunneling=true
autoProxy=true
Starten Sie dann WSL neu und bereinigen Sie alle veralteten Installationsreste: 
wsl --shutdown
wsl -d Ubuntu -- bash -c "rm -f ~/.windsurf-server/.installation_lock"
Öffnen Sie Devin Desktop erneut und verbinden Sie es wieder mit WSL. Der Server wird automatisch installiert.
Hinweis: Erfordert WSL 2.0.0 oder höher. Führen Sie wsl --version aus, um dies zu überprüfen, und wsl --update, um bei Bedarf ein Update durchzuführen.

​
2. Alternative: VPN vorübergehend trennen

Wenn Sie .wslconfig nicht ändern können, trennen Sie vorübergehend die VPN-/ZTNA-Verbindung, lassen Sie Devin Desktop den Server installieren und verbinden Sie sich dann wieder. Für künftige Updates von Devin Desktop ist aus WSL erneut Netzwerkzugriff erforderlich.