Установка
Веб-приложение для iPhone, iPad и Android
Веб-приложение AirCode Ø является постоянным клиентом без магазина. Он обслуживается вашим собственным текущим экземпляром, не упакованным в подписанный канал загрузки, поэтому он остается доступным независимо от Google Play, App Store и TestFlight.
- Запустите инстанцию AirCode Ø и дайте ей стабильный адрес HTTPS . это Quickstart и Remote Access.
- Откройте для себя посвященный Web App настройтеВойдите в HTTPS по происхождению объекта, и выберите Откройте страницу установки. Такая же схема доступна и для Скачать. Веб-сайт проверяет ценность локально и никогда не отправляет или не хранит его.
- Подпишитесь на инстанцию. Chromium раскрывает свой собственный инсталляционный призыв; iPhone и iPad использует управляемую Share → Добавить в Home Screen потока.
- Запустите установленную икону. Включить Подавать уведомления только при желании закрытое приложение предупреждения; 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. Параметры установщика ниже позволяют вместо этого выбрать бета-версию или конкретную версию.
Для инсталлятора :
- обнаруживает вашу платформу (
linux-x64,linux-arm64), - загружает тарбол выпуска и проверяет его sha256 чек суммы и Ed25519 Подпись,
- установка на
~/.aircode/versions/<version>с помощью~/.aircode/currentsymlink, - Ссылка
aircodeна~/.local/bin - проверяет системные зависимости (
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.
- Выберите VPS с Ubuntu 24.04 и Docker (x86-64). KVM 2 (2 vCPU, 8 ГБ RAM) подходит для небольшого теста. Проверьте цену и продление перед оплатой.
- Docker Manager открывает подготовленную конфигурацию. Выберите Deploy, затем HTTPS-ссылку Open проекта.
- Продолжите в исходном браузере, подтвердите адрес экземпляра и выберите пароль. Сохраните данные сайта до завершения настройки.
Первый доступ
Эти шаги относятся к ручному запуску 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 остается лексическим, пока вы не установите модель локальных встраиваний из ее настроек. Затем модель проверяется и используется вне сети; индексация никогда не запускает косвенную загрузку модели.