Provider 配置参考

说明

由 scripts/docs/references.py 从内置 provider Pydantic 模型生成。英文原页应重新生成，不要手动编辑数据行。

编写配置、理解配置/运行时/状态边界和跨字段限制时，参见配置 provider。这些是 provider 设置，不是独立守护进程 JSON 默认值。

“必填”表示没有默认值。由工厂提供的字段具有模型计算的默认值；生成本页时不会读取 Host 环境或凭据存储。下面的命名 schema 部分包含嵌套根目录、挂载和 shell 配置。运行时客户端和权威目标状态不应放入这些目标配置、账号配置和凭据对象。

云 provider

六个云 provider 使用相同的目标配置、后端和私有凭据边界。下方平行列出各自 schema；能力差异见云 provider 指南。

Provider	目标配置	后端	凭据
E2B	E2BEnvironmentConfiguration	E2BConnectionConfiguration	E2B凭据
Daytona	DaytonaEnvironmentConfiguration	DaytonaConnectionConfiguration	Token凭据
Modal	ModalEnvironmentConfiguration	ModalConnectionConfiguration	Modal凭据
Vercel Sandbox	VercelEnvironmentConfiguration	VercelConnectionConfiguration	Token凭据
Fly.io Sprites	SpritesEnvironmentConfiguration	SpritesConnectionConfiguration	Token凭据
Runloop	RunloopEnvironmentConfiguration	RunloopConnectionConfiguration	Token凭据

`DirectLocalEnvironmentConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`root`	true	DirectLocalRootConfiguration	—
`shell_profiles`	false	数组，元素类型为 DirectLocalShellProfile	default=[]
`allowed_executables`	false	string 数组	uniqueItems=true; default=[]
`inherit_environment`	false	boolean	default=false
`allowed_environment_keys`	false	string 数组或 null	uniqueItems=true; default=[]
`allowed_ports`	false	integer 数组	uniqueItems=true; default=[]
`max_value_bytes`	false	integer	exclusiveMinimum=0; default=67108864
`max_concurrent_processes`	false	integer	exclusiveMinimum=0; default=128
`max_wall_time_seconds`	false	number	default=86400
`terminate_grace_seconds`	false	number	default=5.0
`max_buffer_bytes`	false	integer	exclusiveMinimum=0; default=1048576
`max_spool_bytes`	false	integer	exclusiveMinimum=0; default=68719476736

`DirectLocalRootConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`path`	true	string	format="path"

`DirectLocalShellProfile`

字段	必填	类型 / 可选值	约束与默认值
`profile_id`	true	string	minLength=1; maxLength=128
`executable`	true	string	format="path"
`fixed_arguments`	false	string 数组	default=[]
`dialect`	false	"posix", "powershell"	default="posix"
`allow_login`	false	boolean	default=false

`LocalEnvdEnvironmentConfiguration`

选择一个固定 cwd 的会话，不设置守护进程启动策略。

字段	必填	类型 / 可选值	约束与默认值
`egress`	false	EnvdEgressConfiguration 或 null	default=null
`expected_boundary`	false	EnvdBoundaryRequirement 或 null	default=null
`working_directory`	false	string 或 null	format="eip-absolute-path"; default=null
`required_methods`	false	string 数组	maxItems=128; default=[]

`AllowlistDestinations`

字段	必填	类型 / 可选值	约束与默认值
`mode`	true	"allowlist"	—
`hosts`	false	string 数组	maxItems=256; default=[]

`DisabledSandbox`

字段	必填	类型 / 可选值	约束与默认值
`mode`	true	"disabled"	—

`EgressDestinations`

可选值： PublicDestinations or AllowlistDestinations.

`EgressMode`

可选值： "inherit", "deny", "controlled".

`EnvdBoundaryRequirement`

选择远程边界，不授予修改该设备的权限。

字段	必填	类型 / 可选值	约束与默认值
`sandbox`	true	SandboxPolicy	—
`egress`	true	"inherit", "deny", "controlled"	—
`identity`	false	ExecutionIdentity 或 null	default=null
`privilege_gain_blocked`	false	boolean 或 null	default=null

`EnvdEgressConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`destinations`	true	EgressDestinations	—
`secrets`	false	数组，元素类型为 EnvdSecretReference	maxItems=64; default=[]

`EnvdSecretReference`

字段	必填	类型 / 可选值	约束与默认值
`env`	true	string	maxLength=128; `pattern="^[A-Za-z_][A-Za-z0-9_]*$"`
`source`	true	Environment凭据Source	—
`inject_hosts`	true	string 数组	minItems=1; maxItems=256

`Environment凭据Source`

字段	必填	类型 / 可选值	约束与默认值
`kind`	true	"environment"	—
`name`	true	string	`pattern="^[A-Za-z_][A-Za-z0-9_]*$"`

`ExecutionIdentity`

字段	必填	类型 / 可选值	约束与默认值
`uid`	true	integer	minimum=0; maximum=4294967295
`gid`	true	integer	minimum=0; maximum=4294967295

`GrantAccess`

可选值： "read_only", "read_write".

`PublicDestinations`

字段	必填	类型 / 可选值	约束与默认值
`mode`	true	"public"	—

`RestrictedSandbox`

字段	必填	类型 / 可选值	约束与默认值
`mode`	true	"restricted"	—
`grants`	false	数组，元素类型为 SandboxGrant	default=[]

`SandboxGrant`

字段	必填	类型 / 可选值	约束与默认值
`path`	true	string	format="eip-absolute-path"
`access`	true	"read_only", "read_write"	—

`SandboxPolicy`

可选值： DisabledSandbox or RestrictedSandbox.

`LocalEnvdLaunchConfiguration`

由 Host 选择的守护进程启动配置，由该运行时上的所有会话共享。

字段	必填	类型 / 可选值	约束与默认值
`execution`	false	EnvdExecutionConfiguration	—; 默认值由模型工厂计算
`sandbox`	false	SandboxPolicy	—; 默认值由模型工厂计算
`egress`	false	EnvdNetworkConfiguration	—; 默认值由模型工厂计算
`default_working_directory`	false	string 或 null	format="path"; default=null
`directory_discovery`	false	boolean	default=true
`trusted_executable_roots`	false	string 数组	default=[]
`shell_profiles`	false	数组，元素类型为 LocalEnvdShellProfile	default=[]
`max_file_bytes`	false	integer	exclusiveMinimum=0; default=16777216
`max_output_preview_bytes`	false	integer	maximum=16777216; exclusiveMinimum=0; default=65536
`max_output_bytes_per_stream`	false	integer	exclusiveMinimum=0; default=268435456
`max_spool_bytes`	false	integer	exclusiveMinimum=0; default=1073741824
`max_device_spool_bytes`	false	integer	exclusiveMinimum=0; default=4294967296

`EnvdExecutionConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`uid`	false	integer 或 null	minimum=0; exclusiveMaximum=4294967295; default=null
`gid`	false	integer 或 null	minimum=0; exclusiveMaximum=4294967295; default=null
`allow_sudo`	false	boolean	default=true

`EnvdNetworkConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`mode`	true	"inherit", "deny", "controlled"	—

`LocalEnvdShellProfile`

字段	必填	类型 / 可选值	约束与默认值
`profile_id`	true	string	minLength=1; maxLength=128
`executable`	true	string	format="path"
`fixed_arguments`	false	string 数组	default=[]
`allow_login`	false	boolean	default=false
`max_script_bytes`	false	integer	exclusiveMinimum=0; default=1048576

`DockerEnvironmentConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`image`	false	string	minLength=1; maxLength=1024; default="ghcr.io/converge-ai-labs/a13n-docker-environment:dev"
`pull_policy`	false	"never", "if_missing"	default="if_missing"
`mounts`	false	数组，元素类型为 DockerMountConfiguration	default=[]
`environment`	false	object	—; 默认值由模型工厂计算
`init_script`	false	string 或 null	maxLength=1048576; format="multiline"; default=null
`disable_network`	false	boolean	default=false
`user`	false	string 或 null	minLength=1; maxLength=128; default=null
`shell`	false	string	default="/bin/sh"
`python`	false	string	default="python3"
`cpus`	false	number 或 null	minimum=0.001; default=null
`memory_gb`	false	number 或 null	minimum=0.006291456; default=null
`pids_limit`	false	integer 或 null	exclusiveMinimum=0; default=null
`stop_grace_seconds`	false	integer	minimum=0; maximum=300; default=10
`request_timeout_seconds`	false	integer	maximum=3600; exclusiveMinimum=0; default=60
`max_file_bytes`	false	integer	exclusiveMinimum=0; default=16777216
`max_query_entries`	false	integer	exclusiveMinimum=0; default=100000
`max_output_preview_bytes`	false	integer	exclusiveMinimum=0; default=65536
`max_output_bytes_per_stream`	false	integer	exclusiveMinimum=0; default=16777216
`max_spool_bytes`	false	integer	exclusiveMinimum=0; default=67108864
`max_concurrent_processes`	false	integer	exclusiveMinimum=0; default=128

`DockerMountConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`source`	true	string	—
`target`	true	string	format="path"
`read_only`	false	boolean	default=true

`E2BEnvironmentConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`template`	false	string	minLength=1; maxLength=256; default="base"
`root`	false	string	default="/home/user"
`user`	false	string	`pattern="^[a-z_][a-z0-9_-]{0,63}$"`; default="user"
`python`	false	string	default="/usr/bin/python3"
`timeout_seconds`	false	integer	minimum=30; maximum=86400; default=3600
`request_timeout_seconds`	false	number	maximum=300; exclusiveMinimum=0; default=30
`allow_internet_access`	false	boolean	default=true
`max_file_bytes`	false	integer	maximum=1073741824; exclusiveMinimum=0; default=16777216
`max_observation_bytes`	false	integer	maximum=16777216; exclusiveMinimum=0; default=1048576
`max_active_observations`	false	integer	maximum=1024; exclusiveMinimum=0; default=128
`max_retained_output_bytes`	false	integer	maximum=1073741824; exclusiveMinimum=0; default=134217728
`max_query_entries`	false	integer	maximum=100000; exclusiveMinimum=0; default=10000

`DaytonaEnvironmentConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`root`	false	string	default="/home/daytona"
`python`	false	string	default="python3"
`shell`	false	string	default="/bin/bash"
`request_timeout_seconds`	false	number	maximum=600; exclusiveMinimum=0; default=120
`max_file_bytes`	false	integer	maximum=67108864; exclusiveMinimum=0; default=16777216
`max_query_entries`	false	integer	maximum=100000; exclusiveMinimum=0; default=10000
`max_output_bytes`	false	integer	maximum=16777216; exclusiveMinimum=0; default=1048576
`snapshot`	false	string 或 null	maxLength=256; default=null

`ModalEnvironmentConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`root`	false	string	default="/"
`python`	false	string	default="/usr/local/bin/python3"
`shell`	false	string	default="/bin/bash"
`request_timeout_seconds`	false	number	maximum=600; exclusiveMinimum=0; default=120
`max_file_bytes`	false	integer	maximum=67108864; exclusiveMinimum=0; default=16777216
`max_query_entries`	false	integer	maximum=100000; exclusiveMinimum=0; default=10000
`max_output_bytes`	false	integer	maximum=16777216; exclusiveMinimum=0; default=1048576
`image`	false	string	minLength=1; maxLength=256; default="python:3.13-slim"
`timeout_seconds`	false	integer	minimum=300; maximum=86400; default=86400
`cpu`	false	number	maximum=64; exclusiveMinimum=0; default=1
`memory`	false	integer	minimum=128; maximum=262144; default=1024

`VercelEnvironmentConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`root`	false	string	default="/vercel/sandbox"
`python`	false	string	default="/vercel/runtimes/python/bin/python3"
`shell`	false	string	default="/bin/bash"
`request_timeout_seconds`	false	number	maximum=600; exclusiveMinimum=0; default=120
`max_file_bytes`	false	integer	maximum=67108864; exclusiveMinimum=0; default=16777216
`max_query_entries`	false	integer	maximum=100000; exclusiveMinimum=0; default=10000
`max_output_bytes`	false	integer	maximum=16777216; exclusiveMinimum=0; default=1048576
`runtime`	false	string	minLength=1; maxLength=128; default="python3.13"
`timeout_seconds`	false	integer	minimum=300; maximum=18000; default=3600
`vcpus`	false	integer	minimum=2; maximum=8; default=2

`SpritesEnvironmentConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`root`	false	string	default="/home/sprite"
`python`	false	string	default="python3"
`shell`	false	string	default="/bin/bash"
`request_timeout_seconds`	false	number	maximum=600; exclusiveMinimum=0; default=120
`max_file_bytes`	false	integer	maximum=67108864; exclusiveMinimum=0; default=16777216
`max_query_entries`	false	integer	maximum=100000; exclusiveMinimum=0; default=10000
`max_output_bytes`	false	integer	maximum=16777216; exclusiveMinimum=0; default=1048576
`region`	false	string 或 null	maxLength=64; default=null

`RunloopEnvironmentConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`root`	false	string	default="/home/user"
`python`	false	string	default="python3"
`shell`	false	string	default="/bin/bash"
`request_timeout_seconds`	false	number	maximum=600; exclusiveMinimum=0; default=120
`max_file_bytes`	false	integer	maximum=67108864; exclusiveMinimum=0; default=16777216
`max_query_entries`	false	integer	maximum=100000; exclusiveMinimum=0; default=10000
`max_output_bytes`	false	integer	maximum=16777216; exclusiveMinimum=0; default=1048576
`blueprint_id`	false	string 或 null	maxLength=128; default=null
`resource_size`	false	"X_SMALL", "SMALL", "MEDIUM", "LARGE", "X_LARGE"	default="SMALL"
`idle_timeout_seconds`	false	integer	minimum=300; maximum=172800; default=3600

`RemoteEnvdEnvironmentConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`egress`	false	EnvdEgressConfiguration 或 null	default=null
`expected_boundary`	false	EnvdBoundaryRequirement 或 null	default=null
`working_directory`	false	string 或 null	format="eip-absolute-path"; default=null
`required_methods`	false	string 数组	maxItems=128; default=[]

`HostLocalProviderConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`host_id`	false	string	minLength=1; maxLength=256; 默认值由模型工厂计算

`DockerConnectionConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`docker_host`	false	string	minLength=1; 默认值由模型工厂计算

`E2BConnectionConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`domain`	false	string	`pattern="^[a-zA-Z0-9](?:[a-zA-Z0-9.-]*[a-zA-Z0-9])?$"`; default="e2b.dev"
`api_url`	false	string 或 null	default=null

`E2B凭据`

字段	必填	类型 / 可选值	约束与默认值
`api_key`	true	string	minLength=1; format="password"

`DaytonaConnectionConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`organization_id`	true	string	minLength=1; maxLength=128
`target`	false	string	minLength=1; maxLength=64; default="us"

`ModalConnectionConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`workspace`	true	string	minLength=1; maxLength=128
`app_name`	true	string	minLength=1; maxLength=128
`environment_name`	false	string	minLength=1; maxLength=128; default="main"

`Modal凭据`

字段	必填	类型 / 可选值	约束与默认值
`token_id`	true	string	minLength=1; format="password"
`token_secret`	true	string	minLength=1; format="password"

`VercelConnectionConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`team_id`	true	string	minLength=1; maxLength=128
`project_id`	true	string	minLength=1; maxLength=128

`SpritesConnectionConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`organization`	true	string	minLength=1; maxLength=128

`RunloopConnectionConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`organization`	true	string	minLength=1; maxLength=128

`Token凭据`

字段	必填	类型 / 可选值	约束与默认值
`api_key`	true	string	minLength=1; format="password"

`HttpEnvdConnectionConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`initialization_timeout`	false	number	maximum=300; exclusiveMinimum=0; default=10
`request_timeout`	false	number	maximum=3600; exclusiveMinimum=0; default=30
`max_in_flight`	false	integer	minimum=1; maximum=1024; default=32
`endpoint`	true	string	minLength=1; maxLength=2048
`allow_plaintext_private_link`	false	boolean	default=false

`HttpEnvd凭据`

字段	必填	类型 / 可选值	约束与默认值
`token`	true	string	minLength=1; maxLength=4096; format="password"

`WebSocketEnvdConnectionConfiguration`

字段	必填	类型 / 可选值	约束与默认值
`connection_timeout`	false	number	maximum=300; exclusiveMinimum=0; default=10

云 provider复制章节链接

DirectLocalEnvironmentConfiguration复制章节链接

DirectLocalRootConfiguration复制章节链接

DirectLocalShellProfile复制章节链接

LocalEnvdEnvironmentConfiguration复制章节链接

AllowlistDestinations复制章节链接

DisabledSandbox复制章节链接

EgressDestinations复制章节链接

EgressMode复制章节链接

EnvdBoundaryRequirement复制章节链接

EnvdEgressConfiguration复制章节链接

EnvdSecretReference复制章节链接

Environment凭据Source复制章节链接

ExecutionIdentity复制章节链接

GrantAccess复制章节链接

PublicDestinations复制章节链接

RestrictedSandbox复制章节链接

SandboxGrant复制章节链接

SandboxPolicy复制章节链接

LocalEnvdLaunchConfiguration复制章节链接

EnvdExecutionConfiguration复制章节链接

EnvdNetworkConfiguration复制章节链接

LocalEnvdShellProfile复制章节链接

DockerEnvironmentConfiguration复制章节链接

DockerMountConfiguration复制章节链接

E2BEnvironmentConfiguration复制章节链接

DaytonaEnvironmentConfiguration复制章节链接

ModalEnvironmentConfiguration复制章节链接

VercelEnvironmentConfiguration复制章节链接

SpritesEnvironmentConfiguration复制章节链接

RunloopEnvironmentConfiguration复制章节链接

RemoteEnvdEnvironmentConfiguration复制章节链接

HostLocalProviderConfiguration复制章节链接

DockerConnectionConfiguration复制章节链接

E2BConnectionConfiguration复制章节链接

E2B凭据复制章节链接

DaytonaConnectionConfiguration复制章节链接

ModalConnectionConfiguration复制章节链接

Modal凭据复制章节链接

VercelConnectionConfiguration复制章节链接

SpritesConnectionConfiguration复制章节链接

RunloopConnectionConfiguration复制章节链接

Token凭据复制章节链接

HttpEnvdConnectionConfiguration复制章节链接

HttpEnvd凭据复制章节链接

WebSocketEnvdConnectionConfiguration复制章节链接

本页目录