1.下载Caddy

访问Caddy官网下载页面：https://caddyserver.com/download ，下载后把文件名称改为caddy
根据你的CPU架构选择对应版本：amd64 arm64 ...
按需选择插件：目前用的是阿里的域名，所以这里选 caddy-dns/alidns

2.安装配置

上传并授权：

# 上传 caddy 文件到 /usr/bin/ 目录，并运行命令授权
chmod +x /usr/bin/caddy

创建配置目录和文件：

# 创建目录
mkdir -p /etc/caddy 
# 创建 Caddyfile 配置文件
vi /etc/caddy/Caddyfile

配置示例

1. 基础配置

基础配置展示了最简单的反向代理设置：

{
    http_port 667
    https_port 668
    email your-email@example.com
    }
}

blog.example.com:668 {
    reverse_proxy 192.168.1.100:8080
}

# 这个配置将：
# - 使用667端口处理HTTP请求（因为80端口被封）
# - 使用668端口处理HTTPS请求（因为443端口被封）
# - 通过DNS验证方式自动申请和续期SSL证书（因为无法使用HTTP验证）
# - 将访问your.domain.com:668的请求反向代理到内网192.168.1.100:8080

2. 进阶配置：多服务统一管理

Caddy的配置语法简洁优雅，特别适合管理多个内网服务。下面是一个使用通配符域名管理多个服务的实例：

{
    http_port 667
    https_port 668
    email your-email@example.com
    acme_dns tencentcloud {
        secret_id "YOUR_SECRET_ID"
        secret_key "YOUR_SECRET_KEY"
    }
}

*.example.com:668 {
    @nas host nas.example.com
    handle @nas {
        reverse_proxy http://192.168.1.100:5000
    }

    @photos host photos.example.com
    handle @photos {
        reverse_proxy http://192.168.1.100:5001
    }

    @cloud host cloud.example.com
    handle @cloud {
        reverse_proxy http://192.168.1.100:5002
    }

    @media host media.example.com
    handle @media {
        reverse_proxy http://192.168.1.100:8096
    }

    @router host router.example.com
    handle @router {
        reverse_proxy http://192.168.1.1:80
    }
}

这个配置展示了Caddy强大的特性：

通配符域名支持：
- 使用*.example.com配置，支持所有子域名
- 在DNS服务商处，只需添加一条*.example.com的CNAME记录，指向www.example.com即可
- 一次性申请通配符SSL证书，覆盖所有子域名
优雅的多服务配置：
- 使用@name host domain语法定义服务匹配规则
- 每个服务独立配置，便于管理和维护
- 支持不同的内网IP和端口
简洁的配置语法：
- 无需复杂的location块和rewrite规则
- 配置结构清晰，易于理解和修改
- 自动处理HTTPS重定向和证书管理

提示

使用通配符域名时，DNS配置很简单：
添加www.example.com的A记录，指向你的公网IP
添加*.example.com的CNAME记录，指向www.example.com
Caddy会自动为所有子域名申请和管理SSL证书

3.系统配置

1. 配置自启动服务

创建并编辑启动脚本：

vi /etc/init.d/caddy

添加以下内容：

#!/bin/sh /etc/rc.common

START=99
USE_PROCD=1

start_service() {
    procd_open_instance
    procd_set_param command /usr/bin/caddy run --config /etc/caddy/Caddyfile
    procd_set_param respawn
    procd_set_param stdout 1
    procd_set_param stderr 1
    procd_close_instance
}

启用caddy服务：

chmod +x /etc/init.d/caddy
/etc/init.d/caddy enable
/etc/init.d/caddy start

2. 配置防火墙

为了允许外部访问，需要在OpenWrt防火墙中开放相应端口。你可以通过以下两种方式之一完成配置：

登录OpenWrt管理界面
导航至：网络 -> 防火墙 -> 端口转发
添加新规则：
- 名称：Caddy-HTTPS
- 协议：TCP
- 外部端口：667,668（根据你的配置调整）
- 内部端口：667,668
- 内部IP地址：192.168.1.1（路由器IP）

4.使用维护

日常维护操作

查看服务状态：

/etc/init.d/caddy status

重启服务（配置修改后需要）：

/etc/init.d/caddy restart

5.故障排查

如果遇到访问问题，请按以下步骤排查：

1.检查Caddy服务状态：

/etc/init.d/caddy status

2.查看Caddy运行日志 ####：

logread | grep caddy

常见的日志信息及其含义：

caddy[xxxx]: failed to start: 服务启动失败
caddy[xxxx]: error: listen tcp :xxx: bind: address already in use: 端口被占用
caddy[xxxx]: tls: [nas.example.com] acme: error presenting token: xxx: DNS验证失败
caddy[xxxx]: http: TLS handshake error: SSL证书问题

3.实时监控日志：

logread -f | grep caddy

这个命令会持续显示新产生的日志，适合实时排查问题。

官方文档：https://caddyserver.com.cn/docs/_