cenk1cenk2/caddy

Caddy Docker镜像文档

镜像概述

Caddy Docker镜像是将Caddy Web服务器容器化的部署方案。Caddy是一款现代化的开源Web服务器，以自动HTTPS配置、简洁的配置语法和强大的扩展性著称。该镜像旨在提供开箱即用的Web服务能力，帮助用户快速部署安全、高效的Web服务。

核心功能与特性

• 自动HTTPS：自动获取和续期Let's Encrypt证书，默认启用HTTPS，无需手动配置
• HTTP/2与HTTP/3支持：原生支持现代HTTP协议，提升服务性能与用户体验
• 反向代理：支持灵活的反向代理配置，可路由请求至后端服务（如API服务器、应用容器）
• 静态文件服务：高效托管静态网站资源（HTML、CSS、JavaScript、图片等）
• 简洁配置：采用Caddyfile作为配置文件，语法简洁易懂，支持动态配置重载
• 轻量级：基于Alpine Linux构建，镜像体积小，资源占用低

使用场景与适用范围

• 静态网站托管：部署个人博客、企业官网、文档站点等静态资源
• API服务网关：作为API服务的入口，处理请求路由、负载均衡与SSL终止
• 反向代理服务器：将请求转发至内部多个服务，实现服务隔离与统一入口
• 开发环境快速搭建：本地开发时快速启动Web服务，模拟生产环境配置

使用方法

基本部署（docker run）

1. 静态文件服务

将本地静态文件目录挂载到容器中，启动Caddy提供静态文件服务：

bash
docker run -d \
  --name caddy \
  -p 80:80 \
  -p 443:443 \
  -v ./Caddyfile:/etc/caddy/Caddyfile \
  -v ./static-files:/srv \
  -v caddy_data:/data \
  docker.xuanyuan.run/caddy:latest

2. 反向代理示例

通过Caddyfile配置反向代理，将请求转发至后端服务（如运行在localhost:3000的Node.js应用）：

Caddyfile内容：

example.com {
  reverse_proxy localhost:3000
}

启动容器（需确保后端服务与Caddy容器网络互通，可使用--network参数指定共享网络）：

bash
docker run -d \
  --name caddy \
  --network my-network \
  -p 80:80 \
  -p 443:443 \
  -v ./Caddyfile:/etc/caddy/Caddyfile \
  -v caddy_data:/data \
  docker.xuanyuan.run/caddy:latest

Docker Compose部署

创建docker-compose.yml文件，定义Caddy服务及相关配置：

yaml
version: '3.8'

services:
  caddy:
    image: docker.xuanyuan.run/caddy:latest
    container_name: caddy
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - ./static-files:/srv  # 静态文件目录（按需挂载）
      - caddy_data:/data      # 存储SSL证书等持久化数据
      - caddy_config:/config  # 配置持久化目录
    environment:
      - TZ=Asia/Shanghai      # 设置时区
    networks:
      - caddy-network

volumes:
  caddy_data:
  caddy_config:

networks:
  caddy-network:

启动服务：

bash
docker-compose up -d

配置说明

Caddyfile配置

Caddy的核心配置通过Caddyfile实现，以下是常见配置示例：

1. 静态网站托管

example.com {
  root * /srv
  file_server
}

2. 反向代理至后端服务

api.example.com {
  reverse_proxy backend:8080  # backend为docker-compose中后端服务名称
}

3. 启用压缩与缓存

example.com {
  root * /srv
  encode gzip zstd  # 启用Gzip和Zstd压缩
  header Cache-Control "public, max-age=3600"  # 设置缓存策略
  file_server
}

环境变量

数据卷挂载

管理与维护

查看日志

bash
docker logs -f caddy

重载配置

修改Caddyfile后，无需重启容器，执行以下命令重载配置：

bash
docker exec caddy caddy reload

更新镜像

bash
docker pull docker.xuanyuan.run/caddy:latest
docker-compose down
docker-compose up -d

注意事项

• 首次启动时，Caddy需要访问Let's Encrypt服务器以获取证书，请确保容器可访问互联网
• 生产环境中建议使用持久化卷挂载/data目录，避免证书丢失
• 若使用自定义域名，需确保DNS记录已正确指向服务器IP

参考链接

• https://caddyserver.com/docs
• https://github.com/caddyserver/caddy-docker