注意： 这是 varnish官方镜像 的 i386 架构构建的“按架构”仓库——更多信息，请参见官方镜像文档中的“非amd64架构？”和官方镜像FAQ中的“镜像源在Git中已更改，该怎么办？”。

快速参考

-** 维护者：**Varnish Docker社区

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

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

• fresh, 8.0.0, 8, 8.0, latest

• fresh-alpine, 8.0.0-alpine, 8-alpine, 8.0-alpine, alpine

• old, 7.7.3, 7.7

• old-alpine, 7.7.3-alpine, 7.7-alpine

• stable, 6.0.16, 6.0

快速参考（续）

-** 问题提交地址：[*]

-** 支持的架构：**(更多信息)
amd64、arm32v7、arm64v8、i386、ppc64le、s390x

-** 镜像 artifact 详情：**repo-info 仓库的 repos/varnish/ 目录（历史记录）
（镜像元数据、传输大小等）

-** 镜像更新：**official-images 仓库的 library/varnish 标签
official-images 仓库的 library/varnish 文件（历史记录）

-** 本描述的来源：**docs 仓库的 varnish/ 目录（历史记录）

什么是 Varnish？

Varnish 是一款 HTTP 加速器，专为内容密集型动态网站和 API 设计。与其他 Web 加速器（如 ***，最初作为客户端缓存；或 Apache 和 nginx，主要作为源服务器）不同，Varnish 从设计之初就是一款 HTTP 加速器。Varnish 仅专注于 HTTP，而其他代理服务器通常支持 FTP、SMTP 等网络协议。

***：Varnish (软件))

!logo

如何使用本镜像

基本用法

使用 VARNISH_BACKEND_HOST 和 VARNISH_BACKEND_PORT

只需指定后端服务器（Varnish 将加速其内容）的地址：

# 定义 VARNISH_BACKEND_HOST/VARNISH_BACKEND_PORT
# 工作目录需挂载为 tmpfs 以避免磁盘 I/O，
# 使用 8080 端口与容器通信（容器内部监听 80 端口）
$ docker run \
    -e VARNISH_BACKEND_HOST=example.com -e VARNISH_BACKEND_PORT=80 \
    --tmpfs /var/lib/varnish/varnishd:exec \
    -p 8080:80 \
    i386/varnish

之后，可在浏览器中访问 localhost:8080 查看 example.com 的首页。

使用 VCL 文件

如果已有 VCL 配置文件，可直接将其挂载为 /etc/varnish/default.vcl：

# 需将配置文件挂载到容器内的 /etc/varnish/default.vcl，
# 工作目录需挂载为 tmpfs 以避免磁盘 I/O，
# 使用 8080 端口与容器通信（容器内部监听 80 端口）
$ docker run \
    -v /path/to/default.vcl:/etc/varnish/default.vcl:ro \
    --tmpfs /var/lib/varnish/varnishd:exec \
    -p 8080:80 \
    i386/varnish

或者，可通过简单的 Dockerfile 生成包含自定义 default.vcl 的新镜像：

FROM i386/varnish

COPY default.vcl /etc/varnish/

将此文件与 default.vcl 放在同一目录，运行 docker build -t my-varnish . 构建镜像，然后启动容器：

$ docker run --tmpfs /var/lib/varnish/varnishd:exec -p 8080:80 my-varnish

重新加载配置

所有镜像均包含 varnishreload 工具，可在不重启容器（从而不丢失缓存）的情况下更新运行中的配置。基本用法如下：

# 更新容器内的 default.vcl
docker cp new_default.vcl running_container:/etc/varnish/default.vcl
# 运行 varnishreload
docker exec running_container varnishreload

注意，varnishreload 还支持重新加载其他文件（不一定是 default.vcl）、标签（l）、旧标签垃圾回收（-m）等功能。如需了解更多，运行：

docker run varnish varnishreload -h

额外配置

缓存大小（VARNISH_SIZE）

默认情况下，容器使用 100MB 缓存大小，通常偏小。可通过 VARNISH_SIZE 环境变量调整：

