登录
目录
当前位置： 首页 > 文档资料 > WebPageTest 中文文档 >

1.4 私有实例（Private Instances）

优质
小牛编辑
126浏览
2023-12-01

WebPagetest可安装和运行私有实例的软件包。

一、发布

最新版本是3.0

二、轻松部署（在EC2上）

有一个EC2 AMI用于WebPageTest服务器，可以有很多好处：

  • 无需配置（在5分钟内启动并运行）。
  • 根据需要在所有EC2（亚马逊弹性计算云）区域中自动启动和停止EC2测试代理。
  • 自动更新到最新的服务器和代理代码。

三、手动部署

3.1 系统要求

WebPageTest可以配置在一个系统上运行（Web服务器和测试机器都在同一台PC上运行），或者为Web服务器和测试人员使用单独的系统。

3.2 Web服务器

Web服务器可以是任何支持PHP的操作系统（Linux或Windows）。

  • Nginx (推荐php-fpm) 或者 Apache 2.x+:
  • PHP 5.3.0 或更新版本，包括以下模块:
    • gd
    • zip
    • zlib
    • mbstring
    • curl (如果你想使用远程存储，像S3和谷歌存储)
    • sqlite (如果你想要能够编辑测试标签)
  • ffmpeg
    • 在路径中可用（用于提取视频缩略图）
    • 对于移动代理视频支持，需要1.x（Linux，Windows）
  • imagemagick (可选)
    • 如果使用移动Node.js代理，则需要移动视频处理
  • jpegtran (可选)
    • 在路径中可用（用于jpeg分析）
  • exiftool (可选)
    • 在路径中可用（用于jpeg分析）

3.3 测试机

Windows（Vista或更高版本）（如果使用64位，需要WebPagetest 2.9或更高版本支持流量整形）

四、Configuring

zip存档包含2个文件夹。www文件夹是Web服务器软件，代理文件夹用于测试机器。存档中的配置文件具有.sample扩展名，因此如果要更新现有安装，则可以使用存档中的新文件覆盖当前文件。
2.8的新版本是一个脚本，将检查常见的配置问题。 可以通过http://<your web server>/install访问。

4.1 Web Server

  1. 使用所需的模块配置Apache，并设置为允许覆盖.htaccess。配置文件可能如下所示：
    <Directory "/var/www/webpagetest">
     AllowOverride all
     Order allow,deny
     Allow from all
</Directory>
<VirtualHost *:80>
     DocumentRoot /var/www/webpagetest
</VirtualHost>
  2. 如果将使用代理，需要上传.pcap文件。在php.ini中将upload_max_filesize和post_max_size设置为大值（10mb应该足够）。
  3. 如果要收集Chrome开发工具跟踪，请考虑将memory_limit设置为较大值或通过将其设置为-1来禁用内存限制。
  4. 使用PHP DSO处理程序mod_php可以大幅减少CPU使用率。
  5. 重新启动Apache以使用新的配置设置。
  6. 将文件从归档中的www文件夹复制到DocumentRoot位置（例如/var/www/webpagetest）。
  7. 授予Apache用户对DocumentRoot下的以下文件夹的读/写权限：
    • tmp
    • dat
    • results
    • work/jobs
    • work/video
    • logs
  8. 在设置文件夹中有几个设置文件可用于配置站点。制作所有.sample文件的副本（删除.sample扩展名）作为配置设置的模板。大多数设置可以按原样使用，除了locations.ini（特别是如果要配置多个测试位置）。
  9. 有关配置locations.ini的详情，请访问：locations

