本教程适用于以下操作系统版本

  • Debian 11 (Bullseye)
  • Debian 8 (Jessie)
  • Debian
  • Debian 7 (Wheezy)

本页内容

  • 前提条件
  • 安装软件包依赖
  • 检查当前 Nginx 版本
  • 下载 Nginx 和 Pagespeed 源代码
  • 编译 Nginx Pagespeed 模块
  • 将 Pagespeed 模块添加到当前 Nginx 安装
  • 在虚拟主机上添加 Nginx Pagespeed 模块
  • 验证 Nginx Pagespeed 模块
  • 结论

Google Pagespeed Module 是一个开源模块,用于优化运行在 Nginx 和 Apache Web 服务器下的网站。Pagespeed 模块是安装在 Nginx 和 Apache Web 服务器旁的服务器级模块。

Pagespeed 模块通过优化您网站上的静态文件来提升网站的性能和速度。Pagespeed 模块会优化您网站上的图片、压缩 HTML、CSS 和 JavaScript 等静态文件,并优化文件缓存。

在本教程中,我们将向您展示如何在最新的 Debian 11 Bullseye 上构建 Nginx Pagespeed 模块。由于您只构建 Nginx 模块,本指南可应用于您当前的 Nginx 安装。

前提条件

在开始之前,请确保您已满足以下要求。

  • 操作系统:Debian 11 Bullseye
  • Root 权限

现在让我们开始吧。

安装软件包依赖

首先,您将安装用于编译 Nginx 模块的软件包依赖。

1. 执行下面的 apt 命令以更新系统上当前的软件仓库。

sudo apt update

2. 接下来,使用下面的 apt 命令安装用于编译程序的基本软件包依赖。

sudo apt install curl dpkg-dev build-essential zlib1g-dev git libpcre3 git libpcre3-dev unzip uuid-dev -y

3. 之后,安装用于编译 Nginx 模块的构建依赖。

sudo apt build-dep nginx -y

检查当前 Nginx 版本

要构建自定义的 Nginx Pagespeed 模块,请确保您当前的 Nginx Web 服务器与您用于构建该 Nginx 模块的 Nginx 源代码保持相同版本。1. 执行以下命令检查 Nginx 版本。

nginx -v

在本示例中,我们机器上安装的当前 Nginx 版本为 ' 1.18.0 '。您将看到如下类似的输出。

nginx version: nginx/1.18.0

可选地,如果您的系统上没有 Nginx 软件包,可使用下面的 apt 命令从官方 Debian 仓库安装它。

sudo apt install nginx -y

2. 接下来,使用下面的命令为您的 Nginx 版本创建一个新的临时环境变量。

export NG_VER=1.18.0

下载 Nginx 和 Pagespeed 源代码

在此步骤中,您将把 Nginx 源代码和 Pagespeed 模块下载到您的服务器。此 Nginx 源代码将与您当前的 Nginx 软件包版本相同。

1. 创建一个新的项目目录 ' /usr/src/nginx ' 并进入该目录。

mkdir -p /usr/src/nginx; cd /usr/src/nginx

2. 现在执行以下命令下载并解压 Nginx 源代码。

wget http://nginx.org/download/nginx-$NG_VER.tar.gz
tar -xzvf nginx-$NG_VER.tar.gz

3. 接下来,将 Nginx Pagespeed 模块克隆到当前目录,完成后您将看到一个新目录 'incubator-pagespeed-ngx'。

git clone https://github.com/apache/incubator-pagespeed-ngx.git

4. 进入 ' incubator-pagespeed-ngx ' 目录,并切换到 Nginx Pagespeed 模块的稳定分支。

cd incubator-pagespeed-ngx/
git checkout latest-stable

5. 查看文件 ' PSOL_BINARY_URL ' 以获取 Page Optimization Library (PSOL) 的下载链接。该库是 Nginx Pagespeed 模块所必需的。

cat PSOL_BINARY_URL

您将看到如下类似的输出。变量 ' $BIT_SIZE_NAME ' 表示您的服务器架构。

wget https://dl.google.com/dl/page-speed/psol/1.13.35.2-$BIT_SIZE_NAME.tar.gz

6. 现在创建一个新的临时环境变量 'BIT_SIZE_NAME',其值为您的服务器架构。下面的示例使用 'x64' 或 64 位服务器架构。

export BIT_SIZE_NAME=x64

7. 现在下载 PSOL 源代码并解压。

wget https://dl.google.com/dl/page-speed/psol/1.13.35.2-$BIT_SIZE_NAME.tar.gz
tar -xzvf 1.13.35.2-$BIT_SIZE_NAME.tar.gz

现在您可以开始构建 Nginx Pagespeed 模块了。

编译 Nginx Pagespeed 模块

在此步骤中,您将编译 Nginx Pagespeed 模块。最终您将得到格式为 ' .so ' 的 Nginx 模块,可将其应用到您当前的 Nginx Web 服务器。

1. 将工作目录切换到 Nginx 项目目录。

cd /usr/src/nginx/nginx-$NG_VER

2. 执行以下命令配置您的 Nginx 模块编译。此命令还会检查您的系统要求,请确保没有任何错误。

./configure --with-compat --add-dynamic-module=../incubator-pagespeed-ngx

以下是您应当得到的输出。

