Docker 容器化解决方案

Chromium JsRPC 容器化浏览器与远程调用

基于 Docker 的轻量级部署方案，集成 Chromium 浏览器与 JsRPC 工具，免证书配置，开箱即用

获取 Docker 镜像 快速开始
4GB
共享内存
5
端口映射
v1.095
JsRPC 版本
3
部署方案

主要特性

开箱即用的容器化解决方案，集成强大功能

容器化部署

基于 Docker 的轻量级部署方案，一键启动，环境隔离，易于管理和维护

Chromium 浏览器

集成最新版本的 Chromium 浏览器，支持完整的 Web 应用测试和自动化操作

JsRPC 支持

内置 JsRpc v1.095 工具，支持 JavaScript 远程调用，无需复杂证书配置

安全配置

提供灵活的安全策略配置，支持 seccomp 和硬件加速选项

灵活配置

丰富的环境变量支持，包括时区、语言、代理等个性化配置选项

持续更新

GitHub Actions 自动构建，快速迭代，确保使用最新版本

快速开始

三种部署方案，选择最适合你的方式

推荐

Docker Compose

最简单的启动方式，一条命令即可运行

docker compose -p chromium-jsrpc up -d
查看完整配置

Docker 命令

完整的配置控制，适合高级用户

docker run -itd \
--name chromium-jsrpc \
--shm-size 4g \
-p 53010:3000 \
samge/chromium-jsrpc:latest
查看所有参数

自定义二进制

使用自己的 JsRPC 二进制文件

mkdir -p ./docker_data/jsrpc
curl -L -o ./docker_data/jsrpc/linux_amd64 \
https://github.com/jxhczhl/JsRpc/releases/...
chmod +x ./docker_data/jsrpc/linux_amd64
JsRPC 项目

配置选项

灵活的环境变量和端口映射配置

环境变量

PUID 1000
PGID 1000
TZ Asia/Shanghai
CHROME_CLI https://www.bing.com/
LANGUAGE zh_CN:zh
TITLE Pidin

端口映射

Chromium 浏览器
Web 访问端口
3000 → 53010
Chromium VNC
VNC 远程桌面
3001 → 53011
JsRPC HTTP
默认端口
12080 → 52080
JsRPC HTTPS
安全连接 (wss)
12443 → 52443

高级配置

代理设置

http_proxy: "http://your-proxy:port"
https_proxy: "http://your-proxy:port"
no_proxy: "localhost,127.0.0.1,::1,192.168.*"

硬件加速

支持 DRI 设备挂载，启用 GPU 硬件加速

--device /dev/dri:/dev/dri

工作流程

简单的部署流程，快速上手

拉取镜像

从 Docker Hub 获取最新镜像

配置环境

设置环境变量和端口映射

启动容器

一键启动，自动配置完成

开始使用

访问浏览器，使用 JsRPC

常见问题

快速解答常见疑问

如何查看容器日志？
docker logs chromium-jsrpc
docker logs -f chromium-jsrpc
如何更新镜像？
docker pull samge/chromium-jsrpc:latest
docker restart chromium-jsrpc
支持哪些硬件加速？

项目支持 DRI 设备挂载实现 GPU 硬件加速。确保主机支持并挂载 /dev/dri 设备即可启用。

如何配置代理？

在 docker-compose.yaml 中添加以下环境变量：

http_proxy: "http://your-proxy:port"
https_proxy: "http://your-proxy:port"
no_proxy: "localhost,127.0.0.1,::1,192.168.*"
遇到问题如何获取支持？

如果遇到问题，建议：

  1. 查看本文档的故障排除部分
  2. 搜索已有的 Issue
  3. 创建新的 Issue 并详细描述问题