4.2 测试机

  1. 安装要用于测试的浏览器
  2. 在测试系统中配置的管理员帐户。最简单和最可靠的方法是使用Microsoft Technet的自动登录应用程序。
  3. 禁用任何屏幕保护程序（桌面需要保持可见的视频捕获工作）
  4. 停用UAC（Vista或更高版本 - 滑动到“从不通知”）
  5. 卸载IE的增强安全模式（Windows Server）
  6. 在虚拟机（特别是KVM）中运行时使用稳定的时钟
    • /USEPMTIMER到XP或Server 2003的boot.ini
    • 管理员shell命令“bcdedit / set {default} useplatformclock true”
  7. 配置Windows引导到桌面（Server 2012）
  8. 禁用事件跟踪器（Windows Server - 为了方便）
    • 运行gpedit.msc
    • 打开Computer ConfigurationAdministrative TemplatesSystem
    • 打开Display Shutdown Event Tracker
    • 将其设置为禁用
  9. 将测试软件从代理文件夹复制到系统（本示例为c: webpagetest）
  10. 对于Windows 8.1（或服务器2012 R2）测试代理程序，请安装DUMMYNET ipfw驱动程序
  11. 如果要在64位Windows上安装，请右键单击c:webpagetestdummynet64bit文件夹中的testmode.cmd，然后选择以管理员身份运行。重新启动系统以启用测试模式。如果你不运行，重启后不会开启流量整形。
  12. 将文件从webpagetestdummynet32bit或webpagetestdummynet64bit目录复制到webpagetestdummynet目录（取决于操作系统）
  13. 拔出用于访问Internet的网络适配器的属性
  14. 点击Install
  15. 选择Service然后点击Add
  16. 点击Have Disk并导航到webpagetestdummynet
  17. 选择ipfw + dummynet服务（单击任何有关未签名的驱动程序的警告）
  18. Windows 10中，如果使用Microsoft Edge测试（工作进行中）：
  19. 为所有用户安装Python 2.7到c: Python27（默认安装目录）
  20. 从cmd shell安装selenium
    • c:Python27Scriptspip install selenium
  21. 从代理文件夹安装pyWin32（可能需要从管理员命令提示符运行）
  22. 安装Imagemagick
  23. 安装Windows性能工具包（取消选中adk设置中的所有其他选项）
  24. 需要为每个版本的IE配置单独的机器/VM，但其余的浏览器都可以在同一台机器上运行，与IE共享一台机器（测试将不会同时运行，将会交替进行）
  25. 创建任务计划程序任务以在登录时运行wptdriver.exe：
  26. 将其配置为以最高权限运行
  27. 让它在用户帐户登录时运行
  28. 确保它未配置为在3天后终止（默认任务调度程序配置）
  29. 根据样本创建设置文件（wptdriver.ini）的副本
  30. wptdriver可以自动安装Chrome和Firefox（并保持Firefox最新）。如果你想手动安装浏览器，然后删除installer = ...条目为每个你想要tp手动安装的浏览器
  31. 确保浏览器可执行文件的路径对于系统是正确的（如果正在自动安装Chrome和Firefox，他们只会在首次运行wptdriver后安装）
  32. 将位置配置为与locations.ini中服务器上定义的位置匹配
  33. 配置位置键与locations.ini中的服务器匹配
  34. 确保location.ini文件中的browsers = x，y，z条目中的浏览器名，与ini文件中定义的名字对应。
  35. 启动wptdriver，安装它需要安装的任何软件（退出，当出现“waiting for work”）。
  36. 重新启动以确保一切正常启动

如果将远程桌面连接到测试机，请确保在完成后重新启动机器，否则桌面将保持锁定，屏幕捕获将不起作用。

4.2.1 无外设服务器（包括Google Compute Engine）

