跳转到内容

1Panel 面板

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

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

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

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

创建 1Panel API Key

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

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

复制 1Panel 接口密钥

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

配置 1Panel API 接口

回到证书熊的新建应用,操作如下图:

在证书熊中新增应用

填写 1Panel 应用配置

面板地址填写在浏览器里打开 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 网站的证书吗?

Section titled “证书熊能自动更新 1Panel 网站的证书吗?”

能。接入 1Panel 后,为网站新建部署任务,再为证书和部署任务开启自动续期。证书到期前 15 天自动续签,新证书会自动部署到网站上,见 1Panel 网站证书自动续期。

1Panel 自己也能申请证书,为什么还要用证书熊?

Section titled “1Panel 自己也能申请证书,为什么还要用证书熊?”

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