rodinvr/nginx

Docker-Nginx镜像

该镜像基于开源软件Nginx构建，Nginx是一款高性能的HTTP反向代理服务器、负载均衡器、HTTP缓存及Web服务器，以高并发、低内存占用为核心优势，支持Linux、BSD等多种操作系统。

核心功能

• 反向代理：支持HTTP、HTTPS、SMTP等协议的反向代理
• 负载均衡：实现多服务器间请求分发，提升系统可用性
• HTTP缓存：缓存静态资源，减少后端服务器压力
• Web服务器：直接托管HTML、CSS、JS等静态内容
• 灵活配置：支持自定义配置文件，适配复杂业务场景

使用场景

1. 托管静态网站或应用的静态资源
2. 作为反向代理转发请求到后端服务
3. 实现多服务器的负载均衡
4. 配置HTTPS加密访问
5. 调试Nginx服务及监控性能

配置说明

托管静态内容

方法1：挂载本地目录

console
docker run --name some-nginx -v /本地静态内容目录:/usr/share/nginx/html:ro -d rodinvr/nginx

方法2：通过Dockerfile构建

dockerfile
FROM rodinvr/nginx
COPY 本地静态目录 /usr/share/nginx/html

构建并运行：

console
docker build -t some-content-nginx .
docker run --name some-nginx -d some-content-nginx

暴露外部端口

console
docker run --name some-nginx -d -p 8080:80 some-content-nginx

访问 http://localhost:8080 或 http://主机IP:8080

复杂配置

挂载自定义配置文件

console
docker run --name my-custom-nginx -v /本地配置目录/nginx.conf:/etc/nginx/nginx.conf:ro -d rodinvr/nginx

复制默认配置文件

console
docker run --name tmp-nginx -d rodinvr/nginx
docker cp tmp-nginx:/etc/nginx/nginx.conf /本地路径/nginx.conf
docker rm -f tmp-nginx

通过Dockerfile自定义配置

dockerfile
FROM rodinvr/nginx
COPY nginx.conf /etc/nginx/nginx.conf

构建并运行：

console
docker build -t custom-nginx .
docker run --name my-custom-nginx -d custom-nginx

使用环境变量配置

通过envsubst动态生成配置，示例docker-compose.yml：

yaml
web:
  image: rodinvr/nginx
  volumes:
    - ./mysite.template:/etc/nginx/conf.d/mysite.template
  ports:
    - "8080:80"
  environment:
    - NGINX_HOST=foobar.com
    - NGINX_PORT=80
  command: /bin/bash -c "envsubst < /etc/nginx/conf.d/mysite.template > /etc/nginx/conf.d/default.conf && nginx -g 'daemon off;'"

mysite.template示例：

listen ${NGINX_PORT};
server_name ${NGINX_HOST};

调试模式运行

console
docker run --name my-nginx -v /本地配置/nginx.conf:/etc/nginx/nginx.conf:ro -d rodinvr/nginx nginx-debug -g 'daemon off;'

docker-compose示例：

yaml
web:
  image: rodinvr/nginx
  volumes:
    - ./nginx.conf:/etc/nginx/nginx.conf:ro
  command: [nginx-debug, '-g', 'daemon off;']

监控Nginx性能

可使用Nginx Amplify工具监控，需安装Amplify Agent到容器内，详情参考https://github.com/nginxinc/nginx-amplify-doc%E3%80%82

镜像变体

• rodinvr/nginx:<version>：默认镜像，适用于大多数场景
• rodinvr/nginx:alpine：基于Alpine Linux，镜像体积更小，适合对大小敏感的场景 ===END===