安装与续期

证书签发后，您需要把证书文件部署到 Web 服务器或 CDN 上，并在到期前续期。本文介绍「我的证书」页面的各项操作、证书文件的获取方式和常见的部署方法。

#「我的证书」页面

打开 证书服务 → 我的证书（/ssl/certificates），列表包含以下列：

点击 详情 可查看主域名、SAN 域名、颁发者、序列号、颁发与过期时间、SHA256 指纹等信息。

#获取证书文件

• 列表中的「下载」：证书签发后出现，下载证书本体文件 <域名>.crt（PEM 格式）。
• 完整文件包：证书、私钥和 CA 中间证书可以通过 API 一次取回（仅限状态为「生效中」的证书）：

curl -X POST https://api.yeap.cloud/api/user/ssl/orders/download \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"order_id": 123}'

返回的 certificate、ca_bundle、private_key 分别为证书、CA 中间证书链和私钥（PEM）。对于已签发的订单，订单详情页 /ssl/order/<订单号> 也提供 下载证书 按钮，会同时下载 <域名>.crt、<域名>.key 和 <域名>-ca-bundle.crt。

#部署到 Web 服务器

大多数服务器需要「完整证书链」：先放您的证书，再接 CA 中间证书。可以用以下命令合并：

cat example.com.crt example.com-ca-bundle.crt > example.com.fullchain.pem

如果缺少中间证书，可以用 SSL 工具 中的「证书链补全」自动生成完整链。

#Nginx

server {
    listen 443 ssl;
    http2 on;
    server_name example.com;

    ssl_certificate     /etc/ssl/example.com.fullchain.pem;
    ssl_certificate_key /etc/ssl/example.com.key;
    ssl_protocols       TLSv1.2 TLSv1.3;
}

执行 nginx -t 检查配置，再 nginx -s reload 生效。

#Apache

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile    /etc/ssl/example.com.fullchain.pem
    SSLCertificateKeyFile /etc/ssl/example.com.key
</VirtualHost>

Apache 2.4.8 及以上版本可以直接在 SSLCertificateFile 中使用完整链文件。

#需要 PFX/PKCS#12 格式（IIS、Tomcat 等）

平台提供的是 PEM 格式文件，可以在本地用 OpenSSL 转换：

openssl pkcs12 -export -out example.com.pfx \
  -inkey example.com.key -in example.com.crt -certfile example.com-ca-bundle.crt

#部署到 Yeap Cloud CDN

如果站点接入了 Yeap Cloud CDN，可以在 CDN 域名的 SSL 设置页（/cdn/domains/<域名>/ssl）为加速主机名上传证书和私钥（PEM）。CDN 也可以为加速域名自动申请并续期免费证书，详见 CDN 文档。

#验证部署

openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null \
  | openssl x509 -noout -subject -issuer -dates

也可以把服务器返回的证书粘贴到 SSL 工具 的「证书解析」中检查有效期和 SAN；如果安装时报私钥不匹配，用「密钥匹配」确认证书与私钥是否成对。

#续期

证书到期前需要续期。DV 证书有效期为 90 天（Let's Encrypt、ZeroSSL），付费 OV/EV 证书一般为 1 年，列表会在剩余 30 天内提示「即将过期」。

在 我的证书 中，状态为「生效中」或「已过期」的证书会显示 续期 按钮。点击并确认后系统创建一个与原订单关联的续期订单（提示「续期订单已创建」）：

• 免费 DV 证书：续期订单无需付款，按 购买与验证证书 中的步骤重新提交域名并完成验证即可。
• 付费证书：续期订单需要付款后才能继续。如需协助完成付费续期，或希望直接购买新证书替换，请联系我们。

也可以通过 API 发起续期：

curl -X POST https://api.yeap.cloud/api/user/ssl/certificates/renew \
  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
  -d '{"order_id": 123}'

续期签发新证书后，请用新文件替换服务器上的旧证书并重新加载服务。

#上传已有证书

如果您在其他 CA 购买了证书，可以点击 上传证书，填写主域名、证书内容（PEM）、私钥（PEM）和可选的 CA Bundle，集中保存在「我的证书」中。平台会校验证书格式并自动读取颁发者和过期时间。

#删除证书

点击 删除 并确认即可删除记录，删除后不可恢复。手动上传的证书随时可以删除；购买的证书在「生效中」状态下不能删除。

#重新签发与吊销

如果私钥泄露、需要更换域名或需要吊销证书，请联系我们并提供订单号，我们会协助您向 CA 办理。