第16章 SSL 证书配置指南
SSL 证书
如何为控制面板配置 Let’s Encrypt
请确保服务器主机名已指向该服务器的 IP 地址,且主机名设置正确。执行以下命令即可更改主机名并为控制面板生成 Let’s Encrypt 证书: ```bash v-change-sys-hostname host.domain.tld v-add-letsencrypt-host ```
使用 Let’s Encrypt 的常见错误
【信息】由于代码变更,错误提示已更新。未来该列表将持续扩充。
ErrorMessage: rateLimited 最大请求速率限制已超出。请通过 https://crt.sh 或 CertObserver CT 搜索查看当前有多少个活动证书。
Let’s Encrypt 验证状态 400
在请求 SSL 证书时,可能会遇到以下错误: ```bash Error: Let’s Encrypt validation status 400. Details: Unable to update challenge :: authorisation must be pending ``` 这可能由多种原因导致: 1. Cloudflare 代理已启用,且 SSL/TLS 设置项为“Full (strict)”。 2. Nginx 或 Apache 未正确重新加载。 3. 已启用 IPv6。请在 DNS 中禁用 IPv6。 4. 模板存在问题。
未来我们希望改进调试功能,但目前排查此问题的最简单方式是前往 `/var/log/hestia/` 目录,检查目标日志文件(格式为 `LE-{user}-{domain}.log`,该文件应在请求证书后生成)。
查找“Step 5”,你将看到类似以下内容:
```bash
==[Step 5]==
- status: 200
- nonce: 0004EDQMty6_ZOb1BdRQSc-debiHXGXaXbZuyySFU2xoogk
- validation: pending
- details:
- answer: HTTP/2 200
server: nginx
date: Wed, 21 Apr 2021 22:32:16 GMT
content-type: application/json
content-length: 186
boulder-requester: 80260362
cache-control: public, max-age=0, no-cache
link:
{ "type": "http-01", "status": "pending", "url": "https://acme-v02.api.letsencrypt.org/acme/chall-v3/12520447717/scDRXA", "token": "9yriok5bpLtV__m-rZ8f2tQmrfeQli0tCxSj4iNkv2Y" } ``` 根据 JSON 响应中的 URL 访问,可获取更多关于错误原因的信息。
其他 Let’s Encrypt 调试技巧
尝试使用 Let’s Debug: 1. 输入你的域名。 2. 确保选择 HTTP-01。 3. 运行测试。 测试完成后,将显示包含更多详细信息的错误提示或成功消息。
我可以在使用 Let’s Encrypt 时启用 Cloudflare 代理吗?
可以,你可以在使用 Cloudflare 代理时配合 Let’s Encrypt 证书,但需遵循以下特殊步骤: 1. 禁用目标域名的 Cloudflare 代理。 2. 等待至少 5 分钟,让 DNS 缓存过期。 3. 通过控制面板请求证书,或使用 CLI 命令。 4. 重新启用代理。 5. 在 SSL/TLS 标签页中,切换为“Full (strict)”。
我可以使用 Cloudflare Origin CA SSL 证书吗?
请按以下步骤创建 Origin CA 证书。生成后,在“编辑 Web 域”页面填入 SSL 密钥。在“SSL Certificate Authority / Intermediate”框中填入该证书。在 Cloudflare 的 SSL/TLS 标签页中,切换为“Full (strict)”。