zzrot/alpine-caddy

Alpine Linux上的Caddy服务器

这是一个基于http://www.alpinelinux.org/的https://caddyserver.com/ Docker镜像，具有体积极小、安全可靠、运行高效的特点，可在https://hub.docker.com/r/zzrot/alpine-caddy/获取。

核心功能

• 静态文件服务：默认使用容器内/var/www/html目录存储静态资源
• 反向代理：支持将请求转发至后端服务
• 全功能中间件：包含Caddy所有官方中间件及特性
• SSL证书管理：支持通过Let's Encrypt自动生成并持久化存储证书

使用场景

• 静态网站部署（如个人博客、企业官网）
• 反向代理服务（统一暴露多服务端口）
• 轻量级Web服务需求场景

配置说明

基础部署

可通过docker run快速启动：

bash
docker run -d -p 80:80 -v $(pwd)/public:/var/www/html docker.xuanyuan.run/zzrot/alpine-caddy

启动后通过Docker主机IP访问服务。

卷挂载配置

1. 静态文件卷：挂载本地静态资源目录至容器/var/www/html

   bash
   -v $(pwd)/public:/var/www/html
   

2. 自定义Caddyfile：替换默认配置文件

   bash
   -v $(pwd)/Caddyfile:/etc/Caddyfile
   

3. 证书持久化：保存Let's Encrypt证书（避免容器重启丢失）

   bash
   -v $(pwd)/.caddy:/root/.caddy
   

Docker Compose示例

yaml
version: '3'
services:
  caddy:
    image: docker.xuanyuan.run/zzrot/alpine-caddy
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./public:/var/www/html
      - ./Caddyfile:/etc/Caddyfile
      - ./.caddy:/root/.caddy

贡献指南

团队成员

• https://github.com/Skilgarriff *** T: @seankilgarriff
• https://github.com/killianbrackey *** T: @kmbrackey

新增功能步骤

1. Fork仓库
2. 创建特性分支：git checkout -b my-new-feature
3. 提交变更：git commit -am 'Add some feature'
4. 推送分支：git push origin my-new-feature
5. 提交Pull Request

安全问题报告

若发现安全漏洞，请发送邮件至***，我们将在公开前评估并修复。

许可证

本项目基于https://github.com/ZZROTDesign/alpine-caddy/tree/master/LICENSE开源。