Executor Manager 配置
调度、分发与回调协调相关的环境变量。负责调度任务,并协调 Backend 与 Executor 服务。
必需(否则无法启动或无法调度执行):
BACKEND_URL:Backend 地址,示例:http://backend:8000INTERNAL_API_TOKEN:必须与 Backend 的INTERNAL_API_TOKEN一致CALLBACK_BASE_URL:必须能被 Executor 容器访问到,Docker Compose 默认http://host.docker.internal:8001EXECUTOR_IMAGE:Executor 镜像名(Executor Manager 会通过 Docker API 拉起该镜像)。默认建议:ghcr.io/poco-ai/poco-executor:liteEXECUTOR_BROWSER_IMAGE:可选,启用浏览器/桌面能力时使用的 Executor 镜像(用于browser_enabled=true)。默认建议:ghcr.io/poco-ai/poco-executor:fullPOCO_BROWSER_VIEWPORT_SIZE:可选,浏览器视口大小(影响截图与响应式布局),格式如1366x768/1920x1080。该值由 Executor Manager 透传给 Executor 容器(仅browser_enabled=true时)。EXECUTOR_TIMEZONE:可选,透传给 Executor 容器的时区(IANA 时区名,如Asia/Shanghai、UTC)。默认Asia/Shanghai。EXECUTOR_PUBLISHED_HOST:Executor Manager 访问“已映射到宿主机端口”的 Executor 容器时使用的 host(本地裸跑一般是localhost;Compose 内推荐host.docker.internal)WORKSPACE_ROOT:工作区根目录(必须是宿主机路径,因为会被 bind mount 到 Executor 容器)S3_ENDPOINT/S3_ACCESS_KEY/S3_SECRET_KEY/S3_BUCKET:用于导出 workspace 到对象存储(否则相关接口会失败)- 可选配置
S3_KEY_PREFIX,将所有对象读写统一收敛到如poco-prod这样的前缀下 - 可选配置
S3_PUBLIC_READ,让后端返回公开文件直链而不是预签名 URL - 可选配置
S3_PUBLIC_ENDPOINT_BUCKET_BOUND,用于标记公共端点是否已经绑定到单 bucket 域名 - 可选配置
S3_SIGNATURE_VERSION,用于覆盖 boto3 的签名模式(阿里云 OSS 常需设为s3) - Cloudflare R2 通常建议:
S3_REGION=auto,S3_FORCE_PATH_STYLE=false
- 可选配置
执行模型(跑任务时必需):
ANTHROPIC_API_KEY:必需(支持 Anthropic 官方或 Anthropic 兼容服务)ANTHROPIC_BASE_URL(默认https://api.anthropic.com;使用兼容服务时建议显式配置)DEFAULT_MODEL(默认claude-sonnet-4-20250514;需与所用端点兼容)
调度与拉取:
TASK_PULL_ENABLED(默认true):是否从 Backend run queue 拉取任务MAX_CONCURRENT_TASKS(默认5)TASK_PULL_INTERVAL_SECONDS(默认2)TASK_CLAIM_LEASE_SECONDS(默认900):claim 的租约时间。需要覆盖 Manager 侧从 claim 到成功 start_run 的耗时(可能包含技能/附件 staging、拉起 Executor 容器等),否则 run 可能在租约过期后被重新 claim,导致重复调度/重复启动容器。SCHEDULE_CONFIG_PATH:可选,提供 TOML/JSON schedule 配置时会作为 source of truth
工作区清理(可选):
WORKSPACE_CLEANUP_ENABLED(默认false)WORKSPACE_CLEANUP_INTERVAL_HOURS(默认24)WORKSPACE_MAX_AGE_HOURS(默认24)WORKSPACE_ARCHIVE_ENABLED(默认true)WORKSPACE_ARCHIVE_DAYS(默认7)WORKSPACE_IGNORE_DOT_FILES(默认true)