wehub-resource-sync
e0e362d700
SDK Tests / SDK CI (push) Blocked by required conditions
SDK Tests / changes (push) Successful in 2m29s
Real E2E Tests / changes (push) Successful in 2m29s
SDK Tests / Python SDK Tests (sandbox) (push) Waiting to run
SDK Tests / CLI Quality (push) Waiting to run
SDK Tests / CLI Tests (push) Waiting to run
SDK Tests / Python SDK Quality (code-interpreter) (push) Waiting to run
SDK Tests / Python SDK Quality (sandbox) (push) Waiting to run
SDK Tests / Python SDK Tests (code-interpreter) (push) Waiting to run
SDK Tests / JavaScript SDK Quality And Tests (code-interpreter) (push) Waiting to run
SDK Tests / JavaScript SDK Quality And Tests (sandbox) (push) Waiting to run
SDK Tests / Kotlin SDK Quality And Tests (sandbox) (push) Waiting to run
SDK Tests / Kotlin SDK Quality And Tests (code-interpreter) (push) Waiting to run
SDK Tests / C# SDK Quality And Tests (code-interpreter) (push) Waiting to run
SDK Tests / C# SDK Quality And Tests (sandbox) (push) Waiting to run
SDK Tests / Go SDK Quality And Tests (push) Waiting to run
Deploy Docs Pages / build (push) Has been cancelled
Deploy Docs Pages / deploy (push) Has been cancelled
Real E2E Tests / JavaScript E2E (docker bridge) (push) Has been cancelled
Real E2E Tests / Python E2E (docker bridge) (push) Has been cancelled
Real E2E Tests / Java E2E (docker bridge) (push) Has been cancelled
Real E2E Tests / C# E2E (docker bridge) (push) Has been cancelled
Real E2E Tests / Go E2E (docker bridge) (push) Has been cancelled
Real E2E Tests / Real E2E CI (push) Has been cancelled
81 lines
2.4 KiB
Markdown
81 lines
2.4 KiB
Markdown
---
|
|
title: Chrome
|
|
description: Run Chrome Browser with OpenSandbox runtime for remote debugging via DevTools.
|
|
---
|
|
|
|
# Chrome Browser in OpenSandbox
|
|
|
|
This example runs Chrome Browser with OpenSandbox runtime.
|
|
|
|
The image starts a VNC server (`Xtigervnc :1`) and launches Chromium with remote debugging enabled on port `9222`.
|
|
|
|
## Getting Chrome image
|
|
|
|
You can build the image from source or pull it from Docker Hub.
|
|
|
|
### Build from source
|
|
|
|
```shell
|
|
cd examples/chrome
|
|
docker build -t opensandbox/chrome .
|
|
```
|
|
|
|
### Pull an existing image
|
|
|
|
```shell
|
|
docker pull opensandbox/chrome:latest
|
|
|
|
# use acr from china
|
|
# docker pull sandbox-registry.cn-zhangjiakou.cr.aliyuncs.com/opensandbox/chrome:latest
|
|
```
|
|
|
|
## Start OpenSandbox server
|
|
|
|
Start the OpenSandbox server and tail stdout from the terminal:
|
|
|
|
```shell
|
|
uv pip install opensandbox-server
|
|
opensandbox-server init-config ~/.sandbox.toml --example docker
|
|
opensandbox-server
|
|
```
|
|
|
|
## Create and access a Chrome sandbox
|
|
|
|
Build/pull the image above, then create a sandbox with image `opensandbox/chrome:latest` and an entrypoint that keeps it
|
|
alive (e.g., `["/bin/sh", "-c", "sleep infinity"]`), or reuse `tail -f /dev/null`. Make sure the runtime exposes ports
|
|
`5901` and `9222` for VNC/DevTools.
|
|
|
|
```shell
|
|
uv pip install opensandbox
|
|
uv run python examples/chrome/main.py
|
|
```
|
|
|
|
Then fetch endpoints for 5901/9222 to connect with a VNC client or DevTools, like:
|
|
|
|
```text
|
|
execd daemon running with endpoint='127.0.0.1:48379/proxy/44772'
|
|
VNC running with endpoint='127.0.0.1:48379/proxy/5901'
|
|
DevTools running with endpoint='127.0.0.1:48379/proxy/9222'/json
|
|
```
|
|
|
|
```text
|
|
[ {
|
|
"description": "",
|
|
"devtoolsFrontendUrl": "https://chrome-devtools-frontend.appspot.com/serve_rev/@.../inspector.html?ws=127.0.0.1:52302/devtools/page/...",
|
|
"faviconUrl": "https://www.gstatic.com/images/branding/searchlogo/ico/favicon.ico",
|
|
"id": "2215AF60AC345E4BA6D822389CFC743B",
|
|
"title": "Google",
|
|
"type": "page",
|
|
"url": "https://www.google.com.hk/",
|
|
"webSocketDebuggerUrl": "ws://127.0.0.1:52302/devtools/page/2215AF60AC345E4BA6D822389CFC743B"
|
|
} ]
|
|
```
|
|
|
|
Or you can use it by MCP client, more information please refer
|
|
to: [chrome-devtools-mcp](https://github.com/ChromeDevTools/chrome-devtools-mcp).
|
|
|
|
## References
|
|
|
|
- [chrome-devtools-mcp](https://github.com/ChromeDevTools/chrome-devtools-mcp)
|
|
- [Source code on GitHub](https://github.com/opensandbox-group/OpenSandbox/tree/main/examples/chrome)
|