cs2ag/docker-varnish

Varnish 7.5 Docker容器

基于Debian 11构建的Varnish 7.5 Docker容器，提供高性能HTTP缓存加速能力，用于减轻后端服务器负载并提升Web应用响应速度。

核心功能与特性

• 基于Debian 11稳定系统，内置Varnish 7.5缓存服务器
• 支持自定义VCL（Varnish配置语言）文件定义缓存策略
• 通过环境变量灵活配置Varnish运行参数和存储设置
• 支持挂载主机目录实现配置文件持久化管理
• 暴露标准服务端口（80）和管理端口（6082）

使用场景

• Web服务器前端缓存，加速静态资源（图片、CSS、JS等）交付
• 减轻后端应用服务器负载，提高系统并发处理能力
• 实现HTTP请求路由、内容压缩及高级缓存策略
• 需要自定义缓存规则的Web应用部署环境

使用方法

前提条件

使用容器前需准备：

• 自定义VCL配置文件（命名为default.vcl）
• Varnish密钥文件（命名为secret）

配置文件可通过两种方式集成：

1. 重建镜像时包含配置文件
2. 运行容器时挂载包含配置文件的主机目录

Docker运行示例

bash
docker run -d \
  -v /path/to/host/varnish/config:/etc/varnish \  # 挂载包含配置文件的主机目录
  --env 'VARNISH_PARAMS=-p pipe_timeout=1440 -p syslog_cli_traffic=off -p feature=+esi_ignore_https' \  # Varnish运行参数
  --env 'VARNISH_STORAGE=malloc,1G' \  # 缓存存储配置
  --name cs2agvarnish \
  -p 8080:80 \  # 映射Varnish服务端口
  -p 8081:6082 \  # 映射Varnish管理端口
  cs2ag/varnish:v7.5

环境变量配置

挂载主机目录

需将包含以下文件的主机目录挂载至容器/etc/varnish目录：

• default.vcl：Varnish主配置文件，定义缓存规则、后端服务器等
• secret：Varnish管理接口认证密钥文件

挂载示例：

bash
-v /srv/www/varnish_config:/etc/varnish

暴露端口

重新加载VCL配置

修改default.vcl后，通过以下命令重载配置（无需重启容器）：

bash
docker container exec CONTAINER_NAME '/usr/sbin/varnishreload'

其中CONTAINER_NAME为容器名称（如示例中的cs2agvarnish）。

作者

Peter Misinsky (<***>)