webhippie/caddy

Caddy Docker镜像

https://github.com/dockhippie/caddy/actions/workflows/docker.yml/badge.svg](https://github.com/dockhippie/caddy/actions/workflows/docker.yml)

这些是运行在https://github.com/dockhippie/alpine上的Caddy Docker镜像。

镜像概述

Caddy是一款现代化的Web服务器，以自动HTTPS、简单配置和高性能为特点。本镜像基于轻量级Alpine Linux构建，提供了便捷的环境变量配置方式，适用于快速部署Web服务。

核心功能与特性

• 基于Alpine Linux，镜像体积小、资源占用低
• 支持通过环境变量灵活配置Caddy服务
• 内置默认网站根目录，便于存放网站文件
• 暴露8080端口，可直接映射提供Web服务
• 支持健康检查、日志配置等扩展功能

版本信息

可用版本请查看：

• https://hub.docker.com/r/webhippie/caddy/tags
• Quay
• https://github.com/dockhippie/caddy中的现有文件夹

卷

• /srv/www：用于存放网站静态文件的根目录

端口

• 8080：Caddy Web服务默认监听端口

环境变量配置

核心环境变量

console
CADDY_ADAPTER = caddyfile（配置适配器，默认caddyfile）
CADDY_AGREE = false（是否自动同意服务条款）
CADDY_CONFIG = /etc/caddy/caddyfile（配置文件路径）
CADDY_WEBROOT = /srv/www（网站根目录，默认/srv/www）
CADDY_EMAIL =（管理员邮箱，用于HTTPS证书注册）
CADDY_HEALTHCHECK_URL = http://localhost:8080/（健康检查URL）
CADDY_HEALTHCHECK_CODE = 200（健康检查预期状态码）

完整环境变量列表

console
CADDY_ADAPTER = caddyfile
CADDY_AGREE = false
CADDY_CA =（CA机构地址）
CADDY_CA_TIMEOUT =（CA请求超时时间）
CADDY_CONFIG = /etc/caddy/caddyfile
CADDY_CPU =（CPU资源限制）
CADDY_DEFAULT_SNI =（默认SNI值）
CADDY_DISABLE_ALPN_CHALLENGE =（禁用ALPN挑战）
CADDY_DISABLE_HTTP_CHALLENGE =（禁用HTTP挑战）
CADDY_DISABLE_METRICS =（禁用指标收集）
CADDY_DROP_INDEX_FILE = false（是否删除索引文件）
CADDY_EMAIL =
CADDY_ENV =（额外环境变量）
CADDY_ENVFILE =（环境变量文件路径）
CADDY_ENVIRON = false（是否显示环境变量）
CADDY_GRACE =（优雅关闭等待时间）
CADDY_HEALTHCHECK_CODE = 200
CADDY_HEALTHCHECK_URL = http://localhost:8080/
CADDY_HOST =（绑定主机地址）
CADDY_HTTP_PORT =（HTTP服务端口）
CADDY_HTTP2 =（HTTP/2配置）
CADDY_HTTPS_PORT =（HTTPS服务端口）
CADDY_LOG =（日志配置）
CADDY_LOG_ROLL_COMPRESS =（日志滚动压缩）
CADDY_LOG_ROLL_MB =（日志滚动大小，MB）
CADDY_PIDFILE =（PID文件路径）
CADDY_PINGBACK =（回调URL）
CADDY_PORT =（服务端口）
CADDY_QUIC =（QUIC协议配置）
CADDY_QUIET =（安静模式）
CADDY_RESUME = false（恢复上次运行状态）
CADDY_SKIP_CHOWN = false（跳过文件权限修改）
CADDY_SKIP_TEMPLATES = false（跳过模板处理）
CADDY_WATCH = false（监控配置文件变化）
CADDY_WEBROOT = /srv/www

继承的环境变量

该镜像继承了基础镜像的环境变量，详情参见：https://github.com/dockhippie/alpine#available-environment-variables

使用示例

基本运行命令

bash
docker run -d -p 8080:8080 -v ./www:/srv/www webhippie/caddy

自定义配置运行

bash
docker run -d \
  -p 80:8080 \
  -v ./www:/srv/www \
  -e CADDY_EMAIL=admin@example.com \
  -e CADDY_WEBROOT=/srv/www \
  webhippie/caddy

贡献方式

Fork → 提交补丁 → 推送 → 拉取请求

作者

• https://github.com/tboerger

许可协议

MIT

版权信息

console
Copyright (c) 2018 Thomas Boerger <http://www.webhippie.de>