持久登录配置文件¶
持久配置文件会在浏览器会话之间保留登录状态。
npm¶
mkdir -p .profiles/default
PLAYWRIGHT_MCP_USER_DATA_DIR="$PWD/.profiles/default" \
npx -y cloakbrowser-mcp@latest
用同一命令配置 MCP 客户端。不要在两个活动服务器之间共享一个配置文件目录。
异常退出后,桥接器仅在记录的进程 ID 有效且确认该进程已不存在时,才会移除 .cloakbrowser-mcp-profile.lock。如果锁的所有者仍在运行、内容无法读取或无效,或者进程状态无法确定,启动仍会被阻止。此恢复操作不会终止残留的 Chromium 进程,也不会移除 Chromium 自身的锁。
同一配置文件每次只能重启一个服务器:重新检查并移除过期锁不是原子操作。如果写入新建锁文件失败,桥接器会关闭文件描述符,并仅在路径仍指向该文件时删除它。
Docker¶
docker run --rm -i \
-e PLAYWRIGHT_MCP_USER_DATA_DIR=/data/profiles/default \
-v "$PWD/artifacts:/data" \
swimmwatch/cloakbrowser-mcp:latest
环境变量中使用容器路径;主机路径只出现在 volume mount 中。
验证¶
- 请让 MCP 客户端打开登录页面并登录。
- 正常停止服务器。
- 使用相同的
PLAYWRIGHT_MCP_USER_DATA_DIR再次启动服务器。 - 请让客户端重新访问网站,确认登录状态仍保留。
相关内容¶
CloakBrowser 0.6.0¶
启用 CloakBrowser stealth 时,显式配置的持久配置文件会将指纹种子保存在 .cloakbrowser-seed 中。升级后的首次启动会在文件缺失时分配种子。显式的 --fingerprint(包括 --fingerprint=off)优先,且不会修改该文件。禁用 stealth 时不会修改种子文件。损坏的文件会重新生成并发出警告;文件访问失败会阻止启动。