注意

本仓库是Nginx镜像针对i386架构的"每架构"仓库——更多信息请参见镜像文档中的"非amd64架构？"和***镜像FAQ中的"Git中的镜像源已更改，该怎么办？"。

快速参考

• 维护者：
  NGINX Docker维护团队

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

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

• 1.29.2, mainline, 1, 1.29, latest, 1.29.2-trixie, mainline-trixie, 1-trixie, 1.29-trixie, trixie

• 1.29.2-perl, mainline-perl, 1-perl, 1.29-perl, perl, 1.29.2-trixie-perl, mainline-trixie-perl, 1-trixie-perl, 1.29-trixie-perl, trixie-perl

• 1.29.2-alpine, mainline-alpine, 1-alpine, 1.29-alpine, alpine, 1.29.2-alpine3.22, mainline-alpine3.22, 1-alpine3.22, 1.29-alpine3.22, alpine3.22

• 1.29.2-alpine-perl, mainline-alpine-perl, 1-alpine-perl, 1.29-alpine-perl, alpine-perl, 1.29.2-alpine3.22-perl, mainline-alpine3.22-perl, 1-alpine3.22-perl, 1.29-alpine3.22-perl, alpine3.22-perl

• 1.29.2-alpine-slim, mainline-alpine-slim, 1-alpine-slim, 1.29-alpine-slim, alpine-slim, 1.29.2-alpine3.22-slim, mainline-alpine3.22-slim, 1-alpine3.22-slim, 1.29-alpine3.22-slim, alpine3.22-slim

• 1.28.0, stable, 1.28, 1.28.0-bookworm, stable-bookworm, 1.28-bookworm

• 1.28.0-perl, stable-perl, 1.28-perl, 1.28.0-bookworm-perl, stable-bookworm-perl, 1.28-bookworm-perl

• 1.28.0-alpine, stable-alpine, 1.28-alpine, 1.28.0-alpine3.21, stable-alpine3.21, 1.28-alpine3.21

• 1.28.0-alpine-perl, stable-alpine-perl, 1.28-alpine-perl, 1.28.0-alpine3.21-perl, stable-alpine3.21-perl, 1.28-alpine3.21-perl

• 1.28.0-alpine-slim, stable-alpine-slim, 1.28-alpine-slim, 1.28.0-alpine3.21-slim, stable-alpine3.21-slim, 1.28-alpine3.21-slim

快速参考（续）

• 问题反馈地址：
  [***]

• 支持的架构：(更多信息)
  amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x

• 镜像制品详情：
  repo-info仓库的repos/nginx/目录 (历史记录)
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images仓库的library/nginx标签
  official-images仓库的library/nginx文件 (历史记录)

• 本描述的来源：
  docs仓库的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

!logo

如何使用此镜像

托管简单静态内容

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

或者，可通过简单的Dockerfile生成包含必要内容的新镜像（比上述绑定挂载方式更简洁）：

dockerfile
FROM i386/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或[***]。

自定义配置

可通过挂载配置文件或构建新镜像来自定义配置。

若需修改默认配置，可从运行中的nginx容器获取默认配置：

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

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

有关nginx配置文件语法的详细信息，请参见***文档（特别是入门指南）。

挂载配置文件

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

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

dockerfile
FROM i386/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

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

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

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

yaml
web:
  image: i386/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
  • 此目录必须可由运行容器的用户写入

以只读模式运行i386/nginx

要以只读模式运行i386/nginx，需将Docker卷挂载到所有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:ro -d i386/nginx nginx-debug -g 'daemon off;'

compose.yaml中的类似配置如下：

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

入口点静默日志

1.19.0及以上版本添加了详细的入口点输出，提供容器启动过程的信息。可通过设置环境变量NGINX_ENTRYPOINT_QUIET_LOGS静默此输出：

console
$ docker run -d -e NGINX_ENTRYPOINT_QUIET_LOGS=1 i386/nginx

用户和组ID

自1.17.0版本起，基于alpine和debian的镜像变体使用相同的用户和组ID来降低工作进程的权限：

console
$ id
uid=101(nginx) gid=101(nginx) groups=101(nginx)

以非root用户运行i386/nginx

可使用较低权限的任意UID/GID运行镜像，但需修改i386/nginx配置以使用该UID/GID对可写目录：

console
$ docker run -d -v $PWD/nginx.conf:/etc/nginx/nginx.conf i386/nginx

当前目录中的nginx.conf需重新定义以下指令：

nginx
pid        /tmp/nginx.pid;

并在http上下文中：

nginx
http {
    client_body_temp_path /tmp/client_temp;
    proxy_temp_path       /tmp/proxy_temp_path;
    fastcgi_temp_path     /tmp/fastcgi_temp;
    uwsgi_temp_path       /tmp/uwsgi_temp;
    scgi_temp_path        /tmp/scgi_temp;
...
}

或者，可参考***Docker NGINX非特权镜像。

镜像变体

i386/nginx镜像有多种版本，适用于不同使用场景。

i386/nginx:<version>

这是默认镜像。若不确定需求，建议使用此版本。它既可作为临时容器（挂载源代码并启动容器运行应用），也可作为构建其他镜像的基础。

部分标签可能包含bookworm或t