安装、启动与健康检查

本章目标是让 deepseek-browser-use 服务正常响应健康检查。浏览器任务在下一章创建。

环境准备

当前源码需要 Java 21 或以上环境。源码运行还需要 Maven；使用 dsb 客户端需要 Python 3，无需安装第三方 Python 包。选用平台对应的发行包或在源码目录运行，示例中的路径均相对于项目根目录。

准备与操作系统、处理器架构对应的发行 JAR：

java -jar <发行包文件名>.jar

平台发行包包含相应 Chromium 资源。实际选用的浏览器由配置和任务启动参数决定，创建任务后应检查回执中的 effectiveBrowser 与 engineHonored。不要仅凭包名判断浏览器引擎。

在仓库根目录执行：

cd playwright-server
mvn spring-boot:run

这里使用 Maven 插件启动配置的主类；真正的应用入口是 nexus.io.ai.browser.PlaywrightApp，内部调用 TioApplication.run(...)。

Windows 长时间使用时，可以在仓库根目录运行项目自带后台脚本：

.\scripts\run\start-server.cmd -Port 10049 -Engine chromium

后台脚本执行健康检查，并记录日志。不要同时重复启动占用相同端口和 profile 的服务。浏览器安装或启动失败时，先查看启动日志与实际配置，再按浏览器与 profile 排查。

在另一个终端进入仓库根目录：

python client/dsb.py --port 10049 health
python client/dsb.py --port 10049 methods
python client/dsb.py --port 10049 config

也可以直接请求：

curl http://localhost:10049/playwright/health
curl http://localhost:10049/playwright/methods

健康检查应返回 ok:true；命令列表位于 data.methods。健康检查通过只表示 HTTP 服务正常，不能证明浏览器已经成功启动。下一章的 start 才会验证浏览器创建。

配置文件 playwright-server/src/main/resources/app.properties 设置默认端口。Java 扩展代码使用 EnvUtils.get 读取配置。配置项的实际生效值可以通过 /playwright/config 查看，详见配置与运维。

示例使用 localhost 访问；这不等于服务绑定地址已经限制为回环接口。当前应用配置只明确了端口，没有提供内置鉴权，部署时需核对实际监听地址和网络访问范围。

任务结束先调用该任务的 close。需要停止整个服务时，在仓库根目录运行：

.\scripts\run\stop-server.cmd -Port 10049

停止脚本先关闭浏览器，再结束服务进程。命令 shutdown 会关闭所有任务与共享浏览器，但不会单独终止 Java 进程。已有登录任务运行时，不要为了新建任务随意停止共享服务。