ЯзыкРусский

Установка

Веб-приложение для iPhone, iPad и Android

Веб-приложение AirCode Ø является постоянным клиентом без магазина. Он обслуживается вашим собственным текущим экземпляром, не упакованным в подписанный канал загрузки, поэтому он остается доступным независимо от Google Play, App Store и TestFlight.

  1. Запустите инстанцию AirCode Ø и дайте ей стабильный адрес HTTPS . это Quickstart и Remote Access.
  2. Откройте для себя посвященный Web App настройтеВойдите в HTTPS по происхождению объекта, и выберите Откройте страницу установки. Такая же схема доступна и для Скачать. Веб-сайт проверяет ценность локально и никогда не отправляет или не хранит его.
  3. Подпишитесь на инстанцию. Chromium раскрывает свой собственный инсталляционный призыв; iPhone и iPad использует управляемую Share → Добавить в Home Screen потока.
  4. Запустите установленную икону. Включить Подавать уведомления только при желании закрытое приложение предупреждения; iOS и iPadOS предлагают этот контроль только с Home Screen веб-приложение.

Инсталляция является оригинальной. Адрес HTTP LAN не является полной целевой мобильной PWA , и изменение происхождения HTTPS требует отдельной установки и может потребовать повторной аутентификации. Веб-приложение обновляется с инстанции через своего сервисного работника; это не APK, IPAили пакет Store.

Веб-приложение несет в себе адаптивное ядро рабочего пространства. Native mobile остается лучшим выбором, когда вам нужно безопасное переключение серверов в приложении, зашифрованные управляемые оффлайн файлы, надежные ограниченные задачи на фоне, native sharing/scanning, хаптики, приоритет уведомления-канала или глубокие ссылки на операционную систему.

Сервер Linux

Установщик публикуется только после того, как манифест выпуска, контрольные суммы и проверки подписи пройдены. Перед запуском команды убедитесь, что серверная сборка отмечена как доступная на странице загрузок.

curl -fsSL https://dl.aircodezero.com/install.sh | bash

Эта команда устанавливает последний выпуск stable. Параметры установщика ниже позволяют вместо этого выбрать бета-версию или конкретную версию.

Для инсталлятора :

  1. обнаруживает вашу платформу (linux-x64, linux-arm64),
  2. загружает тарбол выпуска и проверяет его sha256 чек суммы и Ed25519 Подпись,
  3. установка на ~/.aircode/versions/<version> с помощью ~/.aircode/current symlink,
  4. Ссылка aircode на ~/.local/bin
  5. проверяет системные зависимости (git, tmux) и говорит вам, что именно нужно делать установить, если что-то не хватает.

Нет корней нужны. Все живет в вашем домашнем каталоге. Повторное запуск инсталлятора исправляет или обновляет установку. Если ~/.local/bin не находится в текущей оболочке PATH, в окончательных инструкциях используется путь ~/.aircode/current/bin/aircode , который можно выполнить сразу, а также показан дополнительный экспорт PATH .

Затем запустить инстанцию из каталога, который должен содержать выбранные проекты:

cd /srv/workspaces
aircode start

На Linux aircode start создает конфигурацию, охваченную маршрутом, выбирает свободный порт, генерирует и печатает пароль доступа, запускает пользовательскую службу systemd и обеспечивает восстановление после сбоев и перезагрузок. Он также пытается включить systemd linger и печатает одну точную команду по ремонту, если хост требует одобрения администратора. Не требуется ручной письменный файл единицы.

Если эта установка все еще владеет историческим устройством aircode.service , то первый aircode start безопасно удаляет это устройство перед созданием сервиса, предназначенного для маршрута, поэтому оба сервера не могут конкурировать за один и тот же порт. Единицы, принадлежащие другому кассету или установке, никогда не изменяются.

Параметры установщика: --channel beta (канал по умолчанию — stable), --version x.y.z и --no-modify-path. Исторический вариант --service остается совместимым со старым блоком единой инстанции; новые установки должны использовать aircode start.

Системные требования

Требования Заметки
Linux x64 / arm64 Ubuntu 22.04+, Debian 12+, Fedora (недавнее) — glibc
git, tmux sudo apt-get install -y git tmux
Агент CLIs Установлена и аутентифицирована с Твой счетов; используйте Тестовые версии в Quickstart Для чувствительных версий TUI интеграции
системд требуется для постоянного aircode start; не требуется для фронтового aircode serve

Время запуска Node.js встроено — не требуется системный узел.

Docker

Публичный образ aircodezero/aircode запускает тот же опубликованный серверный пакет для Linux, который устанавливает install.sh. Node.js, веб-клиент, Claude Code, Codex, Grok Build и Kimi Code уже входят в состав образа. Он публикуется для linux/amd64 и linux/arm64 с тегами stable и beta, а также с тегами точных версий, например 0.1.30.

Запустите его на любом хосте Docker одной командой:

docker run -d --name aircode --restart unless-stopped --stop-timeout 30 -p 7860:7860 -v aircode-home:/home/aircode aircodezero/aircode:stable

Docker Compose

