Docker サンドボックス
プレビュー: Claude Code, Codex, Grok Build , Kimi Code セッションが利用可能 オイ Linux そして macOS. ローカル実行は引き続き利用可能であり、デフォルトは保持されます。 監査されたサイクルは、このプレビュー中に既存のローカルランタイムを保持します。
AirCode Ø は、コンピュータまたはサーバー上でコントロール フロントを保持します。 Docker サンドボックス を選択すると、直接エージェントのセッションだけを短期労働者コンテナに移動します。 これは、バイパス権限付きの開発用に設計されています:エージェントは、選択したクローンプロジェクトに書き込むことができ、ホームディレクトリの残りの部分や Docker ソケットを受け取ることなく。
Web / Desktop / mobile
↓
AirCode Ø API + auth + tunnel (host)
↓
Local tmux / Windows ConPTY OR one Docker worker per session
これは実行オプションであり、第二次コンテナ化 AirCode Ø インストールではありません。 認証、セッションの状態、通知、WebSockets、リモートアクセス、UIがホストに留まります。
選択肢が表示される場所
- Web: 新しいセッション → 実行環境
- デスクトップ: 同一のランチャー、なぜならデスクトップはウェブワークベンチを埋め込んでいるからです。
- ネイティブモバイル: 新セッション → 実行環境, persisted per 保存されたサーバー接続
- API:
POST /api/sessions受け入れるexecutionMode: "local" | "docker".
セッションの詳細は、効果的な環境とイメージを示します。 サーバーはデーモン、イメージ、エンジンを検証します; 決して静かにローカルに戻りません。
今日のソースプレビューを使用する
Docker エンジンまたは Docker デスクトップが実行されている必要があります。
git clone https://github.com/spartaquant/aircode.git
cd aircode
npm run docker:runtime:build
npm run docker:runtime:check
npm run docker:session:smoke
AirCode Øを再起動し、セッションを作成し、 Docker サンドボックス を 実行環境で選択します。 Docker または画像が利用できない場合、ランチャーは正確な理由を表示し、ローカルに戻らない。
この最初のビルドの後、チェックアウトは、そのホストと同様に画像を保持します: アップデートが最新の Claude Code, Codex, Grok Build または Kimi Code バージョンをピンしたり、別のパッケージ CLIを有効にすると、 AirCode Ø は aircode-session-runtime:local をバックグラウンドで再構築し、新しい Docker セッションは現在のバージョンとエンジンリストを使用します。
画像のタグは aircode-session-runtime:localです。 タグ付き製品リリースは linux/amd64 と linux/arm64の両方を構築し、検証し、不変な Docker Hub バージョンタグを公開し、署名された AirCode Ø リリース宣言にそのディジェストを記録します。 Docker ワークフローは、 preview チャンネルのみを公開します。 公開レポジトリおよびリリース認証は設定されますが、タグは最初の成功したリリース後のみ引き出せるようになります。
公開タグが利用可能である場合、 AirCode Ø 再構築は必要ありません。
AIRCODE_DOCKER_IMAGE=aircodezero/session-runtime:<version> aircode
労働者がアクセスできるもの
AirCode Ø は、リポジトリを画像にコピーしません。 それは、すでにクローンされたプロジェクトを と同じ絶対的なパス に作業員の内部に組み込む。 したがって、エディットは実際のチェックアウトに着陸し、コンテナが外出した後に残ります。
| マウント | アクセス | なぜ |
|---|---|---|
| 選択されたプロジェクト | 読み書き | コード、ファイル、および Git チェックアウト |
| 選択されたエンジンプロフィール | 読み書き | 認証、履歴およびネイティブ レポート |
セッションごとに /home/aircode |
読み書き | プライベート 仮設住宅 |
/run/aircode スタート契約 |
読書のみ | コマンドと初期プロンプト |
/tmp |
In-memory read-writing | 臨時ファイル |
It does ノー あなたのホームディレクトリを完全に取得し、The Docker ソケットまたはホスト Linux 能力の ルートファイルシステムは読み取りのみで、 AirCode Ø は PID、メモリ、 CPU コントロールを適用します。
AirCode Øのループバック API はプライベートです。 安定した、機能保護のコントロールポートは、デスクトップサーバーが再起動した後も、作業員自身の完成ハックのみを受け入れます。
エンジンプロフィールには認証が含まれており、プレビューで読み書きが共有されます。 コンテナ隔離は、無関係のホストファイルを保護し、エンジン認証をエンジンや同じコンテナユーザーとして実行されている悪意のあるコードに読み取れないようにします。
セッション中に起こること
- クライアントはホストからランタイムカタログを読み取ります。
- ホストは Docker、画像契約と選択したエンジンを検証します。
- AirCode Ø は、ラベル付きの 1 人の労働者と、機能範囲のコールバック URLを作成します。
- 作業員は、組み立てられたプロジェクトで tmux を開始します。
- 既存の端末 WebSocket は tmux セッションを Docker経由でドライブします。
- 通常の出力または Kill セッションは、作業員を削除しますが、プロジェクトの変更を残します。 とエンジン履歴をホスト上で表示します。
- AirCode Ø が再起動すると、作業員を再発見し、完了を復元します。 コールバック
VPN Dev-Server トラフィック
コンテナエグレードは通常、 Dockerのホストルーティングと NAT のルールに従います。 ホスト VPN は、 VPN が Docker ブリッジ トラフィックを含む場合にのみそれを持ち込む。 管理されたHetzner/AirCode Ø トンネルは、 AirCode Ø コントロールフロントへの入力のためであり、自動的に労働者エグレードをルーティングしません。
| トラフィック | ルート |
|---|---|
| 携帯電話/ブラウザ → AirCode Ø | LAN, VPN or Hetzner tunnel → ホスト |
| ターミナル → 作業員 | ホスト → Docker API → 作業員 tmux |
| エージェント API/Git トラフィック | Docker ブリッジ/NAT → ホスト VPN ポリシー → インターネット |
| Worker 完成ハック | worker → protected host callback port |
Workers Port はまだ公開されていません。 AirCode Ø や Hetzner ルートを介して認証された開発者サーバーのリダイレクトは、次なるネットワーク増加です。 ローカル AirCode Ø セッションと既存のリモート アクセスは、変更なく動作します。
プレビュー制限
- Claude Code, Codex, Grok Build and Kimi Code are packaged and available for 通常の Docker セッション まだ欠けている、読めない、または時代遅れのバージョン は、打ち上げ前に閉じられた。
- Direct セッションがカバーされています。 監査されたサイクルは、ローカル実行を使用し続けます。
- Linux ホストと macOS ホストをターゲットにします。 Windows Desktop keeps native ConPTY Local デスクトップは、 セッション; Docker パスセマンティクスはまだ証明されていません。
- ホストブラウザ機能と外部トークン最適化ウォレッパーは使用できません。 はまだ労働者に注入されています。
設定
| 環境変数 | config.json |
デフォルト | 目的 |
|---|---|---|---|
AIRCODE_DEFAULT_EXECUTION_MODE |
defaultExecutionMode |
local |
デフォルト・ラウザー環境 |
AIRCODE_DOCKER_ENABLED |
dockerEnabled |
true |
Docker 機能スイッチ |
AIRCODE_DOCKER_BIN |
dockerBin |
docker |
Docker CLI |
AIRCODE_DOCKER_IMAGE |
dockerImage |
aircode-session-runtime:local |
ワーカー画像 |
AIRCODE_DOCKER_NETWORK |
dockerNetwork |
aircode-runtime |
専用ブリッジ |
AIRCODE_DOCKER_CONTROL_PORT |
dockerControlPort |
AirCode Ø ポート + 1000 | Capability-scoped ハック ブリッジ |
AIRCODE_DOCKER_ENGINES |
dockerEngines |
claude,codex,grok,kimi |
Fallback ordinary-session engine list for legacy/custom images. フォールバック フォールバック |
AIRCODE_DOCKER_PIDS_LIMIT |
dockerPidsLimit |
512 |
Per-worker PID limit |
AIRCODE_DOCKER_MEMORY |
dockerMemory |
8g |
Per-Worker Memory Limits メモリ |
AIRCODE_DOCKER_CPUS |
dockerCpus |
オフセット | オプション CPU 制限 |
従業員が動いている間、コールバックポートを安定的に保つ。 トラブルシューティング を参照し、ランタイムエラーコードを参照してください。
Docker デモンは、信頼できるホストコンポーネントです。 このデーモンをコントロールする人は誰でも、コンテナの隔離を回避することができます。