vukor/dnsmasq

docker-web-stack镜像概述

该镜像属于docker-web-stack项目的一部分，旨在通过Docker容器快速构建包含nginx、php、mysql、postfix、dnsmasq等组件的Web应用环境，适用于本地开发和测试场景。

核心功能

• 提供nginx作为Web服务器，处理HTTP请求
• 支持PHP（默认5.6版本）运行环境，解析动态Web内容
• 集成MySQL数据库，实现数据存储与管理
• 包含dnsmasq工具，支持本地DNS域名映射配置
• 提供Cron任务管理、数据库备份/恢复等辅助功能

使用场景

• 本地Web应用开发环境搭建
• 多项目并行测试环境配置
• 快速验证Web应用功能与兼容性

配置说明

必要步骤

1. 下载项目代码：

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

2. 安装Docker及Docker Compose工具
3. （可选）修改docker-compose.yml，调整MySQL密码、PHP版本等参数
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/
  # 或指定PHP版本5：
  ./bin/create.prj.py -v5 PRJNAME  # 文档根目录：./htdocs/PRJNAME/www/
  

  将Web文件放入对应目录即可部署应用

容器管理

• 基础操作：

  bash
  docker-compose stop [容器名]  # 停止容器
  docker-compose start [容器名] # 启动容器
  docker-compose restart [容器名] # 重启容器
  docker-compose build [容器名] # 构建容器
  

DNS配置

1. 添加自定义域名映射：

   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. 修改系统DNS：在/etc/resolv.conf中添加nameserver 127.0.0.2

数据库管理

• 连接MySQL：

  bash
  make db-cmd
  

• 备份数据库：

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

• 恢复数据库：

  bash
  make db-restore
  

镜像更新

bash
make upgrade  # 自动备份数据库、升级镜像并恢复数据

Cron任务管理

• 查看任务：

  bash
  make crontabs
  

• 编辑任务：修改.cron/cron-jobs后执行：

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

共享目录说明

• .nginx/etc/.mysql5x/etc/.php5x/etc：组件配置文件目录
• htdocs：Web应用文件目录
• logs：应用日志目录
• backup：数据库备份目录

参考链接

• Docker Compose官方文档
• https://github.com/docker/compose/blob/master/docs/index.md

许可证

该项目遵循MIT许可证，详情见原项目说明。