镜像设置

更新时间:
复制为 MD 格式

启用自定义镜像前,需要配置规格地域、沙箱生命周期、网络、画面和 MCP 工具等参数。本文介绍各设置模块的配置方法。

通用设置

  1. 登录无影 AgentBay 控制台

  2. 在左侧导航栏,单击资源管理>镜像管理

  3. 镜像管理页面找到目标镜像,单击操作列的设置按钮,进入镜像设置页面,包含如下设置:

规格地域

在规格地域区域,为镜像选择运行规格和部署地域。

说明
  • 系统镜像默认支持多个地域、多个规格,可以按照业务需要进行调用。

  • 单个自定义镜像仅支持设置一个地域和一个规格。修改地域或规格后,设置将在一定时间后生效。

  • 设置更改不会影响正在进行的会话,新发起的会话将使用更新后的设置。

沙箱生命周期

为镜像进行沙箱生命周期管理,确保云端资源高效利用。支持如下释放模式:

  • 自动释放:镜像启动的会话在配置的指标生效后自动关闭。系统镜像默认为自动释放,不可修改。

  • 手动释放:镜像启动的会话不会自动关闭,需要用户自行关闭。

设置自动释放后,还需进行如下配置:

  • 单次运行最长时长:单次运行超过设定时间后将释放沙箱,按分钟计算,支持最小1分钟最大1000分钟。

  • 休眠最大时长:沙箱被休眠超过设定时间后将释放沙箱,按小时计算,支持最小1小时最大72小时。

    说明

    沙箱休眠与唤醒需要通过SDK进行触发。

  • 无活动(闲置)最大时长:沙箱闲置超过设定时间后将释放沙箱,按分钟计算,支持最小1分钟最大1000分钟。可为空,为空时沙箱不会因闲置自动释放。

    说明

    无活动检测范围包含:MCP交互、SDK调用、用户操作等行为全部终止后,视为无活动并开始计时。

网络重定向

支持将云端环境的流量通过Socks5协议透明代理,重定向到客户自定义的公网IP,实现灵活的网络出口策略。支持以下两种模式:

说明

当代理服务器启用了 用户名/密码认证方式时,还需提供有效的用户名密码

全局模式

配置全局模式时,所有请求都将重定向到自定义IP。需要配置如下参数:

  • 服务器IP:流量最终目的地。

  • 端口:指定服务入口。

IP白名单模式

说明

支持导入白名单。

配置IP白名单后,仅白名单域名将重定向到自定义IP。需要配置如下参数:

  • 域名:当请求涉及该域名时,触发网络重定向。

  • 服务器IP:流量最终目的地。

  • 端口:指定服务入口。

画面

对沙箱分辨率进行设置和管理。支持如下配置:

  • 固定分辨率:始终使用1920×1080。

  • 最大分辨率:最大1920x1080,低于时按终端分辨率自适应。

  • 自适应分辨率:完全按终端分辨率自适应。

MCP 工具设置

在 MCP 工具设置区域,为镜像配置可用的 MCP工具。配置完成后,基于该镜像创建的沙箱实例将自动加载已配置的 MCP 工具。

说明
  • 系统镜像已根据镜像类型默认加载相关MCP工具,不支持手动修改。

  • 自定义镜像可根据需求自行添加或取消MCP工具。

自定义镜像设置

网络设置

  1. 登录无影 AgentBay 控制台

  2. 在左侧导航栏,单击资源管理>镜像管理

  3. 镜像管理页面选择自定义镜像页签。

  4. 单击操作列的设置按钮,进入镜像设置页面。

  5. 网络设置区域选择网络类型,支持以下网络类型:

    • 普通网络:最大支持 200并发,会话实例将使用5Mbps共享带宽。

    • 自定义网络:会话实例将创建在指定的VPC下,可自定义网络配置。

    • 高级网络:最大支持1000并发,会话实例将独享付费带宽,按使用流量计费。

      • 如需限制单个会话的带宽,可开启session最高公网带宽开关并配置带宽,支持2~200Mbps。