config.json

config.json はリレー自身の設定ファイルです。ポート、リレーに接続できる範囲、アクセストークン、ターンが停滞したとみなされるタイミングを決めるタイマー、任意のトンネルとプレビューレーンを保持します。作成するのは oar setup です。セットアップが尋ねない項目は、すべて手で編集します。

Web UI で設定するもののほとんどは、このファイルにはありません。Web UI と環境での設定を参照してください。

ファイルの場所 #

OAR_STATE_ROOT は、グローバルインストールの状態フォルダー全体（設定ファイル、データ、ログ）を移動します。OAR がファイルを置く場所を参照してください。

COPILOT_WEB_RELAY_CONFIG は、場所に関係なくリレーを 1 つのファイルに向けます。ただし、oar 自身のランチャーを使わずにリレーを起動した場合に限ります。つまり node server/server.js、または（ファイルが存在する場合の）oar copilot です。oar setup、oar start、oar restart とサービスは、この変数の値にかかわらず、常にインストール自身の config.json を使います。server/config.json がないチェックアウトでは、oar copilot は代わりに ~/.config/copilot-remote（Windows では %LOCALAPPDATA%\copilot-remote）にファイルを作ります。環境変数を参照してください。

ファイルにはアクセストークンが平文で入っているため、リレーはファイルをオーナーだけが読める状態に保ちます（macOS と Linux ではモード 0600）。ファイルのコピーはパスワードと同じように扱ってください。

書き込むもの #

• oar setup はトークン、localhostOnly、port を書き込み、ほかのキーはすべて見つけたとおりに残します。作成したファイルや、これらのキーがないファイルには、pollIntervalMs、processingTimeoutMs（600000）、conversationSessionMode も書き込みます。oar setup と初回起動を参照してください。
• リレーは、Settings（設定）からプロバイダーの CLI をインストールまたは更新したときに cliBinaries を書き込みます。変更するのはこのキーだけです。ファイルを JSON として読めない場合は書き込みを拒否し、その結び付けは実行中のプロセスの中だけで保持します。
• リレーは、起動時にファイルがなければ作成します。内容は空の authToken、ポート 3333、localhostOnly: true、pollIntervalMs、conversationSessionMode です。古いリリースから残った features キーも削除します（非推奨、無視されるキー、内部用のキーを参照）。
• あなたが、任意のテキストエディターで書き込みます。

手で編集する #

ファイルは 1 つの JSON オブジェクトです。省いたキーは既定値になり、previews のような入れ子のブロックはまとめて 1 つとして読み込まれます。編集したら、リレーを再起動します。リレーがファイルを読み込むのは起動時の 1 回だけです。 ファイルを保存しても、実行中のリレーが保持している内容は何も変わりません。再起動は oar restart（グローバルインストール）か、会話の ⋯ メニューの 🌄 Restart web relay（Web リレーを再起動）で行います。

• 不明なキーは無視され、そのまま残ります。セットアップやリレー自身の書き込みでも残ります。
• 不正な JSON でもリレーは止まりません。Failed to read config.json, using defaults. とログに出し、既定値で動作します。つまりポート 3333、このマシンのみ、起動のたびに新しくなるランダムなトークン（ログに出力）です。ファイルを直すまで、保存したトークンは使えなくなります。もう 1 つの読み取り処理、つまりデータフォルダーを選ぶ処理は、既定のフォルダーに戻ります。リレーは壊れたファイルには触れません。
• 誤った値はキーごとに扱われます。下の既定値は、タイマーや上限の値がないか使えないときにリレーが使う値です。トンネルとプレビューレーンはオフのままになり、理由をログに出します。リレー自体は動作し続けます。
• 1 回の実行に限り、コマンドラインがファイルより優先されます。node server/server.js の --token <value> と --port <number>（oar copilot も渡しますが、oar start は渡しません）は authToken と port を上書きし、ファイルには保存されません。1 ～ 65535 の数値でない --port は、警告を出して無視されます。

ネットワークとアクセス #

最初の接続、トークン、LAN アクセスについては、初回起動を参照してください。

ターンとタイマー #

ターンの最大時間、バックグラウンドタスクのタイムアウト、停滞の監視はここにはありません。ターンが停滞したときを参照してください。

再起動とシャットダウン #

これらのキーは、計画的なリレーの再起動（🌄 Restart web relay）の動作を決めます。再起動と再開を参照してください。各タイマーはミリ秒で指定します。0 以下の値や数値でない値では、既定値が使われます。

メモリ 0.9.19 で追加 #

ワークスペースとデータ #

プロバイダーの CLI #

これらのキーが関係するのは、リレーがインストール済みの Copilot CLI と直接やり取りする場合です。たとえば既存の Copilot セッションの取り込みやモデルの一覧の取得です。検索では Copilot CLI のパッケージキャッシュを探します（COPILOT_PKG_DIR で、最初に探すフォルダーを 1 つ追加できます）。GitHub Copilot を参照してください。

