指南
API
博客
版本
指南
API
博客
简体中文

浏览器配置

AIO Sandbox 在容器内运行 Chromium。可以通过环境变量配置语言、首页、User-Agent 和启动参数。

常用变量

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

语言

docker run --security-opt seccomp=unconfined --rm -it \
  -p 8080:8080 \
  -e BROWSER_LANG=en-US \
  ghcr.io/agent-infra/sandbox:latest

首页

-e HOMEPAGE=https://example.com

User-Agent

-e BROWSER_USER_AGENT="Mozilla/5.0 ..."

额外启动参数

高级 Chromium flag 可以通过 BROWSER_EXTRA_ARGS 传入：

-e BROWSER_EXTRA_ARGS="--disable-dev-shm-usage"

建议谨慎修改启动参数。删除默认安全或进程相关参数可能影响自动化稳定性。

运行时配置

部分浏览器设置也可以通过以下 API 查看或更新：

  • POST /v1/browser/config
  • POST /v1/browser/restart
  • GET /v1/browser/info

示例：

curl -X POST http://127.0.0.1:8080/v1/browser/config \
  -H 'Content-Type: application/json' \
  -d '{"resolution":{"width":1280,"height":720}}'