serfriz/caddy-netcup

Caddy Docker镜像（含Netcup DNS模块）

![GitHub]([] ![Quay]([]

镜像概述

本镜像基于官方https://hub.docker.com/_/caddy%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%9B%86%E6%88%90%E4%BA%86Netcup DNS模块，用于支持DNS-01 ACME验证。当https://github.com/caddyserver/caddy%E5%8F%91%E5%B8%83%E6%96%B0%E7%89%88%E6%9C%AC%E6%97%B6%EF%BC%8CGitHub Actions会自动更新本镜像，确保功能与官方版本同步。

核心功能与特性

• Netcup DNS支持：集成https://github.com/caddy-dns/netcup%E6%A8%A1%E5%9D%97%EF%BC%8C%E6%8F%90%E4%BE%9BNetcup DNS-01 ACME验证能力，支持通过Netcup DNS完成域名所有权验证以获取SSL/TLS证书。
• 官方兼容性：完全兼容官方Caddy镜像的使用方式，包括卷挂载、端口映射、配置文件结构等。
• 自动更新：通过GitHub Actions自动跟踪Caddy官方版本更新，确保镜像功能及时同步。
• 多平台支持：提供Caddy官方支持的所有平台构建版本。

使用场景

适用于需要通过Netcup DNS服务进行域名验证的HTTPS证书管理场景，例如：

• 个人服务器或VPS的HTTPS配置
• 无法直接暴露80/443端口的网络环境（如NAT后的服务）
• 需要自动化管理多域名SSL证书的场景

使用方法

基础使用

本镜像的使用方式与官方Caddy镜像一致，支持相同的卷、绑定挂载、端口映射等配置。由于集成了Netcup DNS模块，可能需要额外配置环境变量（具体参见https://github.com/serfriz/caddy-custom-builds?tab=readme-ov-file#container-creation%EF%BC%89%E3%80%82

镜像拉取

可从以下容器仓库拉取镜像：

• Docker Hub
  docker pull serfriz/caddy-netcup:latest

• GitHub Packages
  docker pull ghcr.io/serfriz/caddy-netcup:latest

• Quay
  docker pull quay.io/serfriz/caddy-netcup:latest

标签说明

serfriz/caddy-netcup镜像提供以下标签：

• latest：最新稳定版本
• <version>：特定版本（如2.7.4，也支持2.7、2等版本号格式）

部署示例

Docker Run示例

bash
docker run -d \
  --name caddy \
  -p 80:80 \
  -p 443:443 \
  -v ./Caddyfile:/etc/caddy/Caddyfile \
  -v caddy_data:/data \
  -v caddy_config:/config \
  -e NETCUP_CUSTOMER_ID=your_customer_id \
  -e NETCUP_API_KEY=your_api_key \
  -e NETCUP_API_PASSWORD=your_api_password \
  serfriz/caddy-netcup:latest

Docker Compose示例

yaml
version: '3.8'

services:
  caddy:
    image: serfriz/caddy-netcup:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
      - caddy_data:/data
      - caddy_config:/config
    environment:
      - NETCUP_CUSTOMER_ID=your_customer_id
      - NETCUP_API_KEY=your_api_key
      - NETCUP_API_PASSWORD=your_api_password
    restart: unless-stopped

volumes:
  caddy_data:
  caddy_config:

贡献

欢迎通过https://github.com/serfriz/caddy-custom-builds/issues%E6%88%96https://github.com/serfriz/caddy-custom-builds/pulls%E6%8F%90%E5%87%BA%E5%BB%BA%E8%AE%AE%E3%80%81%E5%8F%8D%E9%A6%88%E9%97%AE%E9%A2%98%E6%88%96%E8%B4%A1%E7%8C%AE%E4%BB%A3%E7%A0%81%EF%BC%8C%E4%B9%9F%E5%8F%AF%E8%AF%B7%E6%B1%82%E9%9B%86%E6%88%90%E5%85%B6%E4%BB%96Caddy%E6%A8%A1%E5%9D%97%E7%9A%84%E5%AE%9A%E5%88%B6%E9%95%9C%E5%83%8F%E3%80%82

许可证

本软件采用https://github.com/serfriz/caddy-custom-builds/blob/main/LICENSE%E8%AE%B8%E5%8F%AF%E8%AF%81%EF%BC%8C%E7%A1%AE%E4%BF%9D%E7%94%A8%E6%88%B7%E6%8B%A5%E6%9C%89%E4%BD%BF%E7%94%A8%E3%80%81%E4%BF%AE%E6%94%B9%E5%92%8C%E5%88%86%E5%8F%91%E8%BD%AF%E4%BB%B6%E7%9A%84%E8%87%AA%E7%94%B1%EF%BC%8C%E5%90%8C%E6%97%B6%E8%A6%81%E6%B1%82%E6%BA%90%E4%BB%A3%E7%A0%81%E4%BF%9D%E6%8C%81%E5%BC%80%E6%94%BE%E3%80%82%E7%94%A8%E6%88%B7%E9%9C%80%E9%81%B5%E5%AE%88GPL-3.0%E8%AE%B8%E5%8F%AF%E6%9D%A1%E6%AC%BE%EF%BC%8C%E5%B9%B6%E5%90%91%E4%BB%96%E4%BA%BA%E6%8F%90%E4%BE%9B%E7%9B%B8%E5%90%8C%E7%9A%84%E8%87%AA%E7%94%B1%E3%80%82