TIP

**推荐做法：**首次使用先运行 rabetbase config init，按 Prompt 选择官方国家/地区。只有企业独立部署或需要覆盖单个服务时，才修改 .rabetbase.json 中的 Domain。

本文只讲 Rabetbase CLI 的连接配置：如何通过交互式 config init 选择中国大陆或印度尼西亚节点，以及如何手工修改 .rabetbase.json 支持企业独立部署。

首次初始化：跟随 Prompt 选择节点

在任意目录执行：

rabetbase config init

CLI 会显示 Select Lovrabet region，使用方向键选择：

• Mainland China (cn)：中国大陆节点，也是默认选项。
• Indonesia (id)：印度尼西亚节点。

确认后，CLI 将连接配置写入全局文件 ~/.rabetbase.json。它只更新 region 和 Domain 路由，不会清除 Cookie、输出格式或应用绑定。

选择	配置文件结果	说明
中国大陆 cn	通常不保存 region	cn 是默认值。省略字段可以保持旧配置兼容，也减少不必要配置。
印度尼西亚 id	"region": "id"	CLI 根据 id 选择整套 *.lovrabet.id 官方地址。

自动化或脚本调用

不需要 Prompt 时直接传入参数：

rabetbase config init --region cn
rabetbase config init --region id

目前新初始化只允许 cn 和 id。历史值 global 仅保留读取兼容，不会出现在 Prompt 中。

配置文件在哪里

作用域	文件	用途
全局配置	~/.rabetbase.json	本机默认的国家/地区、Domain、认证和输出偏好。config init 写这里。
项目配置	项目根目录/.rabetbase.json	只影响当前项目；同名字段覆盖全局配置。

Rabetbase CLI 只读取 .rabetbase.json，不会读取 Lovrabet Runtime CLI 的 .lovrabet.json。手工修改时必须使用合法 JSON：字段名和字符串使用双引号，不能写注释或尾随逗号。

直接修改 JSON 选择官方节点

中国大陆是默认值，最简配置可以完全不写 region：

{
  "accessKey": "<redacted>"
}

印度尼西亚节点：

{
  "region": "id",
  "accessKey": "<redacted>"
}

region 会一次解析六个官方地址：userDomain、apiDomain、runtimeDomain、skillDomain、kbDomain 和 appDomain。用户只需要选择国家/地区，不需要理解内部地址映射。

企业独立部署：配置 Domain

企业部署可以只覆盖实际独立部署的服务，也可以配置完整的六个 Domain。正式字段如下：

字段	负责的请求
userDomain	浏览器登录和用户会话服务
apiDomain	主要研发态 API：应用、数据集、页面、SQL、BFF 和管理能力
runtimeDomain	研发流程调用的运行态数据、SQL 执行和 BFF 相关能力
skillDomain	SkillHub 独立路由；当前 Rabetbase CLI 的主要研发命令暂不依赖它
kbDomain	研发态知识库接口；未单独配置时跟随显式 apiDomain
appDomain	工作台、编辑器和页面链接；这是前端站点地址，不是后端 API

完整独立部署示例

{
  "userDomain": "https://user.example.com",
  "apiDomain": "https://api.example.com",
  "runtimeDomain": "https://runtime.example.com",
  "skillDomain": "https://skills.example.com",
  "kbDomain": "https://kb.example.com",
  "appDomain": "https://app.example.com"
}

只覆盖部分服务

例如企业只独立部署研发态 API 和 Runtime，可以在配置中写：

{
  "apiDomain": "https://api.example.com",
  "runtimeDomain": "https://runtime.example.com"
}

此时 kbDomain 会跟随显式 apiDomain。未配置的 userDomain、skillDomain 和 appDomain 继续使用当前 region 的官方地址。

保留官方节点，只覆盖一个服务

手工编辑 JSON 时，可以同时保留 region 并覆盖某个 Domain：

{
  "region": "id",
  "kbDomain": "https://kb.customer.example.com"
}

这表示除知识库外，其余服务仍使用印度尼西亚节点。该混合方式适合逐步独立部署。

通过 Domain JSON 导入

部署程序也可以生成独立文件，再一次导入：

rabetbase config init --domain-config ./rabetbase-domains.json

使用 --domain-config 时，CLI 切换为独立部署模式：清除原来的 region 和旧 Domain 字段，再写入文件中的正式 Domain。不要同时传 --region，两种模式互斥。

INFO

自定义 Domain 必须是可信的 HTTPS origin，例如 https://api.example.com。不能包含路径、查询参数、账号密码或业务路由。CLI 会把认证信息发送到对应服务。

修改后的验证方法

1. 保存 .rabetbase.json。
2. 运行 rabetbase doctor。
3. 核对输出中的国家/地区和六个最终 Domain。
4. 再执行一个只读命令验证目标服务；不要直接用写命令试连接。

常见问题

为什么执行 config init --region cn 后看不到 region？
因为 cn 是默认值，CLI 会删除冗余字段，这是向前兼容设计。

为什么项目里修改 Domain 后全局配置没有变化？
项目级 .rabetbase.json 只覆盖当前项目。要修改本机默认值，请编辑 ~/.rabetbase.json，或使用带 --global 的配置写命令。

可以给不同项目使用不同企业环境吗？
可以。把各环境 Domain 写入对应项目的 .rabetbase.json。项目字段会覆盖全局默认值。

旧的 agentDomain 或 platformDomain 还能写吗？
它们只用于历史读取兼容。新配置只使用本文列出的六个正式字段，不要新旧字段混写。

---

适用版本：按 2026-08-22 Rabetbase CLI main 分支核对。