Nginx Proxy 项目教程

项目的目录结构及介绍

Nginx Proxy 项目的目录结构如下：

nginx-proxy/
├── Dockerfile
├── LICENSE
├── README.md
├── app
│   ├── Dockerfile
│   ├── entrypoint.sh
│   ├── nginx.tmpl
│   └── test
│       ├── Dockerfile
│       ├── docker-compose.yml
│       ├── index.html
│       └── test.sh
├── docker-compose.yml
├── nginx.tmpl
└── test
    ├── Dockerfile
    ├── docker-compose.yml
    ├── index.html
    └── test.sh

目录介绍

• Dockerfile: 用于构建 Docker 镜像的文件。
• LICENSE: 项目的开源许可证。
• README.md: 项目的说明文档。
• app/: 包含应用程序的 Dockerfile 和入口点脚本。
• app/entrypoint.sh: 应用程序的入口点脚本。
• app/nginx.tmpl: Nginx 配置模板文件。
• app/test/: 包含测试相关的文件。
• docker-compose.yml: Docker Compose 配置文件，用于定义和运行多个 Docker 容器。
• nginx.tmpl: Nginx 配置模板文件。
• test/: 包含测试相关的文件。

项目的启动文件介绍

entrypoint.sh

entrypoint.sh 是项目的启动文件，负责启动 Nginx 服务并加载配置文件。以下是 entrypoint.sh 的部分代码：

#!/bin/sh

# 设置环境变量
export DOLLAR='$'

# 生成 Nginx 配置文件
envsubst < /etc/nginx/nginx.tmpl > /etc/nginx/nginx.conf

# 启动 Nginx 服务
exec nginx -g "daemon off;"

启动流程

1. 设置环境变量: 将 $ 符号赋值给 DOLLAR 环境变量，用于在配置文件中引用环境变量。
2. 生成 Nginx 配置文件: 使用 envsubst 命令将模板文件 /etc/nginx/nginx.tmpl 转换为实际的 Nginx 配置文件 /etc/nginx/nginx.conf。
3. 启动 Nginx 服务: 使用 exec 命令启动 Nginx 服务，并设置 daemon off 选项，确保 Nginx 以前台模式运行。

项目的配置文件介绍

nginx.tmpl

nginx.tmpl 是 Nginx 的配置模板文件，包含了 Nginx 的基本配置和代理规则。以下是 nginx.tmpl 的部分代码：

server {
    listen 80;
    server_name ${VIRTUAL_HOST};

    location / {
        proxy_pass http://${UPSTREAM};
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

配置项介绍

• listen 80: 监听 80 端口。
• server_name ${VIRTUAL_HOST}: 设置虚拟主机名，从环境变量 VIRTUAL_HOST 中获取。
• location /: 定义根路径的代理规则。
• proxy_pass http://${UPSTREAM}: 将请求代理到指定的上游服务器，从环境变量 UPSTREAM 中获取。
• proxy_set_header: 设置代理请求头，包括 Host, X-Real-IP, X-Forwarded-For, X-Forwarded-Proto 等。

通过以上配置，Nginx Proxy 项目可以实现对多个服务的自动代理和负载均衡。