Skip to main content
配置与安全

VPC 使用

配置 Qoder CLI CN 通过组织专属 VPC endpoint 访问服务。

VPC 模式仅适用于 Qoder CLI CN。配置后,CLI 的登录、账号接口和模型请求都会使用组织专属的 VPC endpoint。

使用前准备

向组织管理员获取 VPC endpoint。本文以 acme.vpc.qoder.com.cn 为例,其中 acme 是组织的 VPC 实例名。 请确认当前网络和 DNS 可以访问该域名。配置时只需填写这一个域名,CLI 会自动处理其余请求地址。

配置 VPC endpoint

运行以下命令设置 VPC endpoint:
qodercn config set vpc_endpoint acme.vpc.qoder.com.cn
配置会保存到用户级 ~/.qoder-cn/settings.json,并应用于此用户后续启动的 Qoder CLI CN 会话。 使用以下命令检查已保存的配置:
qodercn config get vpc_endpoint
预期输出:
acme.vpc.qoder.com.cn
设置或更换 VPC endpoint 会清除原有登录状态。重新启动 CLI,并按提示登录:
qodercn
启动后,TUI 顶部会显示当前 endpoint,例如 Endpoint: acme.vpc.qoder.com.cn。完成登录后,可以发送一个简单任务,确认模型请求能够正常返回。

更换或停用 VPC endpoint

更换实例时,重新运行 config set 并使用新的完整域名:
qodercn config set vpc_endpoint new-instance.vpc.qoder.com.cn
停用 VPC endpoint 时,运行:
qodercn config unset vpc_endpoint
通过 config set 设置或更换 endpoint,或者通过 config unset 停用 endpoint 时,CLI 会自动清除原登录状态。完成操作后,请重新启动 CLI 并登录。

常见问题

提示 VPC endpoint 无效

config set 需要 vpc.qoder.com.cn 下的完整域名,例如 acme.vpc.qoder.com.cn。不要使用裸实例名、IP 地址或其他域名。

无法登录或模型请求失败

确认当前网络能够解析并通过 HTTPS 访问实例的基础域名、OpenAPI 域名和网关域名。VPC 模式使用固定的实例域名,网络代理、防火墙和 DNS 需要允许这些地址。