gentlehoneylover/caddy-godaddy-cloudflare

caddy-godaddy-cloudflare-docker

一个添加了GoDaddy和Cloudflare DNS模块的Caddy Docker镜像。基于官方Caddy镜像构建并遵循其文档——详情参见https://hub.docker.com/_/caddy%E3%80%82%E5%AE%B9%E5%99%A8%E7%9A%84%E4%BD%BF%E7%94%A8%E5%92%8C%E9%85%8D%E7%BD%AE%E4%B8%8E%E5%AE%98%E6%96%B9Caddy%E9%95%9C%E5%83%8F%E5%AE%8C%E5%85%A8%E4%B8%80%E8%87%B4%E3%80%82%E5%8F%AF%E6%9F%A5%E7%9C%8Bhttps://github.com/GentleHoneyLover/caddy-godaddy-cloudflare-docker/blob/master/Dockerfile%E7%9A%84Dockerfile%E3%80%82

!https://raw.githubusercontent.com/docker-library/docs/7f3881a28c29ed29bb1a38681b95bd785a8a6da5/caddy/logo.png

镜像概述

核心功能

• 基于官方Caddy 2镜像构建，保留其全部功能
• 集成GoDaddy DNS模块，支持通过GoDaddy DNS进行域名验证
• 集成Cloudflare DNS模块，支持通过Cloudflare DNS进行域名验证
• 支持自动HTTPS，无需手动配置SSL证书
• 与官方Caddy镜像使用方式完全兼容

关于Caddy

[***]

使用场景

• 需要为使用GoDaddy或Cloudflare DNS的域名配置自动HTTPS的Web服务
• 希望简化SSL证书管理，实现证书自动签发与续期的场景
• 需要使用Caddy的反向代理、静态文件服务等功能，同时依赖GoDaddy或Cloudflare DNS进行域名验证的用户

使用方法

基本用法

默认配置文件从/usr/share/caddy目录提供文件服务。若要从当前工作目录提供index.html文件：

sh
$ echo "hello world" > index.html
$ docker run -d -p 80:80 \
    -v $PWD/index.html:/usr/share/caddy/index.html \
    -v caddy_data:/data \
    docker.io/gentlehoneylover/caddy-godaddy-cloudflare:latest
...
$ curl http://localhost/
hello world

覆盖默认Caddyfile

如需自定义配置，可将新的Caddyfile挂载到/etc/caddy/Caddyfile：

sh
$ docker run -d -p 80:80 \
    -v $PWD/Caddyfile:/etc/caddy/Caddyfile \
    -v caddy_data:/data \
    docker.io/gentlehoneylover/caddy-godaddy-cloudflare:latest

自动HTTPS配置

默认Caddyfile仅监听80端口，未配置自动HTTPS。若您拥有域名且其A/AAAA DNS记录已正确指向当前机器的公网IP，可通过以下命令启用HTTPS服务：

sh
$ docker run -d -p 80:80 -p 443:443 -p 443:443/udp \
    -v /site:/srv \
    -v caddy_data:/data \
    -v caddy_config:/config \
    docker.io/gentlehoneylover/caddy-godaddy-cloudflare:latest caddy file-server --domain example.com

注意：Caddy需要监听80和443端口以完成ACME HTTP挑战，确保这些端口在主机上未被占用且已正确开放防火墙。

更多关于自动HTTPS的信息，请参见https://caddyserver.com/docs/automatic-https%E3%80%82

Docker Compose示例

若偏好使用docker-compose管理服务，以下是示例配置：

yaml
version: "3.7"

services:
  caddy:
    image: docker.io/gentlehoneylover/caddy-godaddy-cloudflare:latest
    restart: unless-stopped
    ports:
      - "80:80"       # HTTP端口
      - "443:443"     # HTTPS端口
      - "443:443/udp" # QUIC端口
    volumes:
      - $PWD/Caddyfile:/etc/caddy/Caddyfile  # 自定义Caddy配置
      - $PWD/site:/srv                       # 网站文件目录
      - caddy_data:/data                     # Caddy数据卷（证书等）
      - caddy_config:/config                 # Caddy配置卷

volumes:
  caddy_data:
    external: true  # 使用外部数据卷，避免容器重建丢失证书
  caddy_config: