Устранение неполадок

Первые рефлексы

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 для адресов, связанных; убедитесь, что телефон находится на той же сети /VPN. Удаленный доступ.

Порт уже используется. AirCode Ø автоматически сканирует из 7860, если вы не закрепили порт явно — закрепленный занятый порт является ошибкой по дизайну. Отключите его или освободите.

Инстанция перезапускается после сбоя, но не до тех пор, пока я не войду в систему после перезагрузки. aircode inspect сообщает Boot: after-login , когда устройство включено, но система d не доступна. Запустите точную команду, напечатанную 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) и перезагрузите. Инсталлятор и врач перечисляют точно то, чего не хватает.

Двигатель не обнаруживается. 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 или настройте другой фиксированный порт, а затем перезапустите AirCode Ø перед запуском нового работника.

Мой VPN не несет трафика агентов. Docker egress использует мост/NAT трафик, который некоторые VPN-сервисы с разделенным туннелем исключают. Добавьте подсеть Docker к политике VPN/firewall. Управляемый тоннель AirCode Ø является входящим контрольно-плановым доступом, а не выходящим рабочим VPN.

Dev сервер начинается с Docker не является достижимым. Порты работников не публикуются в текущем просмотре. Автентифицированная переправка через AirCode Ø и маршрут Hetzner является плановым увеличением сетевой активности.

Update говорит, что моя версия слишком старая. Очень старые установки должны быть переустановлены через однослойную программу вместо обновления на месте — сообщение прямо так говорит.

Установка выглядит поврежденной. aircode doctor packaging pinpoints altered files; re-run the installer to repair (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 линий журнала, а затем воспользуйтесь каналами поддержки, поставляемыми с вашим бета-приглашением. Проверьте выход, прежде чем поделиться им; диагностические журналы предназначены для того, чтобы не содержать код или просьбы.