プレビュー #

previews ブロックはプレビューレーンを有効にします。プレビューレーンは専用のポートとホスト名を持つ 2 つ目のリスナーで、ローカルの開発サーバーとフォルダーを公開します。セットアップ、ホスト名、前段のプロキシについては、preview ツールのページにあります。

プレビューが有効なときにこれらのルールのいずれかを満たさないと、リレーは理由とともに PREVIEW LANE disabled とログに出し、レーンをオフのままにして動作を続けます。

次の環境変数は、対応するキーを上書きします。COPILOT_PREVIEWS_ENABLED（1、true、0、false）、COPILOT_PREVIEWS_PORT、COPILOT_PREVIEWS_BIND_HOST、COPILOT_PREVIEWS_PUBLIC_BASE_URL、COPILOT_PREVIEWS_ALLOWED_TARGET_HOSTS（カンマ区切り）です。

トンネル #

ネットワークの外からリレーに到達するためのトンネルは 2 種類あります。互いに独立していて、同時に動かせます。どちらも既定ではオフで、必須の値が欠けている管理対象のトンネルはオフのままになり、理由をログに出します。

sshTunnel #

自分のサーバーへのリバース SSH トンネルです。SSH トンネルを参照してください。

cloudflaredTunnel #

Cloudflare の cloudflared を実行します。これは自分でインストールするもので、OAR には同梱されていません。Cloudflare Tunnel を参照してください。

Web UI と環境での設定 #

Web UI での設定はこのファイルにはありません。 プロバイダーのスイッチとキー、モデルの一覧、ターンの最大時間、バックグラウンドタスクのタイムアウト、機能フラグは、データフォルダーにあるリレーのデータベースに保存されます。ファイルが保持するのは、データベースを開く前にリレーが必要とするもの（データフォルダー、ポート、トークン）と、マシンに関する事実（CLI のパス、トンネル）です。UI がファイルに書き込むのは cliBinaries だけです。0.9.17 で追加 DeepSeek のキーもここにはありません。DeepSeek の API キー、ベース URL、予算は、Settings → Providers → DeepSeek（設定 → プロバイダー → DeepSeek）からデータベースに保存されます。

環境変数。 完全な一覧は環境変数にあります。キーに対応する変数がある場合、変数がファイルより優先されます。該当するのは COPILOT_WEB_RELAY_DATA_DIR（dataDir）、COPILOT_WORKSPACE_ROOT_ALLOW_LIST、COPILOT_CLOUDFLARED_*、COPILOT_PREVIEWS_*（それぞれのセクションに記載）です。COPILOT_TUNNEL_MARKER_HEADERS は例外で、その名前は tunnelMarkerHeaders に追加されます。1 回の実行に限り、--token と --port のオプションがその両方より優先されます。COPILOT_WEB_RELAY_CONFIG 自体については、ファイルの場所で説明しています。

例 #

値はすべて架空のものです。使わないブロックは削除してください。

{
  "authToken": "0f3c1a9e-example-token-do-not-copy",
  "port": 3333,
  "localhostOnly": false,
  "remotePath": "",
  "trustProxy": "loopback",
  "allowedOrigins": [],
  "publicHostnames": ["relay.example.com"],
  "tunnelMarkerHeaders": ["x-edge-request-id"],
  "processingTimeoutMs": 600000,
  "maxRequeueRetries": 5,
  "contextIndicatorMode": "bar",
  "workspaceRootAllowList": ["/home/dev/projects", "/srv/sites"],
  "dataDir": "data",
  "cliBinaries": {
    "claude": "/home/dev/.local/bin/claude",
    "grok": "/home/dev/.grok/bin/grok"
  },
  "restartShutdownTimeoutMs": 45000,
  "restartGracefulTimeoutMs": 8000,
  "restartSpawnTimeoutMs": 18000,
  "restartRebindTimeoutMs": 20000,
  "restartReadyCooldownMs": 1000,
  "restartMaxAttempts": 3,
  "restartRetryBackoffMs": [1000, 3000, 7000],
  "previews": {
    "enabled": true,
    "port": 3334,
    "bindHost": "127.0.0.1",
    "allowPublicBind": false,
    "publicBaseUrl": "https://preview.example.com",
    "allowedTargetHosts": [],
    "maxLive": 8
  },
  "sshTunnel": {
    "mode": "managed",
    "required": false,
    "user": "ubuntu",
    "host": "vps.example.com",
    "remotePort": 4444,
    "remoteBind": "loopback",
    "identityFile": "~/.ssh/id_ed25519"
  },
  "cloudflaredTunnel": {
    "mode": "disabled",
    "token": "",
    "binary": "cloudflared",
    "extraArgs": []
  }
}

非推奨、無視されるキー、内部用のキー #

ファイルにこれらのキーがあっても、残しておいても削除してもかまいません。