fariszr/caddy-dns

Caddy DNS插件集成镜像

镜像概述

本镜像基于Caddy官方版本自动构建，预集成了DNS插件（项目地址：https://github.com/FarisZR/caddy-dns-OCI%EF%BC%89%EF%BC%8C%E6%97%A8%E5%9C%A8%E7%AE%80%E5%8C%96%E9%9C%80%E8%A6%81%E9%80%9A%E8%BF%87DNS%E9%AA%8C%E8%AF%81%E8%8E%B7%E5%8F%96SSL%E8%AF%81%E4%B9%A6%E7%9A%84Caddy%E9%83%A8%E7%BD%B2%E6%B5%81%E7%A8%8B%E3%80%82%E9%95%9C%E5%83%8F%E4%BF%9D%E7%95%99Caddy%E5%8E%9F%E7%94%9F%E5%8A%9F%E8%83%BD%EF%BC%88%E5%A6%82%E5%8F%8D%E5%90%91%E4%BB%A3%E7%90%86%E3%80%81%E9%9D%99%E6%80%81%E6%96%87%E4%BB%B6%E6%9C%8D%E5%8A%A1%E3%80%81%E8%87%AA%E5%8A%A8HTTPS%E7%AD%89%EF%BC%89%EF%BC%8C%E5%90%8C%E6%97%B6%E9%80%9A%E8%BF%87%E5%86%85%E7%BD%AEDNS%E6%8F%92%E4%BB%B6%E6%94%AF%E6%8C%81DNS-01%E6%8C%91%E6%88%98%EF%BC%8C%E8%A7%A3%E5%86%B3%E4%BC%A0%E7%BB%9FHTTP-01%E9%AA%8C%E8%AF%81%E5%9C%A8%E7%AB%AF%E5%8F%A3%E9%99%90%E5%88%B6%E3%80%81%E5%86%85%E7%BD%91%E6%9C%8D%E5%8A%A1%E7%AD%89%E5%9C%BA%E6%99%AF%E4%B8%8B%E7%9A%84%E5%B1%80%E9%99%90%E6%80%A7%E3%80%82

核心功能与特性

基础功能

• 完整继承Caddy官方镜像特性，包括自动HTTPS、HTTP/2/3支持、反向代理、负载均衡、静态文件服务等。
• 基于官方Caddy版本自动构建，确保镜像与Caddy最新稳定版同步。

DNS插件增强

• 预集成DNS插件，支持通过DNS-01挑战完成域名所有权验证，无需开放80/443端口。
• 针对特定DNS服务（如OCI DNS）优化，可直接配置对应DNS服务商的认证信息实现证书自动签发与续期。

使用场景与适用范围

典型场景

1. 内网服务证书管理：内网服务器或无法暴露80/443端口的服务，通过DNS-01挑战获取公网可信SSL证书。
2. 多域名批量管理：需为多个子域名或跨域域名统一配置SSL证书，通过DNS插件简化验证流程。
3. OCI DNS环境适配：使用Oracle Cloud Infrastructure (OCI) DNS服务的用户，可直接通过镜像内置插件对接OCI DNS API。

适用范围

• 需要部署Caddy并启用自动HTTPS的环境。
• 存在HTTP-01验证限制（如防火墙策略、端口占用、内网服务）的场景。
• 使用OCI DNS或兼容插件的DNS服务商的用户。

使用方法与配置说明

1. 拉取镜像

从Docker Hub或项目指定仓库拉取镜像（具体仓库地址请参考原项目文档）：

bash
docker pull fariszr/caddy-dns-oci:latest  # 示例仓库名，以实际项目为准

2. 基本运行示例

单容器运行

通过docker run启动容器，需挂载Caddyfile配置文件并设置DNS插件所需环境变量（如API密钥、区域信息等）：

bash
docker run -d \
  --name caddy-dns \
  -p 80:80 -p 443:443 \
  -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile \
  -v caddy-data:/data \
  -v caddy-config:/config \
  -e "OCI_DNS_API_KEY=your_oci_api_key" \
  -e "OCI_DNS_REGION=us-phoenix-1" \
  fariszr/caddy-dns-oci:latest

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  caddy:
    image: fariszr/caddy-dns-oci:latest
    container_name: caddy-dns
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy-data:/data
      - caddy-config:/config
    environment:
      - OCI_DNS_API_KEY=your_oci_api_key  # 替换为实际OCI API密钥
      - OCI_DNS_REGION=your_oci_region    # 替换为OCI区域（如us-ashburn-1）
      - OCI_DNS_TENANCY_ID=your_tenancy_id # 如插件需要，添加OCI租户ID等参数
    restart: unless-stopped

volumes:
  caddy-data:
  caddy-config:

3. Caddyfile配置示例

在Caddyfile中通过tls指令指定DNS插件进行证书验证，格式如下：

caddyfile
# 示例：为example.com启用DNS-01验证
example.com {
  reverse_proxy http://backend-service:8080  # 配置反向代理（根据实际需求替换）
  
  # 配置DNS插件进行证书验证
  tls {
    dns oci {
      api_key {$OCI_DNS_API_KEY}       # 引用环境变量中的API密钥
      region {$OCI_DNS_REGION}        # 引用环境变量中的区域信息
      # 其他OCI DNS插件所需参数（参考原项目文档）
    }
  }
}

4. 配置参数说明

DNS插件的具体配置参数（如api_key、region等）需根据目标DNS服务商的要求填写，详细参数说明请参考原项目文档（https://github.com/FarisZR/caddy-dns-OCI%EF%BC%89%E3%80%82

注意事项

• 镜像依赖原项目的插件维护，请关注项目更新以获取功能修复和安全补丁。
• 环境变量中的敏感信息（如API密钥）建议通过容器编排工具的保密机制管理（如Docker Swarm Secrets、Kubernetes Secrets），避免明文暴露。
• Caddyfile中dns oci指令的插件名称需与原项目定义一致，若插件名称不同（如oci-dns），需相应调整指令。