bibica/caddy-alpine-latest

docker-caddy-alpine-latest 镜像文档

镜像概述

docker-caddy-alpine-latest是一个基于最新Alpine Linux构建的Caddy Web服务器镜像。该镜像的核心特性是能够自动更新至Caddy的最新稳定版本，确保用户始终使用包含最新功能和安全修复的Caddy服务。镜像继承了Alpine Linux的轻量级特性，同时保留了Caddy的全部核心功能，为Web服务部署提供高效、安全且易于维护的解决方案。

核心功能与特性

• 自动版本更新：定期检查并更新至Caddy最新稳定版本，无需手动干预即可获取最新功能和安全补丁
• 轻量级基础：基于最新Alpine Linux构建，镜像体积小，资源占用低，适合各种部署环境
• Caddy原生功能：支持自动HTTPS（通过Let's Encrypt）、反向代理、负载均衡、HTTP/2、HTTP/3、WebSocket等现代Web服务特性
• 简单配置：兼容Caddyfile配置格式，易于上手和扩展，支持多种配置方式

使用场景与适用范围

• 需要运行最新版本Caddy的Web服务环境
• 开发和测试环境中快速部署Caddy服务器
• 轻量级Web应用和静态网站托管
• 需要自动HTTPS配置的中小型网站
• 作为反向代理服务，转发请求至后端应用（如Node.js、Python、Java等应用）
• 资源受限环境下的Web服务部署

使用方法与配置说明

基本使用

通过以下命令快速启动默认配置的Caddy服务器：

bash
docker run -d -p 80:80 -p 443:443 --name caddy docker.xuanyuan.run/bibicadotnet/caddy-alpine-latest

挂载自定义Caddyfile

若需使用自定义配置，可将本地Caddyfile挂载到容器中：

bash
docker run -d -p 80:80 -p 443:443 \
  -v /path/to/your/Caddyfile:/etc/caddy/Caddyfile \
  --name caddy docker.xuanyuan.run/bibicadotnet/caddy-alpine-latest

Docker Compose 配置示例

创建docker-compose.yml文件进行更便捷的管理：

yaml
version: '3.8'
services:
  caddy:
    image: docker.xuanyuan.run/bibicadotnet/caddy-alpine-latest
    ports:
      - "80:80"    # HTTP端口
      - "443:443"  # HTTPS端口
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile  # 自定义配置文件
      - caddy_data:/data                  # 持久化证书和数据
      - caddy_config:/config              # 持久化配置
    restart: unless-stopped               # 自动重启策略

volumes:
  caddy_data:    # 存储Let's Encrypt证书等数据
  caddy_config:  # 存储Caddy运行时配置

启动服务：

bash
docker-compose up -d

配置说明

• 配置文件：默认配置文件路径为/etc/caddy/Caddyfile，可通过挂载本地文件自定义
• 数据持久化：建议挂载/data和/config目录，以持久化存储Let's Encrypt证书、日志和运行时配置，避免容器重启后数据丢失
• 端口映射：根据需求映射端口，通常需要映射80（HTTP）和443（HTTPS）端口，如需其他端口可自行添加
• 日志查看：通过docker logs caddy命令查看Caddy运行日志

注意事项

• 使用自动HTTPS功能时，需确保主机具有公网IP且域名正确解析，Caddy需要通过80/443端口与Let's Encrypt服务器通信
• 首次启动时，Caddy会生成默认配置，监听80和443端口并提供欢迎页面
• 更新镜像时，建议先备份/data和/config目录，避免配置和证书丢失
• 如需自定义Caddy模块，可基于此镜像构建新镜像或通过Caddyfile配置动态加载模块

更多详细信息和配置示例，请参考项目GitHub仓库：https://github.com/bibicadotnet/docker-caddy-alpine-latest