dr4g0nsr/nginx-php-redis

集成Nginx、PHP和Redis的一站式容器镜像

镜像概述和主要用途

本镜像将Nginx、PHP和Redis集成在单一容器中，提供一站式的Web应用运行环境。旨在简化部署流程，无需配置多个独立容器，适用于快速搭建包含Web服务器、脚本解析和缓存服务的应用架构。

核心功能和特性

• 组件集成：包含Nginx（Web服务器）、PHP 7.4（脚本解析器）和Redis（缓存服务）
• 端口灵活配置：支持自定义HTTP和HTTPS端口映射
• 持久化存储：可挂载Nginx配置、SSL证书、网站文件和日志目录
• 系统兼容：同步宿主机时间和时区，确保日志时间准确性
• 资源优化：配置系统资源限制（ulimits）和内核参数（sysctls），提升性能
• 健康监控：内置健康检查机制，确保服务可用性
• 自动恢复：支持服务异常时自动重启

使用场景和适用范围

• 小型Web应用开发与测试环境
• 个人项目或小型网站快速部署
• 需要简化容器管理的场景
• 对资源占用要求不高的应用场景

使用方法和配置说明

环境变量配置

创建.env文件配置镜像参数，示例如下：

OWNER_NAME=dr4g0nsr
IMAGE_NAME=nginx-php-redis
IMAGE_VERSION=1.2
PHP_VERSION=7.4
HTTP_PORT=80
HTTPS_PORT=443

参数说明：

• OWNER_NAME：镜像所有者名称
• IMAGE_NAME：镜像名称
• IMAGE_VERSION：镜像版本号
• PHP_VERSION：PHP版本（当前为7.4）
• HTTP_PORT：宿主机映射的HTTP端口
• HTTPS_PORT：宿主机映射的HTTPS端口

Docker Compose部署

创建docker-compose.yml文件编排服务，示例如下：

yaml
version: '3.5'
services:
    web:
        image: ${IMAGE_NAME}:${IMAGE_VERSION}
        hostname: web
        container_name: web
        volumes:
         - /etc/localtime:/etc/localtime:ro
         - /etc/timezone:/etc/timezone:ro
         - ./etc/nginx:/etc/nginx/conf.d
         - ./etc/ssl:/etc/ssl-generated
         - /etc/letsencrypt:/etc/letsencrypt:ro
         - ./www:/var/www/html
         - ./logs:/var/log/nginx
        ports:
         - "0.0.0.0:${HTTP_PORT}:80"
         - "0.0.0.0:${HTTPS_PORT}:443"
        ulimits:
         nproc: 65535
         nofile:
          soft: 20000
          hard: 40000
        stop_grace_period: 5s
        sysctls:
         - net.ipv4.ip_local_port_range=5000 65000
         - net.ipv4.conf.all.accept_redirects=0
         - net.ipv4.conf.all.secure_redirects=0
         - net.ipv4.conf.all.send_redirects=0
         - net.core.somaxconn=1024
        restart: always
        healthcheck:
         test: ["CMD", "/docker-healthcheck.sh"]
         interval: 30s
         timeout: 5s
         retries: 3
         start_period: 5s
        stdin_open: true
        tty: true

配置项说明：

• volumes：挂载目录配置
  • /etc/localtime//etc/timezone：同步宿主机时间和时区
  • ./etc/nginx：Nginx配置文件目录
  • ./etc/ssl：生成的SSL证书目录
  • /etc/letsencrypt：Let's Encrypt证书目录（只读）
  • ./www：网站根目录
  • ./logs：Nginx日志目录
• ports：端口映射，将容器80/443端口映射到宿主机指定端口
• ulimits：资源限制，设置最大进程数和文件描述符数
• sysctls：内核参数配置，优化网络性能
• restart：重启策略，设置为always确保服务持续运行
• healthcheck：健康检查配置，每30秒执行一次检查脚本

部署步骤

1. 创建项目目录并存放.env和docker-compose.yml文件
2. 准备Nginx配置文件（存放于./etc/nginx目录）
3. 放置网站文件（存放于./www目录）
4. 执行部署命令：

   bash
   docker-compose up -d
   

5. 检查服务状态：

   bash
   docker-compose ps
   

日志查看

Nginx日志默认挂载到宿主机./logs目录，可通过以下命令查看：

bash
tail -f ./logs/access.log
tail -f ./logs/error.log