配置 · r3

绝大多数工作流开箱即用，无需配置

r3 默认运行在回环地址上，并要求登录。首次使用时，运行 r3 open 让当前浏览器登录；之后即可打开普通的 Artifact 链接。你可以直接在工作区中自定义字号、颜色主题和语法高亮样式。

在设置 → 语言中选择英语或简体中文。该偏好会保存在你的浏览器中。

若要查看当前设置，请在终端中运行 r3 config show。

核心配置项

配置项	控制内容
`backendUrl`	CLI 和智能体连接的后端端点。
`publicUrl`	服务器对浏览器公开的地址；配置外部主机名时必须保持登录开启。
`allowedHosts`	额外允许访问的主机名；包含任何外部主机名时必须保持登录开启。
`trustedProxies`	受信任、可提供客户端地址的代理连接 IP；配置代理时必须保持登录开启。
`requireLogin`	默认要求浏览器和 API 身份验证；只有仅供本机访问且未配置受信任代理时，才允许设置为 `false`。
`archiveTtlDays`	已归档Artifact符合清理条件的最短保留时长（默认：30 天）。
`authTokenIdleDays`	浏览器登录令牌在闲置多久后过期（默认：14 天）。
`projectGrouping`	自动 Git 远程检测（`remote`）或显式项目指定（`manual`）。

服务器级别的更改必须在主机上执行，并通过运行 r3 server restart 生效。（在 CLI 中更新 backendUrl 会立即生效）。

默认要求登录。r3 config set requireLogin false 只允许为仅供本机访问的服务器关闭登录：监听地址必须是回环地址，publicUrl 和 allowedHosts 必须仅包含回环地址，且不能配置 trustedProxies。r3 会拒绝保存不符合条件的配置，也不会以这样的配置启动。r3 config unset requireLogin 恢复登录要求。如果设置了 R3_REQUIRE_LOGIN，它会优先于保存的配置，并遵守相同限制。

关闭登录后，任何能连接到回环端口的程序或本机账号都能访问整个工作区；服务器会拒绝代理转发的请求，也不会创建登录令牌或 API 密钥，因此不会因关闭登录而签发持续有效的凭据。Host/origin 检查和预览隔离仍然生效。无论使用哪种模式，发布返回的 URL 都不包含会过期的登录码。远程 CLI 后端始终需要通过 r3 login 授权，详见本地与远程访问。