nginxinc/ingress-demo

Ingress Demo 镜像文档

镜像概述和主要用途

该镜像是 https://hub.docker.com/r/nginxdemos/hello 的改进版本，专为 Kubernetes Ingress Controller 演示设计的 Web 服务器。主要用于展示和测试 Kubernetes 环境中的 Ingress 规则配置、流量路由及相关功能验证。

核心功能和特性

1. 多版本兼容性

提供两个版本以适配不同安全环境：

2. 健康检查支持

服务器通过 /health URI 端点响应健康检查请求，便于监控和自动恢复机制集成。

3. 选择性日志记录

访问日志仅记录 4xx（客户端错误）和 5xx（服务器错误）响应，减少冗余日志输出。

4. TLS 加密支持

内置自签名 SAN 证书（适用于 *.nginx.net 域名），默认启用 TLSv1.2 及以上版本加密。支持自定义证书替换，满足生产环境安全需求。

使用场景和适用范围

• Kubernetes Ingress 配置演示：验证 Ingress Controller 路由规则、路径匹配及流量转发功能。
• Ingress 规则功能测试：测试 SSL 终止、域名路由、路径重写等 Ingress 特性。
• 特权/非特权环境适配：支持 root 用户（特权环境）和 nginx 用户（非特权环境，如 OpenShift）部署。
• TLS 终端配置测试：验证自定义 TLS 证书挂载、HTTPS 加密及证书轮换机制。

使用方法和配置说明

标签选择与基础部署

根据目标环境选择对应标签，通过 docker run 命令启动容器：

latest 标签（特权环境）

bash
docker run -d -p 80:80 -p 443:443 --name ingress-demo nginxdemos/ingress-demo:latest

latest-unprivileged 标签（非特权环境）

bash
docker run -d -p 8080:8080 -p 8443:8443 --name ingress-demo-unprivileged nginxdemos/ingress-demo:latest-unprivileged

TLS 证书替换

默认使用自签名证书，如需替换为自定义证书，通过挂载卷方式指定证书路径：

• 证书路径：

  • 证书文件：/etc/nginx/certs/nginx.pem
  • 密钥文件：/etc/nginx/certs/nginx-key.pem

• 部署示例（以 latest 标签为例）：

bash
docker run -d \
  -p 80:80 -p 443:443 \
  -v /path/to/custom-cert.pem:/etc/nginx/certs/nginx.pem \
  -v /path/to/custom-key.pem:/etc/nginx/certs/nginx-key.pem \
  --name ingress-demo-custom-tls nginxdemos/ingress-demo:latest

Docker Compose 配置示例

以下为多环境部署示例，包含特权和非特权版本：

yaml
version: '3'
services:
  ingress-demo-privileged:
    image: nginxdemos/ingress-demo:latest
    ports:
      - "80:80"
      - "443:443"
    restart: always

  ingress-demo-unprivileged:
    image: nginxdemos/ingress-demo:latest-unprivileged
    ports:
      - "8080:8080"
      - "8443:8443"
    restart: always
    user: nginx  # 非特权用户运行（可选，镜像默认已配置）

健康检查验证

容器启动后，可通过以下命令验证健康检查端点：

bash
curl http://<容器IP>:<HTTP端口>/health

成功响应表示服务正常运行。