Docker 部署 Caddy Web 服务器完全指南 🐳

Caddy Web服务器

📋 目录导航

🎯 项目简介

Caddy 是一款现代化的开源 Web 服务器，以其简单的配置、自动 HTTPS 和出色的性能而闻名。通过 Docker 部署 Caddy，您可以轻松搭建一个功能强大的 Web 服务器，支持静态网站、反向代理、负载均衡等多种功能。

Caddy 采用 Go 语言编写，可用于静态资源托管和反向代理，默认启用 HTTPS，并且配置方式非常优雅简单。

相关资源：

🛠️ 核心特性

特性类别 功能描述 优势
🔒 自动 HTTPS 自动申请和更新 SSL 证书 为每个托管站点自动启用 HTTPS，无需额外操作
⚡ 高性能 基于 Go 语言开发 提供更高的内存安全性和可靠性
📝 简单配置 使用直观的 Caddyfile 格式 提供简单、易于理解的配置文件格式
🌐 现代协议支持 原生支持 HTTP/1.1、HTTP/2 和 HTTP/3 提供更快的网络传输速度
🔄 反向代理 轻松配置反向代理和负载均衡 灵活的路由和负载分配能力
🛠️ 模块化设计 支持多种扩展和插件 高扩展性能够支持数十万站点
🐳 容器友好 完美支持 Docker 部署 无外部依赖，在任何平台上都能稳定运行

🐳 一、Docker 部署 Caddy

1. 创建部署目录和 docker-compose.yml 文件 📁

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
mkdir -p /mnt/mydisk/home/caddy/{html,ssl,caddy} && cd /mnt/mydisk/home/caddy && \
cat > docker-compose.yml <<'EOF'
services:
  caddy:
    image: caddy:latest
    restart: unless-stopped
    container_name: caddy
    ports:
      - 80:80    # HTTP 端口
      - 443:443  # HTTPS 端口
      - 6663:443 # 自定义 HTTPS 端口
    volumes:
      - ./html:/usr/share/caddy
      - ./caddy:/data
      - ./Caddyfile:/etc/caddy/Caddyfile
      - ./ssl:/etc/live  # SSL 证书目录
    environment:
      - TZ=Asia/Shanghai
EOF

2. 拉取镜像并启动容器 🚀

1
docker-compose up -d

🚀 二、使用 Caddy

1. 访问 Web 界面 💻

2. 基本配置步骤 🎯

  1. 创建基本的 Caddyfile 配置文件：

    1
    2
    3
    4
    5
    6
    7
    cat > /mnt/mydisk/home/caddy/Caddyfile <<'EOF'
    http:// {
        root * /usr/share/caddy
        encode gzip
        file_server
    }
    EOF

  2. 创建示例首页：

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    cat > /mnt/mydisk/home/caddy/html/index.html <<'EOF'
    <!DOCTYPE html>
    <html>
    <head>
        <title>Welcome to Caddy</title>
    </head>
    <body>
        <h1>Hello from Caddy Web Server!</h1>
        <p>Caddy is running successfully in Docker.</p>
    </body>
    </html>
    EOF

  3. 重启 Caddy 容器应用配置：

    1
    docker-compose restart

🌐 三、Nginx 反向代理配置

访问地址示例：https://caddy.example.com

1. 创建 Nginx 配置文件 🔧

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
mkdir -p /etc/nginx/conf.d && \
cat > /etc/nginx/conf.d/caddy.conf <<'EOF'
server {
    listen 443 ssl;
    listen [::]:443 ssl;
    server_name caddy.example.com;   # 替换为你的域名

    # SSL 证书
    ssl_certificate /path/to/your/cert.pem;
    ssl_certificate_key /path/to/your/key.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_prefer_server_ciphers off;
    ssl_ciphers ECDHE+AESGCM:ECDHE+CHACHA20:!aNULL:!MD5;

    # 安全头部
    add_header X-Frame-Options DENY;
    add_header X-Content-Type-Options nosniff;
    add_header X-XSS-Protection "1; mode=block";

    # 文件大小限制
    client_max_body_size 100M;

    location / {
        proxy_pass http://127.0.0.1:80;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_buffering off;

        # WebSocket 支持
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }

    # 错误页
    error_page 404 500 502 503 504 /50x.html;
    location = /50x.html {
        root /usr/share/nginx/html;
    }
}
EOF

2. 测试并重载 Nginx 🔄

1
sudo nginx -t && sudo systemctl reload nginx

🔧 四、容器维护命令

1. Docker Compose 命令 🐳

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# 进入项目目录（请替换为您的实际目录）
cd /path/to/your/project

# 停止并删除容器
docker-compose down

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 仅启动指定服务（请替换 <service_name> 为实际服务名）
docker-compose up -d <service_name>

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

# 跟踪服务日志
docker-compose logs -f

# 查看指定服务日志（请替换 <service_name> 为实际服务名）
docker-compose logs <service_name>

# 完整升级流程
docker-compose down && \
docker-compose pull && \
docker-compose up -d && \
docker image prune -f

2. Docker 容器命令 📦

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器（请替换 <container_name> 为实际容器名）
docker stop <container_name>      # 停止容器
docker start <container_name>     # 启动容器  
docker restart <container_name>   # 重启容器

# 删除容器
docker rm <container_name>        # 删除已停止容器
docker rm -f <container_name>     # 强制删除运行中容器

# 进入容器Shell
docker exec -it <container_name> sh      # 使用sh进入容器
docker exec -it <container_name> bash    # 使用bash进入容器

# 以root身份进入容器  
docker exec -u 0 -it <container_name> sh

# 在容器中执行命令
docker exec <container_name> ls -la

# 查看容器详情和资源使用
docker inspect <container_name>     # 查看详细配置
docker stats <container_name>       # 实时资源监控

## 容器日志管理
docker logs <container_name>           # 查看日志
docker logs -f <container_name>        # 实时跟踪日志
docker logs --tail 100 <container_name>  # 查看最后100行
docker logs -t <container_name>        # 带时间戳的日志

3. Docker 镜像管理 📀

1
2
3
4
docker images                  # 列出所有镜像
docker rmi <image_name:tag>    # 删除指定镜像（请替换为实际镜像名和标签）
docker image prune -f          # 清理悬空镜像
docker image prune -a -f       # 清理所有未使用镜像

🌟 启航 Web 服务，探索无限

通过本文档，你已经成功使用 Docker 部署了 Caddy Web 服务器，并掌握了基本的配置和使用方法。现在，你可以：

🌍 轻松搭建 现代化的网站和应用，享受自动 HTTPS 的便捷
⚡ 高效运行 静态资源和动态应用，体验卓越的性能表现
🔒 安全可靠 的 Web 服务，内置安全特性和自动证书管理
🛠️ 灵活配置 反向代理和负载均衡，满足各种复杂场景需求

Web 服务之路，是连接数字世界与用户的桥梁。愿 Caddy 成为你可靠的 Web 服务伙伴，为你的每一个项目提供稳定高效的运行环境。

从现在开始，部署应用，服务用户——构建你强大可靠的 Web 基础设施吧！🚀

📌 持续学习：建议阅读 Caddy 官方文档，探索更多高级功能和配置选项。
🐛 反馈与互助：使用中如有疑问或建议，可前往 Caddy 社区论坛 交流讨论。

祝你部署顺利，服务稳定！🎉