wemakeservices/caddy-docker

Caddy Docker镜像

镜像概述

本镜像提供了https://caddyserver.com Web服务器的Docker化部署方案。Caddy是一款现代、轻量的Web服务器，以自动HTTPS（通过Let's Encrypt）、简单配置和强大功能著称，适用于各类Web服务场景。

核心功能

• 自动HTTPS：自动获取并续期Let's Encrypt证书，无需手动配置。
• 反向代理：支持将请求转发至后端服务（如API、应用服务器）。
• 静态文件服务：直接托管静态资源（HTML、CSS、JS等）。
• 灵活配置：通过Caddyfile定制服务规则，支持多种指令。

使用场景

• 个人或小型网站的快速部署。
• API服务的反向代理与负载均衡。
• 静态资源托管（如博客、文档站点）。
• 本地开发环境的Web服务模拟。

配置说明

基本运行

bash
docker run -p 2015:2015 docker.xuanyuan.run/wemakeservices/caddy-docker

Docker Compose示例

适用于多服务架构的部署：

yaml
version: '3'
services:
  caddy:
    image: "docker.xuanyuan.run/wemakeservices/caddy-docker:latest"
    volumes:
      - ./some/path:/root/.caddy  # 持久化存储证书
      - ./some/Caddyfile:/etc/Caddyfile  # 挂载自定义配置文件
    ports:
      - "2015:2015"
      - "80:80"  # HTTP端口
      - "443:443"  # HTTPS端口
    depends_on:
      - web

  web:
    build: .
    command: python manage.py runserver 0.0.0.0:5000
    ports:
      - "5000:5000"

修改默认Caddyfile

通过挂载自定义配置文件覆盖默认设置：

bash
docker run -p 2015:2015 -v `pwd`/test/Caddyfile:/etc/Caddyfile docker.xuanyuan.run/wemakeservices/caddy-docker

备份证书

避免Let's Encrypt速率限制，持久化证书：

bash
docker run -p 2015:2015 -v `pwd`/backup:/root/.caddy docker.xuanyuan.run/wemakeservices/caddy-docker

更改Caddy版本

通过构建参数指定版本：

bash
docker build --build-arg VERSION=0.10.0 -t caddy:0.10.0 .

开发构建

从源码构建镜像：

bash
docker build -t caddy:latest .

本地运行：

bash
docker run -p 2015:2015 docker.xuanyuan.run/caddy:latest

许可证

本镜像基于Caddy的Apache 2.0许可证（非EULA），项目本身采用MIT许可证，可自由使用。