amd64/nginx

注意：这是https://hub.docker.com/_/nginx的`amd64`架构专用仓库——更多信息，请参见官方镜像文档中的“https://github.com/docker-library/official-images#architectures-other-than-amd64”和官方镜像FAQ中的“https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what”。

快速参考

• 维护者：
  https://github.com/nginxinc/docker-nginx

• 获取帮助的途径：
  https://dockr.ly/comm-slack、Server Fault、https://unix.stackexchange.com/help/on-topic 或 https://stackoverflow.com/help/on-topic

支持的标签及对应的Dockerfile链接

• https://github.com/nginx/docker-nginx/blob/c3785f2653008f9354c3d29a54d8c5459c53fa60/mainline/debian/Dockerfile

• https://github.com/nginx/docker-nginx/blob/c3785f2653008f9354c3d29a54d8c5459c53fa60/mainline/debian-perl/Dockerfile

• https://github.com/nginx/docker-nginx/blob/c3785f2653008f9354c3d29a54d8c5459c53fa60/mainline/debian-otel/Dockerfile

• https://github.com/nginx/docker-nginx/blob/c3785f2653008f9354c3d29a54d8c5459c53fa60/mainline/alpine/Dockerfile

• https://github.com/nginx/docker-nginx/blob/c3785f2653008f9354c3d29a54d8c5459c53fa60/mainline/alpine-perl/Dockerfile

• https://github.com/nginx/docker-nginx/blob/c3785f2653008f9354c3d29a54d8c5459c53fa60/mainline/alpine-slim/Dockerfile

• https://github.com/nginx/docker-nginx/blob/c3785f2653008f9354c3d29a54d8c5459c53fa60/mainline/alpine-otel/Dockerfile

• https://github.com/nginx/docker-nginx/blob/9b549fdf936778810dbe95a4813899c60444ef1c/stable/debian/Dockerfile

• https://github.com/nginx/docker-nginx/blob/7f1d49f6f222f7e588a9066fd53a0ce43c3466a5/stable/debian-perl/Dockerfile

• https://github.com/nginx/docker-nginx/blob/7f1d49f6f222f7e588a9066fd53a0ce43c3466a5/stable/debian-otel/Dockerfile

• https://github.com/nginx/docker-nginx/blob/7f1d49f6f222f7e588a9066fd53a0ce43c3466a5/stable/alpine/Dockerfile

• https://github.com/nginx/docker-nginx/blob/7f1d49f6f222f7e588a9066fd53a0ce43c3466a5/stable/alpine-perl/Dockerfile

• https://github.com/nginx/docker-nginx/blob/9b549fdf936778810dbe95a4813899c60444ef1c/stable/alpine-slim/Dockerfile

• https://github.com/nginx/docker-nginx/blob/7f1d49f6f222f7e588a9066fd53a0ce43c3466a5/stable/alpine-otel/Dockerfile

快速参考（续）

• 问题反馈地址：
  https://github.com/nginxinc/docker-nginx/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/nginx/、https://hub.docker.com/r/arm32v5/nginx/、https://hub.docker.com/r/arm32v6/nginx/、https://hub.docker.com/r/arm32v7/nginx/、https://hub.docker.com/r/arm64v8/nginx/、https://hub.docker.com/r/i386/nginx/、https://hub.docker.com/r/mips64le/nginx/、https://hub.docker.com/r/ppc64le/nginx/、https://hub.docker.com/r/riscv64/nginx/、https://hub.docker.com/r/s390x/nginx/

