安卓沙箱
更新时间 2026-10-21 09:59:59
最近更新时间: 2026-10-21 09:59:59
概述
本章节主要介绍创建和更新安卓沙箱模板以及安卓沙箱实例调试功能。安卓沙箱提供了Android模拟运行环境，在该类型沙箱实例中你可以模拟Android端用户行为。
创建安卓沙箱模板
操作步骤
登录智能体引擎控制台，左侧导航选择沙箱菜单。
单击创建沙箱模板。
在创建沙箱模板窗口，填写安卓沙箱参数并单击确定。
创建完成后，在沙箱模板列表页面，可以看到沙箱模板。沙箱模板创建和更新都为异步操作，需要您耐心等待完成。
基础沙箱模板创建参数
| 参数名称 | 是否必填 | 参数说明 |
|---|---|---|
| 沙箱类型 | 是 | 智能体引擎支持基础沙箱、代码沙箱、浏览器沙箱、AIO沙箱、安卓沙箱、Linux桌面沙箱和自定义沙箱7种沙箱类型。 |
| 模板名称 | 是 | 沙箱模板名称用户内唯一。 模板名称规则： 以字母开头，可包含字母、数字、下划线和连字符，且长度不超过32个字符。 |
| 描述 | 否 | 沙箱模板的描述。 |
| 安卓版本 | 是 | 安卓版本，目前只支持Android12。 |
| 规格方案 | 是 | 沙箱CPU和内存规格，目前只支持4核CPU和8GB内存这种规格。 |
| 临时磁盘大小 | 是 | 沙箱使用的临时磁盘大小，目前支持多种规格。 |
| 执行超时时间 | 是 | 沙箱实例在创建后可运行的最长时间，超时将自动销毁。规格有多种，最短1分钟，最长为24小时。 |
| 企业项目 | 否 | 天翼云企业项目。如果不填写，默认为default。 |
| 服务端口白名单 | 否 | 访问沙箱中服务的端口白名单，沙箱中用户服务端口受此配置限制，模版内置服务端口不受此配置限制。服务端口白名单为空，沙箱中所有用户服务端口都可以访问， 否则只能访问服务端口白名单中配置的端口。 |
| 访问凭证 | 否 | 访问沙箱实例入站凭证及访问凭证作用端口，沙箱中用户服务端口受此限制，模版内置服务端口不受此限制。目前支持API Key、Basic Auth和JWT3种类型。服务端口配置为空，则访问凭证作用于所用用户进程端口，否则只作用于所配置的端口。 |
| 沙箱凭证 | 否 | 模板绑定指定沙箱凭证，沙箱管理类操作必须使用该沙箱凭证，否则使用租户下任意的沙箱凭证即可。这里的沙箱管理类操作指创建、销毁、暂停和恢复等。 |
| 网络配置 | 是 | 包含沙箱访问公网、访问VPC、黑白名单和金允许指定VPC访问沙箱。 访问公网：允许沙箱访问公网服务。 访问VPC：允许沙箱访问您VPC下的天翼云资源。访问VPC需要选择VPC和子网 。 黑白名单：沙箱出方向的黑白名单，具体语义参见下面的黑白名单语义。 仅允许指定VPC访问沙箱：只能由指定的VPC访问沙箱。 |
| 日志配置 | 否 | 包含是否启用日志功能、配置方式和采集路径。使用日志功能的前提是用户开通日志服务。 日志功能：可以启用或者禁用日志功能。 配置方式：支持自动配置或者自定义配置。如果开启自定义配置，还需要配置日志项目和日志单元。 采集路径：日志采集路径。 |
网络配置中黑白名单语义：
未设置白名单：允许访问用户 VPC 内所有服务（仍受黑名单约束）。
设置白名单：仅允许访问白名单中的网段/IP（或对应服务）。如果白名单不为空，建议加上天翼云内部DNS地址100.95.0.1。
设置黑名单：禁止访问黑名单中的网段/IP（或对应服务）。
黑白名单冲突时，以白名单为更高优先级。
更新安卓沙箱模板
更新安卓沙箱模板和创建沙箱模板的操作流程基本一致，主要区别在于：更新时模板名称、网络配置和内置环境变量配置不可修改，其余配置项的操作方式与创建时完全相同，此处不再赘述。
安卓沙箱调试
前置操作
登录智能体引擎控制台。
左侧导航沙箱菜单下，创建安卓沙箱模板。
进入安卓沙箱模板后，创建安卓沙箱实例。沙箱实例列表操作列点击调试，进入安卓沙箱实例调试页面。
执行命令
操作步骤
在选择执行命令下拉列表中选择启动应用。
在操作参数中，package填写com.android.settings，activity填写.Settings。
点击执行命令，查看右侧VNC窗口中的变化。
