nginxdemos/nginx-hello

NGINX Hello Nonroot 镜像文档

镜像概述

该镜像提供一个以非root权限运行的NGINX Web服务器，主要用于提供包含主机名、IP地址、端口、请求URI及服务器本地时间的简单信息页面。适用于演示、测试环境或基础服务状态展示场景。

核心功能与特性

• 非root权限运行：遵循安全最佳实践，容器内进程以非特权用户身份运行，降低安全风险
• 信息展示页面：默认页面显示关键信息：
  • 服务器主机名
  • 服务器IP地址
  • 监听端口
  • 客户端请求URI
  • 服务器本地时间
• 轻量级设计：基于官方NGINX镜像优化，保持较小镜像体积
• 即开即用：无需额外配置，启动后自动提供信息页面

使用场景

• 容器网络演示：展示容器基础网络属性（主机名、IP等）
• 环境测试：验证端口映射、网络连通性等基础功能
• 服务监控：作为简单状态页，快速确认服务运行状态
• 学习案例：了解非root用户容器配置及安全最佳实践

使用方法与配置说明

快速启动（docker run）

bash
docker run -d -p 8080:8080 --name nginx-hello nginxinc/nginx-hello-nonroot

参数说明：

• -p 8080:8080：端口映射（主机端口:容器端口），默认监听8080端口
• --name nginx-hello：自定义容器名称
• -d：后台运行模式

访问 http://localhost:8080 即可查看信息页面。

Docker Compose 配置

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  nginx-hello:
    image: nginxinc/nginx-hello-nonroot
    ports:
      - "8080:8080"
    container_name: nginx-hello
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

自定义端口配置

如需修改监听端口，可通过挂载自定义NGINX配置实现：

1. 创建自定义配置文件 nginx.conf
2. 启动时挂载配置文件：

bash
docker run -d -p 8081:8081 -v $(pwd)/nginx.conf:/etc/nginx/nginx.conf --name nginx-hello nginxinc/nginx-hello-nonroot

更多信息

项目源代码及详细文档：https://github.com/nginxinc/NGINX-Demos/tree/master/nginx-hello-nonroot