bearstech/nginx

bearstech/nginx 镜像文档

镜像概述和主要用途

bearstech/nginx是由bearstech提供的Nginx Docker镜像，旨在简化Nginx服务的部署与配置管理。该镜像支持动态生成配置文件，适用于需要快速搭建Web服务器并灵活调整Nginx设置的场景。Dockerfile源码可通过https://github.com/factorysh/docker-nginx%E8%8E%B7%E5%8F%96%E3%80%82

核心功能和特性

• 动态配置生成：集成envsubst模板引擎，自动将/etc/nginx/conf.d/*.tmpl模板文件编译为.conf配置文件
• 默认网站根目录：预设网站文件存放路径为/var/www/html，便于通过卷挂载本地文件
• 可定制虚拟主机：支持在自定义镜像中覆盖默认虚拟主机（vhost）配置文件，满足个性化需求

使用场景和适用范围

• 开发/测试环境中快速部署Nginx服务
• 需要根据环境变量动态调整Nginx配置的场景
• 需简化Nginx配置管理流程的中小型Web服务部署

使用方法和配置说明

基本使用示例

通过以下命令启动容器，将当前目录挂载为网站根目录：

bash
docker run --rm -v `pwd`:/var/www/html bearstech/nginx

默认配置说明

• 网站根目录：默认路径为/var/www/html，可通过-v参数挂载本地目录到该路径提供网站文件
• 配置建议：如需精细调整虚拟主机配置，建议在自定义镜像中覆盖default虚拟主机文件

动态配置生成详解

工作机制

容器启动时，ENTRYPOINT会执行以下操作：

1. 扫描/etc/nginx/conf.d/目录下所有扩展名为.tmpl的文件
2. 使用envsubst工具（GNU gettext组件）处理模板文件中的环境变量占位符
3. 将处理后的内容输出为同名.conf文件（如example.tmpl生成example.conf）

模板使用示例

1. 创建配置模板文件/etc/nginx/conf.d/myvhost.tmpl：

   nginx
   server {
       listen 80;
       server_name ${DOMAIN_NAME};
       root /var/www/html;
   }
   

2. 启动容器时设置环境变量：

   bash
   docker run -e DOMAIN_NAME=example.com -v $(pwd)/templates:/etc/nginx/conf.d bearstech/nginx
   

3. 容器会自动生成myvhost.conf配置文件，其中${DOMAIN_NAME}被替换为example.com