# 配置

几个你可能会想要修改的设置。

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

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` 授权，详见[本地与远程访问](http://r3.hyperlogue.tech/zh-cn/docs/access/)。

有关远程服务器托管和多设备设置，请参阅[本地与远程访问](http://r3.hyperlogue.tech/zh-cn/docs/access/)。