言語日本語
言語を選択公共サイトに適用される
EnglishFrançaisFrenchDeutschGermanעבריתHebrewРусскийRussian日本語JapaneseالعربيةArabic简体中文Chinese (Simplified)繁體中文Chinese (Traditional)

Windows コマンドライン

AirCode Ø Windows セットアップでは、PowerShell と Command Prompt の aircode コマンドがインストールされます。 デスクトップアプリケーションに既に組み込まれた Node.js ランタイムと ConPTY サポートを使用します; WSL とシステム Node.js のインストールは不要です。

の新しいターミナル を開いて AirCode Ø をインストールまたは更新した後、更新されたユーザー PATHを受け取るように、コマンドを確認します:

aircode version
aircode serve --help

インストーラは、独自のインストールディレクトリに関連するコマンドを解決するので、インストール中にカスタムディレクトリを選択することはサポートされます。

デスクトップ実行可能またはサーバーコマンド?

もしあなたが… 使用方法
Electron ウィンドウをローカルまたはリモート サーバーに接続する AirCode Ø デスクトップアプリを開く
Embedded Local Server を実行し、Electron から使用する デスクトップアプリを開いて、選択してください。 この機械で走る
Electron ウィンドウなしでサーバーを実行する ターミナルを開いて aircode serve を実行します。

デスクトップ実行可能なデスクトップは、サポートされている --serve 入力ポイントではありません: 常に Electron を開きます。 aircode コマンドは、デスクトップ アプリケーションでインストールされたランタイムとサーバーパイロードを使用しますが、別々のフロントプロセスを開始します。 Desktop operating modes を参照して、完全なライフサイクル概要を参照してください。

サーバーの起動

serve はデフォルトコマンドなので、以下のフォームは同等です。

aircode serve --projects-root "D:\Projects"
aircode --projects-root "D:\Projects"

サーバーは最前線で動作し、その端末にログを書きます。 Ctrl+C を押して、清潔に停止します。 各プロジェクトのルートは、独自の孤立したランタイム状態とセッションネームスペースを取得します。 他のルートが既に好ましいポートを使用している場合、 AirCode Ø は次の利用可能なポートを自動的に選択します。

サービスオプション

オプション デフォルト 目的および同等の設定
--projects-root <dir> 現在のディレクトリ AirCode Ø がプロジェクトとして提示するサブフォルダーのルート。 ディレクターはすでに存在するはずです。 ENV : AIRCODE_PROJECTS_ROOT; JSON: projectsRoot
--host <address> Tailscale IP、その他 127.0.0.1 サーバーが HTTP を聴くネットワーク インターフェイス。 ENV : AIRCODE_HOST; JSON: host
--port <number> 7860 HTTP ポート 1 から 65535 まで。 明示的に忙しいポートは、静かに変更する代わりに失敗します。 ENV : AIRCODE_PORT; JSON: port
--public-url <url> なし 公共 HTTP A)ベース URL リンクや通知で使用する。 ENV : AIRCODE_PUBLIC_URL; JSON: publicUrl
--config <file> ユーザ設定ファイル JSON 設定ファイルを変換します。 タグ: AIRCODE_CONFIG
--state-dir <dir> ユーザー ステータス ディレクトリ ランタイム状態ディレクトリの代替 タグ: AIRCODE_STATE_DIR
--password <value> 生成または構成 このプロセスのパスワードをアクセスします。 シェル履歴と潜在的にプロセス検査で快適だが見える。 ENV : AIRCODE_AUTH_PASSWORD; JSON: authPassword
--password-file <file> なし プライベート ファイルからアクセス パスワードを読み取る
--no-password オフ 明示的に認証を無効にし、意図的に信頼されているインターフェイスでのみ使用する
-h, --help — サーバーを起動せずにコマンドヘルプを表示する

標準の Windows 設定ファイルは %USERPROFILE%\.config\aircode\config.jsonであり、 %USERPROFILE%\.local\state\aircode\instancesの下の root 特定のディレクトリへのランタイム状態のデフォルトです。

