cytopia/nginx-mainline

Nginx主线版Docker镜像

该镜像属于**https://github.com/cytopia/devilbox**项目的一部分，基于官方Nginx主线版镜像扩展，支持自动创建虚拟主机，简化Web服务部署流程。

镜像概述

本镜像在官方Nginx主线版基础上，集成watcherd和vhost-gen工具，实现新增目录时自动生成虚拟主机。用户可通过挂载本地项目目录，快速创建多个Web站点，并支持自定义配置模板、PHP-FPM集成等功能。

核心功能

• 自动虚拟主机：挂载本地目录后，新增子目录将自动生成对应虚拟主机。
• 自定义模板：支持按项目目录配置虚拟主机模板，满足个性化需求。
• PHP-FPM集成：可连接远程PHP-FPM服务，实现动态内容解析。
• 日志管理：支持将日志重定向至Docker日志（stdout/stderr）。
• 权限适配：可修改Nginx用户的UID/GID，匹配本地文件权限。
• 时区设置：支持自定义容器时区。

使用场景

• 静态文件服务：快速部署静态网站或资源文件。
• PHP应用部署：结合PHP-FPM容器搭建LEMP栈，运行PHP应用（如WordPress、Laravel）。
• 多站点管理：通过自动虚拟主机功能，同时管理多个Web项目。

配置说明

环境变量

通用可选变量

默认虚拟主机变量

批量虚拟主机变量

挂载点

端口

部署示例

1. 静态文件服务

bash
docker run -d \
  -p 80:80 \
  -v ~/my-static-files:/var/www/default \
  docker.xuanyuan.run/cytopia/nginx-mainline

（注：文件将从~/my-static-files/htdocs目录提供服务）

2. PHP应用部署（结合PHP-FPM）

bash
# 启动PHP-FPM容器
docker run -d \
  -v ~/my-php-app:/var/www/default \
  --name php-fpm \
  docker.xuanyuan.run/cytopia/php-fpm-5.6

# 启动Nginx容器并连接PHP-FPM
docker run -d \
  -p 80:80 \
  -v ~/my-php-app:/var/www/default \
  -e PHP_FPM_ENABLE=1 \
  -e PHP_FPM_SERVER_ADDR=php-fpm \
  --link php-fpm \
  docker.xuanyuan.run/cytopia/nginx-mainline

3. 批量虚拟主机部署

bash
docker run -d \
  -p 80:80 \
  -e MASS_VHOST_ENABLE=1 \
  -e MASS_VHOST_TLD=.local \
  -e MASS_VHOST_DOCROOT=www \
  -v ~/my-projects:/shared/httpd \
  docker.xuanyuan.run/cytopia/nginx-mainline

（注：~/my-projects下的子目录将自动生成http://子目录名.local的虚拟主机）