云开发 CloudBase HTTP 访问服务

HTTP 访问服务为云开发环境提供统一的 HTTP 访问入口,开发者可通过标准 HTTP 协议访问环境内的各类云资源,无需集成 SDK 即可实现后端云资源的调用与管理。

相关产品
云开发 CloudBase 产品页,含版本规格、价格与购买入口。

一、概述

该服务支持自定义域名绑定、路由规则配置、跨域策略管理等能力,适用于 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. 建议为生产环境接口启用身份认证和限频设置,保障服务安全

参考链接:HTTP 访问服务

赞 (0)
上一篇 4天前
下一篇 4天前