解決問題

第一反射

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

常見案例

我錯過了密碼. 運行 aircode password reset [instance]. 持久的 Linux 實例會自動重新啓動新的密碼。

該 URL 沒有從我的手機上加載。 服務器將連接 Tailscale或本地主機默認。 檢查 aircode status 對接地址; 確保手機在同一個 tailnet/VPN。 查看 遠程訪問。

端口已經在使用中. AirCode Ø 自動掃描從 7860 開始,除非您明確插入端口 - 插入的繁忙端口是設計錯誤。 解開它或釋放它。

發生故障後,該實例重新啓動,但直到我重新啓動後登錄。 aircode inspect 報告 Boot: after-login 當單位已啟用,但 systemd linger 不可用時。 運行由 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 表示需要登錄 授權 Unix 用戶一次使用 aircode login,用 aircode whoami驗證並重新啓動 aircode start <instance> --relay managed。 管理的 Relay 還需要一個非空實例密碼。

tmux 或 git 缺失. 安裝它們(sudo apt-get install -y git tmux)並重新運行。 安裝器和醫生列出缺少的東西。

發動機未被檢測到. 必須爲運行 AirCode Ø的相同用戶安裝和驗證 CLI。 嘗試運行 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 或配置另一個固定端口,然後在啓動新工人之前重新啓動 AirCode Ø 。

我的 VPN 不會攜帶代理流量。 Docker egress 使用橋樑/NAT 流量,有些分裂隧道 VPN 排除。 將 Docker 子網添加到 VPN/firewall 策略中。 管理的 AirCode Ø 隧道是入口控制機接入,而不是外出工人 VPN。

Dev 服務器開始在 Docker 是無法達到的。 工人端口不會在當前預覽中發佈。 通過 AirCode Ø 和 Hetzner 路線進行認證的轉發是計劃的網絡增量。

更新表示我的版本太舊了 非常舊的安裝必須通過單線器重新安裝,而不是在現場更新 - 消息明確表示。

安裝顯示破壞了。 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 個日誌行,然後使用帶有 beta 邀請的支持渠道。 在共享前審查輸出;診斷日誌旨在不包含代碼或提示。