トラブルシューティング
初回反射
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
一般的なケース
パスワードを紛失しました Run aircode password reset [instance] 持続的な Linux インスタンスは、新しいパスワードで自動的に再起動します。
** URL は私の携帯電話からロードされません。** サーバーはデフォルトで Tailscale-or-localhost を結び付けています。 aircode status を確認し、電話は同じ tailnet/VPNにあります。 Remote Accessを参照してください。
ポートはすでに使用中です。 AirCode Ø は、明示的にポートを固定していない限り、7860 から自動スキャンします。 解放するか、解放するか。
インスタンスは、クラッシュ後に再起動しますが、再起動後にログインするまでではありません。 aircode inspect レポート Boot: after-login ユニットが有効であるが、systemd ランガーが利用できない場合。 aircode startで印刷された正確なコマンドを実行し、通常 sudo loginctl enable-linger $USERで印刷し、 loginctl show-user $USER --property=Linger が Linger=yesをレポートすることを確認します。
サービスは再起動ループにあります。 チェック aircode logs <instance> まずは instance config に接続されたポートは現在占有され、プロジェクト ルートはもはや存在しないか、必要なシステム依存性が利用できない場合があります。 報告された原因を修正し、 aircode restart <instance>を実行します。
ルート選択は曖昧です。 いくつかの名前が付いているインスタンスは、同じパスを使用します。 aircode ps -a を実行し、ユニークな名前または短い IDをターゲットにします。
Managed Relay says login is required. aircode loginで 1 回 Unix ユーザを許可し、 aircode whoamiで検証し、 aircode start <instance> --relay managedを再起動します。 Managed Relay には、空のインスタンスのパスワードが必要です。
tmux あるいは git 欠落 インストール(sudo apt-get install -y git tmux)を再開する。 インストーラーと医師は、欠けているものを正確にリストします。
エンジンが検出されていない 同一のユーザで CLI をインストールし、 AirCode Øを実行するために認証する必要があります。 claude (または codex、 …) を最初にそのユーザーとしてシェルで実行してみてください。
Docker サンドボックスは利用できません。 ラウザーは権威的な理由を示します。 Dockerを起動し、現在のソースのプレビューのために npm run docker:runtime:build を実行するか、既存の設定された公開画像を引っ張る。 npm run docker:runtime:checkで確認します。
DOCKER_ENGINE_UNAVAILABLE. この画像は有効ですが、そのエンジンは通常のセッションエンジンリストで有効ではありません。 標準画像は Claude Code, Codex, Grok Build と Kimi Code を有効にします; 現行画像を再構築または引っ張り、有効なエンジンを選択するか、セッションをローカルに切り替える。
DOCKER_CONTROL_UNAVAILABLE 従業員のコールバックブリッジは、安定したポートを結びつけることができませんでした。 AIRCODE_DOCKER_CONTROL_PORT を無料で使用するか、別の固定ポートを設定し、新しい worker を起動する前に AirCode Ø を再起動します。
My VPN はエージェントトラフィックを運ぶものではありません。 Docker egress はブリッジ/NAT トラフィックを使用し、いくつかのスピリット トンネル VPN はそれを排除します。 Docker サブネットを VPN/firewall ポリシーに追加します。 管理された AirCode Ø トンネルは、出入りコントロール フラット アクセスであり、出入り労働者 VPNではありません。
Dev サーバーが始まりました。 Docker 達成できない。 ワーカーポートは、現在のプレビューでは公開されません。 AirCode Ø や Hetzner ルートを介して認証されたリダイレクトは、計画されたネットワーク拡張です。
Update は、私のバージョンが古すぎると言います。 非常に古いインストールは、現地で更新する代わりに、1 つのラインを介して再インストールする必要があります。
インストールが腐敗しているように見えます。 aircode doctor packaging 修理のためのファイルを再起動し、修理のためのインストーラを再起動する(curl -fsSL …/install.sh | bash -s -- --channel beta). コンフィギュレーション、セッション、およびデータは、バージョンディレクトリの外に存在します。
古いインストールは、制限モードまたはライセンスを言及します。 現在の AirCode Ø リリースは、完全な無料の自己管理モデルを使用し、製品キーまたは試用が欠落しているか、または有効期限が切れたため、リリースを制限することはありません。 更新または現在の署名されたチャンネルから再インストールします; aircode license status は、遺伝記録診断としてのみ残ります。
まだ閉じ込められているか?
aircode ps -a --json、 aircode inspect <instance> --json、 aircode doctor packaging --json、および最後の100のログラインをグラブし、ベータ招待状に付属するサポートチャンネルを使用します。 出力を共有する前に、出力をレビューする; 診断ログはコードやプロンプトを含まないように設計されています。