luizeof/nginx-proxy

镜像概述

nginx-proxy是一款基于Nginx构建的HTTP代理Docker镜像，主要用于在Docker环境中实现HTTP请求的转发与反向代理。该镜像通过简化配置流程，帮助用户快速搭建容器间的通信桥梁或实现服务暴露，适用于各类需要代理转发的Docker部署场景。

核心功能和特性

• 基于Nginx构建：依托Nginx稳定可靠的HTTP代理能力，确保代理服务的高性能和稳定性
• HTTP代理支持：提供HTTP请求转发和反向代理功能，满足基本代理需求
• 轻量级设计：镜像体积小巧，部署快速，资源占用低，适合Docker环境集成
• 简单配置方式：支持通过环境变量快速配置代理目标，减少手动配置复杂度

使用场景和适用范围

• Docker容器间的HTTP通信代理，解决容器网络隔离下的服务访问问题
• 将外部请求转发至内部Docker容器服务，实现服务暴露
• 开发环境中临时搭建的代理服务，简化多容器应用的通信配置
• 轻量级反向代理场景，无需复杂配置即可实现基础代理功能

使用方法和配置说明

基本使用（docker run 命令）

通过以下命令启动nginx-proxy容器，实现基本的HTTP代理功能：

bash
docker run -d -p 80:80 -e TARGET_URL=<目标服务URL> --name nginx-proxy nginx-proxy

参数说明：

• -p 80:80：将容器的80端口映射到主机80端口，接收外部HTTP请求
• -e TARGET_URL=<目标服务URL>：设置代理目标URL（如http://web-service:8080，需确保目标服务与nginx-proxy容器网络可达）
• --name nginx-proxy：指定容器名称为nginx-proxy

环境变量配置

自定义Nginx配置（高级用法）

如需更复杂的代理配置，可通过挂载本地Nginx配置文件覆盖容器默认配置：

bash
docker run -d -p 80:80 -v /本地路径/nginx.conf:/etc/nginx/nginx.conf --name nginx-proxy nginx-proxy

说明：本地Nginx配置文件需符合Nginx配置规范，确保包含代理相关配置（如proxy_pass指令指向目标服务）。

使用场景示例

示例1：容器间服务代理

将请求转发至同一Docker网络中的web服务容器（假设web服务容器名为web-app，端口8080）：

bash
# 创建自定义网络（若需）
docker network create my-network

# 启动web服务容器（示例）
docker run -d --name web-app --network my-network nginx:alpine

# 启动nginx-proxy容器，代理至web-app
docker run -d -p 80:80 --network my-network -e TARGET_URL=http://web-app:80 --name nginx-proxy nginx-proxy

此时访问主机80端口，请求将被转发至web-app容器的80端口。

示例2：外部请求转发至内部服务

将外部请求通过nginx-proxy转发至运行在本地的Docker容器服务：

bash
docker run -d -p 8080:8080 --name api-service my-api-service  # 启动API服务，端口8080
docker run -d -p 80:80 -e TARGET_URL=http://host.docker.internal:8080 --name nginx-proxy nginx-proxy

说明：host.docker.internal为Docker提供的特殊域名，用于容器访问主机网络服务（需Docker 18.03+版本支持）。