Windows 中搭建 browser-use WebUI 1.4

1. 背景介绍

背景：想要在 Windows 中复现 browser-use WebUI pickle反序列化漏洞，该漏洞在 v1.7 版本中已经修复，所以需要搭建 小于 1.7 版本的环境，我这里搭建的是 1.4 版本。

项目地址：https://github.com/browser-use/web-ui.git

2. 搭建过程

新建一个目录：WebUI

在这个目录中打开cmd，克隆仓库：git clone https://github.com/browser-use/web-ui.git

进入安装目录：cd web-ui

切换到1.4版本：git checkout v1.4

一定要切换版本，最新版已经修复了，在webui的目录下执行命令：git describe --tags
这个命令会输出你当前所在的 版本 tag（如果在 tag 上），或显示你基于哪个 tag 派生出来的。

官方建议使用 uv 来管理 Python 环境。

安装 uv：pip install uv

使用 uv：uv venv --python 3.11

激活虚拟环境：.venv\Scripts\activate

在安装依赖前需要做一些改动。按照直接 clone 下来的 requirements ，最后启动的时候会一直报错错：TypeError: argument of type 'bool' is not iterable

反复试了很多次，最后自己摸索出来的解决办法是修改 requirements.txt 文件，将 gradio 的版本改为 5.23.1：gradio==5.23.1

（在虚拟环境中）安装python依赖：uv pip install -r requirements.txt

在 Windows 的 cmd 命令行中，进入 Python 虚拟环境后的标志通常是在命令行提示符前面看到虚拟环境的名称。前面的 (web-ui) 表示你当前已经激活了名为 web-ui 的虚拟环境（名称取决于你创建虚拟环境时使用的名字），后是你当前所在的目录路径：

安装浏览器运行环境：playwright install

（安装这个环境的话，使用 web-ui 的时候不选择用自己的浏览器，就会启动现在安装的浏览器环境。如果想用自己的浏览器，就不用安装这个，后面再修改一下配置文件即可。）

（在虚拟环境中）配置环境：copy .env.example .env

配置文件 .env ，可以在里面修改浏览器的地址，设置各种 api 等。

（在虚拟环境中）启用 WebUI：python webui.py --ip 192.168.119.1 --port 7788

在浏览器中访问：http://192.168.119.1:7788

3. 补充

如果前面没有安装浏览器运行环境，想使用自己的浏览器，需要做以下更改。

在 .env 文件中修改：

CHROME_PATH="C:\Program Files\Google\Chrome\Application\chrome.exe"
CHROME_USER_DATA="C:\Users\你的username\AppData\Local\Google\Chrome\User Data"

CHROME_PERSISTENT_SESSION=true

其中：

CHROME_PATH 是浏览器的执行文件的路径，需要自己做修改，不要直接复制。

CHROME_USER_DATA 是浏览器的数据目录，需要自己做修改，不要直接复制。

CHROME_PERSISTENT_SESSION 是设置让浏览器一直打开，可选项。

接下来：

• 关闭所有 Chrome 窗口
• 在非 Chrome 浏览器（如 Firefox 或 Edge）中打开 WebUI （192.168.119.1:7788）。这一点很重要，因为持久性浏览器上下文将在运行代理时使用 Chrome 数据。
• 选中浏览器设置中的“使用自己的浏览器”选项。