安裝
網頁應用程序 iPhone, iPad 和 Android
AirCode Ø Web 應用程序是永久的非商店客戶端。 它由您自己的運行實例提供服務,而不是包裝在簽名的下載渠道中,因此它仍然可以獨立於 Google Play, App Store 和 TestFlight。
- 啓動一個 AirCode Ø 實例,並給它一個穩定的 HTTPS 地址。 看 快速啓動 遠程訪問
- 打開專用的 Web 應用程序設置,輸入 HTTPS 實例來源, 然後選擇 打開安裝頁面。 相同的設置也可在 下載 網站驗證本地值和 永遠不會提交或存儲它。
- 登記在本案上。 Chromium 揭示了自己的安裝提示; iPhone 和 iPad 使用引導的 分享 → 添加到 Home Screen 流量。
- 打開已安裝的圖標。 啓用 推送通知 僅當您想要時 關閉應用程序警報; iOS 和 iPadOS 提供僅從 Home Screen提供的控制 網站應用程序。
裝置是原始的。 HTTP LAN 地址不是一個完整的移動 PWA 目標,更改 HTTPS 來源需要單獨安裝,可能需要重新驗證。 Web 應用程序通過其服務人員從實例中更新;它不是 APK, IPA或 Store 包。
Web 應用帶有響應式核心工作空間。 當您需要安全的應用內服務器切換、加密的管理離線文件、可靠的邊緣背景任務、本地共享/掃描、觸摸、通知頻道優先級或操作系統深度鏈接時,本地移動仍然是更好的選擇。
Linux 伺服器
只有在版本的資訊清單、檢查碼與簽章檢查全部通過後,才會發佈安裝程式。執行指令之前,請先在下載頁面確認伺服器版本已標示為可用。
curl -fsSL https://dl.aircodezero.com/install.sh | bash
此指令會安裝最新的 stable 版本。如需改裝測試版或指定版本,請使用下文的安裝程式選項。
安裝者 :
- 檢測您的平臺(
linux-x64,linux-arm64), - 下載發佈的 tarball 並驗證其 sha256 支票和 Ed25519 簽名,
- 安裝到
~/.aircode/versions/<version>與~/.aircode/current同步鏈接, aircode連接到~/.local/bin,- 檢查系統依賴(
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。
- 選擇使用 Ubuntu 24.04 和 Docker(x86-64)的 VPS。KVM 2(2 vCPU、8 GB 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 Ø 帳戶。伺服器接著會透過 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 仍然是語法,直到您從其設置明確安裝本地嵌入模型。 然後,該模型被驗證並在線使用;索引從不觸發暗示模型下載。