在 Chrome 136+ 用 browser-use 打开「带登录态」浏览器的完整攻略
适用场景：Python + Playwright ⬄ browser-use ≥ 0.1.42
目标：无需重复登录，稳定复用本机 Chrome Profile
一、背景
| 版本 | 说明 | |
|---|---|---|
| Chrome ≤135 | 允许默认 Profile 开启调试端口 | 无特殊限制 |
| Chrome ≥136 | 强制要求 **--user-data-dir** 若进程携带 --remote-debugging-port/pipe，必须 同时提供 非默认 --user-data-dir。默认 Profile 会屏蔽调试端口 |
默认 Profile 禁用调试端口 |
**browser-use≤0.1.40** |
连接默认 Profile 时触发 **ECONNREFUSED** |
无法适配新安全策略 错误：ECONNREFUSED ::1:9222 |
**browser-use≥0.1.42** |
自动创建临时 Profile（**/tmp/browseruse-***） |
登录态丢失但可正常连接 |
1. Chrome 136 升级日志文档
- Custom data directory required for remote debugging
Remote debugging via a TCP port or a pipe is no longer possible in Google Chrome with the default data directory on Windows, Linux, and macOS. A custom data directory must be specified to remotely debug Google Chrome using the --user-data-dir switch, when using the --remote-debugging-pipe or --remote-debugging-port switches.
We've made this change because these remote debugging switches are being abused by infostealers and malware to extract data from Google Chrome. A custom user data directory uses a different encryption key and so it prevents malware stealing encrypted data such as cookies.
This change does not affect Chrome for Testing and Chromium.
- Chrome 136 on Linux, macOS, Windows
2. Python 代码报错文案
ERROR [browser] ❌ Failed to start a new Chrome instance: BrowserType.connect_over_cdp: connect ECONNREFUSED ::1:9222
Call log:
retrieving websocket url from http://localhost:9222
ERROR [browser] Failed to initialize Playwright browser: To start chrome in Debug mode, you need to close all existing Chrome instances and try again otherwise we can not connect to the instance.
ERROR [browser] ❌ Failed to create new browser session: To start chrome in Debug mode, you need to close all existing Chrome instances and try again otherwise we can not connect to the instance. (did the browser process quit?)
WARNING [browser] ⚠️ Page load failed, continuing...
二、核心思路
- 使用 shell 脚本复制一份现有 Profile（包含 cookie 等）到专用目录
- Python 代码里显式设置 --user-data-dir=<专用目录>
- 可选：多实例/并行→每份 Profile 用独立端口
三、Shell 脚本
1. Shell 脚本
bash
#!/usr/bin/env bash
set -e
PROFILE_DIR="${HOME}/.chrome-profiles/agent" # 可以改成自己需要放在的位置
CHROME_DEFAULT="${HOME}/Library/Application Support/Google/Chrome/Default"
echo "▶ 准备持久化 profile：$PROFILE_DIR"
if [ -d "$PROFILE_DIR" ]; then
echo " 目录已存在，跳过复制（如果要重新复制，请先删掉）"
else
mkdir -p "$PROFILE_DIR"
echo " 复制现有登录态...（可能稍慢，取决于文件大小）"
cp -R "$CHROME_DEFAULT" "$PROFILE_DIR/Default"
echo " ✔ 完成"
fi
echo "ℹ️ 以后在 Python 里把 --user-data-dir 指向：$PROFILE_DIR"2. 执行
plain
chmod +x prepare_chrome_profile.sh
./prepare_chrome_profile.sh四、Python 示例（browser-use ≥ 0.1.42）
python
from browser_use import Browser, BrowserConfig, Agent
from langchain_openai import ChatOpenAI
from pydantic import SecretStr
import os, asyncio
llm = ChatOpenAI(
base_url="https://api.deepseek.com/v1",
model="deepseek-chat",
api_key=SecretStr("sk-...")
)
PROFILE_DIR = os.path.expanduser("~/chrome-profiles/agent")
browser = Browser(
config=BrowserConfig(
browser_binary_path="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
extra_browser_args=[
f"--user-data-dir={PROFILE_DIR}",
"--profile-directory=Default",
],
chrome_remote_debugging_port=9223,
headless=False,
keep_alive=True
)
)
async def main():
agent = Agent(
task="示例任务 ...",
llm=llm,
browser=browser,
use_vision=False
)
print((await agent.run()).final_result())
asyncio.run(main())五、兼容旧版三策略
- 升级 browser-use 并加载持久 Profile（推荐，上文示例）
- 继续 0.1.40 + 手动启动 Chrome
plain
google-chrome --remote-debugging-port=9222 --user-data-dir=/path/to/profile- 然后 BrowserConfig(cdp_url="http://localhost:9222\")
- 降级 Chrome ≤ 135（应急，不建议长期）
六、常见疑问 & 排错
1. 必须每次跑 .sh 吗？
复制 Profile 只做一次；重置登录态时再执行。
2. 提示 profile locked / Chrome 已在运行？
关闭所有手动 Chrome，再启脚本。
3. 多 Agent 并发？
为每个实例复制独立 Profile，并用不同 chrome_remote_debugging_port。
4. chrome_instance_path 提示弃用？
升级后统一用 browser_binary_path。
5. 还是报 ECONNREFUSED 9222？
确认已传入 --user-data-dir=<非默认目录>；端口被占时换新端口。