wodby/varnish

Varnish HTTP加速器容器镜像文档

一、镜像概述和主要用途

Varnish HTTP加速器容器镜像是一个基于Varnish的通用Docker镜像，用于实现HTTP缓存代理功能。Varnish作为高性能的HTTP加速器，通过缓存频繁访问的内容（静态资源、API响应等），显著减少后端服务器负载，提升Web应用的响应速度和吞吐量。该镜像旨在提供开箱即用的Varnish部署方案，支持自定义配置，适用于各类需要HTTP加速的Web场景。

二、核心功能和特性

2.1 核心功能

• HTTP缓存代理：缓存HTTP响应，直接向客户端返回缓存内容，减少后端请求
• 反向代理：转发客户端请求至后端服务器，并将响应缓存
• 动态内容加速：支持通过VCL（Varnish配置语言）对动态内容进行缓存策略定制
• 请求/响应处理：支持修改HTTP请求头、响应头，实现URL重写、压缩等功能

2.2 镜像特性

• 多版本支持：基于官方Varnish多版本构建（如6.x、7.x），满足不同环境需求
• 灵活配置：支持通过环境变量或自定义VCL文件配置缓存策略
• 轻量级部署：容器化设计，易于集成到Docker Compose或Kubernetes环境
• 可观测性：支持日志输出至stdout，便于集成日志收集工具（如ELK、Prometheus）

三、使用场景和适用范围

3.1 使用场景

• 静态内容加速：缓存CSS、JS、图片等静态资源，减少后端重复请求
• 动态内容缓存：通过TTL（生存时间）配置缓存API响应、动态页面片段
• 高并发场景：应对流量峰值，减轻后端服务器（如Nginx、Apache、应用服务器）负载
• CDN前置加速：作为边缘节点缓存，提升用户就近访问速度

3.2 适用范围

• 需要提升响应速度的Web应用（电商网站、内容平台、博客等）
• 高流量API服务（如RESTful API、GraphQL服务）
• 静态资源密集型站点（图片库、文档站点）
• 需优化后端资源利用率的云原生应用

四、使用方法和配置说明

4.1 镜像拉取

从Docker Hub拉取最新版本镜像：

bash
docker pull wodby/varnish:latest

如需指定Varnish版本（如7.4），可使用标签：

bash
docker pull wodby/varnish:7.4

4.2 基本运行（docker run）

4.2.1 最简启动（默认配置）

默认配置下，Varnish监听80端口，后端指向localhost:8080，缓存内存为128M：

bash
docker run -d --name varnish -p 80:80 wodby/varnish:latest

4.2.2 自定义后端和缓存配置

通过环境变量指定后端服务器、缓存内存大小：

bash
docker run -d --name varnish \
  -p 80:80 \
  -e VARNISH_BACKEND_HOST=webapp \  # 后端服务器主机名/IP
  -e VARNISH_BACKEND_PORT=3000 \     # 后端服务器端口
  -e VARNISH_STORAGE_SIZE=512M \     # 缓存内存大小（支持M/G单位）
  wodby/varnish:latest

4.3 Docker Compose配置示例

创建docker-compose.yml，集成Varnish与后端Web服务（如Nginx）：

yaml
version: '3.8'

services:
  varnish:
    image: wodby/varnish:latest
    ports:
      - "80:80"
    environment:
      - VARNISH_BACKEND_HOST=web
      - VARNISH_BACKEND_PORT=80
      - VARNISH_STORAGE_SIZE=1G
      - VARNISH_VCL_CONF=/etc/varnish/default.vcl  # 自定义VCL文件路径
    volumes:
      - ./varnish/default.vcl:/etc/varnish/default.vcl  # 挂载本地VCL文件
    depends_on:
      - web

  web:
    image: nginx:alpine
    volumes:
      - ./web:/usr/share/nginx/html  # 后端静态资源

4.4 配置参数详解

4.4.1 环境变量

4.4.2 VCL配置

Varnish通过VCL（Varnish Configuration Language）定义缓存策略，默认VCL文件路径为/etc/varnish/default.vcl。如需自定义缓存规则，可挂载本地VCL文件至容器内VARNISH_VCL_CONF指定路径。

示例：自定义VCL文件（default.vcl）

vcl
vcl 4.1;

# 定义后端服务器（可通过环境变量动态替换）
backend default {
    .host = "${VARNISH_BACKEND_HOST}";
    .port = "${VARNISH_BACKEND_PORT}";
}

# 收到客户端请求时执行
sub vcl_recv {
    # 对静态资源（.js/.css/.png等）设置较长缓存
    if (req.url ~ "(?i)\.(jpg|jpeg|png|gif|ico|css|js)$") {
        set req.ttl = 1h;  # 缓存1小时
        return (hash);
    }
    # 对API路径（/api/*）不缓存
    if (req.url ~ "^/api/") {
        return (pass);  # 直接转发至后端
    }
}

# 缓存命中时执行
sub vcl_hit {
    if (obj.ttl > 0s) {
        return (deliver);
    }
    return (miss);
}

# 缓存未命中时执行
sub vcl_miss {
    return (fetch);
}

挂载自定义VCL：
通过-v参数将本地default.vcl挂载至容器：

bash
docker run -d --name varnish \
  -p 80:80 \
  -e VARNISH_BACKEND_HOST=webapp \
  -e VARNISH_VCL_CONF=/etc/varnish/custom.vcl \
  -v $(pwd)/default.vcl:/etc/varnish/custom.vcl \
  wodby/varnish:latest

4.5 日志与监控

4.5.1 查看日志

Varnish日志默认输出至容器stdout，可通过docker logs查看：

bash
docker logs -f varnish

4.5.2 性能监控

Varnish提供varnishstat工具查看缓存命中率、请求量等指标，可通过docker exec执行：

bash
docker exec -it varnish varnishstat

4.6 常见操作

• 重启Varnish服务：

  bash
  docker exec -it varnish service varnish restart
  

• 重新加载VCL配置（无需重启容器）：

  bash
  docker exec -it varnish varnishreload
  

• 进入容器：

  bash
  docker exec -it varnish sh
  

五、参考链接

• 官方GitHub仓库：https://github.com/wodby/varnish
• Varnish官方文档：[***]