stefanprodan/caddy

镜像概述

stefanprodan/caddy是一个基于Alpine Linux的非官方Caddy服务器Docker镜像，通过源代码构建。该镜像预集成http.ipfilter（IP过滤）和http.prometheus（Prometheus指标暴露）插件，适用于需要轻量级Web服务且需访问控制和监控功能的场景。构建项目地址：https://github.com/stefanprodan/caddy-builder%E3%80%82

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 内置插件：包含http.ipfilter（IP访问控制）和http.prometheus（Prometheus指标收集）
• 灵活配置：支持通过挂载自定义Caddyfile覆盖默认配置
• 数据持久化：可挂载卷以持久化站点文件和Let's Encrypt证书
• 多环境兼容：支持Docker单机和Docker Swarm集群部署

使用场景

• 部署静态网站的轻量级Web服务器
• 需要IP访问控制的Web服务
• 需集成Prometheus监控的Web应用
• Docker Swarm集群中的反向代理或静态资源服务

使用方法

基本运行（覆盖配置）

默认镜像包含基础Caddyfile，可通过挂载本地配置文件覆盖：

bash
docker run -d --name caddy \
    -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile \
    -p 80:80 \
    stefanprodan/caddy

挂载站点根目录

将本地站点文件挂载到容器的/www目录：

bash
docker run -d --name caddy \
    -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile \
    -v $(pwd)/site:/www \
    -p 80:80 \
    stefanprodan/caddy

暴露Prometheus指标端点

需映射Prometheus端口（如9180）并在Caddyfile中配置插件：

bash
docker run -d --name caddy \
    -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile \
    -v $(pwd)/site:/www \
    -p 80:80 -p 9180:9180 \
    stefanprodan/caddy

在Caddyfile中添加Prometheus配置：

example.com {
    prometheus 0.0.0.0:9180  # 暴露Prometheus指标到9180端口
    log stdout               # 日志输出到标准输出
    errors stderr            # 错误输出到标准错误
}

持久化Let's Encrypt证书

挂载卷以持久化证书（默认存储在/.caddy目录）：

bash
docker run -d --name caddy \
    -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile \
    -v $(pwd)/certs:/.caddy \
    -p 80:80 -p 443:443 \
    stefanprodan/caddy

在Caddyfile中配置TLS***（用于Let's Encrypt证书申请）：

example.com {
    tls contact@example.com  # 配置证书申请联系邮箱
}

Docker Swarm部署

部署到Docker Swarm需使用Docker引擎17.06或更高版本，通过配置文件和卷实现持久化：

yaml
version: "3.3"

configs:
  caddy_config:
    file: ./Caddyfile  # 本地Caddyfile路径

volumes:
  certs: {}  # 持久化证书的命名卷

services:
  caddy:
    image: stefanprodan/caddy
    ports:
      - 80:80   # HTTP端口映射
      - 443:443 # HTTPS端口映射
    configs:
      - source: caddy_config
        target: /etc/caddy/Caddyfile  # 容器内配置文件路径
    volumes:
      - certs:/.caddy  # 挂载证书卷
    deploy:
      mode: replicated
      replicas: 1  # 服务副本数量