使用Docker运行sitespeed.io的完整指南

前言

sitespeed.io是一款强大的网站性能测试工具，能够帮助开发者测量和分析网页加载速度。通过Docker容器化部署，可以简化环境配置过程，快速获得包含所有必要依赖的测试环境。本文将详细介绍如何使用Docker运行sitespeed.io，包括容器选择、基本使用、高级配置以及常见问题解决。

容器选择

sitespeed.io提供了多种预构建的Docker容器，满足不同测试需求：

1. 精简版容器 (sitespeedio/sitespeed.io:X.Y.Z-slim)

   • 仅包含Firefox浏览器
   • 以无头模式运行
   • 不包含FFMpeg和Imagemagick，无法获取视觉指标

2. 标准版容器 (sitespeedio/sitespeed.io:X.Y.Z)

   • 包含Chrome、Firefox和Edge浏览器
   • 包含FFMpeg和Imagemagick
   • 支持视频录制和视觉指标(如Speed Index)

3. 增强版容器 (sitespeedio/sitespeed.io:X.Y.Z-plus1)

   • 在标准版基础上增加Google Page Speed Insights和Lighthouse插件
   • 提供更全面的性能分析

容器架构解析

标准版容器采用分层构建方式：

1. 基础层：Ubuntu 18 + NodeJS(LTS版本)
2. 视觉指标依赖层：FFMpeg、ImageMagick和Python库
3. 浏览器层：特定版本的Firefox、Chrome和XVFB
4. 应用层：sitespeed.io核心功能

这种分层设计确保了各组件版本的稳定性，同时便于维护和更新。

基本使用方法

使用Chrome测试网站

docker run --rm -v "$(pwd):/sitespeed.io" sitespeedio/sitespeed.io:X.Y.Z -b chrome https://www.example.com/

使用Firefox测试网站

Firefox需要更大的共享内存空间：

docker run --shm-size 2g --rm -v "$(pwd):/sitespeed.io" sitespeedio/sitespeed.io:X.Y.Z -b firefox https://www.example.com/

重要提示

• 务必指定具体的版本号(X.Y.Z)，避免使用latest标签
• -v "$(pwd):/sitespeed.io"将当前目录映射到容器内，用于存储测试结果

高级配置

时间同步

确保容器时间与主机一致(Linux系统)：

docker run --shm-size 2g --rm -v "$(pwd):/sitespeed.io" -v /etc/localtime:/etc/localtime:ro sitespeedio/sitespeed.io:X.Y.Z -b firefox https://www.example.com/

设置时区

docker run -e TZ=Asia/Shanghai --rm -v "$(pwd):/sitespeed.io" sitespeedio/sitespeed.io:X.Y.Z https://www.example.com

增加内存限制

处理大量URL时可能需要增加NodeJS内存：

docker run -e MAX_OLD_SPACE_SIZE=4096 --rm -v "$(pwd):/sitespeed.io" sitespeedio/sitespeed.io:X.Y.Z https://www.example.com/

本地开发环境测试

访问localhost服务

Mac/Windows(Docker 18.03+)：

docker run --shm-size 2g --rm -v "$(pwd):/sitespeed.io" sitespeedio/sitespeed.io:X.Y.Z -b firefox http://host.docker.internal:4000/

Linux系统：

docker run --shm-size 2g --rm -v "$(pwd):/sitespeed.io" --network=host sitespeedio/sitespeed.io:X.Y.Z -b firefox http://localhost:4000/

故障排查

可视化测试过程

1. 启动容器并暴露VNC端口：

docker run --rm -v "$(pwd):/sitespeed.io" -p 5900:5900 sitespeedio/sitespeed.io:X.Y.Z https://www.example.com/ -b chrome

2. 进入容器：

docker exec -it <container-id> bash

3. 启动VNC服务器：

x11vnc -display :99 -storepasswd

4. 使用VNC客户端连接0.0.0.0:5900查看测试过程

检查容器内容

docker run -it --entrypoint bash sitespeedio/sitespeed.io:X.Y.Z

安全考虑

sitespeed.io容器在构建过程中会进行漏洞扫描，对CRITICAL级别的问题会中断构建。如果对安全性有更高要求，建议自行构建和管理容器。

最佳实践

1. 始终使用特定版本标签，避免自动升级带来的不兼容问题
2. 测试环境与生产环境保持一致的容器版本
3. 定期更新到新的稳定版本
4. 对于长期运行的监控，考虑使用版本号前缀(如X或X.Y)进行自动小版本更新

通过以上指南，您可以充分利用Docker的便利性，快速搭建稳定可靠的网站性能测试环境。