# 1Panel 网站证书自动续期

> 用证书熊给 1Panel 网站签发证书并自动续期，多台 1Panel 和云服务用同一张证书。

1Panel 自带证书申请，配好 DNS 账号后也能自动续签。不过它签的证书只在这台服务器上用，手动解析申请的证书也不会自动续签。网站分布在多台 1Panel 上，或者同一个域名还用在 CDN、对象存储上时，用证书熊签发一张证书统一续签和部署更省事。

证书熊支持 1Panel v1（1.10 LTS）和 v2，会自动识别面板版本。

## 准备

- 1Panel 开启 API，IP 白名单只填证书熊的 IP `121.43.244.173`，见 [1Panel 面板](https://www.sslbear.com/docs/clouds/onepanel/)。v2.3.2 起新建的 API Key 默认 3 个月到期，建议勾选「永不过期」。
- 网站要绑定域名。TCP/UDP 转发类型的网站不能配置证书，不会出现在列表里。
- 证书配额和部署配额各至少 1 个，见[充值与计费](https://www.sslbear.com/docs/account/recharge/)。

## 操作步骤

1. 进入**我的应用**，新增 1Panel 应用，面板地址只写到端口，比如 `https://1.2.3.4:12345`，不要带安全入口。等状态变为**已完成**。
2. 进入**证书**，点击**申请证书**，选择**从应用选择**，选这个网站。证书熊会签发一张覆盖网站全部域名的证书，最多 5 个域名。
3. 证书停在**待配置 CNAME** 时，按[配置 CNAME](https://www.sslbear.com/docs/certificates/cname/) 添加记录。
4. 进入**部署任务**，新增任务，选择 1Panel 应用和这个网站，再点击**部署证书**。
5. 部署成功后，打开证书和部署任务两处的**自动续期**开关。

## 部署时会改动什么

- 证书先上传到 1Panel 的证书列表，备注以 `sslbear_` 开头，再换到网站上。
- 网站原来已开启 HTTPS 的，只换证书，HTTP 跳转、TLS 协议、加密套件、HSTS 和 HTTP3 保持原样。
- 网站原来没开 HTTPS 的，部署后开启 HTTPS，但不强制跳转，也不开启 HSTS。
- 换下来的旧证书如果是证书熊上传的，并且没有别的网站在用，会从 1Panel 的证书列表删除。你自己的证书不动。

## 常见问题

### 一张证书能部署到多台 1Panel 吗？

能。每台 1Panel 在证书熊里新增一个应用，再给每个网站各建一个部署任务。1Panel 自己的「同步到其他节点」要专业版，证书熊不需要。

### API Key 到期了会怎样？

证书熊同步不到网站，也部署不了证书，自动部署失败后会发邮件提醒。在 1Panel 里换一个新的 API Key，再到**我的应用**编辑应用，填入新密钥。

### 和 1Panel 自带的证书怎么选？

网站都在一台 1Panel 上，域名解析商在 1Panel 支持的 DNS 账号里，用 1Panel 自带的就够了。详细对比见[证书熊和 1Panel 自带证书](https://www.sslbear.com/compare/onepanel-ssl/)。
