mozilla/profiler-server

Firefox Devtools Profiler Server 镜像文档

概述

Firefox Devtools Profiler Server 是Firefox开发者工具生态的核心组件，作为性能分析数据的处理与展示服务器，负责接收Firefox浏览器生成的性能采样数据，进行解析、存储与可视化处理，帮助开发者直观分析浏览器运行时性能瓶颈，优化网页加载、脚本执行及渲染效率。

核心功能与特性

• 性能数据处理：支持解析Firefox生成的性能采样数据（如JavaScript执行栈、DOM操作、网络请求等），生成结构化分析结果
• 可视化分析界面：提供Web端可视化界面，通过时间线、火焰图、调用栈树等多维度展示性能数据，支持交互分析
• 数据持久化：支持本地存储性能分析记录，便于历史数据对比与回溯分析
• 跨版本兼容：适配Firefox稳定版、Beta版及Nightly版，确保不同版本浏览器性能数据的兼容性
• 开放API：提供RESTful API，支持第三方工具集成与自动化性能测试流程

使用场景

• Web前端性能调试：前端开发者优化网页在Firefox中的加载速度、交互响应时间及资源占用
• Firefox扩展开发：扩展开发者分析扩展对浏览器性能的影响，定位扩展代码执行瓶颈
• 浏览器内核优化：浏览器工程师调试Firefox渲染引擎、JavaScript引擎等核心模块的性能问题
• 自动化性能测试：集成到CI/CD流程中，通过API自动上传性能数据并生成分析报告，监控性能 regression

使用方法

基本部署

通过以下命令快速启动Profiler Server容器，默认暴露8080端口：

bash
docker run -d -p 8080:8080 --name firefox-profiler-server firefox-devtools/profiler-server

自定义配置

数据持久化

将主机目录映射至容器内数据存储路径，确保性能数据在容器重启后不丢失：

bash
docker run -d \
  -p 8080:8080 \
  -v /host/path/to/profiler-data:/app/data \
  --name firefox-profiler-server \
  firefox-devtools/profiler-server

自定义端口与跨域设置

通过环境变量配置服务端口及跨域规则：

bash
docker run -d \
  -p 3000:3000 \
  -e PORT=3000 \
  -e CORS_ALLOWED_ORIGINS="https://developer.mozilla.org,https://localhost:3000" \
  -v /host/path/to/profiler-data:/app/data \
  --name firefox-profiler-server \
  firefox-devtools/profiler-server

环境变量配置

访问与使用

1. 启动容器后，通过浏览器访问 http://localhost:8080（或自定义端口）打开Profiler Server界面
2. 在Firefox浏览器中打开开发者工具（F12），切换至「性能」面板，点击「录制」获取性能数据
3. 录制完成后导出数据文件（通常为.json格式），在Profiler Server界面上传文件并开始分析
4. 通过界面交互（如缩放时间线、点击火焰图节点）定位性能瓶颈，导出分析报告

注意事项

• 性能数据文件建议通过Firefox开发者工具直接生成，确保数据格式兼容性
• 生产环境部署时建议设置CORS_ALLOWED_ORIGINS限制访问源，避免未授权访问
• 大规模数据存储场景下，建议将DATA_DIR映射至高性能存储卷（如SSD）以提升读写效率