mirror of
https://github.com/certd/certd.git
synced 2026-04-14 20:40:53 +08:00
62 lines
2.4 KiB
Markdown
62 lines
2.4 KiB
Markdown
# 常见问题
|
||
|
||
|
||
## 1. 是否支持IP证书
|
||
|
||
因为ACME协议不支持IP证书，所以certd目前也不支持IP证书
|
||
|
||
|
||
## 2. 建议设置多长时间运行一次流水线
|
||
建议每天运行一次，检查证书过期时间
|
||
当证书没过期时，自动跳过部署
|
||
当证书到期前35天（创建流水线时可以修改），将会自动重新申请证书，自动部署
|
||
|
||
|
||
## 3. too many certificates 错误
|
||
当出现如下报错时，说明相同的域名短时间内申请超过5次
|
||
解决方案：可以加多一个子域名，重新执行就可以规避次错误
|
||
```
|
||
"detail": too many certificates (5) already issued for this exact set of idantifiers in the last 168hm0s
|
||
```
|
||
|
||
## 4. ssl.com报错 CAA record does not include ssl.com which is required to issue the certificate
|
||
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" |
|
||
|
||
## 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
|
||
```
|
||
|
||
## 6. DNS记录问题
|
||
|
||
1. DNS 不要设置CAA记录，删除即可
|
||
|
||
2. DNSSEC相关报错，DNSSEC管理中删除即可
|
||
|
||
3. DNS 有其他平台申请过的_acme-challenge记录，删除即可
|
||
|
||
|
||
## 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） |