环境变量配置

AIO Sandbox 通过环境变量在容器启动时配置各项服务。通过 Docker、Compose 或 SDK 配置传入时,建议把值都作为字符串处理。

工作目录

变量默认值用途
WORKSPACE/home/gemShell、代码执行、Jupyter 和 code-server 的默认工作目录
USERgem容器内运行用户

网络与代理

变量默认值用途
PROXY_SERVER浏览器和网络流量使用的上游 HTTP/HTTPS 代理
PROXY_EXCLUDE不经过上游代理的主机列表
PROXY_INCLUDE白名单模式下需要经过上游代理的主机列表
PROXY_MAP高级代理场景的静态主机映射规则

浏览器

变量默认值用途
HOMEPAGEChromium 启动时打开的页面
BROWSER_LANGen-US浏览器语言和 Accept-Language 偏好
CHROME_UI_LANGChromium UI 语言
BROWSER_USER_AGENT默认 Chromium UA自定义 User-Agent
BROWSER_EXTRA_ARGS追加 Chromium 启动参数

服务

变量默认值用途
CODE_SERVER_PORT8200code-server 内部端口
DISABLE_CODE_SERVERfalsetruthy 时关闭 code-server
DISABLE_JUPYTERfalsetruthy 时关闭 JupyterLab
SANDBOX_SRV_PORT8080容器内主 API 服务端口

安全

变量默认值用途
JWT_PUBLIC_KEY启用 API 和 Web 路由的 Bearer token 校验
AUTH_TOKEN简单部署场景的共享 token,取决于运行镜像是否支持

生命周期 Hooks

变量执行时机
RUN_HOOK_INIT最早启动阶段
RUN_HOOK_PRE_SERVICES托管服务启动前
RUN_HOOK_POST_READY服务就绪后

示例见 AIO Hooks