• 镜像工件详情：
  https://github.com/docker-library/repo-info/blob/master/repos/nginx (https://github.com/docker-library/repo-info/commits/master/repos/nginx)
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fnginx
  https://github.com/docker-library/official-images/blob/master/library/nginx (https://github.com/docker-library/official-images/commits/master/library/nginx)

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/nginx (https://github.com/docker-library/docs/commits/master/nginx)

什么是Nginx？

Nginx（发音为“engine-x”）是一款开源的反向代理服务器，支持HTTP、HTTPS、SMTP、POP3和IMAP协议，同时也是负载均衡器、HTTP缓存和Web服务器（源服务器）。Nginx项目最初专注于高并发、高性能和低内存占用。它基于2条款BSD类许可证授权，可运行在Linux、BSD变体、Mac OS X、Solaris、AIX、HP-UX以及其他类Unix系统上，同时也有针对Microsoft Windows的概念验证版本。

***.org/wiki/Nginx

如何使用本镜像

托管简单静态内容

console
$ docker run --name some-nginx -v /some/content:/usr/share/nginx/html:ro -d amd64/nginx

或者，可以使用简单的Dockerfile生成包含必要内容的新镜像（这比上述绑定挂载更简洁）：

dockerfile
FROM docker.xuanyuan.run/amd64/nginx
COPY static-html-directory /usr/share/nginx/html

将此文件与内容目录（“static-html-directory”）放在同一目录下，然后运行以下命令构建并启动容器：

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://host-ip:8080。

自定义配置

您可以挂载配置文件，或基于此镜像构建包含自定义配置的新镜像。

如果需要修改默认配置，可以通过以下命令从运行的nginx容器中获取默认配置：

console
$ docker run --rm --entrypoint=cat amd64/nginx /etc/nginx/nginx.conf > /host/path/nginx.conf

然后在主机文件系统中编辑/host/path/nginx.conf。

有关nginx配置文件的语法，请参见http://nginx.org/en/docs/（特别是http://nginx.org/en/docs/beginners_guide.html#conf_structure）。

挂载配置文件

console
$ docker run --name my-custom-nginx-container -v /host/path/nginx.conf:/etc/nginx/nginx.conf:ro -d amd64/nginx

构建包含自定义配置的新镜像

dockerfile
FROM docker.xuanyuan.run/amd64/nginx
COPY nginx.conf /etc/nginx/nginx.conf

如果在Dockerfile中添加自定义CMD，请确保在CMD中包含-g daemon off;，以便nginx在前台运行，Docker能够正确跟踪进程（否则容器启动后会立即停止）！

然后使用docker build -t custom-nginx .构建镜像，并按以下方式运行：

console
$ docker run --name my-custom-nginx-container -d custom-nginx

在amd64/nginx配置中使用环境变量（1.19版本新增）

默认情况下，amd64/nginx不支持在大多数配置块中使用环境变量。但本镜像提供了一个功能，可在nginx启动前提取环境变量。

以下是使用compose.yaml的示例：

yaml
web:
  image: docker.xuanyuan.run/amd64/nginx
  volumes:
   - ./templates:/etc/nginx/templates
  ports:
   - "8080:80"
  environment:
   - NGINX_HOST=foobar.com
   - NGINX_PORT=80

默认情况下，此功能会读取/etc/nginx/templates/*.template中的模板文件，并执行envsubst后将结果输出到/etc/nginx/conf.d。

因此，如果您放置templates/default.conf.template文件，其中包含如下变量引用：

listen       ${NGINX_PORT};

将输出到/etc/nginx/conf.d/default.conf，内容如下：

listen       80;

可通过以下环境变量修改此行为：

• NGINX_ENVSUBST_TEMPLATE_DIR
  • 包含模板文件的目录（默认：/etc/nginx/templates）
  • 当此目录不存在时，该功能不会处理模板。
• NGINX_ENVSUBST_TEMPLATE_SUFFIX
  • 模板文件的后缀（默认：.template）
  • 仅处理名称以此后缀结尾的文件。
• NGINX_ENVSUBST_OUTPUT_DIR
  • 执行envsubst后输出结果的目录（默认：/etc/nginx/conf.d）
  • 输出文件名是移除后缀后的模板文件名。
    • 例如：/etc/nginx/templates/default.conf.template将输出为/etc/nginx/conf.d/default.conf。
  • 此目录必须可被运行容器的用户写入。

以只读模式运行amd64/nginx

要以只读模式运行amd64/nginx，需要将Docker卷挂载到nginx写入信息的所有位置。默认amd64/nginx配置需要对/var/cache/nginx和/var/run具有写权限。可通过以下命令轻松实现：

console
$ docker run -d -p 80:80 --read-only -v $(pwd)/nginx-cache:/var/cache/nginx -v $(pwd)/nginx-pid:/var/run nginx

如果您的高级配置要求nginx写入其他位置，只需为这些位置添加更多卷挂载。

以调试模式运行nginx

1.9.8及以上版本的镜像包含nginx-debug二进制文件，在使用更高日志级别时会生成详细输出。可通过简单的CMD替换使用：

console
$ docker run --name my-nginx -v /host/path/nginx.conf:/etc/nginx/nginx.conf: