braingamer/nginx-proxy-arm

braingamer/nginx-proxy-arm镜像说明

镜像概述

本镜像为https://github.com/jwilder/nginx-proxy%E7%9A%84ARM%E6%9E%B6%E6%9E%84%E5%88%86%E6%94%AF%EF%BC%8C%E4%B8%93%E4%B8%BA%E6%A0%91%E8%8E%93%E6%B4%BE%E7%AD%89ARM%E8%AE%BE%E5%A4%87%E8%AE%BE%E8%AE%A1%E3%80%82%E5%AE%83%E9%80%9A%E8%BF%87%E7%BB%93%E5%90%88nginx%E5%92%8Cdocker-gen%E5%B7%A5%E5%85%B7%EF%BC%8C%E5%AE%9E%E7%8E%B0%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%E9%85%8D%E7%BD%AE%E7%9A%84%E8%87%AA%E5%8A%A8%E7%94%9F%E6%88%90%E4%B8%8E%E5%8A%A8%E6%80%81%E6%9B%B4%E6%96%B0%EF%BC%8C%E5%BD%93%E5%90%8E%E7%AB%AF%E5%AE%B9%E5%99%A8%E5%90%AF%E5%8A%A8%E6%88%96%E5%81%9C%E6%AD%A2%E6%97%B6%EF%BC%8C%E8%87%AA%E5%8A%A8%E9%87%8D%E6%96%B0%E5%8A%A0%E8%BD%BDnginx%E9%85%8D%E7%BD%AE%E3%80%82

核心功能

• 自动配置生成：根据容器的VIRTUAL_HOST环境变量自动生成nginx反向代理配置。
• 动态更新：容器启动/停止时自动更新配置并 reload nginx。
• 多端口支持：可通过VIRTUAL_PORT指定后端容器的端口。
• 多虚拟主机：支持多个域名（用逗号分隔）和通配符域名。
• SSL支持：提供单域名、通配符证书及SNI功能。
• 基础认证：通过htpasswd实现虚拟主机的身份验证。
• 自定义配置：支持全局或按虚拟主机的自定义nginx配置。

使用场景

• 在ARM设备（如树莓派）上部署多个Web服务，需要统一反向代理入口。
• 动态管理容器化应用的访问入口，无需手动修改nginx配置。

配置说明

基本使用

启动nginx-proxy容器：

bash
docker run -d -p 80:80 -v /var/run/docker.sock:/tmp/docker.sock:ro braingamer/nginx-proxy-arm

启动后端容器时添加VIRTUAL_HOST环境变量：

bash
docker run -e VIRTUAL_HOST=foo.bar.com ...

Docker Compose示例

yaml
version: '2'
services:
  nginx-proxy:
    image: braingamer/nginx-proxy-arm
    container_name: nginx-proxy
    ports:
      - "80:80"
    volumes:
      - /var/run/docker.sock:/tmp/docker.sock:ro

  whoami:
    image: jwilder/whoami
    container_name: whoami
    environment:
      - VIRTUAL_HOST=whoami.local

启动后测试：

bash
curl -H "Host: whoami.local" localhost

多端口配置

若容器暴露多个端口，默认使用80端口，可通过VIRTUAL_PORT指定：

bash
docker run -e VIRTUAL_HOST=foo.bar.com -e VIRTUAL_PORT=8080 ...

SSL配置

挂载证书目录并暴露443端口：

bash
docker run -d -p 80:80 -p 443:443 -v /path/to/certs:/etc/nginx/certs -v /var/run/docker.sock:/tmp/docker.sock:ro braingamer/nginx-proxy-arm

证书文件需命名为域名.crt和域名.key，如foo.bar.com.crt。

基础认证

挂载htpasswd目录：

bash
docker run -d -p 80:80 -p 443:443 -v /path/to/htpasswd:/etc/nginx/htpasswd -v /path/to/certs:/etc/nginx/certs -v /var/run/docker.sock:/tmp/docker.sock:ro braingamer/nginx-proxy-arm

htpasswd文件需命名为VIRTUAL_HOST值，如foo.bar.com。

自定义Nginx配置

• 全局配置：挂载自定义.conf文件到/etc/nginx/conf.d/。
• 按虚拟主机配置：挂载文件到/etc/nginx/vhost.d/，文件名与VIRTUAL_HOST一致。
• 位置块配置：添加_location后缀的文件到/etc/nginx/vhost.d/，如foo.bar.com_location。