ictu/caddy

ictu/caddy 镜像说明

镜像概述

ictu/caddy 是基于 Caddy 服务器的定制化镜像，允许通过环境变量快速配置核心服务参数，无需手动编辑 Caddyfile，大幅降低Web服务部署的复杂度。该镜像继承了Caddy原生的HTTPS自动配置、静态文件服务等功能，同时增强了配置的便捷性。

核心功能

1. 环境变量驱动配置：通过设置环境变量即可调整监听端口、文档根目录、反向代理目标等关键参数。
2. 原生安全特性：自动获取并更新Let’s Encrypt证书，支持HTTPS加密传输。
3. 轻量高效：镜像体积小巧，运行资源占用低，适合各类场景快速部署。

使用场景

1. 静态网站托管：快速部署HTML、CSS、JS等静态资源。
2. 反向代理服务：作为前端代理转发请求至后端API或应用服务。
3. 开发测试环境：在本地或测试环境中快速搭建Web服务，便于参数调整与验证。

配置说明

常见环境变量示例：

• CADDY_HTTP_PORT：Web服务监听端口（默认值：80）。
• CADDY_ROOT：静态文件根目录（默认值：/var/www/html）。
• CADDY_REVERSE_PROXY：反向代理目标地址（如http://backend:8080，设置后启用反向代理模式）。

部署示例

Docker Run 命令

bash
docker run -d -p 80:80 \
  -e CADDY_ROOT=/app/static \
  -v /本地静态文件路径:/app/static \
  ictu/caddy

Docker Compose 示例

yaml
version: '3.8'
services:
  caddy:
    image: ictu/caddy
    ports:
      - "80:80"
    environment:
      - CADDY_REVERSE_PROXY=[***]
    depends_on:
      - api
  api:
    image: your-api-image
    ports:
      - "3000:3000"