softonic/varnish

Varnish 镜像文档

镜像概述

本镜像基于官方 Varnish Cache 镜像构建，额外集成了 https://github.com/jonnenauha/prometheus_varnish_exporter 和 https://github.com/varnishcache-friends/libvmod-geoip2%E3%80%82%E5%89%8D%E8%80%85%E7%94%A8%E4%BA%8E%E5%B0%86 Varnish 监控指标暴露给 Prometheus，后者提供 MaxMind 数据库查询能力。

该镜像旨在同时作为 varnishd 服务和监控 exporter 运行，确保 Varnish 服务与监控组件使用相同版本。设计用于 Kubernetes Pod 中的 sidecar 容器，并已集成到 Softonic 的 https://github.com/softonic/varnish-chart 中，核心要求是共享 /var/lib/varnish 目录。

核心功能与特性

• 基于官方镜像：构建自 Varnish Cache 官方镜像，确保基础功能兼容性
• Prometheus 监控：集成 Prometheus Varnish Exporter，支持监控指标采集
• 地理位置查询：通过 libvmod-geoip2 支持 MaxMind 数据库查询
• 版本一致性：确保 Varnish 服务与监控组件版本匹配
• Kubernetes 兼容：支持作为 sidecar 容器部署，满足 Pod 内资源共享需求

使用场景与适用范围

• 需要 Prometheus 监控的 Varnish 缓存服务部署
• Kubernetes 环境中 Varnish Pod 的 sidecar 监控配置
• 需基于地理位置信息进行缓存策略调整的场景
• Softonic Varnish Helm Chart 的配套运行环境

使用方法与配置说明

基本运行要求

• 需共享 /var/lib/varnish 目录，确保 Varnish 服务与 exporter 访问相同的缓存数据
• 建议配合 Varnish 配置文件使用，定义缓存策略及监控指标

Docker 运行示例

bash
# 运行 Varnish 服务（主容器）
docker run -d --name varnish-main \
  -v /path/to/varnish/config:/etc/varnish \
  -v varnish-data:/var/lib/varnish \
  softonic/varnish varnishd -f /etc/varnish/default.vcl

# 运行 Exporter（sidecar 容器，共享数据卷）
docker run -d --name varnish-exporter \
  --volumes-from varnish-main \
  softonic/varnish prometheus_varnish_exporter

Kubernetes Sidecar 配置示例

yaml
apiVersion: v1
kind: Pod
metadata:
  name: varnish-pod
spec:
  containers:
  - name: varnish
    image: softonic/varnish
    command: ["varnishd", "-f", "/etc/varnish/default.vcl"]
    volumeMounts:
    - name: varnish-data
      mountPath: /var/lib/varnish
    - name: varnish-config
      mountPath: /etc/varnish
  - name: varnish-exporter
    image: softonic/varnish
    command: ["prometheus_varnish_exporter"]
    volumeMounts:
    - name: varnish-data
      mountPath: /var/lib/varnish
  volumes:
  - name: varnish-data
    emptyDir: {}
  - name: varnish-config
    configMap:
      name: varnish-config

环境变量与配置参数

• Varnish 核心参数：通过 varnishd 命令行参数配置，如 -f 指定 VCL 配置文件、-s 指定存储类型等
• Exporter 配置：可通过 prometheus_varnish_exporter 命令行参数调整，如 --web.listen-address 指定监听端口（默认 9131）

许可证

本镜像基于 Apache 2.0 许可证发布，详见 LICENSE。