Windows 中搭建 browser-use WebUI 1.4
目录
- 1. 背景介绍
- 2. 搭建过程
- 3. 补充
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 数据。
- 选中浏览器设置中的“使用自己的浏览器”选项。
