78 lines
3.6 KiB
Markdown
78 lines
3.6 KiB
Markdown
# 信任边界说明(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` | 把启动期安全校验降级为警告 |
|