Linux 和 Docker 上的 TinyComputer 浏览器
在 Linux 容器中以无头模式运行 TinyComputer 浏览器,使用本地构建的模块和无人值守自动化。
该 browser 工具通过 TinyComputer 模块(libtinycomputer.so)驱动 Chromium。已编译的模块注册表只会为实际发布了 TinyComputer 的平台固定其版本。如果你的 Linux 主机没有对应的固定版本,或者你需要使用与你的核心构建所依据的确切 vendor/tinycomputer gitlink 构建的模块,请自行构建,并通过模块覆盖配置让核心使用它。
本页介绍容器构建配方、加载器的目录规则、无头研究代理所需的浏览器设置,以及如何让由 cron 驱动的轮次在没有交互式批准的情况下点击和输入。
1. 在构建器阶段构建模块
vendor/tinycomputer/scripts/build-module 会完成加载器所需的一切操作。它会运行 cargo build --locked --release -p tinycomputer --lib 并将 libtinycomputer.so 安装到 TINYCOMPUTER_MODULE_DIR (权限模式 644,目录 755)。它会在 modules.toml 中记录该库的 SHA-256,并将文件放在库文件旁边;随后逐级检查所有父目录,如果加载器会拒绝其中任何一个目录,就会提前报错。
先初始化嵌套子模块(git submodule update --init --recursive vendor/tinycomputer)。TinyComputer 自带 TinyBus、agent-browser 和 agent-desktop。请使用与核心相同的代码检出版本进行构建:如果模块的 TinyComputer 契约版本与核心自身的版本不兼容,主机将拒绝加载该模块。
# 根据此代码检出记录的 gitlink 构建 libtinycomputer.so。
FROM rust:1.99.1-bookworm AS tinycomputer
RUN apt-get update && apt-get install -y --no-install-recommends \
build-essential pkg-config ca-certificates \
libasound2-dev libxdo-dev libxtst-dev libx11-dev \
&& rm -rf /var/lib/apt/lists/*
WORKDIR /src/tinycomputer
COPY vendor/tinycomputer/ ./
# 始终由 root 拥有且权限为 755:这是加载器接受的设置。
ENV TINYCOMPUTER_MODULE_DIR=/opt/tinycomputer
RUN scripts/build-module然后,将它添加到仓库 Dockerfile 的运行时阶段(其中已包含模块链接所需的运行时库 libasound2, libxdo3, libxtst6 和 libx11-6 ),并一并添加 Chromium:
加载器检查的内容
TinyBus 加载器(vendor/tinybus/crates/tinybus/src/module/host.rs)会拒绝不满足以下所有条件的构件:
从
/到模块自身 的每个目录,都必须归 root 或核心程序运行用户(镜像中的 uid10001)所有。除非设置了粘滞位,否则这些目录都不得允许组或其他用户写入。路径中的符号链接组件会被拒绝,库文件本身则使用O_NOFOLLOW打开。不要将模块放在绑定挂载或命名卷中:这些位置通常归其他用户所有,或允许组用户写入。文件 必须是一个小于 512 MiB 的普通
.so文件。modules.toml与库文件放在一起时,其中必须记录该库准确的 SHA-256 值。若校验值不匹配,加载器就会拒绝该库,因此重新构建库后需要重新生成modules.toml由build-module生成的文件。请将两者放在一起。若没有此证明,模块仍会加载,但不会被视为经过证明的接收方,因此不会向它发送诸如StartTask(task操作)之类的机密调用。
模块一旦被拒绝或发生故障,就会一直处于拒绝状态,直到核心程序重启。
2. 使用模块覆盖项加载
id 是注册表 ID(tinycomputer),而 path 是库文件的绝对路径。覆盖项会优先于搜索路径和发布缓存进行检查,并绕过已编译的发布版摘要,因此只有操作者自己的配置可以指定覆盖项(config/schema/modules.rs, modules::ops::local_override). [modules] enabled 必须保持为 true (默认值)。
3. 无头研究代理的浏览器设置
chrome_path会作为浏览器可执行文件传递给模块。Debian 的chromium软件包会安装/usr/bin/chromium.profile_mode = "persistent"需要一个 绝对路径profile_path,而且download_dir也必须是绝对路径。否则会拒绝该会话。请将二者放在工作区卷(镜像中的/home/openhuman/.openhuman)下;入口点会将其所有者改为核心程序的用户,因此容器重启后这些文件仍会保留。导航遵循
[http_request].allowed_domains的设置。列表为空时会拒绝所有会话。若要允许浏览器访问任意位置,请在容器环境中设置OPENHUMAN_BROWSER_ALLOW_ALL=1,而不要添加"*".agent-browser 检测到容器、root 用户或较小的
--no-sandbox和--disable-dev-shm-usage时,会自动添加这两个参数。/dev/shm.
4. 无人值守操作
默认情况下,每次单击、双击、填充、输入、按键、选择和勾选操作都必须通过强制的主机审批关卡。浏览器任务暂停在 needs_approval时也一样。强制关卡只会在实时 WebChat 轮次中等待审批,其他情况一律拒绝;因此,若不设置下文所述选项,cron 作业可以打开并读取页面,却无法点击“下一页”链接。
[browser] unattended_actions 指定 受信任的无人值守轮次 无需审批即可执行的操作类型:
click, double_click
单击元素,包括使用 find 并设置 find_action = "click"
fill, type
在字段中输入文本
press
按下按键,例如 Enter
select, check
选择选项、勾选复选框
task_step
浏览器 task 暂停于 needs_approval 在执行不可逆步骤前,并通过 confirm_pending
该工具从每个回合的
CoreContext中读取回合来源;cron、后台任务和工作流入口会在各自回合的作用域内设置该上下文。只有 来源为
TrustedAutomation且来源类型为Cron,CronActions(其代理已选择启用scheduled_actions),Background,或Workflow { require_approval: false }的 cron 回合才符合条件。无论是否启用了该选项,cron 回合都会经过此检查:browser工具声明自身不会产生外部影响,因此安全门的只读 cron 阶段会放行调用,而是否执行该操作则由此处决定。WebChat、外部渠道(Telegram、Slack 等)、CLI 和直接聊天、未标记的回合,以及设置了
require_approval = true的工作流,仍会像之前一样强制通过安全门,即使操作在允许列表中也不例外。默认列表为空,因此不会改变任何行为。
未知名称不会放行任何操作。加载时,核心会记录一条警告,其中包含未知条目的数量(绝不包含其文本)以及已知名称列表。
每个获准操作都会以
info级别记录,包含操作类型、摘要的前 12 个十六进制字符以及来源类别。不会记录选择器、输入值、页面内容或任务 ID。搜索[browser] unattended action allowed.付款检查点不会
needs_approval暂停。无论此列表如何设置,任务到达该处时仍会停止。
task_step 会放行任务控制器自身标记为不可逆的步骤,例如发送、提交或删除。仅将其列入适用于提示词和允许访问网站均由你控制的任务。
5. 拒绝数据中心地址的网站
有些网站会屏蔽整个数据中心网段。例如,Reddit 会对来自云虚拟机的所有页面请求返回“你已被网络安全系统屏蔽”。要解决这个问题, [browser] upstream_proxies 可将选定域名的流量经由上游 HTTP 代理路由,例如住宅或移动网络出口:
域名匹配自身及其所有子域名。其他所有主机仍会直接连接。
路由不会绕过策略。TinySecurity 会像授权直接访问的页面一样,逐一授权每个经路由访问的页面;禁止访问列表仍然适用。TinyComputer 打开套接字连接到代理之前,代理自身的主机和端口也必须通过 TinySecurity 的浏览器拨号授权。随后,TinyComputer 会要求代理建立一个
CONNECT隧道,连接到 TinySecurity 为该页面主机批准的地址,因此代理不会进行任何解析。浏览器的Host标头和 TLS SNI 会原样通过隧道。普通的http://页面也使用同一隧道。仅支持
http://代理 URL。用户名或密码中的@,:或/都必须进行百分号编码。凭据会以Proxy-Authorization: Basic.URL 本身就是凭据。它只会通过 TinyComputer 的主机私有
browser.egress部分传递给 TinyComputer。配置快照和调试输出中会对其进行遮蔽,且绝不会记录到日志中。请确保只有核心程序的用户可以读取config.toml。只有启用了浏览器出口流量强制管控时,此功能才有效;默认构建已启用该功能,并包含
security-module。更改列表后,须等核心程序下次启动才会生效。如果代理拒绝凭据(
407)或拒绝建立隧道,页面将失败并显示502。核心日志中只会记录状态。
最后更新于