config.json

config.json 是中繼自己的設定檔：它的連接埠、誰可以連到它、存取 token、決定回合何時算是卡住的計時器，以及選用的 tunnel 和預覽通道。oar setup 會建立這個檔案。setup 沒有詢問的項目，都要你手動編輯。

你在網頁介面中設定的大部分內容都不在這個檔案裡。見網頁介面與環境中的設定。

檔案在哪裡 #

OAR_STATE_ROOT 會搬移全域安裝的整個狀態資料夾（設定檔、資料和記錄）；見 OAR 把檔案放在哪裡。

COPILOT_WEB_RELAY_CONFIG 可以讓中繼使用某一個檔案，不論它放在哪裡，但只適用於不透過 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），因為檔案中以明文存放存取 token。請像對待密碼一樣對待它的副本。

由誰寫入 #

• oar setup 會寫入 token、localhostOnly 和 port，其他每個 key 都維持原樣。它建立的檔案，或缺少這些 key 的檔案，還會加上 pollIntervalMs、processingTimeoutMs（600000）和 conversationSessionMode。見 oar setup 和首次執行。
• 中繼在你從 Settings（設定）安裝或更新供應商 CLI 時會寫入 cliBinaries。它只會改動這個 key。如果它無法把檔案讀成 JSON，就會拒絕寫入，只在執行中的處理程序內保留這個綁定。
• 中繼在啟動時若找不到檔案，會建立一個，內容為空的 authToken、連接埠 3333、localhostOnly: true、pollIntervalMs 和 conversationSessionMode。它也會移除舊版本留下的 features key（見已淘汰、被忽略與內部使用的 key）。
• 你，用任何文字編輯器。

手動編輯 #

這個檔案是一個 JSON 物件。你省略的 key 會採用預設值，而像 previews 這樣的巢狀區塊會整個一起讀取。編輯後請重新啟動中繼：中繼只在啟動時讀取一次這個檔案。你儲存檔案時，執行中的中繼所持有的設定都不會改變。用 oar restart（全域安裝）重新啟動，或在對話的 ⋯ 選單中用 🌄 Restart web relay（重新啟動網頁中繼）。

• 不認得的 key 會被忽略並保留。setup 和中繼自己的寫入都會把它留在原處。
• 無效的 JSON 不會讓中繼停止。中繼會記錄 Failed to read config.json, using defaults.，並以預設值執行：連接埠 3333、僅限本機，以及每次啟動都會重新產生並印在記錄中的隨機 token。在你修好檔案之前，你儲存的 token 都無法使用。第二個讀取者——選擇資料目錄的那一個——會退回預設資料夾。中繼不會動到損壞的檔案。
• 錯誤的值會逐個 key 處理。下方的預設值，就是計時器或上限缺少或無法使用時中繼採用的值。tunnel 和預覽通道會保持關閉並記錄原因；中繼本身會繼續執行。
• 命令列優先於檔案，僅限該次執行：node server/server.js 上的 --token <value> 和 --port <number>（oar copilot 也會傳入；oar start 不會）會覆寫 authToken 和 port，而且絕不會存入檔案。不是 1 到 65535 之間數字的 --port 會被忽略並發出警告。

網路與存取 #

關於第一次連線、token 和區域網路存取，見首次執行。

回合與計時器 #

回合最長時間、背景任務逾時和停滯監看不在這裡：見回合卡住時。

重新啟動與關閉 #

這些 key 決定中繼計畫性重新啟動（🌄 Restart web relay）的行為。見重新啟動與繼續。每個計時器都以毫秒為單位；0 或更小的值，或不是數字的值，會使用預設值。

記憶體 0.9.19 新增 #

Workspace 與資料 #

供應商 CLI #

這些 key 在中繼自己和已安裝的 Copilot CLI 溝通時才有作用，例如匯入現有的 Copilot session 和列出模型。搜尋會查看 Copilot CLI 的套件快取（COPILOT_PKG_DIR 會加入一個優先搜尋的資料夾）。見 GitHub Copilot。

預覽 #

previews 區塊會啟用預覽通道：使用自己的連接埠和主機名稱的第二個監聽器，用來發布本機的 dev server 和資料夾。設定、主機名稱和前端 proxy 寫在 preview 工具的頁面上。

預覽開啟時，如果其中一條規則不成立，中繼會記錄 PREVIEW LANE disabled 和原因，讓通道保持關閉，並繼續執行。

下列環境變數會覆寫對應的 key：COPILOT_PREVIEWS_ENABLED（1、true、0、false）、COPILOT_PREVIEWS_PORT、COPILOT_PREVIEWS_BIND_HOST、COPILOT_PREVIEWS_PUBLIC_BASE_URL 和 COPILOT_PREVIEWS_ALLOWED_TARGET_HOSTS（以逗號分隔）。

Tunnel #

有兩種 tunnel 可以從你的網路外部連到中繼。它們彼此獨立，可以同時執行。兩者預設都是關閉的，而缺少必要值的受管理 tunnel 會保持關閉並記錄原因。

sshTunnel #

連到你自己伺服器的反向 SSH tunnel。見 SSH tunnel。

cloudflaredTunnel #

執行 Cloudflare 的 cloudflared，需要你自己安裝；OAR 不附帶。見 Cloudflare Tunnel。

網頁介面與環境中的設定 #

網頁介面中的設定不在這個檔案裡。供應商開關和金鑰、模型清單、回合最長時間、背景任務逾時和功能旗標都存放在中繼的資料庫中，位於資料目錄內。這個檔案存放的是中繼在資料庫開啟之前就需要的東西（資料目錄、連接埠、token），以及關於這台機器的資訊（CLI 路徑、tunnel）。介面寫進這個檔案的唯一項目是 cliBinaries。0.9.17 新增 DeepSeek 在這裡也沒有 key：它的 API 金鑰、基礎 URL 和預算都是從 Settings → Providers → DeepSeek（設定 → 供應商 → DeepSeek）存進資料庫。

環境變數。完整清單在環境變數頁面。某個 key 有對應的變數時，變數優先於檔案：COPILOT_WEB_RELAY_DATA_DIR（dataDir）、COPILOT_WORKSPACE_ROOT_ALLOW_LIST、COPILOT_CLOUDFLARED_* 和 COPILOT_PREVIEWS_*（列在各自的章節中）。COPILOT_TUNNEL_MARKER_HEADERS 是例外：它的名稱會加到 tunnelMarkerHeaders 上。--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": []
  }
}

已淘汰、被忽略與內部使用的 key #

如果你在檔案中看到其中任何一個，可以保留，也可以刪除：