文档中心

函数服务

沙箱实例

沙箱实例管理

沙箱实例是云沙箱中实际执行沙箱镜像的安全且隔离的容器运行环境。创建沙箱应用后，可创建沙箱实例，用于运行沙箱镜像。本文主要介绍沙箱实例的创建和管理方法。

沙箱实例规格

以下为当前支持的 vCPU 与内存组合，最终以控制台显示为准。

vCPU	内存（GiB）
0.25	0.5 / 1
0.5	1 / 2
0.75	1.5 / 3
1	2 / 4 / 8
1.25	2.5 / 5
1.5	3 / 6
2	4 / 8 / 16
4	8 / 16 / 32
8	16 / 32 / 64
16	32 / 64 / 128

vCPU 与内存（GiB）的比值规则：

vCPU 为整数时，支持 1:2、1:4、1:8 三种比值。

vCPU 为非整数时，支持 1:2、1:4 两种比值。

创建沙箱实例

前提条件

已创建沙箱应用，详细操作，请参见创建沙箱应用。

操作步骤

登录函数服务控制台。

在顶部导航栏，选择目标地域。

左侧导航栏选择云沙箱 > 沙箱应用，找到目标沙箱应用，单击应用名称。

在沙箱应用详情页面，选择沙箱实例页签，单击创建沙箱实例。

按照如下说明，配置沙箱实例参数。

参数	说明
沙箱镜像
容器镜像	配置沙箱实例的容器镜像：复用应用配置：复用沙箱应用中的容器镜像配置。此时无需配置沙箱实例的启动命令、监听端口。配置独立镜像：配置独立的沙箱实例容器镜像。按需选择公共镜像或自定义镜像，并配置启动命令和监听端口。
启动命令	沙箱实例程序的启动命令。如需指定脚本文件，请使用绝对路径，并确保脚本具有相应的可执行权限。
监听端口	沙箱实例 HTTP Server 监听的端口。注意请避免使用 veFaaS 占用的端口：9000、9001、9990。您启动的 HTTP Server 需监听0.0.0.0:Port或*:Port。否则会导致请求超时错误。
实例配置
实例规格	选择单个 CPU 实例的 vCPU 和内存。默认将复用沙箱应用配置的实例规格，您也可根据页面提示和业务需求选择合适的实例规格。
实例生命周期时长	沙箱实例的存活时长。超过该时长后，实例会被销毁。
环境变量
环境变量	沙箱实例级别的环境变量，若未配置，则复用沙箱应用的环境变量配置。若沙箱实例环境变量 Key 与沙箱应用环境变量 Key 重名，则实例级别环境变量 Value 将覆盖应用级别环境变量配置。
高级配置
实例元信息	实例 Label 元信息，示例：user:2100******。后续可通过元信息<key,value>筛选查询沙箱实例。可在如下场景中使用：将沙箱实例与用户会话关联。存储沙箱实例的自定义用户数据（如 API 密钥）。将沙箱实例与用户 ID 关联，以便后续连接到云沙箱。
执行超时	设置单次请求的最长执行时间，超时后实例进程将被终止并返回错误。请根据代码实际执行耗时合理配置。
NAS 挂载	将文件存储 NAS 挂载至实例，可在代码中像访问本地目录一样读写 NAS 上的文件。产生的费用参见文件存储 NAS 计费说明。
TOS 存储配置	支持为该实例单独指定挂载 TOS Bucket 的子目录，覆盖沙箱应用级别的 TOS 存储配置。若不配置，则沿用沙箱应用已有的 TOS 存储配置。
EBS 云盘挂载	将弹性块存储（EBS）挂载至实例，提供高可用、高可靠、高性能的持久化块存储能力。产生的费用参见 EBS 计费说明

确认费用信息，然后单击确定，完成沙箱实例的创建。

查看和管理沙箱实例

成功创建沙箱实例后，在沙箱实例页签的搜索框，以及沙箱实例操作列，通过对应操作按钮管理沙箱实例。

操作	说明
搜索框	支持基于名称、实例元信息、镜像地址三种方式搜索。使用实例元信息方式搜索时，在搜索框中按key=value格式输入元信息查询对应的沙箱实例。
查看日志	查看沙箱实例相关的日志信息。
Webshell	登录实例 Webshell 端口，执行相应的命令行操作，例如查看实例的环境信息，对函数进行调试等。查看实例配置 env 信息，常用的命令如下：查询 Sandbox 服务 proc id：ps aux \| grep "sandbox" 说明如果使用的是自定义镜像，需要把sandbox修改为您自定义镜像应用程序的主进程名称。查看进程 env：cat /proc/${your_sandbox_proc_id}/environ \| tr '\0' '\n' 说明将${your_sandbox_proc_id}替换为您查询到的实际 Sandbox 服务 proc id，例如 proc id 为15，则完整命令为：cat /proc/15/environ \| tr '\0' '\n'。
修改生命周期	修改云沙箱实例存活时长。实例会保持到当前设置的生命周期时长后销毁。
删除	删除沙箱实例。删除后不可恢复。

访问沙箱实例

当沙箱应用已设置网关路由配置时，可在沙箱实例列表查看实例的访问域名。您可通过统一域名或泛域名的方式访问指定的沙箱实例。

网关路由配置统一域名时，可通过 API 网关提供的统一域名访问指定沙箱实例，支持两种传参方式：

说明

访问统一域名未使用指定 Query 和 Header 时，流量将随机调度沙箱实例。

在 Query 参数中传入沙箱实例的名称 faasInstanceName。实例列表中可直接获取拼接好 Query 参数的统一域名访问地址。

在请求头 Header 中传入沙箱实例的名称 x-faas-instance-name。

网关路由配置泛域名时，实例列表可获取泛域名提供的实例唯一访问地址。

最近更新时间：2026.09.14 16:46:17

这个页面对您有帮助吗？

有用

无用