config.json

config.json 是中继自己的配置文件：其中有它的端口、谁可以访问它、访问令牌、决定一轮何时算作卡住的计时器，以及可选的隧道和预览通道。oar 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），因为它以明文保存访问令牌。请像对待密码一样对待它的副本。

谁写入它 #

• oar setup 写入令牌、localhostOnly 和 port，其他每个键都保持原样。它创建的文件，或缺少以下键的文件，还会得到 pollIntervalMs、processingTimeoutMs（600000）和 conversationSessionMode。见 oar setup 和首次运行。
• 中继在你从 Settings（设置）安装或更新提供商 CLI 时写入 cliBinaries。它只更改这一个键。如果它无法把文件读取为 JSON，它会拒绝写入，并只为正在运行的进程保留该绑定。
• 中继在启动时若不存在该文件，会创建它，其中有空的 authToken、端口 3333、localhostOnly: true、pollIntervalMs 和 conversationSessionMode。它还会删除旧版本遗留的 features 键（见已弃用、被忽略和内部使用的键）。
• 你，用任意文本编辑器。

手动编辑 #

该文件是一个 JSON 对象。你省略的键取其默认值，而 previews 这样的嵌套块会作为一个整体读取。编辑后，重启中继：中继只在启动时读取一次该文件。 你保存文件时，正在运行的中继所持有的任何内容都不会改变。用 oar restart（全局安装）重启，或用对话 ⋯ 菜单中的 🌄 Restart web relay（重启网页中继）重启。

• 未知的键会被忽略并保留。设置向导和中继自己的写入都会把它留在原处。
• 无效的 JSON 不会让中继停止。它会记录 Failed to read config.json, using defaults.，并以默认值运行：端口 3333、仅本机，以及一个随机令牌，每次启动都是新的，并打印在日志中。在你修好文件之前，你保存的令牌不再有效。第二个读取者，即选择数据文件夹的那一个，会退回到默认文件夹。中继不会动这个损坏的文件。
• 错误的值按键逐个处理。下文的默认值是计时器或限制缺失或无法使用时中继所用的值。隧道和预览通道会保持关闭并记录原因；中继本身继续运行。
• 命令行在一次运行中优先于文件：node server/server.js 上的 --token <value> 和 --port <number>（oar copilot 也会传递它们；oar start 不会）会覆盖 authToken 和 port，并且永远不会保存到文件中。不是 1 到 65535 之间数字的 --port 会被忽略并给出警告。

网络与访问 #

关于首次连接、令牌和局域网访问，见首次运行。

轮次与计时器 #

单轮最长时长、后台任务超时和停滞监视不在这里：见一轮卡住时。

重启与关闭 #

这些键决定中继计划重启（🌄 Restart web relay）的方式。见重启与恢复。每个计时器的单位都是毫秒；0 或更小的值，或不是数字的值，使用默认值。

内存 0.9.19 新增 #

工作区与数据 #

提供商 CLI #

这些键在中继自己与已安装的 Copilot CLI 通信时起作用，例如导入已有的 Copilot 会话和列出模型。搜索会查找 Copilot CLI 的包缓存（COPILOT_PKG_DIR 会添加一个优先搜索的文件夹）。见 GitHub Copilot。

预览 #

previews 块会开启预览通道：一个使用自己端口和主机名的第二个监听器，用于发布本地开发服务器和文件夹。设置、主机名和前端代理见 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（逗号分隔）。

隧道 #

有两种隧道可以从你的网络之外访问中继。它们相互独立，可以同时运行。两者默认都关闭，缺少必填值的托管隧道会保持关闭并记录原因。

sshTunnel #

通往你自己服务器的反向 SSH 隧道。见 SSH 隧道。

cloudflaredTunnel #

运行 Cloudflare 的 cloudflared，由你自己安装；OAR 不附带它。见 Cloudflare Tunnel。

网页界面中的设置与环境变量 #

网页界面中的设置不在这个文件中。 提供商开关和密钥、模型列表、单轮最长时长、后台任务超时和功能开关都保存在中继的数据库中，位于数据文件夹内。这个文件保存的是中继在数据库打开之前就需要的内容（数据文件夹、端口、令牌），以及关于这台机器的信息（CLI 路径、隧道）。界面写入这个文件的唯一内容是 cliBinaries。0.9.17 新增 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 中。--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": []
  }
}

已弃用、被忽略和内部使用的键 #

如果你在文件中发现其中某个键，可以保留它，也可以删除它：