crunchgeek/nginx-pagespeed

镜像概述与主要用途

本Docker镜像基于Debian Stretch Linux发行版构建，目标是提供集成多种增强模块的最新Nginx Web服务器。通过整合Google PageSpeed优化、GeoIP地理位置解析、虚拟主机流量监控(VTS)、响应头自定义、内容替换过滤及JSON日志等功能，满足高性能Web服务部署与运维需求。

核心功能与特性### PageSpeed

集成PageSpeed网站优化工具，可自动分析并优化网站资源以遵循Web最佳实践。启用后可通过以下地址访问管理状态页：

• http://localhost:8080/pagespeed_admin/

VTS（虚拟主机流量状态模块）

集成https://github.com/vozlt/nginx-module-vts%E6%A8%A1%E5%9D%97%EF%BC%8C%E6%8F%90%E4%BE%9B%E8%99%9A%E6%8B%9F%E4%B8%BB%E6%9C%BA%E6%B5%81%E9%87%8F%E7%9B%91%E6%8E%A7%E5%8A%9F%E8%83%BD%EF%BC%8C%E5%8F%AF%E9%80%9A%E8%BF%87%E4%BB%A5%E4%B8%8B%E5%9C%B0%E5%9D%80%E8%AE%BF%E9%97%AE%E7%8A%B6%E6%80%81%E9%A1%B5%EF%BC%9A

• http://localhost:8080/status/

GeoIP（地理位置解析）

集成GeoIP数据库，支持将远程IP地址解析为地理位置信息。

重要提示：受数据隐私***影响，MaxMind已调整免费GeoLite2数据库的访问方式。由于无法通过公共URL直接获取数据库文件，用户需手动下载数据库文件。

More Headers（响应头扩展设置）

通过https://github.com/openresty/headers-more-nginx-module%E6%A8%A1%E5%9D%97%E6%94%AF%E6%8C%81%E8%AE%BE%E7%BD%AE%E6%9B%B4%E5%A4%9AHTTP%E5%93%8D%E5%BA%94%E5%A4%B4%EF%BC%8C%E7%89%B9%E5%88%AB%E9%80%82%E7%94%A8%E4%BA%8E%E5%A4%9A%E9%9B%86%E7%BE%A4%E7%8E%AF%E5%A2%83%E4%B8%8B%E7%9A%84%E5%A4%B4%E4%BF%A1%E6%81%AF%E8%87%AA%E5%AE%9A%E4%B9%89%E3%80%82

Substitutions Filter（响应内容替换）

集成https://github.com/yaoweibin/ngx_http_substitutions_filter_module%E6%A8%A1%E5%9D%97%EF%BC%8C%E6%94%AF%E6%8C%81%E5%AF%B9%E5%93%8D%E5%BA%94%E4%BD%93%E8%BF%9B%E8%A1%8C%E6%AD%A3%E5%88%99%E8%A1%A8%E8%BE%BE%E5%BC%8F%E6%88%96%E5%9B%BA%E5%AE%9A%E5%AD%97%E7%AC%A6%E4%B8%B2%E6%9B%BF%E6%8D%A2%EF%BC%8C%E5%AE%9E%E7%8E%B0%E5%8A%A8%E6%80%81%E5%86%85%E5%AE%B9%E4%BF%AE%E6%94%B9%E3%80%82

JSON格式访问日志

容器将Web服务器访问日志以JSON格式输出至/stdout，便于通过Fluentd等第三方工具进行日志解析与分析。

核心功能亮点

• PageSpeed优化控制：通过环境变量启用/禁用以下优化特性：
  • 图片优化
  • JavaScript优化
  • 样式表优化
• 缓存引擎灵活选择：支持文件、memcached或Redis作为PageSpeed缓存存储
• 内置监控能力：包含虚拟主机流量统计与健康检查功能
• FastCGI优化：集成FastCGI文件缓存提升动态内容性能
• Redis内存缓存：支持Redis作为高效内存缓存后端

使用场景与适用范围

• 需提升页面加载速度的高性能Web服务（PageSpeed优化）
• 需要地理位置解析的访问控制场景（GeoIP）
• 需实时监控虚拟主机流量的运维场景（VTS）
• 多集群环境下的响应头自定义需求（More Headers）
• 需要动态替换响应内容的应用（Substitutions Filter）
• 需集成日志分析系统的环境（JSON格式日志）

使用方法与配置说明### 环境变量配置

通过环境变量控制镜像功能开关与参数，主要配置项如下：

Docker Compose部署示例

yaml
version: '3'
services:
  nginx:
    image: [镜像名称]
    ports:
      - "8080:8080"
    environment:
      - NGINX_PAGESPEED=on
      - NGINX_PAGESPEED_IMG=on
      - NGINX_PAGESPEED_JS=on
      - NGINX_PAGESPEED_CSS=on
      - NGINX_PAGESPEED_STORAGE=redis
      - NGINX_PAGESPEED_REDIS=redis:6379
      - NGINX_GEOIP=on
      - NGINX_DEFAULT_SERVER=on
    volumes:
      - ./geoip:/etc/nginx/geoip  # 挂载手动下载的GeoIP数据库
      - ./nginx/conf.d:/etc/nginx/conf.d  # 挂载自定义Nginx配置
    depends_on:
      - redis
  redis:
    image: redis:alpine

关键配置注意事项

1. GeoIP数据库：需从MaxMind官网注册并手动下载GeoLite2数据库，挂载至容器内Nginx配置指定路径
2. PageSpeed缓存：选择redis/memcached时，需确保对应服务可用且地址配置正确
3. 日志收集：JSON格式日志输出至stdout，可通过docker logs直接查看或集成至Fluentd等日志系统
4. 配置扩展：通过NGINX_INCLUDE_PATH指定额外配置文件路径，实现自定义Nginx配置扩展