Сайт предоставляет готовый к использованию файл compose.yaml. Сохраните его в отдельном каталоге и запустите оттуда:

curl -fsSLO https://aircodezero.com/docker/compose.yaml
docker compose up -d

Развернуть на Hostinger

Развернуть на Hostinger Пошаговое развёртывание подготавливает доступ браузера и открывает Hostinger.

  1. Выберите VPS с Ubuntu 24.04 и Docker (x86-64). KVM 2 (2 vCPU, 8 ГБ RAM) подходит для небольшого теста. Проверьте цену и продление перед оплатой.
  2. Docker Manager открывает подготовленную конфигурацию. Выберите Deploy, затем HTTPS-ссылку Open проекта.
  3. Продолжите в исходном браузере, подтвердите адрес экземпляра и выберите пароль. Сохраните данные сайта до завершения настройки.

Первый доступ

Эти шаги относятся к ручному запуску Docker (docker run или переносимый Compose). Для Hostinger используйте настройку HTTPS выше.

Откройте http://<server-address>:7860. При первом запуске контейнер один раз выводит в своём журнале сгенерированный пароль:

docker logs aircode

Чтобы задать пароль самостоятельно, установите переменную окружения AIRCODE_AUTH_PASSWORD при создании контейнера. Позже пароль можно изменить в настройках приложения.

Частный адрес HTTPS

В AirCode Ø откройте Настройки → Удаленный доступ к серверу и выберите Войти в систему, чтобы подключить свою учётную запись AirCode Ø. После этого сервер получает свой частный адрес HTTPS через Relay:

https://<name>.tunnel.aircodezero.com

Подключение к Relay только исходящее, поэтому открывать порт не нужно. Подробнее см. Удаленный доступ.

Данные и обновления

Проекты, входы в учётные записи провайдеров, диалоги и настройки хранятся в томе aircode-home. Удаление тома удаляет и их.

Чтобы обновить сервер, загрузите новый образ и пересоздайте контейнер. С Docker Compose выполните эту команду рядом с compose.yaml:

docker compose pull && docker compose up -d

С docker run загрузите образ, остановите и удалите контейнер, затем снова выполните ту же команду docker run:

docker pull aircodezero/aircode:stable
docker stop aircode && docker rm aircode

Контейнер никогда не запускает версию старше той, которую его том уже запускал. Если серверный процесс внутри контейнера останавливается, контейнер перезапускает его, и сессии агентов переживают этот перезапуск.

macOS

Desktop app (рекомендуется): скачать .dmg с страницы Скачать страницу. Он встраивает полный сервер (локальные сессии) и также подключается к удаленным серверам.

Без головы / CLI: тот же однолинер, как Linux работает на macOS 13+ (darwin-arm64, darwin-x64). Сначала установите tmux через Homebrew, а затем используйте aircode serve; постоянный aircode start в настоящее время требует Linux systemd.

Windows

Установите настольное приложение с страницы загрузки Скачать страницу. Локальные сессии выполняются на Windows через ConPTY. Инсталлятор встраивает сервер и его время запуска Node.js , поэтому WSL, распределение Linux и установка системного узла не требуются. Он также добавляет aircode к текущему пользователю PATH, позволяя встроенному серверу запускаться с PowerShell или Command Prompt. Откройте новый терминал после установки и см. Windows командный ряд ссылка. Приложение также может подключаться к удаленным серверам AirCode Ø .

Десктопные режимы работы

Цель Начало Результат
только удаленный клиент Откройте AirCode Ø и выберите Подключитесь к серверу без настройки локального Окно Electron загружает выбранный удаленный сервер AirCode Ø
Локальный клиент + сервер Откройте AirCode Ø, выберите папку проектов, а затем выберите Запустить на этой машине Electron запускает и управляет встроенным сервером, а затем загружает его рабочее пространство
только сервер Запустить aircode serve --projects-root "D:\Projects" в PowerShell или Command Prompt Объединенный сервер работает на переднем плане без электронного окна

Не запускайте рабочий стол с --serve: он открывает Electron и не обеспечивает режим только для серверов. Используйте команду aircode , установленную в PATH для сервера, предназначенного только для терминалов.

После того, как Local будет настроен, нормальное запуск рабочего стола гарантирует, что встроенный сервер работает, даже если окно подключено к удаленному серверу. На рабочем столе управляемый сервер прослушивает только 127.0.0.1. Чтобы подключиться с другого устройства, используйте Remote Access или запустите сервер CLI с явным адресом частной сети.

На Windows закрытие каждого окна рабочего стола оставляет AirCode Ø и его встроенный сервер, работающий в области уведомлений. Выберите Quit из этой иконы, чтобы остановить встроенный сервер. Сервер CLI является отдельным процессом и может сосуществовать на другом порту; см. Сосуществование приложений для рабочего стола.

Тяжелые дополнительные компоненты

Ничто большое не загружается подразумеваемым образом:

aircode browser install   # pinned Chromium for the agent browser
aircode doctor browser    # verify it

Knowledge остается лексическим, пока вы не установите модель локальных встраиваний из ее настроек. Затем модель проверяется и используется вне сети; индексация никогда не запускает косвенную загрузку модели.