私有实例

    最新版本是

    二、轻松部署（在EC2上）

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

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

    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

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

    1. 使用所需的模块配置Apache，并设置为允许覆盖.htaccess。配置文件可能如下所示：
    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的详情，请访问：

    4.2 测试机

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

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

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

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

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

    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区域：

    5.2 AMI Images

    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)

    1. IE10/Chrome/Firefox/Safari - ami-0ae1c060  
    2. IE11/Chrome/Firefox/Safari - ami-4a84a220  
    3. Linux (Chrome Only) - ami-cf68c6d9

    5.2.3 us-east-2 (Ohio)

    1. IE9/Chrome/Firefox/Safari - ami-c86933ad  
    2. IE10/Chrome/Firefox/Safari - ami-55742e30  
    3. IE11/Chrome/Firefox/Safari - ami-c96933ac  
    4. Linux (Chrome Only) - ami-cd4f6ba8

    5.2.4 us-west (California)

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

    5.2.5 us-west-2 (Oregon)

    1. IE9/Chrome/Firefox/Safari - ami-03e80c63  
    2. IE10/Chrome/Firefox/Safari - ami-fdeb0f9d  
    3. IE11/Chrome/Firefox/Safari - ami-b4ab4fd4  
    4. Linux (Chrome Only) - ami-9cc049fc

    5.2.6 ca-central-1 (Canada Central)

    5.2.7 eu-west-1 (Ireland)

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

    5.2.8 eu-west-2 (London)

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

    5.2.9 eu-central (Frankfurt)

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

    5.2.10 ap-northeast-1 (Tokyo)

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

    5.2.11 ap-northeast-2 (Seoul)

    5.2.12 ap-southeast-1 (Singapore)

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

    5.2.13 ap-southeast-2 (Sydney)

    1. IE9/Chrome/Firefox/Safari - ami-306c4853  
    2. IE10/Chrome/Firefox/Safari - ami-25644046  
    3. IE11/Chrome/Firefox/Safari - ami-e88eab8b  
    4. Linux (Chrome Only) - ami-f72f2294

    5.2.14 ap-south-1 (Mumbai)

    1. IE9/Chrome/Firefox/Safari - ami-7a86ec15  
    2. IE10/Chrome/Firefox/Safari - ami-bf80ead0  
    3. IE11/Chrome/Firefox/Safari - ami-d498f2bb  
    4. Linux (Chrome Only) - ami-b787f7d8

    5.2.15 sa-east (Sao Paulo)

    1. IE9/Chrome/Firefox/Safari - ami-79c54515  
    2. IE10/Chrome/Firefox/Safari - ami-7cc54510  
    3. IE11/Chrome/Firefox/Safari - ami-203abb4c  
    4. 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中，添加：

    手动下载和更新：

    • 下载代理更新：
    • 从zip文件中提取ini文件（update.ini和wptupdate.ini）
    • 将zip文件复制到服务器上的/work/update文件夹（可能需要备份现有的代理更新，以便在必要时回滚）
    • 将ini文件复制到服务器上的/work/update文件夹

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

    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:\Windows\SoftwareDistribution\Download中的所有内容。Windows将为其安装的每个软件更新保持完整的安装程序，并且在安装后不需要它们。
      • 尝试 右键单击C盘 -> 属性 -> 磁盘清理。 可能会有一些崩溃报告可以清理
    • 如果没有足够的空间，还可以做更多的事情：
      • 使用windirstat看看占用磁盘空间
      • IE临时Internet文件可能被破坏，并且正在失去控制。CCleaner有时可以帮助修复
      • 确保休眠已禁用（盘上没有·hiberfil.sys`）
      • 最糟糕的情况是，可以禁用交换文件来恢复一两次