运行于Alpine Linux的Caddy容器镜像

![Docker Automated build]([] ![Docker Pulls]([] ![Docker Stars]([***]

![Alpine Version]([] ![Caddy Version]([]

此容器镜像 (yobasystems/alpine-caddy) 基于轻量级 Alpine Linux，使用支持HTTPS的 Caddy HTTP/2 web服务器构建。

Alpine版本 3.22.1（发布于2025-07-15）

Caddy版本 2.10.2

目录

• 什么是Alpine Linux？
• 特性
• 支持架构
• 标签
• 镜像层与大小
• 如何使用此镜像
• 镜像内容与漏洞分析
• 源码仓库
• 容器仓库
• 链接

• ---

🏔️ 什么是Alpine Linux？

Alpine Linux是一个围绕musl libc和BusyBox构建的Linux发行版。该镜像仅5MB大小，且可访问的软件包仓库比其他基于BusyBox的镜像更为完整。这使得Alpine Linux成为实用工具甚至生产应用的理想镜像基础。

什么是Caddy？

Caddy（有时称为Caddy web服务器）是一个开源、支持HTTP/2的web服务器，使用Go语言编写，其HTTP功能基于Go标准库实现。Caddy最显著的特性之一是默认启用HTTPS。

✨ 特性

• 仅包含最小体积，最少镜像层
• 简单安装下内存占用极低
• 使用yobasystems/alpine-nginx:git标签可从仓库自动克隆git代码

🏗️ 架构

• :amd64, :x86_64 - 64位Intel/AMD（x86_64/amd64）
• :arm64v8, :aarch64 - 64位ARM（ARMv8/aarch64）
• :arm32v7, :armhf - 32位ARM（ARMv7/armhf）

📝 请查看下方标签了解支持的架构，以上为架构说明列表

🏷️ 标签

• :latest 基于最新分支（自动架构选择）
• :php 包含PHP的最新分支
• :amd64, :x86_64 基于latest标签的amd64架构版本
• :php-amd64, :php-x86_64 基于latest标签的amd64架构且包含PHP的版本
• :aarch64, :arm64v8 基于latest标签的arm64架构版本
• :php-aarch64, :php-arm64v8 基于latest标签的arm64架构且包含PHP的版本
• :armhf, :arm32v7 基于latest标签的arm架构版本
• :php-armhf, :php-arm32v7 基于latest标签的arm架构且包含PHP的版本

📏 镜像层与大小

!Version !Docker Image Size (tag)

!Version !Docker Image Size (tag)

!Version !Docker Image Size (tag)

🚀 如何使用此镜像

环境变量：

主要Caddy参数：

• URL：指定URL，格式为[***]

创建实例

sh
$ docker run -d --name examplecaddy -p 2015:2015 yobasystems/alpine-caddy

在浏览器中访问 [***]。

PHP支持

:[<version>-]php 变体镜像包含PHP-FPM，例如 :php、:0.11.0-php

sh
$ docker run -d --name examplecaddy -p 2015:2015 yobasystems/alpine-caddy:php

在浏览器中访问 [***]，将看到PHP信息页面。

本地PHP源码

将/path/to/php/src替换为您的PHP源码目录。

sh
$ docker run -d --name examplecaddy -v /path/to/php/src:/srv -p 2015:2015 yobasystems/alpine-caddy:php

在浏览器中访问 [***]。

注意

您的Caddyfile必须包含startup php-fpm行。由于Caddy在容器中作为PID 1运行，php-fpm无法自动启动。

使用Git源码

Caddy可通过git中间件从Git仓库提供网站服务。

创建Caddyfile

将github.com/team/repo替换为您的仓库。

sh
$ printf "0.0.0.0\ngit github.com/team/repo" > Caddyfile

运行镜像

sh
$ docker run -d --name examplecaddy -v $(pwd)/Caddyfile:/etc/Caddyfile -p 2015:2015 yobasystems/alpine-caddy

在浏览器中访问 [***]。

Let's Encrypt自动SSL

注意：本地环境不支持此功能，域名必须解析到请求证书的服务器。

使用有效域名并在Caddyfile中添加***，避免运行时提示。将example.co.uk替换为您的域名，***替换为您的***。

example.co.uk
tls ***

运行镜像

如果主机的80和443端口不可用，可更改端口映射，例如81:80、444:443。

sh
$ docker run -d --name examplecaddy -v $(pwd)/Caddyfile:/etc/Caddyfile -p 80:80 -p 443:443 yobasystems/alpine-caddy

建议：将证书保存在主机上，防止容器每次启动时重新生成。Let's Encrypt的速率限制限制了证书的重新生成次数。

sh
$ docker run -d -v $(pwd)/Caddyfile:/etc/Caddyfile -v $HOME/.caddy:/root/.caddy -p 80:80 -p 443:443 yobasystems/alpine-caddy

🔍 镜像内容与漏洞分析

📚 源码仓库

• Github - yobasystems/alpine-caddy
• Gitlab - yobasystems/alpine-caddy

🐳 容器仓库

• Dockerhub - yobasystems/alpine-caddy
• Quay.io - yobasystems/alpine-caddy
• GHCR - yobasystems/alpine-caddy

🔗 链接

• Yoba Systems
• Github - Yoba Systems
• Dockerhub - Yoba Systems
• Quay.io - Yoba Systems
• GHCR - Yoba Systems
• 维护者 - Dominic Taylor