函数服务
函数服务
文档指南
请输入
- 文档首页
函数服务用户指南云沙箱沙箱应用沙箱应用
复制全文
下载 pdf沙箱应用
文档反馈
问问助手沙箱应用是云沙箱的基础单元，用于管理资源调度和运行。本文主要介绍函数服务（veFaaS）提供的云沙箱应用相关创建、使用、管理操作。
创建沙箱应用
前提条件
- （可选）若需要使用自定义镜像，请确保已上传镜像到火山引擎镜像仓库（CR）中。详细操作，请参见 基于 Docker 推送和拉取镜像。
- （可选）如需挂载对象存储（TOS），请参考 挂载 TOS 对象存储 内容操作。
- （可选）如需挂载文件存储（NAS），请参考 挂载 NAS 文件存储 内容操作。
操作步骤
- 登录 函数服务控制台。
- 在顶部导航栏，选择目标地域。
- 左侧导航栏选择 云沙箱 > 沙箱应用，单击 创建沙箱应用。
- 在 创建沙箱应用 页面，按照如下说明配置参数。
- 参数说明基础配置名称自定义沙箱应用名称。同一账号下沙箱应用名称不可重复。创建成功后名称不支持修改。备注沙箱应用的备注信息。可以为空。沙箱镜像容器镜像通过容器镜像方式部署沙箱应用：
- 公共镜像：沙箱镜像预置的开箱即用的公共镜像，可直接使用。
- 自定义镜像：从沙箱镜像中选择已预热的镜像。支持通过镜像 ID、镜像地址进行筛选。
启动命令输入应用程序的启动命令。如需指定脚本文件，请使用绝对路径，并确保脚本具有相应的可执行权限。说明- 容器镜像 选择 公共镜像 时：veFaaS 根据您选择的镜像显示默认启动命令。您可以按需修改。
- 容器镜像 选择 自定义镜像 时：veFaaS 自动解析目标镜像配置文件，获取该镜像中的 启动命令 信息。您可以按需修改。
监听端口输入 HTTP Server 所监听的端口。注意- 请避免使用 veFaaS 占用的端口：9000、9001、9990。
- 您启动的 HTTP Server 需监听0.0.0.0:Port或*:Port。否则会导致请求超时错误。
网关路由配置域名类型网关实例选择 API 网关实例。沙箱应用将以 API 网关作为流量入口。网关服务选择 API 网关实例对应的服务。路由名称自定义路由名称。路由名称创建成功后不支持修改。Path设置允许访问沙箱应用的请求路径。仅支持前缀匹配，路径必须以/开头。路由鉴权配置 API 网关实例的路由鉴权，保证沙箱应用的路由安全：- 关闭：（默认）不开启鉴权，后续您可以根据自身需求手动开启 Key Auth 鉴权。详细操作，请参见 API Key 认证鉴权。
- Key Auth：通过 API 网关使用 Key Auth 插件实现基于 API Key 的认证鉴权。
- 选择 Key Auth 后，您还需要进行 认证配置，即选择 Key Auth 认证信息的位置：
- header：在请求头中附带 Key Auth 认证信息，默认来源为 Authorization。
- querystring：在请求参数中附带 Key Auth 认证信息。默认来源为 token。
说明环境变量环境变量自定义配置的环境变量，在函数代码运行时可以直接读取到。说明容器镜像 选择 自定义镜像 时：veFaaS 将自动解析目标镜像配置文件，获取该镜像中的 环境变量 信息。您可以按需修改。高级配置
- 阅读并勾选《函数服务专用服务条款》和《函数服务产品服务等级协议》，然后单击 确定，完成沙箱应用的创建。
管理沙箱应用
成功创建沙箱应用后，可以查看沙箱应用基本信息、监控和日志等，管理沙箱应用以及创建沙箱实例接口每分钟请求数上限（QPM）。
- 登录 函数服务控制台。
- 在顶部导航栏，选择目标地域。
- 左侧导航栏选择 云沙箱 > 沙箱应用。
- 在 沙箱应用 列表页面，查看沙箱应用相关信息。
- 模块分类说明用户级 QPM 配置【邀测·申请试用】沙箱应用每分钟可发起创建沙箱实例的请求数是有限的，若主账号下不同沙箱应用同一时间段发起创建实例的请求，可能存在资源争抢、高优先级业务应用（例如试试推理应用）资源配额受影响等情况。针对此场景，veFaaS 支持配置用户级别的 QPM，提供资源隔离、优先级保障等能力。通过功能邀测申请后，可在 沙箱应用 页面查看当前用户下所有沙箱应用共享的 QPM 配额。您可以单击 申请用户及配额，通过获取技术支持，更新用户级 QPM 配额。
快速部署模板沙箱应用信息在沙箱应用列表中，可查看目标沙箱应用的可观测（监控和日志）信息，以及标签、实例数、镜像地址等其他基本信息。
- 选择一个目标沙箱应用，单击应用名称，进入沙箱应用详情页面管理沙箱应用。
- 详情页顶部
- 在详情页顶部的右侧支持发布应用、删除应用操作。
- 基本信息
-
- 沙箱实例
- 功能模块说明资源统计展示当前应用中实例的总数和运行中实例的个数。资源配额支持展示当前资源用量和百分比，并支持单击 申请资源，在 配额中心 申请更多的配额。
- 实例数上限：展示当前应用中已创建实例的数量和所占配额上限的百分比。单击 设置，支持调整当前应用可用的实例上限和预热池数量。如需更多实例配置，支持在 配额中心，通过 SandboxFunctionInstancesLimit 参数申请更多资源。
- 内存使用量：展示当前应用的内存使用量和占账号总配额的百分比。支持在 配额中心，通过 SandboxMemory 参数申请更多资源。
- vCPU 使用量：展示当前应用的 vCPU 使用量和占账号总配额的百分比。支持在 配额中心，通过 SandboxVCPU 参数申请更多资源。
- 应用 QPM 上限：【邀测·申请试用】云沙箱的应用级别 QPM 配置，可控制当前沙箱应用中每分钟可发起创建沙箱实例的请求数，从而实现更细粒度的资源配额控制。
- 申请功能邀测并通过技术支持首次配置应用级别 QPM 限制后，可在 资源配额 模块中查看该沙箱应用的 QPM 限制。您可以单击 QPM 限制数旁的 申请，通过获取技术支持，更新应用级 QPM 配额。
-
实例列表
- 变更管理
-
- 监控
- 可查看或配置沙箱应用的监控。更多操作和说明，请参见 监控与日志。
- 日志
- 可查看沙箱应用的日志。更多操作和说明，请参见 监控与日志。
测试沙箱应用
下文以公共镜像中类别为 Code 的 sandbox-fusion 镜像为例，测试沙箱应用。
API 网关域名请求测试
通过本地curl命令，调用 API 来测试云沙箱应用。可通过x-faas-insatnce-name指定实例请求。
- 将https://****.apigateway-cn-beijing.volceapi.com替换为您自己云沙箱函数的访问地址。
- 根据实际情况，替换data下的参数值。
-
Playground 测试
- 在沙箱应用详情页面 基本信息 页签的 网关路由配置 区域，获取沙箱应用的 访问地址。
-
- 在 SandboxFusion 页面，单击 Playground 页签，选择 Sandbox 页面。
- 在 Code 文本框中输入待运行代码段并选择对应编程语言，单击 Submit 提交代码运行请求。
- 等待运行完成后，可查看结果输出。
-
最近更新时间：2026.04.03 17:50:54
这个页面对您有帮助吗？
有用
有用
无用
无用