Open Remote Chrome Browser Management
Launch and manage a remote Chrome browser with web-based VNC access
Quick Start
CODEBLOCK0
That's it! The start script automatically checks dependencies and provides clear installation instructions if anything is missing.
What You Get
- - Web Access: Browser-based VNC client at INLINECODE0
- VNC Access: Direct VNC connection at INLINECODE1
- Remote Debugging: Chrome DevTools at INLINECODE2
- Status Monitoring: Process info, memory usage, open tabs, VNC password
Scripts
| Script | Purpose |
|---|
| INLINECODE3 | Start the service (with auto dependency check) |
| INLINECODE4 |
Stop the service |
|
status-remote-chrome.sh | Monitor status, memory, tabs, and get access info |
Options
CODEBLOCK1
Configuration Parameters
The start script supports the following configurable parameters:
Port Configuration
- -
--vnc-port <port>: VNC server port (default: 5900) - INLINECODE7 : noVNC web access port (default: 6080)
- INLINECODE8 : Chrome remote debugging port (default: 9222)
Example:
CODEBLOCK2
Screen Resolution
- -
--screen-size <WxHxD>: Screen resolution in format WidthxHeightxColorDepth (default: 1600x1200x24)
Examples:
CODEBLOCK3
Examples
CODEBLOCK4
Proxy Environment Variables
The script also respects standard proxy environment variables if set:
- -
HTTP_PROXY / INLINECODE12 - INLINECODE13 / INLINECODE14
- INLINECODE15 / INLINECODE16
Priority: Command-line parameters > Environment variables > No proxy
Common Tasks
Start Service
./start-remote-chrome.sh
Output includes access URLs and VNC password.
Check Status
./status-remote-chrome.sh
Shows: process status, memory usage, open Chrome tabs, VNC password, access URLs.
Restart Service
CODEBLOCK7
Integration with agent-browser
Control Chrome programmatically via the agent-browser skill:
CODEBLOCK8
Benefits:
- - Visual monitoring via VNC + programmatic control via agent-browser
- Use agent-browser for automation, VNC for visual verification
- Debug automation scripts in real-time through web interface
References
For detailed information, see:
Need Help?
- - Missing dependencies? The start script will tell you exactly what to install.
- Port conflicts? Run
./stop-remote-chrome.sh first. - Want details? Check the
references/ folder for comprehensive documentation.
打开远程Chrome浏览器管理
启动并管理一个远程Chrome浏览器，支持基于网页的VNC访问
快速开始
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
代理环境变量
如果设置了以下标准代理环境变量，脚本也会识别：
- - HTTPPROXY / httpproxy
- HTTPSPROXY / httpsproxy
- NOPROXY / noproxy
优先级：命令行参数 > 环境变量 > 无代理
常见任务
启动服务
bash
./start-remote-chrome.sh
输出包括访问URL和VNC密码。
检查状态
bash
./status-remote-chrome.sh
显示：进程状态、内存使用、打开的Chrome标签页、VNC密码、访问URL。
重启服务
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/ 文件夹获取全面的文档。
