沙箱实例是云沙箱中实际执行沙箱镜像的安全且隔离的容器运行环境。创建沙箱应用后，可创建沙箱实例，用于运行沙箱镜像。本文主要介绍沙箱实例的创建和管理方法。 ## 创建沙箱实例 ### 前提条件已创建沙箱应用，详细操作，请参见 [创建沙箱应用](https://www.volcengine.com/docs/6662/1802881?LibVersion=markdown备份版本)。 ### 操作步骤 1. 登录 [函数服务控制台](https://console.volcengine.com/vefaas)。 2. 在顶部导航栏，选择目标地域。 3. 左侧导航栏选择 **云沙箱 ** \> ** 沙箱应用**，找到目标沙箱应用，单击应用名称。 4. 在沙箱应用详情页面，选择 **沙箱实例 ** 页签，单击 **创建沙箱实例**。 5. 按照如下说明，配置沙箱实例参数。 |**参数** |**说明** | |---|---| |**沙箱镜像** || |容器镜像 |配置沙箱实例的容器镜像：|\ | ||\ | |* **复用应用配置**：复用沙箱应用中的容器镜像配置。此时无需配置沙箱实例的 **启动命令**、**监听端口**。|\ | |* **配置独立镜像**：配置独立的沙箱实例容器镜像。按需选择 **公共镜像** 或 **自定义镜像**，并配置 **启动命令** 和 **监听端口**。 | |启动命令|沙箱实例程序的启动命令。如需指定脚本文件，请使用绝对路径，并确保脚本具有相应的可执行权限。 |\ | | | |监听端口 |沙箱实例 HTTP Server 监听的端口。|\ | |:::warning|\ | ||\ | |* 请避免使用 veFaaS 占用的端口：`9000`、`9001`、`9990`。|\ | |* 您启动的 HTTP Server 需监听`0.0.0.0:Port`或`*:Port`。否则会导致请求超时错误。|\ | ||\ | |:::| |**实例配置** || |实例规格 |选择单个 CPU 实例的 vCPU 和内存。默认将复用沙箱应用配置的实例规格，您也可根据页面提示和业务需求选择合适的实例规格。 | |实例生命周期时长 |沙箱实例的存活时长。超过该时长后，实例会被销毁。 | | ** 环境变量** || | 环境变量 |沙箱实例级别的环境变量，若未配置，则复用沙箱应用的环境变量配置。|\ | |若沙箱实例环境变量 Key 与沙箱应用环境变量 Key 重名，则实例级别环境变量 Value 将覆盖应用级别环境变量配置。 | |**高级配置** || |实例元信息 |实例 Label 元信息，示例：`user:2100******`。后续可通过元信息``筛选查询沙箱实例。|\ | |可在如下场景中使用：|\ | ||\ | |* 将沙箱实例与用户会话关联。|\ | |* 存储沙箱实例的自定义用户数据（如 API 密钥）。|\ | |* 将沙箱实例与用户 ID 关联，以便后续连接到云沙箱[ ](https://e2b.dev/docs/sandbox/connect)。 | |执行超时 |根据代码执行需求，按需配置执行时长。请求执行时长超过该时长时，会终止进程并返回错误。 | |TOS 存储配置 |沙箱应用已配置 TOS 存储挂载时，支持实例级别挂载 TOS Bucket 的不同子目录。若未配置，则复用沙箱应用的 TOS 存储配置。 | 6. 确认费用信息，然后单击 **确定**，完成沙箱实例的创建。 ## 查看和管理沙箱实例成功创建沙箱实例后，在 **沙箱实例** 页签的搜索框，以及沙箱实例 **操作** 列，通过对应操作按钮管理沙箱实例。 |**操作** |**说明** | |---|---| |搜索框 |支持基于名称、实例元信息、镜像地址三种方式搜索。使用实例元信息方式搜索时，在搜索框中按`key=value`格式输入元信息查询对应的沙箱实例。 | |查看日志 |查看沙箱实例相关的日志信息。 | |Webshell |登录实例 Webshell 端口，执行相应的命令行操作，例如查看实例的环境信息，对函数进行调试等。|\ | |查看实例配置 env 信息，常用的命令如下：|\ | ||\ | |1. 查询 Sandbox 服务 proc id：`ps aux \| grep "sandbox"`|\ | | :::tip|\ | | 如果使用的是自定义镜像，需要把`sandbox`修改为您自定义镜像应用程序的主进程名称。|\ | | :::|\ | |2. 查看进程 env：`cat /proc/${your_sandbox_proc_id}/environ \| tr '\0' '\n'`|\ | | :::tip|\ | | 将`${your_sandbox_proc_id}`替换为您查询到的实际 Sandbox 服务 proc id，例如 proc id 为`15`，则完整命令为：`cat /proc/15/environ \| tr '\0' '\n'`。|\ | ||\ | | :::| |修改生命周期 |修改云沙箱实例存活时长。实例会保持到当前设置的生命周期时长后销毁。 | |删除 |删除沙箱实例。删除后不可恢复。 | ## 访问沙箱实例当沙箱应用已设置 **网关路由配置** 时，可在沙箱实例列表查看实例的访问域名。您可通过统一域名或泛域名的方式访问指定的沙箱实例。 * 网关路由配置统一域名时，可通过 API 网关提供的统一域名访问指定沙箱实例，支持两种传参方式： :::tip 访问统一域名未使用指定 Query 和 Header 时，流量将随机调度沙箱实例。 ::: * 在 Query 参数中传入沙箱实例的名称 `faasInstanceName`。实例列表中可直接获取拼接好 Query 参数的统一域名访问地址。 * 在请求头 Header 中传入沙箱实例的名称 `x-faas-instance-name`。 * 网关路由配置泛域名时，实例列表可获取泛域名提供的实例唯一访问地址。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_37ee9a0329f904340f8136d6e62e2951.png =985x)