2025-09-11 15:20:13 +08:00
|
|
|
|
# 常见问题
|
2025-05-15 09:38:35 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 1. 是否支持IP证书
|
|
|
|
|
|
|
|
|
|
|
|
因为ACME协议不支持IP证书，所以certd目前也不支持IP证书
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 2. 建议设置多长时间运行一次流水线
|
2025-09-11 15:20:13 +08:00
|
|
|
|
建议每天运行一次，检查证书过期时间
|
2025-05-15 09:38:35 +08:00
|
|
|
|
当证书没过期时，自动跳过部署
|
|
|
|
|
|
当证书到期前35天（创建流水线时可以修改），将会自动重新申请证书，自动部署
|
|
|
|
|
|
|
|
|
|
|
|
|
2025-09-11 15:20:13 +08:00
|
|
|
|
## 3. too many certificates 错误
|
|
|
|
|
|
当出现如下报错时，说明相同的域名短时间内申请超过5次
|
|
|
|
|
|
解决方案：可以加多一个子域名，重新执行就可以规避次错误
|
|
|
|
|
|
```
|
|
|
|
|
|
"detail": too many certificates (5) already issued for this exact set of idantifiers in the last 168hm0s
|
2025-09-14 23:01:18 +08:00
|
|
|
|
```
|
|
|
|
|
|
|
2025-10-11 16:59:28 +08:00
|
|
|
|
## 4. ssl.com报错 CAA record does not include ssl.com which is required to issue the certificate
|
2025-09-14 23:01:18 +08:00
|
|
|
|
ssl.com申请证书要求必须设置CAA记录，表示允许ssl.com为该域名颁发证书
|
|
|
|
|
|
请按如下格式添加CAA记录
|
|
|
|
|
|
|
|
|
|
|
|
| 示例 | 类型 | 域名前缀 | flag | tag | 值 |
|
|
|
|
|
|
|-------|-----| -- |-----------|--------|----------------------|
|
|
|
|
|
|
| 顶级域名 | CAA | @ | 0 | issue | "ssl.com" （注意有双引号） |
|
|
|
|
|
|
| 一级泛域名 | CAA | * | 0 | issue/issuewild | "ssl.com" |
|
|
|
|
|
|
| 固定子域名 | CAA | sub | 0 | issue |"ssl.com" |
|
|
|
|
|
|
|
2025-10-11 16:59:28 +08:00
|
|
|
|
## 5. address family not supported
|
|
|
|
|
|
启动时出现此错误，是由于您的服务器不支持绑定ipv6地址
|
|
|
|
|
|
|
|
|
|
|
|
请配置环境变量 certd_koa_hostname=0.0.0.0
|
|
|
|
|
|
|
|
|
|
|
|
在docker-compose.yml中添加如下配置
|
|
|
|
|
|
|
|
|
|
|
|
```yaml
|
|
|
|
|
|
service:
|
|
|
|
|
|
certd:
|
|
|
|
|
|
environment:
|
|
|
|
|
|
certd_koa_hostname: 0.0.0.0
|
|
|
|
|
|
```
|
2025-09-14 23:01:18 +08:00
|
|
|
|
|
2025-12-19 11:30:01 +08:00
|
|
|
|
## 6. DNS记录问题
|
|
|
|
|
|
|
|
|
|
|
|
1. DNS 不要设置CAA记录，删除即可
|
|
|
|
|
|
|
|
|
|
|
|
2. DNSSEC相关报错，DNSSEC管理中删除即可
|
|
|
|
|
|
|
|
|
|
|
|
3. DNS 有其他平台申请过的_acme-challenge记录，删除即可
|
|
|
|
|
|
|
2025-09-14 23:01:18 +08:00
|
|
|
|
|
2026-02-03 12:28:30 +08:00
|
|
|
|
## 7. DNS problem: NXDOMAIN looking up TXT for _acme-challenge.xxx
|
|
|
|
|
|
`
|
|
|
|
|
|
DNS problem: NXDOMAIN looking up TXT for _acme-challenge.xxxxx - check that a DNS record exists for this domain
|
|
|
|
|
|
`
|
|
|
|
|
|
证书颁发机构向域名ns查询TXT验证记录失败，有以下几种可能
|
|
|
|
|
|
1、域名的ns服务器修改成别的了，但申请证书时的DNS提供商选择错误（检查确认，配置正确的DNS提供商）
|
|
|
|
|
|
2、证书颁发机构与ns域名服务器之间访问不通，无法查询到TXT记录（尝试更换证书颁发机构）
|
|
|
|
|
|
3、ns服务商解析值生效慢（尝试修改证书申请任务里面的等待生效时长600-1000s）
|
