📦 remote-chrome — 远程浏览器

# 远程 Chrome 浏览器管理 启动并管理可通过网页 VNC 访问的远程 Chrome 浏览器 ## 快速开始 ``bash # 启动服务（自动检查依赖） ./start-remote-chrome.sh # 查看状态并获取访问信息 ./status-remote-chrome.sh # 停止服务 ./stop-remote-chrome.sh ` 就这么简单！启动脚本会自动检查依赖，如有缺失会给出清晰的安装指引。 ## 你能得到什么 - 网页访问：浏览器内 VNC 客户端 http://:6080 - VNC 访问：直连 VNC :5900 - 远程调试：Chrome DevTools http://:9222 - 状态监控：进程信息、内存占用、打开标签页、VNC 密码 ## 脚本 | 脚本 | 用途 | |--------|---------| | start-remote-chrome.sh | 启动服务（含自动依赖检查） | | stop-remote-chrome.sh | 停止服务 | | status-remote-chrome.sh | 监控状态、内存、标签页并获取访问信息 | ## 选项 `bash # 详细模式（查看 Chrome 输出及进程详情） ./start-remote-chrome.sh -v # 前台模式（脚本保持运行，Ctrl+C 停止） ./start-remote-chrome.sh -f # 自定义端口 ./start-remote-chrome.sh --vnc-port 5901 --novnc-port 6081 --chrome-debug-port 9223 # 自定义分辨率 ./start-remote-chrome.sh --screen-size 1920x1080x24 # 带代理及绕过列表 ./start-remote-chrome.sh --proxy http://proxy.example.com:8080 --proxy-bypass "localhost,127.0.0.1,.example.com" # 组合选项 ./start-remote-chrome.sh --screen-size 1920x1080x24 --vnc-port 5901 --novnc-port 6081 -v # 获取帮助 ./start-remote-chrome.sh -h ` ## 配置参数 启动脚本支持以下可配置参数： ### 端口配置 - --vnc-port : VNC 服务器端口（默认：5900） - --novnc-port : noVNC 网页访问端口（默认：6080） - --chrome-debug-port : Chrome 远程调试端口（默认：9222） 示例： `bash # 使用不同端口避免冲突 ./start-remote-chrome.sh --vnc-port 5901 --novnc-port 6081 ` ### 屏幕分辨率 - --screen-size : 屏幕分辨率，格式为宽度x高度x色深（默认：1600x1200x24） 示例： `bash # 全高清分辨率，24 位色深 ./start-remote-chrome.sh --screen-size 1920x1080x24 ` ### 示例 `bash # 使用公司代理 ./start-remote-chrome.sh --proxy http://proxy.company.com:3128 # 带绕过列表，内部站点直连 ./start-remote-chrome.sh --proxy http://proxy.company.com:3128 --proxy-bypass ".internal.com,localhost,10.*" # 无代理（直连，默认行为） ./start-remote-chrome.sh ` ### 代理环境变量 脚本同时尊重标准代理环境变量（如已设置）： - HTTP_PROXY / http_proxy - HTTPS_PROXY / https_proxy - NO_PROXY / no_proxy 优先级：命令行参数 > 环境变量 > 无代理 ## 常见任务 ### 启动服务 `bash ./start-remote-chrome.sh ` 输出包含访问地址和 VNC 密码。 ### 查看状态 `bash ./status-remote-chrome.sh ` 显示：进程状态、内存使用、已打开标签页、VNC 密码、访问地址。 ### 重启服务 `bash ./stop-remote-chrome.sh && ./start-remote-chrome.sh ` ## 与 agent-browser 集成 通过 agent-browser 技能以编程方式控制 Chrome： `bash # 1. 启动远程 Chrome（启用调试端口） ./start-remote-chrome.sh # 2. 将 agent-browser 连接到 Chrome agent-browser connect --url http://localhost:9222 # 3. 导航与交互 agent-browser open https://example.com agent-browser click "#button-id" agent-browser type "#input-field" "text content" # 4. 查看已打开标签页 ./status-remote-chrome.sh # 显示 agent-browser 打开的所有标签页 ` 优势： - 通过 VNC 可视化监控，同时用 agent-browser 编程控制 - 用 agent-browser 做自动化，用 VNC 做视觉验证 - 通过网页界面实时调试自动化脚本 ## 参考资料 详见： - 安装指南 - 依赖与安装命令 - 输出示例 - 各操作样例输出 - 配置说明 - 脚本参数、端口、故障排查 ## 需要帮助？ - 缺少依赖？启动脚本会明确告诉你该安装什么。 - 端口冲突？先运行 ./stop-remote-chrome.sh。 - 想要详情？查看 references/` 文件夹中的完整文档。