devilboxcommunity/nginx-stable

Devilbox Nginx stable 镜像文档

镜像概述

Devilbox Nginx stable 镜像基于官方 Nginx Docker 镜像构建，是 Devilbox 本地开发环境的核心组件之一，提供稳定版本的 Nginx Web 服务器功能，并支持多架构运行。该镜像继承官方 Nginx 的基础特性，同时针对本地开发场景进行优化，便于与 Devilbox 生态中的其他服务（如 PHP、数据库等）集成。

核心功能与特性

• 官方镜像基础：构建于官方 Nginx Docker 镜像之上，确保与 Nginx 官方功能的兼容性和安全性
• 稳定版本保障：采用 Nginx 稳定版分支，提供可靠的 Web 服务运行环境
• 多架构支持：支持多种硬件架构（如 x86_64、ARM 等），可在不同设备和平台上部署
• 开发环境优化：针对本地开发流程设计，支持快速配置和灵活扩展

使用场景与适用范围

• 本地 Web 应用开发与测试环境搭建
• 与 Devilbox 开发栈（PHP-FPM、MySQL、Redis 等）配合构建完整开发环境
• 需要快速部署 Nginx 服务进行配置验证或功能测试的场景
• 多架构开发环境（如 ARM 设备上的开发调试）

使用方法与配置说明

基本运行命令

通过以下命令快速启动 Nginx 服务：

bash
docker run -d -p 80:80 --name devilbox-nginx devilbox/nginx:stable

挂载自定义配置

如需使用自定义 Nginx 配置，可挂载本地配置目录：

bash
docker run -d \
  -p 80:80 \
  -v /path/to/local/nginx/conf:/etc/nginx/conf.d \
  -v /path/to/webroot:/var/www/html \
  --name devilbox-nginx \
  devilbox/nginx:stable

Docker Compose 集成示例

在 Devilbox 环境中，通常与 PHP 等服务配合使用，以下是 docker-compose.yml 配置片段：

yaml
version: '3'
services:
  nginx:
    image: devilbox/nginx:stable
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx/conf:/etc/nginx/conf.d
      - ./webroot:/var/www/html
    depends_on:
      - php
    networks:
      - devilbox-network

  php:
    image: devilbox/php:8.2
    volumes:
      - ./webroot:/var/www/html
    networks:
      - devilbox-network

networks:
  devilbox-network:
    driver: bridge

配置文件说明

该镜像沿用官方 Nginx 的配置结构，主要配置路径如下：

• 主配置文件：/etc/nginx/nginx.conf
• 站点配置目录：/etc/nginx/conf.d/（推荐在此目录挂载自定义 .conf 文件）
• 默认网站根目录：/var/www/html

配置方式与官方 Nginx 一致，可通过修改配置文件实现虚拟主机、反向代理、SSL 等功能。