demyx/browsersync

browsersync

镜像概述和主要用途

browsersync是一个非root权限的Docker镜像，基于Alpine Linux构建，集成Node.js运行环境和BrowserSync工具。主要用途是作为前端开发的浏览器同步解决方案，实现多浏览器、多设备间的实时预览、文件监听与自动刷新，提升Web开发效率。

核心功能和特性

• 非root安全运行：采用非root用户权限执行，降低容器运行风险，增强安全性
• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低，启动速度快
• 完整运行环境：内置Node.js环境，无需额外配置即可运行JavaScript相关工具链
• BrowserSync集成：包含BrowserSync核心功能，支持文件变更监听、多设备同步、自动刷新、网络代理等前端开发必备功能
• 跨平台兼容：支持linux/amd64架构，可在主流Docker环境中运行

使用场景和适用范围

• 前端开发实时预览：适用于HTML、CSS、JavaScript等前端代码开发，实时预览代码变更效果
• 多设备同步测试：支持同时在多个浏览器、移动设备上同步显示和操作，便于跨设备兼容性测试
• 团队协作开发：可作为共享开发环境组件，确保团队成员使用一致的浏览器同步配置
• 快速原型迭代：通过自动刷新机制减少手动操作，加速Web原型的开发与调试流程

使用方法和配置说明

前提条件

官方建议配合Demyx工具使用以获得最佳体验。Demyx是一套Docker化的开发工具集，提供简化的容器管理和环境配置流程。

• Demyx仓库：https://github.com/demyxsh/demyx
• Demyx主页：demyx.sh

基础部署示例

Docker Run命令

bash
docker run -d \
  --name browsersync \
  -p 3000:3000 \  # BrowserSync控制界面端口
  -p 3001:3001 \  # 浏览器同步代理端口
  -v /path/to/your/project:/app \  # 挂载本地项目目录到容器内工作目录
  demyx/browsersync

配置说明

• 端口映射：默认使用3000端口作为BrowserSync控制界面，3001端口作为浏览器同步代理端口，可根据实际需求调整主机端口映射
• 数据卷挂载：将本地前端项目目录挂载到容器内的/app目录，BrowserSync会自动监听该目录下的文件变更
• 自定义配置：可在项目根目录创建bs-config.js文件自定义BrowserSync配置，容器启动时会自动加载该配置文件

版本信息

该镜像的基础组件版本可通过以下方式获取：

• Alpine Linux版本：查看https://github.com/demyxsh/browsersync/raw/master/version.json%E4%B8%AD%E7%9A%84%60alpine%60%E5%AD%97%E6%AE%B5
• Node.js版本：查看https://github.com/demyxsh/browsersync/raw/master/version.json%E4%B8%AD%E7%9A%84%60node%60%E5%AD%97%E6%AE%B5
• BrowserSync版本：查看https://github.com/demyxsh/browsersync/raw/master/version.json%E4%B8%AD%E7%9A%84%60browsersync%60%E5%AD%97%E6%AE%B5

社区支持与资源

• GitHub仓库：https://github.com/demyxsh/browsersync
• Docker Hub：https://hub.docker.com/r/demyx/browsersync
• ***社区：Demyx ***（获取最新资讯和技术支持）

赞助支持

该项目接受社区赞助，您可以通过以下方式支持开发：

• Buy Me A Coffee
• Patreon