eeacms/varnish

Varnish Docker 镜像

镜像概述与主要用途

Varnish Docker 镜像是一个支持动态后端、Rancher DNS 集成、自动配置与重载的通用缓存服务镜像。该镜像基于轻量级 Alpine 系统构建，可广泛应用于各类 Web 服务的性能优化场景，不仅限于 EEA（欧洲环境署）相关项目。

基础信息：

• 基础镜像：Alpine 3.19
• Varnish 版本：7.6.1
• 暴露端口：80（HTTP）、8443（HTTPS）

核心功能与特性

• 动态后端支持：自动感知后端容器变化，实时更新 IP 列表
• Rancher DNS 集成：通过 dynamic.director 实现 Rancher 环境下的 DNS 动态解析
• 自动配置与重载：支持 VCL 配置自动生成及服务热重载
• 环境变量注入：允许将环境变量直接嵌入 VCL 配置文件
• 只读卷支持：通过 /varnish-config 卷管理只读 VCL 模板文件
• 轻量级构建：基于 Alpine 系统，镜像体积小，资源占用低

支持的标签及 Dockerfile 链接

主要标签

• :7 https://github.com/eea/eea.docker.varnish/blob/7.x/Dockerfile%EF%BC%88Alpine 3.19，Varnish 7.6.1）

稳定不可变标签

查看https://github.com/eea/eea.docker.varnish/releases

使用场景与适用范围

• 通用 Web 缓存：为静态资源（图片、CSS、JS）或动态内容提供高性能 HTTP 缓存
• 容器化环境：在 Docker/Kubernetes/Rancher 等容器平台中部署，动态管理后端服务
• 动态后端场景：后端服务频繁扩缩容或 IP 变化时，自动维护缓存路由
• 自定义配置需求：需要通过环境变量或自定义 VCL 文件定制缓存策略的场景

安装与准备

1. 安装 Docker 环境
2. 拉取镜像：docker pull eeacms/varnish

配置参数说明（环境变量）

使用方法

1. 通过 VARNISH_CFG_CONTENT 注入配置

直接通过环境变量传递 VCL 配置内容，适用于简单配置场景。示例 docker-compose.yml：

yaml
version: '3'
services:
  varnish:
    image: eeacms/varnish:7
    ports:
      - "80:80"
    environment:
      - VARNISH_SIZE=2G
      - VARNISH_CFG_CONTENT='vcl 4.1;
backend default {
    .host = "webserver";
    .port = "80";
}'
    depends_on:
      - webserver
  webserver:
    image: nginx:alpine

启动：docker-compose up -d

2. 扩展镜像自定义 VCL 文件

默认 default.vcl 仅包含 VCL 版本声明。如需自定义基础配置，可通过 Dockerfile 扩展镜像：

dockerfile
FROM eeacms/varnish:7
COPY varnish.vcl /etc/varnish/default.vcl

构建自定义镜像：docker build -t my-varnish /path/to/dockerfile-dir

3. 在 VCL 中使用环境变量

步骤：

1. 定义以 VARNISH_ 为前缀的环境变量（如 VARNISH_BACKEND_HOST）
2. 在 Dockerfile 中设置默认值（如 ENV VARNISH_BACKEND_HOST=webserver）
3. 在 VCL 文件中用 <变量名> 占位：

   vcl
   backend default {
       .host = "<VARNISH_BACKEND_HOST>";
       .port = "<VARNISH_BACKEND_PORT>";
   }
   

4. 运行容器时通过 -e 覆盖默认值：docker run -e VARNISH_BACKEND_HOST=api-server eeacms/varnish

4. 使用只读卷存储 VCL 模板

通过 /varnish-config 只读卷挂载 VCL 模板文件，容器启动时会将该目录下的文件（保持目录结构）复制到 /etc/varnish 并进行变量替换：

bash
docker run -v /local/vcl-templates:/varnish-config:ro eeacms/varnish

5. Rancher 集成（动态后端）

使用 dynamic.director 实现 Rancher DNS 动态解析，自动发现后端容器 IP：

vcl
vcl 4.1;
import dynamic;

sub vcl_init {
    # 动态后端配置：端口、DNS TTL（秒）
    new cluster = dynamic.director(port = "<VARNISH_BACKEND_PORT>", ttl = <VARNISH_DNS_TTL>);
    # 添加后端服务域名（Rancher 服务名）
    cluster.add_backend("web-service");
}

sub vcl_recv {
    set req.backend_hint = cluster.backend();
}

环境变量配置：-e VARNISH_BACKEND_PORT=80 -e VARNISH_DNS_TTL=60

6. 基础 docker run 示例

bash
docker run -d \
  --name varnish \
  -p 80:80 \
  -e VARNISH_SIZE=512M \
  -e VARNISH_CFG_CONTENT='vcl 4.1; backend default { .host="nginx"; .port="80"; }' \
  --link nginx:nginx \
  eeacms/varnish:7

升级方法

拉取最新镜像并重建容器：

bash
docker pull eeacms/varnish:7
docker stop varnish && docker rm varnish
# 重新运行容器（使用原配置参数）

版权与许可

原始代码的初始所有者为欧洲环境署（EEA），保留所有权利。
原始代码为自由软件，可根据 GNU 通用公共许可证（GPL）第 2 版或更高版本的条款重新分发和/或修改。

资助信息

由 欧洲环境署（EU） 资助开发。