語言繁體中文

安裝

網頁應用程序 iPhone, iPad 和 Android

AirCode Ø Web 應用程序是永久的非商店客戶端。 它由您自己的運行實例提供服務,而不是包裝在簽名的下載渠道中,因此它仍然可以獨立於 Google Play, App Store 和 TestFlight。

  1. 啓動一個 AirCode Ø 實例,並給它一個穩定的 HTTPS 地址。 看 快速啓動 遠程訪問
  2. 打開專用的 Web 應用程序設置,輸入 HTTPS 實例來源, 然後選擇 打開安裝頁面。 相同的設置也可在 下載 網站驗證本地值和 永遠不會提交或存儲它。
  3. 登記在本案上。 Chromium 揭示了自己的安裝提示; iPhone 和 iPad 使用引導的 分享 → 添加到 Home Screen 流量。
  4. 打開已安裝的圖標。 啓用 推送通知 僅當您想要時 關閉應用程序警報; iOS 和 iPadOS 提供僅從 Home Screen提供的控制 網站應用程序。

裝置是原始的。 HTTP LAN 地址不是一個完整的移動 PWA 目標,更改 HTTPS 來源需要單獨安裝,可能需要重新驗證。 Web 應用程序通過其服務人員從實例中更新;它不是 APK, IPA或 Store 包。

Web 應用帶有響應式核心工作空間。 當您需要安全的應用內服務器切換、加密的管理離線文件、可靠的邊緣背景任務、本地共享/掃描、觸摸、通知頻道優先級或操作系統深度鏈接時,本地移動仍然是更好的選擇。

Linux 伺服器

只有在版本的資訊清單、檢查碼與簽章檢查全部通過後,才會發佈安裝程式。執行指令之前,請先在下載頁面確認伺服器版本已標示為可用。

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

此指令會安裝最新的 stable 版本。如需改裝測試版或指定版本,請使用下文的安裝程式選項。

安裝者 :

  1. 檢測您的平臺(linux-x64, linux-arm64),
  2. 下載發佈的 tarball 並驗證其 sha256 支票和 Ed25519 簽名,
  3. 安裝到 ~/.aircode/versions/<version> 與 ~/.aircode/current 同步鏈接,
  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 延遲,並打印一個確切的修復命令,如果主機需要管理員批准。 不需要手寫單元文件。

如果此安裝仍然擁有歷史的 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
代理 CLI 安裝和認證與 你的 帳戶;使用 在 Quickstart 中測試的版本 敏感版本 TUI 整合
系統d 需要持久 aircode start;不需要前臺 aircode serve

Node.js 運行時間嵌入式 - 無需系統節點。

Docker

公開映像檔 aircodezero/aircode 執行的是與 install.sh 所安裝內容相同的已發布 Linux 伺服器套件。其中已內建 Node.js、Web 用戶端、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. 選擇使用 Ubuntu 24.04 和 Docker(x86-64)的 VPS。KVM 2(2 vCPU、8 GB 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 Ø 帳戶。伺服器接著會透過 Relay 取得自己的私人 HTTPS 位址:

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

桌面應用程序 (推薦):下載 .dmg 來自於 下載頁面. 它嵌入了完整的服務器(本地會話),並連接到遠程服務器。

無頭 / CLI:同樣的單線器和 Linux 工作在 macOS 13+ (darwin-arm64, darwin-x64) 。 首先通過 Homebrew 安裝 tmux ,然後使用 aircode serve; 持久的 aircode start 目前需要 Linux systemd。

Windows

從 下載頁面安裝桌面應用程序。 局部會話在 Windows 通過 ConPTY內地運行。 安裝程序嵌入服務器及其 Node.js 運行時間,因此不需要 WSL、 Linux 分佈和系統節點安裝。 它還將 aircode 添加到當前用戶的 PATH,允許嵌入式服務器從 PowerShell 或命令提示運行。 安裝後打開新終端,並查看 Windows 命令行參考。 該應用程序還可以連接到遠程 AirCode Ø 服務器。

桌面操作模式

目標 開始 結果
遠程客戶端僅 打開 AirCode Ø 然後選擇 連接到服務器 無需配置本地 電子窗口加載所選的遠程服務器 AirCode Ø
局部客戶端 + 服務器 打開 AirCode Ø,選擇一個項目文件夾,然後選擇 在這個機器上運行 Electron 啓動並管理嵌入式原生服務器,然後加載其工作空間
服務器 運行 aircode serve --projects-root "D:\Projects" 在 PowerShell 或命令指示板中 包裝服務器在沒有電子窗口的情況下在前臺運行

不要使用 --serve啓動桌面可執行:它打開了電子,並且不提供服務器單獨的模式。 使用 aircode 命令,安裝在 PATH 對一個終端僅服務器。

Local 配置後,正常桌面啓動確保嵌入式服務器運行,即使窗口連接到遠程服務器。 桌面管理服務器只聽取 127.0.0.1。 若要從其他設備連接,請使用 遠程訪問 或啓動具有明確私有網絡連接地址的 CLI 服務器。

在 Windows上,關閉每個桌面窗口會讓 AirCode Ø 和其嵌入式服務器在通知區域中運行。 從該圖標中選擇 Quit 以停止嵌入式服務器。 CLI 服務器是一個單獨的過程,可以在不同的端口共存;參見 桌面應用程序共存。

重型可選部件

沒有什麼大東西被暗示下載:

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

Knowledge 仍然是語法,直到您從其設置明確安裝本地嵌入模型。 然後,該模型被驗證並在線使用;索引從不觸發暗示模型下載。