# 自有服务器（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 端口。

## 添加服务器

进入「我的应用」，点击「新增应用」，操作如下：

![添加自有服务器](https://www.sslbear.com/_astro/app-form.CHW2Co3Y_Z1BLpr.webp)

## 运行安装命令

打开刚建的应用，操作如下：

![复制安装命令并检测连接](https://www.sslbear.com/_astro/install.CQK9nKKE_2gfVPs.webp)

用 root 登录服务器，粘贴命令运行，看到「证书熊安装完成」后回到控制台点击「检测连接」，状态变成「已连通」就好了。

服务器上已经在用证书的，在命令末尾加上 `--site`，写明域名、证书路径和私钥路径（就是 web 配置里写的那两个文件），证书熊会直接替换这两个文件，不用改 web 配置。有几个域名就加几个 `--site`：

```bash
--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 服务，重新运行一次就行。

## 核对服务器指纹

连通后，应用详情里会显示服务器指纹，操作如下：

![核对服务器指纹](https://www.sslbear.com/_astro/connected.DGKSlxQ3_ZJUWAI.webp)

它要和安装命令最后打印的同类型指纹一致（`SHA256:` 后面完全相同）。不一致说明连到的可能不是你的服务器，先不要部署，检查服务器地址。

## 新建部署任务

进入「部署任务」，点击「新增任务」，操作如下：

![新建部署任务](https://www.sslbear.com/_astro/create-task._QwVM4PS_Z2avj6C.webp)

- 每行一个任务。几个域名用同一份证书文件时（比如 Nginx 同一个 `server` 里的 `example.com` 和 `www.example.com`），写在同一行，用空格隔开，证书要覆盖这一行的全部域名。
- 每行的第一个域名决定证书写到哪里：用 `--site` 指定过的，写到指定的路径；没指定的，写到 `/etc/sslbear/live/<域名>/fullchain.pem` 和 `privkey.pem`。

建好后点击「部署证书」先部署一次，再打开任务的「自动续期」，证书续签后会自动部署到服务器。

没有用 `--site` 时，第一次部署后把 web 配置改成 `/etc/sslbear/live/` 下的文件，再部署一次。以 Nginx 为例：

```nginx
ssl_certificate     /etc/sslbear/live/example.com/fullchain.pem;
ssl_certificate_key /etc/sslbear/live/example.com/privkey.pem;
```

## 部署时会做什么

备份旧证书，换上新证书，检查配置（比如 `nginx -t`），重新加载 web 服务（不中断已有连接），最后核对网站返回的是不是新证书。检查或重新加载失败时会自动换回旧证书，原因显示在部署记录里。

## 卸载

```bash
curl -fsSL https://console.sslbear.com/ssh/install.sh -o /tmp/sslbear-install.sh && sudo sh /tmp/sslbear-install.sh --uninstall
```

会删除 `sslbear` 用户、sudo 规则和脚本，已经写到服务器上的证书会保留。

## 常见问题

### 证书熊在服务器上能做什么？

只能检测连接和更换证书。`sslbear` 用户不能用密码登录，只能用证书熊的密钥从 `121.43.244.173` 登录，登录后拿不到 shell。需要 root 的操作都在 `/usr/local/libexec/sslbear/apply` 这一个脚本里，sudo 只允许运行它，可以直接打开查看。

### 检测连接报“服务器拒绝了证书熊的密钥”

还没运行安装命令，或者 sshd 的 `AllowUsers` 挡住了 `sslbear`（安装时会提示）。按提示处理后重新运行安装命令。

### 检测连接报“连不上服务器”

检查服务器地址和 SSH 端口，以及安全组和防火墙是否放行了 `121.43.244.173`。

### 检测连接报“配置检查没通过”

web 服务的配置本身有错误，这时部署也会失败。先在服务器上运行 `nginx -t`（Apache 用 `apachectl configtest`）把错误修好。

### 服务器指纹变了怎么办？

服务器重装过系统：重新运行安装命令，在应用详情点击「修改服务器地址」重新保存，再检测连接。没有重装过的话，先不要部署，检查服务器地址。

### 部署失败，提示网站返回的还是别的证书

证书已经写到服务器上了，但 web 服务没有用这份文件。按提示里的路径修改 web 配置，或者用 `--site` 指向 web 配置里的路径，然后再部署一次。

### 支持 Windows 吗？

暂不支持 Windows、IIS 和 Tomcat，可以[下载证书自己安装](https://www.sslbear.com/blog/nginx-manual/)。
