Fehlerbehebung

Erste Reflexen

aircode ps -a               # every path-scoped instance and its boot state
aircode inspect [instance]  # root, port, auth, Relay, service and state paths
aircode logs [instance] --follow
aircode doctor packaging    # install integrity: checksums, runtime, symlink
aircode doctor browser      # agent browser stack
aircode doctor tokens       # token-optimization stack

Häufige Fälle

Ich habe das Passwort verloren. Run aircode password reset [instance]. Eine anhaltende Linux -Instanz startet automatisch mit dem neuen Passwort neu.

Die URL lädt nicht von meinem Telefon. Der Server bindet Tailscale-or-localhost standardmäßig. Überprüfen Sie aircode status für die gebundene Adresse; stellen Sie sicher, dass das Telefon auf dem gleichen Tailnet/VPNist. Siehe Fernzugriff.

Port bereits in Gebrauch. AirCode Ø scannt automatisch von 7860 aus, es sei denn, Sie haben einen Port explizit geklebt – ein geklebter, beschäftigter Port ist ein Entwurfsfehler. Entfernen oder befreien Sie es.

Die Instanz startet nach einem Absturz neu, aber nicht, bis ich mich nach dem Neustart anmelde. aircode inspect meldet Boot: after-login , wenn die Einheit aktiviert ist, aber systemd Linger nicht verfügbar ist. Führen Sie den exakten Befehl aus, der von aircode start, normalerweise sudo loginctl enable-linger $USER, gedruckt wurde, und bestätigen Sie dann, dass loginctl show-user $USER --property=Linger Berichte Linger=yesliefert.

Der Dienst befindet sich in einer Neustartschleife. aircode logs <instance> zuerst überprüfen. Ein Port, der in der Instance-Config-Instanz angebunden ist, kann jetzt besetzt sein, eine Projektwurzel kann nicht mehr existieren oder eine erforderliche Systemabhängigkeit kann nicht verfügbar sein. Beheben Sie die gemeldete Ursache und führen Sie aircode restart <instance>aus.

Ein Wurzel-Selektor ist zweideutig. Mehrere benannte Instanzen verwenden den gleichen Pfad. Führen Sie aircode ps -a aus und zielen Sie auf den einzigartigen Namen oder kurz ID.

Managed Relay sagt, dass ein Login erforderlich ist. Autorisieren Sie den Unix-Benutzer einmal mit aircode login, überprüfen Sie mit aircode whoamiund führen Sie aircode start <instance> --relay managederneut aus. Managed Relay erfordert auch ein nicht leeres Instances-Passwort.

tmux oder git fehlt. Installieren Sie sie (sudo apt-get install -y git tmux) und führen Sie sie erneut aus. Der Installer und der Arzt listet genau, was fehlt.

Ein Motor wird nicht erkannt. Die CLIs müssen für den gleichen Benutzer installiert und authentifiziert werden, der AirCode Ø ausführt. Versuchen Sie, claude (oder codex, …) in einer Schale als dieser Benutzer zuerst auszuführen.

Docker Sandbox ist nicht verfügbar. Der Launcher zeigt den autoritativen Grund. Starten Sie Docker, und führen Sie dann npm run docker:runtime:build für die aktuelle Quellvorsicht aus oder ziehen Sie das konfigurierte öffentliche Bild, sobald es existiert. Bestätigen Sie mit npm run docker:runtime:check.

DOCKER_ENGINE_UNAVAILABLE. Das Bild ist gültig, aber dieser Motor ist in seiner Liste der normalen Sitzungs-Engine nicht aktiviert. Das Standardbild ermöglicht Claude Code, Codex, Grok Build und Kimi Code; rekonstruieren oder ziehen Sie das aktuelle Bild, wählen Sie eine Engine, die es aktiviert, oder wechseln Sie die Sitzung auf Lokal.

DOCKER_CONTROL_UNAVAILABLE. Die Callback-Brücke des Arbeitnehmers konnte ihren stabilen Port nicht binden. Freien Sie AIRCODE_DOCKER_CONTROL_PORT oder konfigurieren Sie einen anderen festen Port, und starten Sie AirCode Ø erneut, bevor Sie einen neuen Arbeiter starten.

Mein VPN trägt keinen Agentenverkehr. Docker egress verwendet Bridge/NAT -Verkehr, den einige Split-Tunnel-VPNs ausschließen. Fügen Sie das Docker -Unternetz zu der VPN/Firewall-Richtlinie hinzu. Der verwaltete AirCode Ø -Tunnel ist ein Inbound-Control-Plane-Zugriff, kein Ausgangsarbeiter VPN.

Ein Dev-Server begann in Docker ist nicht erreichbar. Worker-Ports werden in der aktuellen Vorschau nicht veröffentlicht. Authentifizierte Weiterleitung über AirCode Ø und die Hetzner-Route ist ein geplantes Netzwerk-Increment.

Update sagt, dass meine Version zu alt ist. Sehr alte Installationen müssen über den One-Liner neu installiert werden, anstatt sie vor Ort zu aktualisieren – die Nachricht sagt es explizit.

Die Installation sieht beschädigt aus. aircode doctor packaging pinpoints veränderte Dateien; führen Sie den Installer erneut aus, um es zu reparieren (curl -fsSL …/install.sh | bash -s -- --channel beta). Ihre Konfiguration, Sitzungen und Daten bleiben unberührt – sie leben außerhalb des Versionsverzeichnisses.

Eine alte Installation erwähnt einen eingeschränkten Modus oder eine Lizenz. Aktuelle AirCode Ø -Releases verwenden das vollständige kostenlose selbstverwaltete Modell und beschränken niemals Launchs, weil ein Produktschlüssel oder eine Testversion fehlt oder abgelaufen ist. Aktualisieren oder neu installieren aus dem aktuellen unterzeichneten Kanal; aircode license status bleibt nur als Diagnose von veralteten Datensätzen.

Noch stecken?

Erfassen Sie aircode ps -a --json, aircode inspect <instance> --json, aircode doctor packaging --jsonund die letzten 100 Log-Linien, und verwenden Sie dann den Support-Kanal, der mit Ihrer Beta-Einladung geliefert wurde. Überprüfen Sie die Ausgabe, bevor Sie sie teilen; Diagnose-Logs sind so konzipiert, dass sie keinen Code oder Anweisungen enthalten.