crunchgeek/nginx-pagespeed Docker 镜像 - 轩辕镜像

镜像概述与主要用途

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

核心功能与特性### PageSpeed

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

• http://localhost:8080/pagespeed_admin/

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

集成VTS模块，提供虚拟主机流量监控功能，可通过以下地址访问状态页：

• http://localhost:8080/status/

GeoIP（地理位置解析）

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

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

More Headers（响应头扩展设置）

通过more_set_headers模块支持设置更多HTTP响应头，特别适用于多集群环境下的头信息自定义。

Substitutions Filter（响应内容替换）

集成subs_filter模块，支持对响应体进行正则表达式或固定字符串替换，实现动态内容修改。

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配置扩展