xTag

Overview

Full name
docker.io/viacooky/caddy
Registry
docker.io
Namespace
viacooky
Repository
caddy
Cached tags
2
Last synced
07/06/2026, 01:15 PM
Topics
Web 服务器与反向代理

Introduction

集成常用插件的 Caddy 2 反向代理镜像，自动 HTTPS 与简洁 Caddyfile 配置，适合 Web 入口、静态站点与 upstream 反代。

Details

viacooky/caddy 在官方 caddy 基础上预装 cloudflare dns、rate_limit 等社区插件，通过 Caddyfile 或 JSON 配置路由与 TLS。典型替代 nginx 用于中小站点与 homelab 统一入口，自动 ACME 证书续期。与 caddy:2 官方镜像相比插件开箱即用；生产固定 tag、配置经 volume 挂载并限制 admin API 仅内网。

快速启动

docker run -d --name caddy \
  -p 80:80 -p 443:443 \
  -v $(pwd)/Caddyfile:/etc/caddy/Caddyfile \
  docker.io/viacooky/caddy:latest

推荐实践

docker run -d --name caddy \
  --restart unless-stopped \
  -p 80:80 -p 443:443 \
  -v /data/caddy/Caddyfile:/etc/caddy/Caddyfile \
  -v /data/caddy/data:/data \
  -e ACME_AGREE=true \
  docker.io/viacooky/caddy:2.8.0

核心参数说明

  • -p 80:80 -p 443:443 — HTTP/HTTPS 入口
  • -v .../Caddyfile:... — 站点与反代规则
  • -v .../data:... — ACME 证书与 OCSP 缓存
  • -e ACME_AGREE — 同意 Let's Encrypt 条款
  • --restart unless-stopped — 入口网关持续在线
  • 固定 tag — Caddy 大版本与插件 pin

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: caddy
spec:
  replicas: 2
  selector:
    matchLabels:
      app: caddy
  template:
    metadata:
      labels:
        app: caddy
    spec:
      containers:
        - name: caddy
          image: docker.io/viacooky/caddy:2.8.0
          ports:
            - containerPort: 80
            - containerPort: 443
          volumeMounts:
            - name: caddyfile
              mountPath: /etc/caddy/Caddyfile
              subPath: Caddyfile
            - name: data
              mountPath: /data
      volumes:
        - name: caddyfile
          configMap:
            name: caddy-config
        - name: data
          persistentVolumeClaim:
            claimName: caddy-data
---
apiVersion: v1
kind: Service
metadata:
  name: caddy
spec:
  type: LoadBalancer
  selector:
    app: caddy
  ports:
    - port: 80
      targetPort: 80
    - port: 443
      targetPort: 443

Caddyfile 放 ConfigMap/PVC；集群内 TLS 可改 cert-manager，LoadBalancer 或 Ingress 二选一。

Latest tags (20)

View all 2 tags →
TagArchPushed AtSizeDigestSyncWishAction
docker.io/viacooky/caddy
:2.11
linux/amd64
2026/06/01 18:5439.6 MBsha256:6832aac1ee39…
docker.io/viacooky/caddy
:latest
linux/amd64
2026/06/01 18:5439.6 MBsha256:6832aac1ee39…