自有服务器(SSH)
在 Linux 服务器上运行一次安装命令,证书熊通过 SSH 把证书部署到 Nginx、Apache 等 web 服务。
服务器上没有装宝塔、1Panel 时,证书熊可以通过 SSH 把证书部署到 Linux 服务器上的 Nginx、OpenResty、Apache,续签后自动更新。
不需要提供 root 密码。安装命令会在服务器上建一个低权限用户 sslbear,证书熊只能用它检测连接和更换证书。
- 一台有公网 IP 的 Linux 服务器,能用 root 运行命令,装了 sudo 和 OpenSSH(7.2 及以上)。
- 安全组和防火墙放行证书熊的 IP
121.43.244.173访问 SSH 端口。
进入「我的应用」,点击「新增应用」,操作如下:

运行安装命令
Section titled “运行安装命令”打开刚建的应用,操作如下:

用 root 登录服务器,粘贴命令运行,看到「证书熊安装完成」后回到控制台点击「检测连接」,状态变成「已连通」就好了。
服务器上已经在用证书的,在命令末尾加上 --site,写明域名、证书路径和私钥路径(就是 web 配置里写的那两个文件),证书熊会直接替换这两个文件,不用改 web 配置。有几个域名就加几个 --site:
--site 'example.com /etc/nginx/ssl/example.pem /etc/nginx/ssl/example.key'web 服务跑在 Docker 里,或者不在列表中时,选「其他(自定义命令)」,把命令末尾 --reload 后面换成让证书生效的命令,比如 --reload 'docker exec web nginx -s reload'。
安装命令可以重复运行,加了 --site 或换了 web 服务,重新运行一次就行。
核对服务器指纹
Section titled “核对服务器指纹”连通后,应用详情里会显示服务器指纹,操作如下:

它要和安装命令最后打印的同类型指纹一致(SHA256: 后面完全相同)。不一致说明连到的可能不是你的服务器,先不要部署,检查服务器地址。
新建部署任务
Section titled “新建部署任务”进入「部署任务」,点击「新增任务」,操作如下:

- 每行一个任务。几个域名用同一份证书文件时(比如 Nginx 同一个
server里的example.com和www.example.com),写在同一行,用空格隔开,证书要覆盖这一行的全部域名。 - 每行的第一个域名决定证书写到哪里:用
--site指定过的,写到指定的路径;没指定的,写到/etc/sslbear/live/<域名>/fullchain.pem和privkey.pem。
建好后点击「部署证书」先部署一次,再打开任务的「自动续期」,证书续签后会自动部署到服务器。
没有用 --site 时,第一次部署后把 web 配置改成 /etc/sslbear/live/ 下的文件,再部署一次。以 Nginx 为例:
ssl_certificate /etc/sslbear/live/example.com/fullchain.pem;ssl_certificate_key /etc/sslbear/live/example.com/privkey.pem;部署时会做什么
Section titled “部署时会做什么”备份旧证书,换上新证书,检查配置(比如 nginx -t),重新加载 web 服务(不中断已有连接),最后核对网站返回的是不是新证书。检查或重新加载失败时会自动换回旧证书,原因显示在部署记录里。
curl -fsSL https://console.sslbear.com/ssh/install.sh -o /tmp/sslbear-install.sh && sudo sh /tmp/sslbear-install.sh --uninstall会删除 sslbear 用户、sudo 规则和脚本,已经写到服务器上的证书会保留。
证书熊在服务器上能做什么?
Section titled “证书熊在服务器上能做什么?”只能检测连接和更换证书。sslbear 用户不能用密码登录,只能用证书熊的密钥从 121.43.244.173 登录,登录后拿不到 shell。需要 root 的操作都在 /usr/local/libexec/sslbear/apply 这一个脚本里,sudo 只允许运行它,可以直接打开查看。
检测连接报“服务器拒绝了证书熊的密钥”
Section titled “检测连接报“服务器拒绝了证书熊的密钥””还没运行安装命令,或者 sshd 的 AllowUsers 挡住了 sslbear(安装时会提示)。按提示处理后重新运行安装命令。
检测连接报“连不上服务器”
Section titled “检测连接报“连不上服务器””检查服务器地址和 SSH 端口,以及安全组和防火墙是否放行了 121.43.244.173。
检测连接报“配置检查没通过”
Section titled “检测连接报“配置检查没通过””web 服务的配置本身有错误,这时部署也会失败。先在服务器上运行 nginx -t(Apache 用 apachectl configtest)把错误修好。
服务器指纹变了怎么办?
Section titled “服务器指纹变了怎么办?”服务器重装过系统:重新运行安装命令,在应用详情点击「修改服务器地址」重新保存,再检测连接。没有重装过的话,先不要部署,检查服务器地址。
部署失败,提示网站返回的还是别的证书
Section titled “部署失败,提示网站返回的还是别的证书”证书已经写到服务器上了,但 web 服务没有用这份文件。按提示里的路径修改 web 配置,或者用 --site 指向 web 配置里的路径,然后再部署一次。
支持 Windows 吗?
Section titled “支持 Windows 吗?”暂不支持 Windows、IIS 和 Tomcat,可以下载证书自己安装。