概述
HTTP 访问服务为云开发环境提供统一的 HTTP 访问入口，开发者可通过标准 HTTP 协议访问环境内的各类云资源，无需集成 SDK 即可实现后端云资源的调用与管理。
该服务支持自定义域名绑定、路由规则配置、跨域策略管理等能力，适用于 Web 应用、API 接口、静态资源分发等场景。
控制台入口
在左侧菜单「环境管理」下选择「HTTP 访问服务」进入管理页面。页面顶部提供 HTTP 访问服务的全局开关，开启后方可使用相关功能。
核心能力
能力 | 说明 |
高性能访问 | 基于优化的 HTTP 协议实现，提供低延迟、高并发的资源访问能力 |
灵活路由配置 | 支持针对域名和访问路径进行精细化路由规则配置，实现请求的智能分发 |
自定义域名管理 | 支持绑定/解绑自定义域名，通过自有域名访问环境服务 |
多协议支持 | 支持 HTTP 与 HTTPS 协议 |
一、域名管理
1.1 默认域名
CloudBase 为每个环境提供默认域名（
*.app.tcloudbase.com），但默认域名仅适用于开发测试阶段，存在以下限制：访问频率限制
部分高级功能不可用
浏览器直接访问时会出现安全提示中间页
生产环境必须绑定已完成备案的自定义域名，以获得完整的服务能力和稳定性保障。
1.2 自定义域名
控制台「域名管理」区域支持自定义域名和默认域名两个 Tab 切换。单击「添加自定义域名」可绑定自有域名。
自定义域名列表包含以下字段：
字段 | 说明 |
域名 | 已绑定的自定义域名 |
域名启用 | 域名启用/停用开关 |
证书状态 | SSL 证书的当前状态（如「正常」） |
状态 | 域名接入状态（如「正常」） |
接入方式 | 接入类型（如「云开发 CDN 接入」） |
CNAME | 需要在域名服务商处配置的 CNAME 记录值 |
协议类型 | 支持的协议（HTTP / HTTPS / HTTP & HTTPS） |
更新时间 | 最近一次配置变更时间 |
操作 | 编辑、Headers 设置 |
二、路由管理
路由管理用于配置域名下各路径与云资源的映射关系，支持将不同路径指向不同的后端资源。
2.1 路由列表
路由按域名分组展示，每个域名下可配置多条路由规则。单击「添加路由」或「添加该域名路由」新增路由。单击「路由配置」可进入全局路由管理。
路由列表包含以下字段：
字段 | 说明 |
路由 | 访问路径（如 /、/blog、/test） |
路由启用 | 路由的启用/停用开关 |
资源类型 | 后端资源类型（静态托管、云函数、自定义应用等） |
资源对象 | 具体的资源实例名称（如 staticstore、blog-autoPublish） |
路径透传 | 是否将完整请求路径传递给后端服务 |
身份认证 | 是否启用访问身份验证 |
限频设置 | 访问频率限制配置状态 |
更新时间 | 最近一次路由变更时间 |
操作 | 编辑、限频设置、Headers 设置、监控、删除 |
2.2 支持的资源类型
资源类型 | 说明 |
静态托管 | 将路径指向静态网站托管资源（资源对象为 staticstore） |
云函数 | 将路径指向指定云函数，实现 HTTP 接口 |
自定义应用 | 将路径指向云托管中的自定义应用服务 |
2.3 路由配置说明
路径透传：开启后，请求的完整 URL 路径将传递给后端服务，适用于后端服务自行处理路由的场景
身份认证：为敏感接口启用访问控制，确保数据安全
限频设置：配置单位时间内允许的最大请求次数，防止恶意请求
Headers 设置：配置自定义响应头，如缓存策略、安全头等
三、跨域设置
HTTP 访问服务提供跨域（CORS）策略管理功能，用于控制哪些外部域名可以跨域访问当前环境的资源。
云开发会校验跨域应用请求的来源域名，需要将来源域名加入到 Web 安全域名列表中。
3.1 跨域域名列表
单击「添加跨域域名」将来源域名加入白名单。列表包含以下字段：
字段 | 说明 |
域名 | 允许跨域访问的来源域名 |
类型 | 域名类型（自定义） |
操作 | 删除 |
3.2 常见配置场景
场景 | 域名示例 |
预览环境 | *.preview.cloudbase.net |
本地开发 | localhost:5173、localhost:80、localhost:8080 |
低代码应用 | lowcode-xxx.ap-shanghai.app.tcloudbase.com |
自定义业务域名 | 根据实际业务域名添加 |
腾讯云服务域名 | icap.cloud.tencent.cn、icap.cloud.tencent.com 等 |
四、适用场景
场景 | 说明 |
Web 应用托管 | 通过自定义域名访问静态网站托管资源，配合路由规则实现前后端分离 |
API 接口服务 | 将云函数通过路由映射为标准 HTTP API，对外提供接口服务 |
微服务网关 | 通过路由将不同路径分发至不同的云托管服务，实现统一入口 |
低代码应用访问 | 为微搭等低代码应用提供自定义域名访问能力 |
五、注意事项
1. 默认域名仅适用于开发测试，生产环境必须绑定已完成备案的自定义域名
2. 自定义域名需在域名服务商处正确配置 CNAME 记录，指向控制台提供的 CNAME 值
3. 跨域域名列表需包含所有前端应用的访问来源域名，否则浏览器将拦截请求
4. 本地开发时需将
localhost 及对应端口加入跨域域名列表5. 路由规则变更后可能存在短暂生效延迟
6. 建议为生产环境接口启用身份认证和限频设置，保障服务安全
