salbr/caddy-desec

带有deSEC DNS插件的Caddy

镜像概述和主要用途

这是预安装了https://github.com/caddy-dns/desec的Caddy自动构建镜像。当官方Caddy镜像发布新版本时，本镜像会自动更新，适用于需要通过DNS-01挑战验证来获取SSL证书的场景。

支持的标签

• latest：始终指向最新构建版本
• <version>：与Caddy版本对应（例如 2.9.1）

快速启动

使用以下命令快速启动容器：

bash
docker run -d \
  --name caddy \
  -p 80:80 \
  -p 443:443 \
  -v $PWD/Caddyfile:/etc/caddy/Caddyfile \
  -v caddy_data:/data \
  -v caddy_config:/config \
  docker.xuanyuan.run/salbr/caddy-desec

使用Docker Compose

创建docker-compose.yml文件，内容如下：

yaml
services:
  caddy-desec:
    image: docker.xuanyuan.run/salbr/caddy-desec:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data
      - caddy_config:/config

volumes:
  caddy_data:
  caddy_config:

DNS挑战配置

要使用此模块进行ACME DNS挑战，请在Caddy JSON中配置ACME颁发者，如下所示：

{
	"module": "acme",
	"challenges": {
		"dns": {
			"provider": {
				"name": "desec",
				"token": "YOUR_TOKEN" // 替换为你的deSEC令牌
			}
		}
	}
}

或在Caddyfile中配置：

# 全局配置
{
	acme_dns desec {
		token "YOUR_TOKEN" // 替换为你的deSEC令牌
	}
}

# 单个站点
tls {
	dns desec {
		token "YOUR_TOKEN" // 替换为你的deSEC令牌
	}
}

核心功能和特性

• 官方Caddy镜像更新时自动同步更新
• 内置deSEC DNS插件，支持ACME DNS-01挑战验证
• 继承官方Caddy镜像的所有安全特性

资源

• https://github.com/salbr/caddy-desec
• https://caddyserver.com/docs/
• https://github.com/caddy-dns/desec
• https://desec.readthedocs.io/