屏幕截图和视频捕获都需要桌面可见才能进行测试。 某些服务器没有可用的视频设备或分辨率太低，无法用于测试。在这些情况下，设置变得有点复杂（但仍然可能）。测试机需要2个用户帐户，并且需要为自己运行RDP会话，并在RDP会话中运行测试，这将给它一个虚拟显示使用。这也可以用作一种安全技术，如果你不舒服让桌面解锁在任何时候。

    1. 创建2个用户帐户。 我们将他们称为“用户”和“管理员”。 “用户”帐户将是在启动时用于创建RDP会话的帐户，“管理员”帐户是将运行测试的地方。 “用户”帐户不需要是管理员帐户
    1. 设置测试帐户：
      • 将RDP连接到“管理员”帐户，并将其设置为使用正常的WPT配置运行测试
      • 注销RDP会话（不要仅断开连接，将用户注销，但使系统保持运行）
      • 通过RDP重新连接到“管理员”帐户，并确保测试在连接后立即自动启动并正常运行
    1. 设置RDP主机帐户：
      • 用RDP连接到“用户”帐户
      • 配置自动登录在启动时自动登录“用户”帐户。我通常使用Microsoft的自动登录应用程序来进行配置。
      • 使用管理员帐户将RDP连接到127.0.0.2，并记住凭据（不能是localhost或127.0.0.1，因为RDP将阻止这些尝试，但它允许127.0.0.2仍然是本地主机）
      • 打开cmd shell
      • 使用cmdkey /generic:TERMSRV/127.0.0.2 /user:administrator /pass:<adminpass>存储RDP的管理员密码
      • 输入mstsc /w:1920 /h:1200 /v:127.0.0.2并确保它打开一个RDP连接并开始测试（在验证其工作后关闭会话）
      • 创建任务计划程序任务以在运行mstsc.exe的用户帐户的命令行选项/w:1920 /h:1200 /v:127.0.0.2登录时运行。

现在当你重新启动服务器，它应该自动登录到“用户”帐户，然后RDP到本地实例与“管理员”帐户，测试将在RDP会话内部运行。

4.3 Mobile

移动代理说明在这里可用。

五、EC2测试代理

我们为EC2准备了公共AMI，可以用作通过实例用户数据动态配置的WebPagetest测试器。这些映像具有安装和配置测试系统所需的所有软件（包括用于生成视频的AVISynth和用于进行流量整形的dummynet）。

5.1 配置

在启动实例时，通过用户数据字符串来配置测试代理。

5.1.1 WebPagetest参数

  • wpt_server - WebPagetest正在运行的Web服务器（必需）
  • wpt_url - （仅限Linux代理）用于获取的工作目录的基本URL。即https://www.webpagetest.org/work/
  • wpt_loc - 要用于wptdriver的位置名称（可选 - 如果未指定，它将回退到wpt_location或从区域构建 - 例如ec2-us-east）
  • wpt_location - 用于URLBlast的位置名称 (可选 - 如果没有指定，它将从区域和浏览器（例如ec2-us-east-IE8）构建)。如果wpt_loc未设置，wptdriver将附加_wptdriver到此位置ID。
  • wpt_key - 指定位置的秘密密钥（可选）
  • wpt_timeout - 每个测试的超时设置（以秒为单位）（可选，默认为60）
  • wpt_username - 使用WPT服务器进行基本认证的用户名。 如果未指定wpt_password，则忽略。 （可选的）
  • wpt_password - 使用WPT服务器进行基本认证的密码。 如果未指定wpt_username，则忽略。 （可选的）
  • wpt_validcertificate - 可如果wpt_server的方案不为“https”，就可忽略。如果值为“0”，则不会检查证书的主机名和到期时间。如果值为'1'，则WPT服务器SSL证书的CN必须与wpt_server参数中指定的主机名匹配，证书必须有效。 （可选，默认为'0'）

5.1.2 用户数据字符串示例

wpt_server=www.webpagetest.org wpt_loc=Test wpt_key=xxxxx

5.1.3 locations.ini示例

服务器的samples.ini示例可用于配置所有可用的EC2区域： http://webpagetest.googlecode.com/svn/trunk/www/webpagetest/settings/locations.ini.EC2-sample

5.2 AMI Images

对于AMI（“IE 9”，“IE 10”或“IE 11”）中的IE版本，wptdriver实例（IE 9,10和11）必须在locations.ini中具有匹配的浏览器名称。 这些实例会在启动时自动安装最新支持的Chrome和Firefox版本（并在运行时自动更新）

5.2.1 查找图片（又名EC2 AMI search sucks）

如果无法找到手动启动的AMI，那是因为EC2的AMI搜索功能非常糟糕。 我发现这条路可行：

  • 请勿在Images-> AMIs界面中搜索AMI
  • 转到Instances - >Instances（或spot instances）
  • 登录 Instance
  • 选择 "Community AMIs"
  • 选中 "Windows"
  • 将AMI ID放在搜索框中，然后按Enter键

