openpitrix/caddy

caddy-docker

镜像概述

caddy-docker是Caddy服务器的Docker容器化实现，旨在提供便捷的Caddy部署方式。Caddy是一款功能强大的开源Web服务器，以自动HTTPS、简洁配置和丰富插件生态著称。本镜像预先集成了git、gopkg和hugo插件，进一步扩展了其功能。

核心功能和特性

• 基础Web服务：提供标准的HTTP/HTTPS服务，支持自动HTTPS配置
• 插件集成：包含以下实用插件：
  • git：支持从Git仓库自动拉取网站内容
  • gopkg：用于Go包的服务和代理
  • hugo：集成Hugo静态网站生成器，可自动构建Hugo项目
• 容器化优势：简化部署流程，隔离运行环境，便于版本管理和迁移

使用场景和适用范围

• 静态网站托管（尤其是使用Hugo构建的网站）
• 需要从Git仓库自动同步内容的Web服务
• Go项目的包代理服务
• 快速搭建支持HTTPS的Web服务原型
• 开发和测试环境中的Web服务器部署

使用方法和配置说明

基本运行

通过以下命令启动Caddy容器，默认使用Caddyfile配置：

bash
docker run -d -p 80:80 -p 443:443 --name caddy docker.xuanyuan.run/caddy-docker

挂载自定义配置

若需使用自定义Caddyfile，可通过挂载本地配置文件实现：

bash
docker run -d -p 80:80 -p 443:443 -v /path/to/Caddyfile:/etc/caddy/Caddyfile --name caddy docker.xuanyuan.run/caddy-docker

数据持久化

为确保网站内容和Caddy数据持久化，可挂载数据卷：

bash
docker run -d -p 80:80 -p 443:443 \
  -v /path/to/Caddyfile:/etc/caddy/Caddyfile \
  -v caddy_data:/data \
  -v caddy_config:/config \
  --name caddy docker.xuanyuan.run/caddy-docker

集成Hugo示例

在Caddyfile中配置Hugo插件，实现从Git仓库拉取并构建Hugo项目：

caddyfile
example.com {
  root * /srv/example.com
  hugo {
    repo https://github.com/username/hugo-site.git
    branch main
    output public
  }
  file_server
}

启动容器时挂载配置文件即可应用上述配置。

环境变量

目前本镜像未定义额外环境变量，主要通过Caddyfile进行配置。如需自定义，可在Dockerfile或运行时通过-e参数添加环境变量，并在Caddyfile中引用。