$ docker run --tmpfs /var/lib/varnish/varnishd:exec -p 8080:80 -e VARNISH_SIZE=2G i386/varnish

监听端口（VARNISH_HTTP_PORT/VARNISH_PROXY_PORT）

Varnish 默认在 80 端口监听 HTTP 流量，可通过 VARNISH_HTTP_PORT 环境变量覆盖。类似地，VARNISH_PROXY_PORT 变量（默认 8443）指定 PROXY 协议 的监听端口，该协议主要用于与 hitch 交互（hitch 也默认使用 8443 端口）。

# 让 Varnish 在 7777 端口监听，而非默认的 80 端口
$ docker run --tmpfs /var/lib/varnish/varnishd:exec -p 8080:7777 -e VARNISH_HTTP_PORT=7777 i386/varnish

VCL 文件路径

默认 Varnish 配置文件为 /etc/varnish/default.vcl，可通过 VARNISH_VCL_FILE 环境变量覆盖。这有助于创建可通过不同配置部署的单一镜像。

额外参数

此外，可在 i386/varnish 后添加参数。若第一个参数以 - 开头，整个参数列表将附加到默认命令：

# 延长默认保持时间
$ docker run --tmpfs /var/lib/varnish/varnishd:exec -p 8080:80 -e VARNISH_SIZE=2G i386/varnish -p default_keep=300

若 i386/varnish 后的第一个参数不以 - 开头，则会覆盖默认命令：

# 显示命令行选项
$ docker run i386/varnish varnishd -?

# 使用自定义参数运行服务器（不要忘记 -F 以避免后台运行）
$ docker run i386/varnish varnishd -F -a :8080 -b 127.0.0.1:8181 -t 600 -p feature=+http2

vmods（7.1 及以上版本）

如前所述，可使用 vmod_dynamic 进行后端解析。镜像还包含 varnish-modules 集合。有关用法和语法的所有文档可在该仓库的 src/ 目录中找到。

此外，镜像包含 install-vmod helper 脚本，可在创建自定义镜像时快速下载、编译和安装 vmods。注意，镜像设置了 ENV 变量 VMOD_DEPS 以简化操作。

Debian

FROM i386/varnish:7.1

# 切换到 root 用户并安装构建依赖
USER root
RUN set -e; \
    apt-get update; \
    apt-get -y install $VMOD_DEPS /pkgs/*.deb; \
    \
# 安装一个或多个 vmods
    install-vmod [***] \
    \
# 清理并切换回 varnish 用户
    apt-get -y purge --auto-remove $VMOD_DEPS varnish-dev; \
    rm -rf /var/lib/apt/lists/*
USER varnish

Alpine

FROM i386/varnish:7.1-alpine

# 安装构建依赖
USER root
RUN set -e; \
    apk add --no-cache $VMOD_DEPS; \
    \
# 安装一个或多个 vmods
    install-vmod [***] \
    \
# 清理
    apk del --no-network $VMOD_DEPS
USER varnish

镜像变体

i386/varnish 镜像有多种变体，适用于不同场景。

i386/varnish:<version>

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

i386/varnish:<version>-alpine

此镜像基于流行的 Alpine Linux 项目，来自 alpine 官方镜像。Alpine Linux 比大多数发行版基础镜像小得多（约 5MB），因此生成的镜像通常更精简。

当最终镜像大小是首要考虑因素时，此变体非常有用。需注意的是，它使用 musl libc 而非 glibc 等，因此软件可能因 libc 依赖/假设而出现问题。更多讨论参见 Hacker News 评论线程。

为最小化镜像大小，Alpine 基础镜像通常不包含额外工具（如 git 或 bash）。如需这些工具，可在自己的 Dockerfile 中添加（参见 alpine 镜像描述 了解安装包的示例）。

许可证

查看此镜像中包含的软件的 许可证信息。

与所有 Docker 镜像一样，这些镜像可能还包含其他软件，可能采用其他许可证（如基础发行版中的 Bash 等，以及主要软件的任何直接或间接依赖）。

可在 repo-info 仓库的 varnish/ 目录 中找到一些自动检测到的额外许可证信息。

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用符合其中包含的所有软件的相关许可证。