daevien/caddymod Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

caddymod 镜像文档

镜像概述

caddymod是一个基于Caddy服务器的定制化Docker镜像，在Caddy原生功能基础上集成了额外扩展模块（mods），提供增强的Web服务能力。Caddy本身是一款功能强大的HTTP/HTTPS服务器，以自动HTTPS配置、简洁的配置语法和跨平台支持为核心特点，caddymod进一步扩展了其适用场景。

核心功能与特性

基础功能继承

• 完整继承Caddy原生核心能力，包括：
  • 自动HTTPS（Let's Encrypt证书自动申请与续期）
  • HTTP/1.1、HTTP/2及HTTP/3协议支持
  • 反向代理、负载均衡与API网关功能
  • 内置文件服务器与请求过滤能力

扩展模块增强

• 集成额外扩展模块（mods），具体功能取决于镜像维护者提供的定制内容，通常包括但不限于：
  • 增强型反向代理功能（如自定义请求头、路径重写规则）
  • WebSocket协议优化支持
  • 简化的配置模板或常用场景预设

使用场景与适用范围

• Web服务器部署：快速搭建支持HTTPS的静态网站或动态应用服务
• 反向代理与API网关：作为前端流量入口，路由请求至后端服务集群
• 开发与测试环境：提供与生产环境一致的Web服务能力，简化本地开发流程
• 轻量级生产环境：适用于中小型应用或边缘计算场景，资源占用低且配置简单

使用方法与配置说明

基本部署（Docker Run）

通过以下命令启动基础容器，默认使用内置配置：

bash
docker run -d \
  --name caddymod \
  -p 80:80 \
  -p 443:443 \
  caddymod

自定义配置（挂载Caddyfile）

Caddy使用Caddyfile作为配置文件，通过挂载本地配置文件自定义服务行为：

1. 创建本地Caddyfile（示例配置）：

   example.com {
     root * /usr/share/caddy
     file_server
     reverse_proxy /api/* http://backend-service:8080
   }
   

2. 启动容器并挂载配置文件：

   bash
   docker run -d \
     --name caddymod \
     -p 80:80 \
     -p 443:443 \
     -v ./Caddyfile:/etc/caddy/Caddyfile \
     -v caddy_data:/data \  # 持久化存储证书与运行时数据
     caddymod
   

配置参数说明

核心配置文件

• Caddyfile：主配置文件，语法参考Caddy官方文档，具体扩展模块配置需参考镜像维护者提供的模块说明。

常用挂载卷

• /etc/caddy/Caddyfile：配置文件挂载点，必选
• /data：证书与运行时数据存储，建议持久化挂载
• /usr/share/caddy：静态文件根目录（若使用文件服务器功能）

环境变量

• CADDY_HTTP_PORT：自定义HTTP监听端口（默认80）
• CADDY_HTTPS_PORT：自定义HTTPS监听端口（默认443）
• CADDY_CONFIG_ADMIN：配置管理API地址（默认localhost:2019）

注意事项

• 扩展模块（mods）的具体功能需参考镜像维护者提供的详细文档，不同版本可能存在功能差异
• 生产环境部署时，建议通过持久化卷挂载/data目录，避免证书丢失导致HTTPS服务中断
• 容器需具备网络访问权限（特别是80/443端口）以完成Let's Encrypt证书验证流程

参考链接

• Caddy官方文档
• 镜像具体扩展模块说明（请查阅镜像维护者提供的补充文档）