nginx-autoinstall编译ngx_pagespeed：Google性能优化模块实战指南

nginx-autoinstall编译ngx_pagespeed：Google性能优化模块实战指南

【免费下载链接】nginx-autoinstallCompile NGINX from source with custom modules and patches on Debian and Ubuntu项目地址: https://gitcode.com/gh_mirrors/ng/nginx-autoinstall

网站打开速度慢、图片和脚本体积过大导致首屏加载延迟，是很多站长最头疼的问题。ngx_pagespeed（Google 出品的 Nginx 性能优化模块）正是解决这一痛点的利器，而nginx-autoinstall这个开源项目，则让在 Debian 和 Ubuntu 上从源码编译带 ngx_pagespeed 的 Nginx 变得异常简单。本文就带你一步步完成nginx-autoinstall 编译 ngx_pagespeed的完整实战。

🚀 ngx_pagespeed 是什么？为什么值得装？

ngx_pagespeed 是 Google 开源的网页性能优化模块，它能在 Nginx 层面自动优化网页资源，无需逐一手动修改前端代码。它内置了几十个优化过滤器（Filters），主要包括：

装上它之后，网站的 PageSpeed 评分和实际加载速度往往能立竿见影地提升，是 Nginx 生态中最经典的性能优化方案之一。

🔧 nginx-autoinstall：源码编译 Nginx 的最佳搭档

nginx-autoinstall 是一个在Debian 9+ / Ubuntu 16.04+上从源码编译 Nginx 的自动化脚本。它最大的亮点是交互式菜单 + 可选的模块支持，其中就包括 ngx_pagespeed。

脚本的关键逻辑其实很清晰：在 nginx-autoinstall.sh 中，会下载 ngx_pagespeed 源码（版本号由脚本顶部的NPS_VER变量控制，默认 1.13.35.2），并自动拉取对应的 PSOL（PageSpeed Optimization Libraries）二进制库；随后在编译参数中通过--add-module把模块挂载进 Nginx，见 nginx-autoinstall.sh。

也就是说，你不需要手动处理模块源码、PSOL 库、编译参数这些繁琐细节，脚本全部帮你搞定。

📋 安装前的准备工作

开始之前，请确认你的服务器满足以下条件：

• ✅ 操作系统为Debian 9+ 或 Ubuntu 16.04+
• ✅ 拥有root 权限（脚本会强制检查，非 root 直接退出）
• ✅ 服务器可以访问外网（需要下载源码和依赖包）
• ✅ 预留足够的磁盘和内存（编译过程比较吃资源）

然后在服务器上获取项目脚本：

git clone https://gitcode.com/gh_mirrors/ng/nginx-autoinstall cd nginx-autoinstall chmod +x nginx-autoinstall.sh

🖱️ 交互式安装：一步步编译 ngx_pagespeed

直接运行脚本，进入交互式安装流程：

./nginx-autoinstall.sh

按提示依次操作：

1. 选择操作：输入1，选择"Install or update Nginx"
2. 选择版本：输入1安装 Stable 稳定版，或2安装 Mainline 主线版
3. 模块选择：看到PageSpeed 1.13.35.2 [y/n]:时，输入y回车 ✔️
4. 其他模块按需选择（不需要就输入n）
5. 选择 OpenSSL 实现（默认用系统自带的即可）
6. 按任意键开始编译安装

整个过程中，脚本会自动安装编译依赖（build-essential、libpcre3-dev、zlib1g-dev 等），下载并解压 ngx_pagespeed 源码和 PSOL 库，最后完成编译和安装。整个过程通常需要 5～15 分钟，取决于服务器性能。

⚡ 无交互自动化编译：一行命令搞定

如果你需要批量部署或写自动化脚本，nginx-autoinstall 提供了强大的HEADLESS无交互模式。只需设置PAGESPEED=y，即可跳过所有提问、直接编译带 ngx_pagespeed 的 Nginx：

HEADLESS=y \ NGINX_VER=MAINLINE \ PAGESPEED=y \ ./nginx-autoinstall.sh

这一行命令等价于交互模式下的完整操作，非常适合在 CI/CD 流水线或多台服务器上快速复制同样的 Nginx 环境。

✅ 验证 ngx_pagespeed 是否编译成功

安装完成后，用nginx -V查看编译参数，确认包含 pagespeed 模块：

nginx -V 2>&1 | grep pagespeed

输出类似下面这样，就说明编译成功了 🎉：

--add-module=/usr/local/src/nginx/modules/incubator-pagespeed-ngx-1.13.35.2-stable

还可以通过nginx -t检查配置语法是否正确。

⚙️ ngx_pagespeed 基础配置与最佳实践

编译成功只是第一步，还需要在 Nginx 配置中启用它。项目在 conf/README.md 中提供了可直接套用的配置模板，在http块中加入：

pagespeed on; pagespeed FileCachePath /var/ngx_pagespeed_cache;

其中FileCachePath指定的缓存目录必须存在且对 nginx 用户可写。官方建议使用 tmpfs 内存文件系统获得最佳性能，例如挂载后配置为/var/ngx_pagespeed_cache。

如果希望进一步开启统计与调试，可以加上项目模板中的管理路径：

pagespeed StatisticsPath /ngx_pagespeed_statistics; pagespeed MessagesPath /ngx_pagespeed_message; pagespeed ConsolePath /pagespeed_console; pagespeed AdminPath /pagespeed_admin;

配置完成后记得重载：

nginx -t && systemctl reload nginx

打开网页后，在 HTML 源码中能看到ModPagespeed相关的改写痕迹，或用开发者工具对比资源体积，即可确认优化已生效。

🔍 常见问题与排查技巧

• PSOL 下载失败：ngx_pagespeed 编译依赖 Google 的 PSOL 二进制库，网络受限时可能下载超时。可以手动下载psol压缩包放到指定目录后重试。
• 缓存目录无权限：报错Unable to create directory时，用chown -R nginx:nginx /var/ngx_pagespeed_cache修正属主。
• 与 HTTPS 站点配合：ngx_pagespeed 对 HTTPS 站点同样适用，无需额外配置；但若与 HTTP/2 同时启用，建议先在测试环境验证兼容性。
• 升级 Nginx：重新运行脚本即可覆盖安装并保留原有模块，无需卸载旧版本。

💡 总结

通过nginx-autoinstall 编译 ngx_pagespeed，你可以在短短十几分钟内，获得一个自动压缩图片、合并脚本、延迟加载资源的高性能 Nginx 服务器。无论是个人博客、企业官网还是电商站，这套组合都是性价比极高的性能优化方案。交互式安装适合新手，HEADLESS模式适合自动化运维，赶紧在你的 Debian 或 Ubuntu 服务器上试试吧！

【免费下载链接】nginx-autoinstallCompile NGINX from source with custom modules and patches on Debian and Ubuntu项目地址: https://gitcode.com/gh_mirrors/ng/nginx-autoinstall