pixartprinting/http

pixartprinting/php-nginx-proxy 镜像文档

镜像概述

pixartprinting/php-nginx-proxy是专为pixartprinting/php镜像设计的Nginx代理镜像，用于处理前端HTTP请求、实现反向代理至后端PHP服务，并提供负载均衡、SSL终端、缓存等增强功能，优化PHP应用的部署架构与运行效率。

核心功能与特性

1. 反向代理

• 将客户端HTTP/HTTPS请求转发至后端pixartprinting/php服务实例
• 支持自定义请求头传递、路径重写及URL映射规则

2. 负载均衡

• 内置Nginx负载均衡模块，支持轮询、权重、IP哈希等分配策略
• 自动检测后端服务健康状态，实现故障实例自动剔除

3. SSL终端

• 支持SSL/TLS证书配置，实现HTTPS加密传输
• 兼容主流SSL协议版本(TLSv1.2/1.3)及密码套件

4. HTTP缓存

• 可配置静态资源(JS/CSS/图片)缓存策略，减少后端请求压力
• 支持缓存过期时间、条件请求验证(ETag/Last-Modified)

5. 安全增强

• 内置请求过滤规则，防御常见Web***(XSS/CSRF/SQL注入)
• 支持自定义安全响应头(如Content-Security-Policy、X-Frame-Options)

6. 配置灵活性

• 支持通过挂载外部配置文件自定义Nginx规则
• 兼容标准Nginx配置语法，可扩展自定义模块

使用场景与适用范围

适用场景

• pixartprinting/php应用的生产环境部署
• 需要多实例负载均衡的PHP服务架构
• 需启用HTTPS加密的Web应用
• 静态资源密集型PHP应用(如电商、内容管理系统)
• 对请求延迟敏感的业务系统

不适用场景

• 非pixartprinting/php镜像的PHP应用(需手动调整代理配置)
• 纯静态文件服务(无后端PHP依赖时建议使用标准Nginx镜像)

使用方法与配置说明

前提条件

• 已安装Docker Engine(20.10+)/Docker Compose(2.0+)
• 已获取pixartprinting/php镜像并部署后端服务

基本使用步骤

1. 拉取镜像

bash
docker pull pixartprinting/php-nginx-proxy:latest

2. 基本运行命令(单实例代理)

bash
docker run -d \
  --name php-nginx-proxy \
  -p 80:80 \
  -e PHP_SERVICE_URL=http://php-service:9000 \  # 后端PHP服务地址
  --link php-service:php-service \  # 链接至PHP服务容器
  pixartprinting/php-nginx-proxy:latest

3. Docker Compose部署(多实例负载均衡)

yaml
version: '3.8'
services:
  nginx-proxy:
    image: pixartprinting/php-nginx-proxy:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d  # 自定义配置挂载
      - ./ssl:/etc/nginx/ssl  # SSL证书挂载
    environment:
      - PHP_SERVICE_NAME=php-app  # 后端服务集群名称
    depends_on:
      - php-app-1
      - php-app-2

  php-app-1:
    image: pixartprinting/php:latest
    # PHP服务配置...

  php-app-2:
    image: pixartprinting/php:latest
    # PHP服务配置...

核心配置说明

1. 自定义Nginx配置

通过挂载/etc/nginx/conf.d目录添加自定义配置文件(如php-proxy.conf):

nginx
server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://${PHP_SERVICE_NAME};  # 引用环境变量指定后端服务
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    # 静态资源缓存配置
    location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
        proxy_pass http://${PHP_SERVICE_NAME};
        expires 7d;
        add_header Cache-Control "public, max-age=604800";
    }
}

2. 环境变量配置

3. SSL配置示例

1. 准备SSL证书文件(cert.pem/key.pem)并挂载至容器
2. 设置环境变量启用SSL:

bash
docker run -d \
  --name php-nginx-proxy \
  -p 443:443 \
  -e ENABLE_SSL=1 \
  -e PHP_SERVICE_URL=http://php-service:9000 \
  -v ./ssl:/etc/nginx/ssl \
  --link php-service:php-service \
  pixartprinting/php-nginx-proxy:latest

部署注意事项

1. 网络配置：确保代理容器与后端PHP服务在同一Docker网络中，或通过--link参数建立连接
2. 资源限制：根据业务规模调整容器CPU/内存限制，避免Nginx连接数超限
3. 日志管理：建议挂载Nginx日志目录至宿主机，便于问题排查与监控
4. 配置更新：修改配置后需重启容器或通过nginx -s reload热加载配置
5. 安全加固：生产环境中建议禁用默认配置，使用自定义安全规则并定期更新证书

维护与更新

• 定期拉取最新镜像: docker pull pixartprinting/php-nginx-proxy:latest
• 监控Nginx运行状态: docker exec -it php-nginx-proxy nginx -t(配置检测)、docker logs php-nginx-proxy(日志查看)
• 性能优化: 根据访问日志调整缓存策略与负载均衡参数，优化Nginx配置文件