5.2.2 us-east (Virginia)

IE9/Chrome/Firefox/Safari - ami-83e4c5e9  
IE10/Chrome/Firefox/Safari - ami-0ae1c060  
IE11/Chrome/Firefox/Safari - ami-4a84a220  
Linux (Chrome Only) - ami-cf68c6d9

5.2.3 us-east-2 (Ohio)

IE9/Chrome/Firefox/Safari - ami-c86933ad  
IE10/Chrome/Firefox/Safari - ami-55742e30  
IE11/Chrome/Firefox/Safari - ami-c96933ac  
Linux (Chrome Only) - ami-cd4f6ba8

5.2.4 us-west (California)

IE9/Chrome/Firefox/Safari - ami-03d6a263  
IE10/Chrome/Firefox/Safari - ami-05eb9f65  
IE11/Chrome/Firefox/Safari - ami-678afe07  
Linux (Chrome Only) - ami-2a3c644a

5.2.5 us-west-2 (Oregon)

IE9/Chrome/Firefox/Safari - ami-03e80c63  
IE10/Chrome/Firefox/Safari - ami-fdeb0f9d  
IE11/Chrome/Firefox/Safari - ami-b4ab4fd4  
Linux (Chrome Only) - ami-9cc049fc

5.2.6 ca-central-1 (Canada Central)

IE9/Chrome/Firefox/Safari - ami-184efc7c  
IE10/Chrome/Firefox/Safari - ami-13328077  
IE11/Chrome/Firefox/Safari - ami-0345f767  
Linux (Chrome Only) - ami-4140fd25

5.2.7 eu-west-1 (Ireland)

IE9/Chrome/Firefox/Safari - ami-2d5fea5e  
IE10/Chrome/Firefox/Safari - ami-3b45f048  
IE11/Chrome/Firefox/Safari - ami-a3a81dd0  
Linux (Chrome Only) - ami-cc1423aa

5.2.8 eu-west-2 (London)

IE9/Chrome/Firefox/Safari - ami-4ad6dc2e  
IE10/Chrome/Firefox/Safari - ami-2dd5df49  
IE11/Chrome/Firefox/Safari - ami-4bd6dc2f  
Linux (Chrome Only) - ami-b7b7a2d3

5.2.9 eu-central (Frankfurt)

IE9/Chrome/Firefox/Safari - ami-879c85eb  
IE10/Chrome/Firefox/Safari - ami-ec9b8280  
IE11/Chrome/Firefox/Safari - ami-87f2ebeb  
Linux (Chrome Only) - ami-6534e30a

5.2.10 ap-northeast-1 (Tokyo)

IE9/Chrome/Firefox/Safari - ami-4ed6e820  
IE10/Chrome/Firefox/Safari - ami-ebd3ed85  
IE11/Chrome/Firefox/Safari - ami-2f221c41  
Linux (Chrome Only) - ami-31154856

5.2.11 ap-northeast-2 (Seoul)

IE9/Chrome/Firefox/Safari - ami-b2e12fdc  
IE10/Chrome/Firefox/Safari - ami-76e12f18  
IE11/Chrome/Firefox/Safari - ami-15e52b7b  
Linux (Chrome Only) - ami-e9ac7f87

5.2.12 ap-southeast-1 (Singapore)

IE9/Chrome/Firefox/Safari - ami-f87ab69b  
IE10/Chrome/Firefox/Safari - ami-ce78b4ad  
IE11/Chrome/Firefox/Safari - ami-3e55995d  
Linux (Chrome Only) - ami-f3cd7f90

5.2.13 ap-southeast-2 (Sydney)

IE9/Chrome/Firefox/Safari - ami-306c4853  
IE10/Chrome/Firefox/Safari - ami-25644046  
IE11/Chrome/Firefox/Safari - ami-e88eab8b  
Linux (Chrome Only) - ami-f72f2294

5.2.14 ap-south-1 (Mumbai)