Configuration summary
  + using system PCRE library
  + OpenSSL library is not used
  + using system zlib library
  nginx path prefix: "/usr/local/nginx"
  nginx binary file: "/usr/local/nginx/sbin/nginx"
  nginx modules path: "/usr/local/nginx/modules"
  nginx configuration prefix: "/usr/local/nginx/conf"
  nginx configuration file: "/usr/local/nginx/conf/nginx.conf"
  nginx pid file: "/usr/local/nginx/logs/nginx.pid"
  nginx error log file: "/usr/local/nginx/logs/error.log"
  nginx http access log file: "/usr/local/nginx/logs/access.log"
  nginx http client request body temporary files: "client_body_temp"
  nginx http proxy temporary files: "proxy_temp"
  nginx http fastcgi temporary files: "fastcgi_temp"
  nginx http uwsgi temporary files: "uwsgi_temp"
  nginx http scgi temporary files: "scgi_temp"

3. 接下来,使用以下命令编译 Nginx Pagespeed 模块。

make modules

此命令将花费一些时间,具体取决于您系统的 CPU 和内存。

4. 编译过程完成后,您的 Pagespeed 模块将以 ' objs/ngx_pagespeed.so ' 形式提供。使用以下命令检查该模块。

ls objs/ngx_pagespeed.so

您应当得到如下的 Nginx Pagespeed 模块 ' ngx_pagespeed.so '。

-rwxr-xr-x 1 root root 19M Dec  8 21:44 objs/ngx_pagespeed.so

将 Pagespeed 模块添加到当前 Nginx 安装

在此步骤中,您将把 Nginx Pagespeed 模块部署到当前的 Nginx 安装中。为此,请将 Pagespeed 模块 'ngx_pagespeed.so' 复制到 Nginx 模块目录,并添加新的配置以启用它。

1. 将模块 ' ngx_pagespeed.so ' 复制到默认的 Nginx 模块目录 '/usr/share/nginx/modules '。

cp /usr/src/nginx/nginx-$NG_VER/objs/ngx_pagespeed.so /usr/share/nginx/modules

2. 创建一个新的配置文件以启用 Pagespeedd 模块。

nano /usr/share/nginx/modules-available/ngx-pagespeed.conf

复制并粘贴以下配置。

load_module modules/ngx_pagespeed.so;

保存配置并退出。

3. 通过创建指向目录 ' /etc/nginx/modules-enabled/ ' 的符号链接配置 ' ngx-pagespeed.conf ' 来激活 Pagespeed 模块。

ln -s /usr/share/nginx/modules-available/ngx-pagespeed.conf /etc/nginx/modules-enabled/70-ngx-pagespeed.conf

4. 接下来,在 ' /etc/nginx ' 目录中创建一个新配置 'pagespeed.conf'。

nano /etc/nginx/pagespeed.conf

复制并粘贴以下配置。

pagespeed on;
# Needs to exist and be writable by nginx.  Use tmpfs for best performance.
pagespeed FileCachePath /var/ngx_pagespeed_cache;
# Ensure requests for pagespeed optimized resources go to the pagespeed handler
# and no extraneous headers get set.
location ~ "\.pagespeed\.([a-z]\.)?[a-z]{2}\.[^.]{10}\.[^.]+" {
  add_header "" "";
}
location ~ "^/pagespeed_static/" { }
location ~ "^/ngx_pagespeed_beacon$" { }

保存配置并退出。

5. 接下来,创建一个新目录用于存储 Nginx Pagespeed 缓存,并确保该目录对 Nginx 的 ' www-data ' 用户可写。

mkdir -p /var/ngx_pagespeed_cache
chown www-data:www-data /var/ngx_pagespeed_cache

现在 Nginx Pagespeed 模块已添加到您当前的 Nginx 安装中。请进入下一步,在您的虚拟主机(server 块)上启用它。

在虚拟主机上添加 Nginx Pagespeed 模块

要在您的虚拟主机上启用 Pagespeed 模块,请使用 'include' 选项将配置 ' pagespeed.conf' 添加到您的虚拟主机配置文件中。

1. 在本示例中,为虚拟主机 ' default ' 启用 Pagespeed 模块。使用 nano 编辑器编辑配置 '/etc/nginx/sites-available/default'。

nano /etc/nginx/sites-available/default

在 'server {...}' 部分内添加配置 'include /etc/nginx/pagespeed.conf;',如下所示。

server {
  .....
  ....
  include /etc/nginx/pagespeed.conf;
}

保存配置并退出。

2. 验证您的 Nginx 配置并确保没有任何错误。之后,重启 Nginx 服务以应用新配置。

nginx -t
sudo systemctl restart nginx

验证 Nginx Pagespeed 模块

要验证 Nginx Pagespeed 模块的安装与部署,您可以使用 curl 命令获取 Nginx Web 服务器的 HTTP 头,或使用 Web 浏览器中的 Inspect(检查)元素。

1. 执行下面的 curl 命令以获取您 Nginx Web 服务器的 HTTP 头。

curl -I https://domain.com/

现在您应当得到如下输出。额外的头部字段 ' X-Page-Speed ' 表示 Nginx Pagespeed 模块已启用。

HTTP/1.1 200 OK
Server: nginx/1.18.0
Content-Type: text/html
Connection: keep-alive
Date: Wed, 01 Dec 2021 22:02:52 GMT
X-Page-Speed: 1.13.35.2-0
Cache-Control: max-age=0, no-cache

在 Debian 11 上为 Nginx 配置 PageSpeed 加速模块完整教程

2. 要从您的 Web 浏览器进行检查,请访问您的域名并在页面上右键单击,然后选择 ' Inspect ' 菜单。

再次重新加载您的网页,您将看到如下详细的 HTTP 头。

在 Debian 11 上为 Nginx 配置 PageSpeed 加速模块完整教程

结论

恭喜!您已经学会了如何编译 Nginx Pagespeed 模块并将其部署到当前的 Nginx 安装中。您只需将配置 'pagespeed.conf' 引入到您的虚拟主机配置中即可。