配置

對於受管理的實例,優先級是 環境變量 → instance config → global user config → default。 aircode start 選項在服務啓動之前仍然存在於實例配置中。預覽 aircode serve 選項僅覆蓋該過程的環境。

全球文件爲 ~/.config/aircode/config.json。管理的實例文件在 ~/.config/aircode/instances/<id>.json中生存;它們不被放置在項目目錄中。祕密文件使用模式 0600。原始 Windows 前臺選項列在 Windows CLI 參考中。

每例啓動配置

aircode start --projects-root /srv/workspaces --host 127.0.0.1 --port 7860 \
  --password-file ~/.config/aircode/workspaces-password

專用旗幟覆蓋了根,名稱,主機,端口,公共 URL,每個密碼輸入模式,以及 Relay。任何附加的方案支持的值可以繼續使用可重複的 --set key=value;值使用 JSON 當有效時:

aircode start --set maxSessions=64
aircode start --set workflows.maxConcurrent=2
aircode start --set 'browserAllowedHosts=["docs.example.com","*.internal.test"]'

使用 --json 進行無人監督的配置。它的輸出永遠不會揭示現有的密碼;它只有在這個召喚產生密碼時才包含密碼。

常見設置

機械	config.json	默認	用途
`AIRCODE_HOST`	`host`	Tailscale IP其他 `127.0.0.1`	連接地址(默認情況下從未 `0.0.0.0` )
`AIRCODE_PORT`	`port`	`7860` (自動掃描新實例)	端口。持久或明確設置的繁忙端口失敗,而不是移動
`AIRCODE_AUTH_PASSWORD`	`authPassword`	生成	訪問密碼。空字符串禁用 auth (dev only)
`AIRCODE_PROJECTS_ROOT`	`projectsRoot`	發射 cwd	目錄,其子文件夾是可選擇的項目
`AIRCODE_MAX_SESSIONS`	`maxSessions`	`64`	同步會話艙
`AIRCODE_SESSION_IDLE_TTL_MS`	`sessionIdleTtlMs`	`21600000`	Hibernate 完成了 6 個空閒小時後的會話; `0` 也禁用了容量排放
`AIRCODE_DEFAULT_PERMISSION_MODE`	`defaultPermissionMode`	`bypass`	默認代理權限模式
`AIRCODE_DEFAULT_EXECUTION_MODE`	`defaultExecutionMode`	`local`	默認會話環境(`local` 或 `docker`)
`AIRCODE_DOCKER_ENABLED`	`dockerEnabled`	`true`	曝光可選的 Docker 執行後端
`AIRCODE_DOCKER_IMAGE`	`dockerImage`	`aircode-session-runtime:local`	可選 Docker 工人圖像
`AIRCODE_DOCKER_NETWORK`	`dockerNetwork`	`aircode-runtime`	專用工人橋
`AIRCODE_DOCKER_CONTROL_PORT`	`dockerControlPort`	AirCode Ø 端口 + 1000	穩定的能力範圍的工人回調
—	`updateChannel`	`stable`	發佈頻道(`stable` / `beta`)

會話冬眠只停止分離的運行時間,其最後一輪具有持久的完成標記和可重複的轉錄。正在工作、等待輸入、遠程控制或由工作流所有的會話仍在運行。在會話上, AirCode Ø 即刻冬眠最古老的符合條件的運行時間。對話仍然留在歷史中,並恢復正常。

引擎二進制(claudeBin, codexBin, …)和每個特徵設置(瀏覽器,知識,管絃,代幣優化)在產品設置中被記錄,並接受相同的 env / 文件優先級。

請參見 Docker 沙盒有關工人限制、網絡和完整的 Docker 配置。

文件和目錄

路徑	內容
`~/.aircode/versions/<v>`	產品(不變,支票)
`~/.aircode/current`	symlink 到活躍版本
`~/.config/aircode/config.json`	全球用戶默認
`~/.config/aircode/instances/<id>.json`	每次實例配置,包括其密碼(0600)
`~/.config/aircode/providers.env`	提供商憑證由 Unix 用戶共享(0600)
`~/.config/systemd/user/aircode@.service`	每個受管理實例的一個生成的 systemd 模板
`~/.local/state/aircode/instances/<id>/`	孤立的運行時間、隧道和會話狀態
`~/.local/state/aircode/relay-account.json`	管理的 Relay 帳戶憑證由 Unix 用戶共享 (0600)

更新永遠不會觸摸 instance config 或狀態。

多個實例

加拿大根決定了默認身份。不同的根自然產生不同的實例。對於一個根,不同的明確端口創建或重複使用獨立的自動命名的實例,而不是更改和重新啓動默認的實例。 --name 提供一個穩定的角色導向身份,當你想要一個。每個實例都會收到自己的端口、密碼/無密碼策略、 tmux 名稱空間、狀態和隧道身份。

aircode start --projects-root /srv/acme --port 7860 --generate-password
aircode start --projects-root /srv/acme --port 7861 --no-password --relay private
aircode start --projects-root /srv/acme --name demo --port 7862 --generate-password
aircode ps -a

若要更改現有實例的端口,請以名稱或 ID明確選擇該實例。一個新的端口的根式命令故意被視爲一個新的實例,因此它不能默默地將當前服務器脫機。

生命週期命令接受名稱,完整或簡短的 ID, Canonical 根,或當前目錄。根選擇器在使用多個命名實例時故意被拒絕爲模糊;選擇名稱或 ID。

多用戶機器

每個操作系統用戶擁有單獨的註冊表、全球默認、提供商憑證、管理的 Relay 授權和一組 systemd 用戶服務。在該用戶內部,每個路徑範圍的實例仍然有自己的端口,密碼,狀態和會話。 aircode start 創建並啓用正確的模板實例;舊的 aircode service install 命令僅用於兼容性。

免費產品訪問

自動管理產品不需要產品密鑰、激活、卡片或試用。它仍然可以完全在線使用,並且在舊許可證或試用記錄到期時不會限制會話啓動。

aircode license 命令只保留,以便歷史安裝可以檢查或刪除舊記錄。這些記錄不會改變當前的產品訪問。有關託管 Relay 和 Marketplace 操作的單獨帳戶要求，請參閱下載。