FastGPT工作区自定义域名的配置与维护注意事项

功能适用范围与边界

FastGPT云服务版自v4.14.4起支持自定义域名配置功能。使用该功能需满足两个前提：一是当前账号套餐等级支持自定义域名配置，若不支持需按页面指引升级套餐；二是所用域名需完成备案，且仅支持阿里云、腾讯云、火山引擎三家服务商的备案域名。此外，若需修改自定义域名或更换域名服务商，必须先删除原有配置后再重新进行配置。

详细配置步骤

打开自定义域名配置页：在侧边栏选择「账号」-「自定义域名」，进入配置页面。
添加并解析域名：点击「编辑」按钮进入编辑状态，填入目标域名（如www.example.com）。随后前往域名服务商的解析管理界面，添加记录类型为CNAME的DNS解析记录，记录值按页面提示内容填写。完成解析记录添加后点击「保存」按钮，系统将自动检查DNS解析状态，通常一分钟内可获取解析结果。若长时间未获取到记录，可点击重试。待页面状态提示显示为「已生效」后，点击「确认」按钮即可完成配置。配置完成后，即可通过自定义域名访问FastGPT服务、调用FastGPT的API。

解析失效处理与易错点

系统每日会对DNS解析记录进行检查，若发现解析失效，将自动停用该自定义域名。此时可前往自定义域名管理界面点击「编辑」，重新完成解析流程即可恢复。使用过程中需注意：必须使用CNAME类型的DNS记录，不可使用其他记录类型；未完成备案的域名无法完成配置；若未按流程删除原有配置直接修改域名，会导致配置失效。当账号为非云服务版、或云服务版版本低于v4.14.4时，不建议使用该功能。