vukor/nginx

docker-web-stack

这是一个用于将Web应用以容器形式运行的Docker项目，包含nginx、php、mysql、postfix、dnsmasq等组件。

镜像概述

本项目旨在提供一套完整的容器化Web开发与运行环境，帮助用户快速搭建包含Web服务器、后端语言、数据库、邮件服务及DNS服务的应用栈，适用于本地开发、测试及小型生产环境。

核心功能

1. 多组件集成：整合nginx（Web服务器）、php（后端语言）、mysql（数据库）、postfix（邮件服务）、dnsmasq（DNS服务）等核心组件；
2. 便捷管理工具：提供项目创建、容器启停、数据库备份/恢复、定时任务管理等脚本；
3. 灵活配置：支持自定义docker-compose.yml参数（如MySQL密码、PHP版本）；
4. 数据持久化：通过卷（volume）保存数据库数据、配置文件及Web文件。

使用场景

• 本地Web应用开发环境搭建；
• 小型Web项目测试与演示；
• 需要快速部署多组件Web栈的场景。

配置说明

必要步骤

1. 下载项目：

   bash
   git clone https://vukor@github.com/vukor/docker-web-stack.git
   

2. 在系统中安装Docker和Docker Compose；
3. （可选）修改docker-compose.yml，如调整MYSQL_ROOT_PASSWORD或PHP版本（默认5.6）；
4. 创建数据卷：

   bash
   cd docker-web-stack/
   docker volume create --name data
   

5. 创建并启动容器：

   bash
   docker-compose up --no-build -d
   

6. 访问http://localhost/，应看到nginx返回的"410 Gone"响应；
7. （OSX用户）添加回环地址别名：

   bash
   sudo ifconfig lo0 127.0.0.2 alias
   

管理项目

• 创建虚拟主机：

  bash
  ./bin/create.prj.py PRJNAME  # 文档根目录为./htdocs/PRJNAME/
  # 或
  ./bin/create.prj.py -v5 PRJNAME  # 文档根目录为./htdocs/PRJNAME/www/
  

  创建后将Web文件放入对应文档根目录。

管理容器

• 启停/重启容器：

  bash
  docker-compose stop [container]
  docker-compose start [container]
  docker-compose restart [container]
  

• 构建并启动容器：

  bash
  docker-compose up -d [container]
  docker-compose build [container]
  

管理DNS zones

1. 创建DNS zone文件：

   bash
   echo "address=/my-first-project.ru/127.0.0.1" > .dnsmasq/zones/my-first-project.ru
   

2. 构建并启动dnsmasq容器：

   bash
   docker-compose build dns
   docker-compose up -d dns
   

3. 修改/etc/resolv.conf，添加：

   nameserver 127.0.0.2
   

管理数据库

1. 连接MySQL服务：

   bash
   make db-cmd
   

2. 备份所有数据库：

   bash
   make db-backup  # 备份文件存于backup/目录
   

3. 恢复数据库：

   bash
   make db-restore  # 从backup/目录恢复
   

更新镜像

bash
make upgrade  # 备份数据库→升级镜像→重启容器→恢复数据库

管理定时任务

1. 查看当前定时任务：

   bash
   make crontabs
   

2. 编辑.cron/cron-jobs后更新容器：

   bash
   docker-compose build cron && docker-compose up -d cron
   

共享目录说明

• .nginx/etc, .mysql5x/etc, .php5x/etc：配置文件目录；
• htdocs：Web文件目录；
• logs：应用日志目录；
• backup：MySQL备份目录。

有用链接

• http://docs.docker.com/compose/
• https://github.com/docker/compose/blob/master/docs/index.md

许可证

The MIT License (MIT)
Copyright (c) 2016 Anton Bugreev <***>

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.