Apache PageSpeed-Nginx Docker镜像使用指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00356/article/details/148526984

Apache PageSpeed-Nginx Docker镜像使用指南

incubator-pagespeed-ngx Apache Pagespeed Nginx: 这是一个开源的 Nginx 模块，用于优化网站性能。它适用于熟悉 Nginx 和网站优化的开发者，具有自动优化、减少页面加载时间和提高用户体验的特点。项目地址: https://gitcode.com/gh_mirrors/in/incubator-pagespeed-ngx

项目概述

Apache PageSpeed-Nginx（简称ngx_pagespeed）是一个开源的Nginx模块，它能自动优化网站性能，减少页面加载时间。该模块通过自动应用Web性能最佳实践来优化页面和相关资源（CSS、JavaScript、图像），而无需修改现有内容或工作流程。

核心功能特性

ngx_pagespeed模块提供以下优化功能：

图像优化：
- 移除元数据
- 动态调整大小
- 重新压缩图像
CSS和JavaScript优化：
- 代码最小化
- 文件合并
- 内联小型资源
- 延迟加载
HTML重写：
- 自动优化HTML结构
- 缓存生命周期扩展
其他优化：
- 资源预加载
- 关键路径CSS优化
- DNS预取

Docker镜像版本说明

主要镜像标签

稳定版镜像：
- 1.13.35.2、stable、latest等标签
- 基于Alpine Linux 3.8构建
- 与Nginx 1.14版本集成
边缘版镜像：
- 1.13.35.2-edge、edge等标签
- 使用Alpine Edge版本
- 包含最新的系统更新
Nginx主线版本镜像：
- ngx1.15等标签
- 支持Nginx 1.15版本
- 同样提供Alpine 3.8和Edge两种基础

版本选择建议

生产环境推荐使用stable标签
需要最新功能可尝试edge版本
特定Nginx版本需求可选择对应标签

快速使用指南

基础运行方式

运行一个简单的静态网站容器：

docker run --name my-pagespeed -v /本地静态目录:/usr/share/nginx/html:ro -d pagespeed/nginx-pagespeed

自定义镜像构建

更推荐的方式是通过Dockerfile构建自定义镜像：

FROM pagespeed/nginx-pagespeed
COPY 静态目录 /usr/share/nginx/html

构建并运行：

docker build -t my-custom-pagespeed .
docker run --name my-site -d -p 8080:80 my-custom-pagespeed

高级配置方法

自定义Nginx配置

挂载自定义配置文件：

docker run --name custom-nginx -v /本地路径/nginx.conf:/etc/nginx/nginx.conf:ro -d pagespeed/nginx-pagespeed

从运行容器提取默认配置

docker run --name temp-container -d pagespeed/nginx-pagespeed
docker cp temp-container:/etc/nginx/nginx.conf /本地路径/
docker rm -f temp-container

使用环境变量

通过envsubst工具实现动态配置：

# docker-compose.yml示例
version: '3'
services:
  web:
    image: pagespeed/nginx-pagespeed
    volumes:
      - ./template.conf:/etc/nginx/conf.d/template.conf
    environment:
      - NGINX_HOST=example.com
    command: >
      /bin/bash -c "envsubst < /etc/nginx/conf.d/template.conf > /etc/nginx/conf.d/default.conf
      && nginx -g 'daemon off;'"

性能优化配置建议

在nginx.conf中添加pagespeed配置：

pagespeed on;
pagespeed FileCachePath /var/cache/ngx_pagespeed;

# 启用常用过滤器
pagespeed EnableFilters combine_css,combine_javascript;
pagespeed EnableFilters rewrite_images;
pagespeed EnableFilters lazyload_images;