AgentENV配置参考：TOML配置项与环境变量完整清单

AgentENV配置参考TOML配置项与环境变量完整清单【免费下载链接】AgentENVAgentENV (AENV) is a distributed platform for running agent environments at scale.项目地址: https://gitcode.com/gh_mirrors/age/AgentENVAgentENVAENV是一个用于大规模运行智能体环境的分布式沙箱平台其运行行为由一份 TOML 配置文件和一组环境变量共同决定。本文帮你快速读懂 AgentENV 配置从默认配置文件 config/default.toml 的每个配置段到服务、网关、调度器的环境变量清单以及 docs/src/configuration/reference.md 与 docs/src/configuration/env-vars.md 中的关键细节让你不用翻源码也能完成生产级配置。 配置文件在哪里、如何生效AgentENV 服务器启动时会读取 TOML 配置文件默认路径config/default.toml覆盖方式一设置环境变量AENV_CONFIG_PATH/path/to/config.toml覆盖方式二启动参数cargo run --bin server -- --config /path/to/config.toml几个新手容易踩的坑建议先看一眼路径中的$AENV_HOME是配置占位符会被替换成home_path解析后的值不是 Shell 环境变量$AENV_RUNTIME同理指向runtime_path其他相对路径以配置文件所在目录为基准解析依赖版本与下载地址由 config/deps_manifest.toml 统一管理Firecracker、内核、工具盘、OverlayBD、regctl 等用户配置里只写行为参数和本地路径覆盖不要往里面填依赖目录大多数路径配置都有对应环境变量可覆盖环境变量优先级高于 TOML 全局配置项配置项默认值说明环境变量覆盖home_path/var/lib/aenv状态、缓存、日志、依赖的根目录AENV_HOME_PATHruntime_path/run/aenv临时 socket 与网络命名空间状态AENV_RUNTIME_PATHdeps_path$AENV_HOME/deps自动下载的运行时资产目录AENV_DEPS_PATHvirtualization_modekvm虚拟化模式可选kvm/pvmAENV_VIRTUALIZATION_MODE⚠️ 注意快照和暂停的沙箱只能在与创建时相同的虚拟化模式下恢复混用 KVM 与 PVM 节点时请保持模式一致。 TOML 配置段完整清单config/default.toml 按功能划分了配置段下表是全量索引详细说明见 docs/src/configuration/reference.md配置段作用高频配置项[firecracker]微 VM 二进制与启动参数boot_args、socket_timeout_secs、log_level[kernel]微 VM 使用的 Linux 内核镜像image_path[tools]控制面工具盘与 envd 端口control_plane_port默认 49983[image.resolver]模板构建镜像解析default_image、search_registries、allowed_registries[image.cache]/[image.cache.gc]本地镜像缓存与垃圾回收capacity_gb、interval_secs、水位比例[sandbox_proxy]基于域名的沙箱数据面路由domains[network.egress]节点级出口管控优先于沙箱策略always_denied_cidrs[network.internal]沙箱内部地址池host_interaction_cidr、veth_cidr[machine]沙箱默认 VM 资源mem_size_mib1024、vcpu_count2[envd]来宾内 envd 守护进程version、init_timeout_secs[sandbox]沙箱访问令牌派生密钥access_token_hash_seed[volume]持久卷限制max_size_mb256 GiB、max_volume_count4[orchestrator]沙箱生命周期管理default_sandbox_timeout_secs15 秒、auto_evict_interval_ms[pool]/[pool.firecracker]热池预热网络槽、块设备、Firecracker 进程low_watermark、high_watermark、startup_prewarm[snapshot]快照仓库后端与压缩repository_backend、p2p_enabled[backend.posix_fs]/[backend.oss]快照持久化后端snapshot_storeendpoint、bucket、region[ublk]/[ublk.overlaybd]用户态块设备与 OverlayBD 行为daemon_metrics_listen_addr、runtime_upper_mode[memory_snapshot]内存快照 OverlayBD 配置track_dirty_pages[memory_snapshot.background_download]远程内存层后台下载block_size、concurrency、max_inflight_blocks[template_build]BuildKit 构建器资源max_concurrent_builds、builder_image、builder_cpu_count[p2p]P2P 构件传输实验性enabled默认 false、transport[observability]节点指标采集与调度器心跳enabled、scheduler_report.interval_secs[cluster]共享调度器 gRPC 端点scheduler_endpoint[custom_extension]自定义扩展生命周期钩子url、timeout_ms[node_identity]节点标识node_id、cluster_id、service_instance_id新手建议单机部署只需关心[machine]、[orchestrator]、[snapshot]和[pool]四段多节点部署再补上[cluster]、[node_identity]和[observability.scheduler_report]。 快照存储posix_fs 还是 OSS[snapshot].repository_backend决定快照落盘位置这是生产环境最常改的一项posix_fs默认快照存本地或共享文件系统只需配置[backend.posix_fs].snapshot_store可用AENV_SNAPSHOT_STORE覆盖oss快照存入 S3 兼容对象存储[backend.oss]必须提供endpoint、bucket、region凭据二选一credential_process外部命令优先级更高access_key_id/access_key_secret静态凭据多节点恢复场景下记得在每个运行节点上配置相同的AENV_SANDBOX_ACCESS_TOKEN_HASH_SEED否则跨节点恢复沙箱会失败。 服务器环境变量速查变量默认值说明AENV_API_KEY自动生成于$AENV_HOME/secrets/api-keyAPI 密钥多节点需统一API_ADDR0.0.0.0:8000API 服务监听地址AENV_CONFIG_PATHconfig/default.tomlTOML 配置文件路径AENV_LOG_FORMATcompact日志格式compact/pretty/jsonAENV_NODE_ID/AENV_CLUSTER_ID/AENV_SERVICE_INSTANCE_ID自动派生覆盖节点标识与集群 UUIDAENV_HOME_PATH/AENV_RUNTIME_PATH/AENV_DEPS_PATH/var/lib/aenv等覆盖三大基础目录AENV_VIRTUALIZATION_MODEkvm仅按 PVM 部署指南设置pvmAENV_SANDBOX_PROXY_DOMAINS来自配置启用{port}-{sandboxID}.{domain}风格代理 URLAENV_OBSERVABILITY_SCHEDULER_REPORT_ENABLED来自配置开关调度器心跳上报AENV_FORCE_SYSCTL_TUNING未设置特权容器内设为1强制内核调优完整清单见 docs/src/configuration/env-vars.md。 网关与调度器多节点部署多节点模式额外运行 gateway 与 scheduler 两个 Go 服务默认配置示例见 deploy/docker/config/default.json、deploy/k8s/base/config/gateway.json 和 deploy/k8s/base/config/scheduler.json变量默认值所属说明GATEWAY_HTTP_LISTEN_ADDR:8080GatewayHTTP 监听地址GATEWAY_SCHEDULER_ADDR127.0.0.1:9090Gateway调度器 gRPC 地址GATEWAY_METRICS_LISTEN_ADDR:9102GatewayPrometheus 指标地址SCHEDULER_GRPC_LISTEN_ADDR:9090SchedulergRPC 监听地址SCHEDULER_STRATEGYround_robinScheduler节点选择策略round_robin/randomSCHEDULER_REDIS_ADDR未设置Scheduler沙箱-节点绑定持久化到 Redis重启不丢失LOG_LEVEL/LOG_FORMATinfo/auto两者共用日志级别与格式 单机模式下无需网关和调度器API_ADDR即入口多节点模式下客户端统一访问 Gateway 的:8080。 客户端E2B SDK如何指向 AgentENV如果你用 E2B SDK 访问 AgentENV只需三个变量变量说明E2B_API_URL服务器 API 基址单机http://127.0.0.1:8000多节点http://127.0.0.1:8080E2B_SANDBOX_URL沙箱代理 URL通常与E2B_API_URL相同E2B_API_KEY填入部署的AENV_API_KEY✅ 最小生产配置示例以默认文件为底多节点部署通常只需追加这几行[node_identity] node_id node-a cluster_id 你的集群UUID [cluster] scheduler_endpoint http://127.0.0.1:9090 [observability.scheduler_report] enabled true interval_secs 5 [snapshot] repository_backend oss [backend.oss] endpoint https://你的对象存储端点 bucket aenv-snapshots region cn-beijing配置优先级小结环境变量 TOML 配置文件 内置默认值依赖版本始终来自 config/deps_manifest.toml用户配置只关注行为参数。 延伸阅读完整配置参考docs/src/configuration/reference.md环境变量清单docs/src/configuration/env-vars.md默认配置全文config/default.toml部署方式Docker / Compose / Kubernetes / PVMdocs/src/deployment/配置解析源码src/cfg.rs【免费下载链接】AgentENVAgentENV (AENV) is a distributed platform for running agent environments at scale.项目地址: https://gitcode.com/gh_mirrors/age/AgentENV创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考