使用 Let's Encrypt（Certbot） 配置 HTTPS

2017-10-13: 最近尝试了一下 acme 。方便快捷，强烈推荐。

今天又折腾了一下 Let's Encrypt，发现距离上次不久就已经忘了怎么做了。不得不再扒一遍文档。 这次记录下来。

上次折腾时，Let's Encrypt 还叫 Let's Encrypt ，这次已经改名为 Certbot 了。 用的 Let's Encrypt 客户端还叫 letsencrypt ，这次已经改名为 Certbot 了。 ¹ 并且上次是使用 git 下载，这次可以直接 wget 了。

1. 安装

   $ wget https://dl.eff.org/certbot-auto
   $ chmod a+x ./certbot-auto
   $ ./certbot-auto
   

   这个小工具会自动下载并安装相关依赖和 Python 包。稍等一下就完成了。

2. 生成证书

   生成证书过程中需要鉴权。有多种方式，比如 webroot、standalone、apache、nginx、manual 等。我使用过前两种。 这两种中，简单一点的是 standalone。不过，这种方式需要把现有的 WebServer 停掉，因为这种方式下 certbot 需要占用 80 端口。

   # ./certbot-auto certonly --text --agree-tos --email [email protected] --standalone -d example.com -d www.example.com -d service.example.com 
   

   -d 参数指定域名，可多个。一般第一个是主域名。

   webroot 方式稍微繁琐一些，但好处是不需要关停现有的 WebServer 。此方法需要在域名对应的根目录下新建 .well-known 目录并写入若干文件供验证服务访问。 因此需要配置 WebServer 允许外部访问 http://example.com/.well-known 路径。配置方法请参考相应 WebServer 的文档。Nginx 的默认配置应该不用修改，Apache 就不知道了。 另外，不同的域名的根路径可能不同，下面的例子中可以看到为不同的域名指定不同的根路径。

   # ./certbot-auto certonly --text --agree-tos --email [email protected] --webroot -w /var/www/example -d example.com -d www.example.com -w /var/service/example -d service.example.com
   

   无论使用那种方式，运行以上命令后都会在 /etc/letsencrypt 生成一堆东西，包括证书。

3. 修改 WebServer 配置以提供 HTTPS 服务

   这里以 Nginx 作例子吧。

   1. 打开 Nginx 的配置文件（默认为：/etc/nginx/nginx.conf），在需要提供 HTTPS 的 server 下新增以下三行，并把 listen 80; 删掉：

   listen 443 ssl;
   ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
   ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
   

   1. 新增以下 server 使所有 HTTP 请求都跳转至 HTTPS ：

   server {
   listen   80;
   server_name example.com www.example.com service.example.com;
   return 301 https://$host$request_uri;
   }
   

4. 定期 renew

   Let's Encrypt 的证书有效期为 90 天，所以需要在到期前 renew 一下证书。 使用以下命令即可。

   # ./certbot-auto renew --text --agree-tos --email [email protected] --webroot -w /var/www/example -d example.com -d www.example.com -w /var/service/example -d service.example.com
   

   或者直接运行以下命令，此时 certbot 会使用默认参数（此例为：/etc/letsencrypt/renewal/example.com.conf）：

   # ./certbot-auto renew
   

   又或者在 crontab 里加入定时任务，每隔 80 天的凌晨 4 点执行一次 renew：

   0 4 */80 * * /path/to/certbot-auto renew &>> /dev/null
   

参考：https://certbot.eff.org/docs/

启用 HTTPS 之后，会增加一点对服务器计算资源的占用，但是这非常值得。营造安全干净的网络环境需要大家共同的努力。

Except where otherwise noted, content on this site is licensed under a Creative Commons Attribution 4.0 International license .