# 1Panel 面板

> 开启 1Panel 面板 API，再把接口信息添加到证书熊。

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

## 1Panel 配置

不同版本的 1Panel，API 设置的位置不一样，按你的面板版本操作。面板版本显示在页面右下角。

### v2.3.2 及以上

进入 1Panel 面板，打开「面板设置」，切换到「API Key」，点击「创建 API Key」，操作如下：

![创建 1Panel API Key](https://www.sslbear.com/_astro/01.CWjnmO4O_ZClzNs.webp)

IP 白名单只填证书熊的 IP `121.43.244.173`。新建的 API Key 默认 3 个月后到期，到期后证书熊无法同步网站和部署证书，建议勾选「永不过期」；不勾选的话，记得在到期前更换密钥。

创建后会显示接口密钥，只显示这一次，操作如下：

![复制 1Panel 接口密钥](https://www.sslbear.com/_astro/02.CtHc_71__5WUE2.webp)

### v2.3.2 以下（含 v1）

进入 1Panel 面板，打开「面板设置」，在「面板」页找到「API 接口」，打开开关，再点下方的「详情」，操作如下：

![配置 1Panel API 接口](https://www.sslbear.com/_astro/03.CXUEXf52_13oHmp.webp)

## 新建应用

回到证书熊的新建应用，操作如下图：

![在证书熊中新增应用](https://www.sslbear.com/_astro/apps-list.CLcTCzlJ_Z1BEoHA.webp)

![填写 1Panel 应用配置](https://www.sslbear.com/_astro/app-form.poIsxSXJ_1OHs2f.webp)

面板地址填写在浏览器里打开 1Panel 用的地址，只写到端口，比如 `https://1.2.3.4:12345`，不要带安全入口（端口后面的那段路径）。

到这里完成了 1Panel 应用的创建，等 30 秒左右系统会自动完成数据同步，之后就可以申请证书和部署证书了。

## 支持的网站类型

证书熊会同步 1Panel「网站」里这些类型的网站，网站列表里会标出每个网站的类型：

- 静态网站
- 反向代理
- 运行环境（PHP、Node、Java、Go、Python、.NET）
- 一键部署
- 子网站

TCP/UDP 转发类型的网站不能配置 HTTPS 证书，不会同步到证书熊。

网站在证书熊里以主域名作为名称。

## 网站绑定了多个域名

1Panel 的一个网站只能用一张证书，所以部署时证书要覆盖网站上的全部域名。只覆盖其中一部分的证书不会出现在部署证书的选项里，自动部署也不会用它。比如网站绑定了 `example.com`、`www.example.com` 和 `www.other.cn`，`*.example.com` 这张通配符证书覆盖不到 `www.other.cn`，就不能部署到这个网站，部署证书的弹窗会标出没有覆盖的域名。

在**申请证书**里选择**从应用选择**，再选这个网站，证书熊会签发一张覆盖网站全部域名的证书。网站的域名可以属于不同主域名，一张证书最多包含 5 个域名。网站绑定的域名超过 5 个时，请先在 1Panel 把部分域名移到单独的网站，再到「我的应用」同步网站。

## 部署时会改动什么

部署时，证书熊先把证书上传到 1Panel 的证书列表，备注以 `sslbear_` 开头，同一张证书只上传一次，再把网站的 HTTPS 证书换成这一张。

网站原来已经开启 HTTPS 时，证书熊只换证书，HTTP 跳转方式、TLS 协议、加密套件、HSTS 和 HTTP3 都保持原来的设置。

网站原来没有开启 HTTPS 时，证书熊会开启 HTTPS。HTTP 仍然可以访问，不会强制跳转到 HTTPS，也不会开启 HSTS。需要跳转的话，部署成功后到 1Panel 网站的 HTTPS 设置里修改，之后再部署会保留你的设置。

换下来的旧证书如果也是证书熊上传的（备注以 `sslbear_` 开头），并且已经没有网站在用，证书熊会把它从 1Panel 的证书列表里删除。不是证书熊上传的证书不会被删除。

## 常见问题

### 证书熊能自动更新 1Panel 网站的证书吗？

能。接入 1Panel 后，为网站新建部署任务，再为证书和部署任务开启自动续期。证书到期前 15 天自动续签，新证书会自动部署到网站上，见 [1Panel 网站证书自动续期](https://www.sslbear.com/blog/onepanel-website/)。

### 1Panel 自己也能申请证书，为什么还要用证书熊？

1Panel 申请的证书只在这台服务器上用，同步到其他节点要专业版。证书熊可以把同一张证书同时部署到多台服务器的 1Panel、宝塔，以及 CDN、对象存储这些云服务，续签后一起更新，每次部署的结果都能在控制台查到。详细对比见[证书熊和 1Panel 自带证书](https://www.sslbear.com/compare/onepanel-ssl/)。
