概览

最近更新时间:2026-04-20 11:37:31

我的收藏

简介

Cloud Functions 是 Pages Functions 提供的云端函数服务,适用于需要访问外部服务、操作数据库、处理计算密集型任务等复杂后端场景。

支持的运行时

Cloud Functions 支持多种主流编程语言及运行环境,您可以根据业务需求选择最合适的运行时。

Node.js

支持 JavaScript 或 TypeScript 开发。您可以直接访问完整的 npm 生态,利用成熟的 Node.js 工具链构建应用。

Python

支持使用 Python 语言开发,并通过 pip 集成第三方库。原生支持 Flask、FastAPI、Django、Sanic 等主流 Web 框架。

Go

利用 Go 语言出色的并发能力与执行性能构建高性能后端服务,支持通过 Go Modules 管理项目依赖。
说明:
关于各运行时的详细配置、内置 API 及使用示例,请参阅对应的 Node.jsPythonGo 详细文档。

多地域部署

Cloud Functions 支持多地域部署,您可以选择函数运行的地域,将函数部署到离数据源更近的区域,从而降低网络延迟、提升响应速度。
说明:
多地域部署仅适用于 Cloud Functions。

地域选择

Cloud Functions 的地域配置与项目的加速区域相关:
全球可用区(含中国大陆):可分别配置中国大陆地域和中国大陆以外地域。
中国大陆可用区:仅分配需配置中国大陆地域。
全球可用区(不含中国大陆):仅需配置中国大陆以外地域。
默认情况下,中国大陆地域为 ap-guangzhou(广州),中国大陆以外地域为 ap-singapore(新加坡)。

可选地域列表

中国大陆地域:
地域名称
地域 ID
广州
ap-guangzhou
上海
ap-shanghai
南京
ap-nanjing
北京
ap-beijing
成都
ap-chengdu
中国大陆以外地域:
地域名称
地域 ID
新加坡
ap-singapore
中国香港
ap-hongkong
曼谷
ap-bangkok
雅加达
ap-jakarta
首尔
ap-seoul
东京
ap-tokyo
法兰克福
eu-frankfurt
弗吉尼亚
na-ashburn
硅谷
na-siliconvalley

配置方式

通过控制台配置

在 Pages 控制台项目设置的函数管理中选择部署地域。

通过 edgeone.json 配置

edgeone.json 文件中,通过 mainlandRegionsoverseasRegions 字段指定函数部署地域,根据项目的加速区域按需配置:
{
"mainlandRegions": ["ap-beijing"],
"overseasRegions": ["ap-tokyo"]
}
注意:
每个字段的数组中只能配置一个地域。
edgeone.json 中的地域配置优先级高于控制台配置。

使用限制

以下为 Cloud Functions 各运行时的通用限制与运行时版本信息:
内容
限制
说明
代码包大小
128 MB
单个函数代码包大小(含依赖)最多支持 128 MB
请求 body 大小
6 MB
客户端请求携带 body 最多支持 6 MB
最大执行时长
120s
单个请求从开始到响应的最大允许时间(Maximum Duration)
Node.js 版本
v20.x
默认 Node.js 运行时版本
Python 版本
3.10
服务端运行环境为 Python 3.10,建议本地开发也使用相同版本
Go 版本
1.26
运行环境版本 1.26(向后兼容)
注意:
涉及到文件传输时,不建议存储需要长期保留的数据,推荐使用腾讯云 COS 来处理持久化的需求。