スペースを含むパスは引用する必要があります。 --option value と --option=value の両方を受け入れます。 コマンド ライン オプションは、 config.jsonを優先する環境変数に優先され、その後デフォルトが設定されます。

AirCode Ø は最初にパスワードを生成し、選択した構成ファイルに保存し、一度印刷します。 --password は、完全なコマンド ライン プロビジョニングが必要な場合に利用できますが、その値はプロセス検査およびシェル 履歴を通じて明らかにできます。 --password-file、保護された設定ファイル、または安全に提供された AIRCODE_AUTH_PASSWORDを好む。 auth を無効にするには、 --no-passwordで明示的に使用する必要があります。

サンプル

複数の根を同時に

最初のルートで1つのターミナルを開く:

cd "$HOME\Desktop"
aircode

その後、別のルートで別のターミナルを開きます:

cd "$HOME\Documents"
aircode

Tailscale が 100.84.12.30 をコンピュータに割り当てた場合、この 2 つのバナーは http://100.84.12.30:7860 と http://100.84.12.30:7861をレポートできます。 インスタンスは、ランタイム状態やセッションを共有しません。 既にアクティブなルートから aircode を再起動すると、複製を開始する代わりに既存の URL を報告します。

ローカルマシンのみ

aircode serve `
  --projects-root "D:\Projects" `
  --host 127.0.0.1 `
  --port 7860

オープン http://127.0.0.1:7860

Tailscale または個人 VPN

Windows マシンに割り当てられた正確な VPN アドレスを結び付けます。

aircode serve `
  --projects-root "D:\Projects" `
  --host 100.84.12.30 `
  --port 7860

同じプライベートネットワーク上の他のデバイスでは、 http://100.84.12.30:7860を開くことができます。 正確な VPN アドレスを 0.0.0.0に優先します。

ローカルネットワーク

aircode serve `
  --projects-root "D:\Projects" `
  --host 192.168.1.25 `
  --port 7860

Windows ファイアウォールは、接続を許可するかどうかを尋ねる場合があります。 使用する予定のネットワークプロファイルのみを許可します。

逆プロキシまたはトンネル URL

aircode serve `
  --projects-root "D:\Projects" `
  --host 127.0.0.1 `
  --port 7860 `
  --public-url "https://aircode.example.com"

--public-url は AirCode Ø に、生成されたリンクにどのアドレスを配置するかを示します。 **** は、ファイアウォールポートを開いて、逆プロキシを起動したり、トンネルを作成したりしない。 Remote Access を使用して、内蔵の出入りトンネル、 Tailscale、またはプライベート ネットワーク ガイダンスを使用します。

別々の設定と状態

aircode serve `
  --projects-root "D:\Projects" `
  --config "D:\AirCodeData\config.json" `
  --state-dir "D:\AirCodeData\state"

別のターミナルがこのインスタンスに対してライフサイクルコマンドを実行する必要がある場合は、同じ状態ディレクトリを最初に設定します。

$env:AIRCODE_STATE_DIR = "D:\AirCodeData\state"
aircode status
aircode stop

デスクトップアプリの共存

フロントフォードの CLI サーバーと、デスクトップ ウィンドウによって管理されるローカル サーバーは、別々のプロセスです。 aircode status と aircode stop は、前面の CLI サーバーのみをターゲットにし、デスクトップ管理サーバーをレポートまたは制御しません。 同じホストとポートを再度使用する前に、そのウィンドウを閉じることだけではなく、通知領域アイコンから AirCode Ø を削除します。 代わりに、 CLI サーバーに別のポートを与えます。

ターミナルから開始すると、 AirCode Ø ウェブアプリケーションとその認証された APIが表示されます。 プロジェクトディレクトリを公開ファイル共有に変換しない:ファイルアクセスは projectsRoot のプロジェクトに分割され、サーバーによって実行されます。

追加設定

エージェントを実行可能なパス、セッション制限、ブラウザ制御、知識、オーケストラ、通知、トークン最適化は、環境変数と config.jsonを通じて利用可能である。 Configuration を参照して、完全な構成優先度と一般的な設定を参照してください。