进阶 hestiacp.com 2026-11-15 08:32:00 · 7 阅读

第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: ;rel="index" link: ;rel="up" location: https://acme-v02.api.letsencrypt.org/acme/chall-v3/12520447717/scDRXA replay-nonce: 0004EDQMty6_ZOb1BdRQSc-debiHXGXaXbZuyySFU2xoogk x-frame-options: DENY strict-transport-security: max-age=604800

{ "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)”。

评论 (0)