IE9/Chrome/Firefox/Safari - ami-7a86ec15  
IE10/Chrome/Firefox/Safari - ami-bf80ead0  
IE11/Chrome/Firefox/Safari - ami-d498f2bb  
Linux (Chrome Only) - ami-b787f7d8

5.2.15 sa-east (Sao Paulo)

IE9/Chrome/Firefox/Safari - ami-79c54515  
IE10/Chrome/Firefox/Safari - ami-7cc54510  
IE11/Chrome/Firefox/Safari - ami-203abb4c  
Linux (Chrome Only) - ami-38eb8a54

六、更新测试代理

如果存在更新文件（在服务器上的/work/update中），测试代理将自动从服务器更新其代码。 每个更新包括zip文件（实际updata）和包含有关更新的一些元数据（最重要的是软件版本）的ini文件。 IE代理（update.zip/update.ini）和Chrome/Firefox代理（wptupdate.zip/wptupdate.ini）有不同的更新。

每个新版本都包含更新的代理二进制文件，但是如果需要在公用实例上提供，但尚未在新版本中打包的错误修复或功能，则有时更新代理之间的版本是有帮助。在这种情况下，可以从WebPagetest的公共实例下载更新，并将其部署在您的私有实例上（代理向后兼容，所以您不需要更新网页代码，除非您需要更新功能）。

使用WebPageTest 2.18或更高版本，服务器可以在发布时自动更新到最新版本。 在服务器的settings/settings.ini中，添加：

agentUpdate=http://cdn.webpagetest.org/

手动下载和更新：

上传更新后，每个代理程序将在运行下一个测试之前自动下载并安装更新，以确保在进行更多测试之前更新被部署。

七、故障排除

7.1 Web Server

  • 等待在队列前面
    • 通常的问题是在location.ini。仔细检查位置设置是否与代理正在拉动服务器的位置相匹配。还要注意，如果使用的是密钥，它们是否匹配。可以检查Apache访问日志，以便测试代理进行传入请求。
  • 测试完成，但没有成功
    • 如果您使用的是64位Windows客户端，则无法执行流量整形（换为dummynet）。在locations.ini中，将connectivity=LAN添加到测试位置。
  • 瀑布图丢失
    • 检查GD库是否安装。GD库用于绘制瀑布并生成缩略图。
    • 看看是否安装了php-zip，php5-zip或类似的zip库。 使用某些默认的PHP发行版，图形库可能会不存在。
  • 屏幕截图为黑色
    • 从RDP断开连接时，请尝试重新启动实例，而不是从RDP客户端断开连接。当您断开连接时，RDP会锁定桌面，这将导致屏幕截图和视频中断。
  • /var/log/apache2/error.log中的错误消息：
    • [Mon Apr 30 10:18:14 2012] [error] [client 1.2.3.4] PHP Warning: POST Content-Length of 22689689 bytes exceeds the limit of 8388608 bytes in Unknown on line 0
    • PHP enforces a limit on the size of uploaded files, and an agent is uploading something larger than this limit. Change upload_max_filesize and post_max_filesize to larger values in php.ini.

7.1.1 测试代理

磁盘空间不足

  • WebPagetest不会保留任何临时文件，但有时Windows本身会留下东西，磁盘可以填满。当发生这种情况时，可以执行以下几个常见的事情来清理它：
    • 可以删除C:WindowsSoftwareDistributionDownload中的所有内容。Windows将为其安装的每个软件更新保持完整的安装程序，并且在安装后不需要它们。
    • 尝试 右键单击C盘 -> 属性 -> 磁盘清理。 可能会有一些崩溃报告可以清理
  • 如果没有足够的空间，还可以做更多的事情：
    • 使用windirstat看看占用磁盘空间
    • IE临时Internet文件可能被破坏，并且正在失去控制。CCleaner有时可以帮助修复
    • 确保休眠已禁用（盘上没有·hiberfil.sys`）
    • 最糟糕的情况是，可以禁用交换文件来恢复一两次
免责声明： 以上内容版权归原作者所有，如有侵犯您的原创版权请告知，我们将尽快删除相关内容。感谢每一位辛勤著写的作者，感谢每一位的分享。
@小牛知识库 xnip.cn