browserstack/local

BrowserStack Local Docker镜像文档

镜像概述

BrowserStack Local Docker镜像是官方提供的用于运行BrowserStack本地二进制文件的容器化解决方案。该镜像允许开发者在Docker环境中轻松部署BrowserStack Local客户端，实现本地测试环境与BrowserStack云端服务的安全连接，支持Web应用、移动应用的本地测试场景。

核心功能和特性

• 官方支持：BrowserStack官方维护的Docker包装，确保与最新版本地二进制文件同步
• 灵活配置：支持默认命令运行和自定义参数配置
• 网络兼容性：提供多种网络访问模式，适配Linux、Mac和Windows系统
• 端口映射：支持关键服务端口绑定，优化本地测试体验
• 自定义入口点：允许通过修改Dockerfile定制默认运行命令

使用场景和适用范围

• 本地开发环境的Web应用测试
• 内部网络服务的BrowserStack云端测试
• CI/CD流程中集成BrowserStack本地测试
• 需要隔离环境的自动化测试场景
• 跨平台（Linux/Mac/Windows）的本地测试需求

安装方法

拉取BrowserStack Local镜像：

bash
docker pull browserstack/local

拉取完成后，镜像将自动构建并准备使用。

使用方法

默认命令运行

使用默认入口点运行本地二进制文件，需提供BrowserStack访问密钥：

bash
docker run -it browserstack/local --key <browserstack本地测试访问密钥>

为获得最佳测试体验，建议绑定以下服务端口到主机：

bash
docker run -it -p 127.0.0.1:45691:45691 -p 127.0.0.1:45690:45690 -p 127.0.0.1:45454:45454 -p 127.0.0.1:45954:45954 browserstack/local --key <访问密钥>

自定义参数运行

可直接在运行命令中添加自定义参数：

bash
docker run browserstack/local <参数>

示例：启用详细日志（verbose 3）和强制本地模式（force-local）

bash
docker run -it browserstack/local --key=<访问密钥> --verbose 3 --force-local

自定义默认命令

如需永久覆盖默认命令，可按以下步骤操作：

1. 克隆官方仓库：

   bash
   git clone https://github.com/browserstack/docker-browserstack-local
   

2. 编辑Dockerfile，修改ENTRYPOINT为自定义命令或脚本

3. （可选）在镜像中设置BS_KEY环境变量

4. 构建自定义镜像：

   bash
   docker build -t <镜像标签> <Dockerfile路径>
   

构建完成后，新镜像将使用自定义的默认命令运行。

网络中服务器的测试配置

由于二进制文件运行在Docker容器内，需要特殊配置以访问主机网络服务：

方法1

Linux系统

使用--net=host标志将容器网络栈与主机共享：

bash
docker run --net=host -it browserstack/local <参数>

Mac和Windows系统

Docker在Mac和Windows上运行在虚拟机中，需使用host.docker.internal访问主机网络：

1. 修改测试脚本，使用host.docker.internal代替localhost
2. 示例：访问主机3000端口服务，使用host.docker.internal:3000

方法2

将服务器绑定到公共接口（如0.0.0.0），并在测试脚本中使用公共地址访问。

注意：运行公共接口服务存在安全风险，请评估后使用。

常见问题（FAQ）

哪里可以找到Dockerfile？

Dockerfile可在官方仓库获取：https://github.com/browserstack/docker-browserstack-local

是否支持Live和App-Live功能？

支持。需绑定45691和45690端口：

bash
docker run -it -p 127.0.0.1:45691:45691 -p 127.0.0.1:45690:45690 browserstack/local --key <访问密钥>

能否从主机访问二进制控制台仪表板？

可以。需绑定45454和45954端口：

bash
docker run -it -p 127.0.0.1:45454:45454 -p 127.0.0.1:45954:45954 browserstack/local --key <访问密钥>