函数服务
函数服务
文档指南
请输入
- 文档首页
函数服务最佳实践功能应用使用函数服务托管静态站点
复制全文
下载 pdf使用函数服务托管静态站点
文档反馈
问问助手将静态站点托管至函数服务，适合快速验证、灵活配置的场景。配合 API 网关，可以实现丰富的流量控制（例如限流、鉴权），并与其他函数保持统一的部署流程和运维体验。本文为您介绍如何通过函数服务快速托管一个静态站点，获取可访问的站点地址。
背景信息
函数服务支持四种方式托管静态站点，请根据具体业务需求选择。
- 通过 CLI 部署：适用于本地已有前端项目、偏好命令行操作的场景，支持自动探测框架与构建命令，可无缝接入 CI/CD 流程。
- 通过 veFaaS MCP 部署：适用于在 AI Coding 工具（如 Trae IDE）内快速上线 HTML 报告或前端构建产物，无需手动编写命令。
- 通过应用模板创建（控制台）：适用于需要快速创建并托管静态应用的场景，模板内置静态托管方案，发布后自动生成访问地址，支持绑定代码仓库持续开发。
- 通过函数模板创建（控制台）：适用于需要细粒度函数级配置或自定义代理逻辑的场景，适合已有函数工程的用户。
前提条件
- 已创建 API 网关 实例，具体操作可参见 创建实例。
- 已在本地部署 Node.js 环境，建议下载 Node.js 20.x 版本，具体操作可参见 官方文档。安装成功后，执行 node --version 查看 Node.js 版本号。
操作步骤
通过 CLI 部署
veFaaS CLI 命令行工具，可以帮助您在终端环境中完成应用与函数的部署，以及后续域名与环境变量管理，实现静态站点的托管。
- 安装 veFaaS CLI。详情操作参见 CLI 安装。
- 在终端工具中，使用 vefaas login 登录。按提示选择火山账号或者 AK/SK 登录，单击回车确认。
- AK/SK：密钥包括 Access Key ID（简称为 AK） 和 Access Key Secret（简称为 SK），详情请参考 Access Key（密钥）管理。
- 火山账号：通过浏览器打开 SSO 登录页面，您可以选择需要使用的火山账号并授权，登录成功后会提示 认证完成，之后可关闭浏览器标签，完成登录。
- 部署应用。
- 在您的项目目录直接执行 veFaaS 命令，跟随交互式引导，新建 Deploy、输入应用名称。
- 选择一个正在运行的 API 网关，随后 veFaaS CLI 会自动探测出当前项目使用的框架类型、构建命令、产物路径、启动命令和监听端口，并自动选择合适的运行时。您可根据实际情况自行调整，这些配置将作为函数的部署配置。本模板项目直接使用默认配置即可。
- 进入依赖安装和构建流程，完成后由于 veFaaS CLI 检测到当前项目是一个静态站点，会自动生成一份 DefaultCaddyFile 作为静态资源托管服务的配置文件。您可根据实际情况进行调整。本模板项目使用默认配置即可。
- veFaaS CLI 会将构建产物上传到 函数服务，并进行发布流程，同时会生成一个可访问的链接，当函数部署完成时，通过该链接即可访问到托管的静态站点。
通过 veFaaS MCP 部署
veFaaS MCP 已集成 CLI 的能力，可探测静态资源并自动配置参数，对于 HTML 静态文件或前端构建产物，可在 AI Coding 工具中结合 MCP 快速部署。
- Trae IDE：您可以在概览中单击按钮快速跳转到 Trae 配置 MCP，操作详情参见 在 Trae 中使用函数服务。
- 其他 AI Coding 工具：参考文档 使用 veFaaS MCP 管理函数。
通过应用模板部署
您可以通过模板，快速创建静态站点的托管应用，托管静态站点。
- 登录 函数服务控制台。
- 在顶部导航栏，选择目标地域。
- 在左侧导航栏选择 应用 > 应用广场。
- 在应用广场页面，搜索 React.js。
- 将鼠标悬停在 React.js，单击 创建应用。
- 配置应用信息。
- 基础信息
- 参数说明名称应用的名称，默认自动生成。
- 资源配置
- 参数说明地域展示当前应用及应用下关联云资源所在的地域。函数名称自定义函数名称。API 网关实例选择待使用的网关实例。将在该网关实例下自动创建 API 网关触发器相关资源，包括：服务、Upstream、路由。
- 代码仓库配置
说明
代码仓库配置 对应基于仓库自动构建和部署的能力。
- 参数说明绑定代码仓库单击关闭或开启本功能。默认开启该功能。绑定代码仓库，可基于代码源继续开发并推送分支。仓库类型当前仅支持 GitHub。用户名单击右侧的 GitHub 授权，完成授权后，选择已授权的 GitHub 账号。新建代码仓库名称自动生成代码仓库的名称。完成应用创建后，将在已绑定的 GitHub 账号中创建该名称的私有代码仓库。
- 阅读并勾选 已知晓相关部署风险《免责声明》后，单击 确定，完成操作。
- 部署成功后，即可在应用列表中，目标应用卡片的 复制地址 获取静态站点的访问地址。
通过函数模板部署
说明
您可以通过预置的 托管静态网站示例模板，快速创建静态站点的托管函数，托管静态站点。
- 创建托管静态站点的 Web 函数应用，仅 函数代码 需要按照以下说明配置，其他参数保持默认配置，详细操作说明参见 创建 Web 应用。
- 参数说明部署方式选择 代码包。运行时选择 Native Node.js 20.x。代码包类型选择 函数模板 > 托管静态网站示例模板。
- 部署成功后发布函数，详情操作说明参见 发布函数。
- 创建 API 网关触发器，获取访问静态站点的地址。创建 API 网关触发器的操作详情参见 创建 API 网关触发器。
- 在触发器列表，目标触发器的 配置信息 中，获取静态站点的访问地址。
最近更新时间：2026.03.24 19:44:21
这个页面对您有帮助吗？
有用
有用
无用
无用