3.6 KiB
信任边界说明(S2 / S3)
本文档是 2026-09 代码审查(
docs/review/CODE_REVIEW_REPORT.md)中 S2「自定义代码非安全沙箱」 与 S3「解析器安装立即 import」 的配套说明。 它记录的是本项目当前实际具备的隔离强度,以及在什么前提下这些能力是安全的。
一句话结论
本项目假定「能配置命令 / 能安装解析器的人 = 能在服务器上执行任意代码的人」。
命令引擎的 Python/JS 执行不是安全沙箱,它是一个误操作防护(guardrail)。 如果你的威胁模型里包含「不可信的人来写这些脚本」,那么当前架构无法满足, 必须换成独立低权限进程 / 容器方案。
具体是什么情况
1. 命令引擎的 Python 脚本
app/services/command_engine_actions.py
默认走受限模式:AST 白名单校验 + 受限 __builtins__ + import 白名单
(CMD_PYTHON_SANDBOX_ALLOWED_IMPORTS 可扩展)。
为什么这不是沙箱:
- 脚本运行在主服务进程内,与浏览器控制、配置读写共享同一套权限。
- 执行上下文里注入了高权限对象(标签页会话、规则记录回调等)。 即便直接调用被 AST 规则挡住,通过这些对象的属性链依然可能绕行。
- CPython 层面从来没有承诺过「受限
__builtins__等于安全边界」。 历史上这类方案被绕过的方式层出不穷。
CMD_ALLOW_UNSAFE_PYTHON_COMMANDS=true 会完全关闭上述限制
(直接注入完整 __builtins__)。默认为 false。
2. 命令引擎的 JS 脚本
JS 通过 CDP 在受控浏览器里执行,天然拥有该页面的全部能力: 读取已登录会话、发起同源请求、读写页面数据。 这就是这个功能的用途,不存在也不打算存在隔离。
3. 运行时解析器安装
app/services/parser_manager.py
安装 = 把源码写进 app/core/parsers/ 并立刻 import,
从此以服务进程的完整权限运行。
当前的加固(见 S3):
- 默认关闭,需显式
PARSER_INSTALL_ENABLED=true; - 模块顶层不允许出现可执行语句(裸调用 /
for/while/with), 把「装上就跑」收窄为「被调用才跑」,给人工审查留出窗口; - 记录源码 SHA-256 便于事后核对。
这些都不是隔离。 类方法体内可以写任何代码。
部署要求
| 场景 | 要求 |
|---|---|
| 单机自用(默认) | APP_HOST=127.0.0.1。保持默认即可。 |
| 对外绑定 | 必须配置 DASHBOARD_AUTH_ENABLED=true + 强 DASHBOARD_AUTH_TOKEN(启动期强校验,见 S1)。 |
| 对外绑定 + 代码执行开关 | 不允许。CMD_ALLOW_UNSAFE_PYTHON_COMMANDS=true 或 PARSER_INSTALL_ENABLED=true 与非回环 APP_HOST 同时出现时,服务拒绝启动。 |
| 多租户 / 不可信投稿脚本 | 当前架构不支持。需在低权限独立进程或容器内执行,剥离浏览器与配置对象,并限制出网与资源。 |
启动期检查实现在 app/core/http_security.py::startup_security_errors(),
由 main.py 的 lifespan 调用。
隔离网络中如需临时跳过,可设 UWA_ALLOW_INSECURE_STARTUP=true(不推荐)。
相关配置项
| 变量 | 默认 | 说明 |
|---|---|---|
CMD_ALLOW_UNSAFE_PYTHON_COMMANDS |
false |
关闭 Python 脚本的全部限制 |
CMD_PYTHON_SANDBOX_ALLOWED_IMPORTS |
空 | 在受限模式下额外放行的 import(逗号分隔) |
PARSER_INSTALL_ENABLED |
false |
允许运行时安装解析器 |
UWA_ALLOW_INSECURE_STARTUP |
false |
把启动期安全校验降级为警告 |