解决问题

第一反射

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 邀请的支持渠道。 在共享前审查输出;诊断日志旨在不包含代码或提示。