alexandzors/caddy

第三方说明

这是基于caddyserver.com的第三方构建。请勿在生产环境中使用。此镜像仅为需要快速使用带有以下预安装插件的Docker镜像/二进制文件的用户提供。您始终可以通过下载页面生成自己的二进制文件。

Docker镜像和二进制文件均从Caddy源代码构建，仅包含以下提及的插件！

Caddy

https://github.com/alexandzors/caddy/actions/workflows/caddy.yml/badge.svg?branch=main](https://github.com/alexandzors/caddy/actions/workflows/caddy.yml)

Caddy是一款功能强大、企业级的开源Web服务器，用Go语言编写，支持自动HTTPS。

文档：[]
网站：[]
社区：[***]
GitHub：https://github.com/caddyserver/caddy
基础镜像：https://hub.docker.com/_/caddy
构建仓库：https://github.com/alexandzors/caddy
二进制发布：https://github.com/alexandzors/caddy/releases

标签

注意：标签已更改。请查阅以下列表获取可用标签：

• :latest - 最新的Caddy稳定版本（支持多架构）
• :#.#.# - 特定版本的Caddy稳定版（v2.7.6+，支持多架构）
• :latest-l4 - 最新的Caddy稳定版本（包含所有模块+layer 4）
• :#.#.#-l4 - 特定版本的Caddy稳定版（包含所有模块+layer 4）
• :dev - 用于测试，请勿使用

目前不计划提供Windows容器版本。

核心功能和特性

基础功能

• 企业级开源Web服务器，支持自动HTTPS
• 基于Go语言开发，性能高效
• 兼容官方Caddy的所有核心功能

额外模块

在默认模块基础上，预安装以下额外模块：

注意：sjtug/caddy2-filter已替换为caddyserver/replace-response
注意：RussellLuo/caddy-ext/ratelimit已替换为mholt/caddy-ratelimit

• dns.providers.cloudflare
• https://github.com/WeidiDeng/caddy-cloudflare-ip
• https://github.com/caddyserver/ntlm-transport
• https://github.com/caddyserver/replace-response
• https://github.com/greenpau/caddy-security
• https://github.com/caddyserver/transform-encoder
• https://github.com/caddyserver/nginx-adapter
• https://github.com/mholt/caddy-ratelimit
• https://github.com/mholt/caddy-l4%EF%BC%88%E4%BB%85%E5%9C%A8-l4%E6%A0%87%E7%AD%BE%E4%B8%AD%E5%8F%AF%E7%94%A8%EF%BC%89

使用场景和适用范围

适用于需要快速部署带有预安装模块的Caddy服务器的场景，如：

• 需要通过Cloudflare DNS进行HTTPS证书验证
• 需要配置信任Cloudflare代理IP
• 需要处理NTLM传输协议
• 需要实现请求速率限制、响应替换等高级功能

详细使用方法和配置说明

Docker Compose部署示例

1. 创建网络

首先创建外部网络：

bash
docker network create caddy-dockerinternal-net

2. docker-compose.yml配置

yaml
# 适用于<alexandzors/caddy>
# 创建者：github.com/alexandzors 08-18-2023
version: '3'
services:
  caddy:
    restart: always
    logging:
      driver: "json-file"
      options:
        max-size: "500k"
        max-file: "1"
    networks:
      - caddy
    image: alexandzors/caddy
    env_file: .env
    ports:
      - 80:80
      - 443:443
    volumes:
      - ${PWD}/Caddyfile:/etc/caddy/Caddyfile:ro  # Caddy配置文件
      - ${PWD}/config:/etc/caddy/config          # 可选：外部配置文件
      - ${PWD}/.data:/data                       # 证书存储目录
      - ${PWD}/logs:/logs                        # 可选：日志文件目录

networks:
  caddy:
    name: caddy-dockerinternal-net
    external: true

3. .env文件配置

shell
CLOUDFLARETOKEN=YOUR_CLOUDFLARE_TOKEN_HERE  # 替换为您的Cloudflare API令牌

更多详细配置可参考https://hub.docker.com/_/caddy%E3%80%82

模块使用指南

Cloudflare DNS模块

用于通过Cloudflare DNS进行ACME挑战，实现HTTPS证书自动签发。

注意：需为Caddy创建范围API令牌，请勿使用全局API密钥。详见https://github.com/libdns/cloudflare%E3%80%82

JSON API配置

json
{
	"module": "acme",
	"challenges": {
		"dns": {
			"provider": {
				"name": "cloudflare",
				"api_token": "{env.CLOUDFLARETOKEN}"
			}
		}
	}
}

Caddyfile配置

创建可复用代码块：

(tls) {
    tls {
        dns cloudflare {env.CLOUDFLARETOKEN}
    }
}

调用代码块：

domain.tld {
  import tls  # 导入TLS配置块
  reverse_proxy 127.0.0.1:81  # 示例反向代理配置
}

weidideng/caddy-cloudflare-ip模块

拉取Cloudflare端点IP，用于全局配置中的trusted_proxies。

JSON API配置

json
{
  "apps": {
    "http": {
      "servers": {
        "srv0": {
          "listen": [
            ":443"
          ],
          "trusted_proxies": {
            "interval": 43200000000000,  # 12小时（单位：纳秒）
            "source": "cloudflare",
            "timeout": 15000000000       # 15秒（单位：纳秒）
          }
        }
      }
    }
  }
}

Caddyfile配置

# 全局配置
{
  servers {
    trusted_proxies cloudflare {
      interval 12h  # IP更新间隔
      timeout 15s   # 超时时间
    }
  }
}

mysite.com {
  respond * "Hello there"  # 示例响应
}

NTLM-Transport模块

http_ntlm协议与http类似，但始终使用HTTP 1.1且禁用Keep-Alive，适用于需要NTLM认证的后端服务。

JSON API配置

json
{
  "match": [
    {
      "host": ["wac.domain.tld"]  # 替换为您的域名
    }
  ],
  "handle": [
    {
      "handler": "subroute",
      "routes": [
        {
          "handle": [
            {
              "encodings": {
                "gzip": {}  # Gzip压缩
              },
              "handler": "encode"
            },
            {
              "handler": "reverse_proxy",
              "transport": {
                "protocol": "http_ntlm",  # 使用NTLM传输协议
                "tls": {
                  "insecure_skip_verify": true  # 跳过TLS验证（仅测试用）
                }
              },
              "upstreams": {
                {
                  "dial": "192.168.1.5:443"  # 后端服务地址
                }
              }
            }
          ]
        }
      ]
    }
  ]
}

Caddyfile配置

wac.domain.tld {
  import tls  # 导入之前定义的TLS配置块
  encode gzip  # 启用Gzip压缩
  reverse_proxy {
    transport http_ntlm {  # 使用NTLM传输协议
      tls_insecure_skip_verify  # 跳过TLS验证（仅测试用）
    }
    to 192.168.1.5:443  # 后端服务地址
  }
}

其他模块使用参考

• replace-response: https://github.com/caddyserver/replace-response
• caddy-security: https://authp.github.io/docs/intro
• transform-encoder: https://github.com/caddyserver/transform-encoder
• nginx-adapter: https://github.com/caddyserver/nginx-adapter#use
• ratelimit: https://github.com/mholt/caddy-ratelimit