gentlehoneylover/caddy-godaddy-cloudflare Docker 镜像 - 轩辕镜像

caddy-godaddy-cloudflare-docker

一个添加了GoDaddy和Cloudflare DNS模块的Caddy Docker镜像。基于官方Caddy镜像构建并遵循其文档——详情参见Docker Hub上的Caddy镜像。容器的使用和配置与官方Caddy镜像完全一致。可查看此处的Dockerfile。

!Caddy

镜像概述

核心功能

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

关于Caddy

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

使用场景

• 需要为使用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的信息，请参见Caddy官方文档。

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: