本笔记将介绍:如何安装 Certbot 工具;如何使用它获取证书;如何处理在操作过程中遇到的问题。
注意事项
本部分内容属于简述,详细内容请参考 certbot instructions 官方页面,依据提示操作即可。以下是操作大致流程:
1)选择站点服务器软件,以及操作系统发行版
2)查看是否满足条件
3)依据提示安装软件包
4)执行命令生成证书
5)访问站点以检查证书是否生效
6)添加定时任务以实现证书自动续期
CentOS 7.4, PIP3.6 and Certbot
经验:这种东西就应该在虚拟环境里搞,但凡与应用有关且与系统管理无关的 Python 应用,都应该在虚拟环境里搞。要是在系统环境里搞,直接 yum install,pip2.7 install,等着吧,早晚有难受的时候。
我们并没有在虚拟环境里,因为系统没有使用 Python 3.6 环境,因此我们可以直接使用:
pip3.6 install certbot certbot-nginx certbot-dns-aliyun
CentOS 7.4 and Certbot 1.0.0
#!/bin/sh ################################################################################ # 安装 Certbot 工具 ################################################################################ # 安装相关软件包 yum install -y epel-release yum -y install yum-utils yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional # 安装并获取证书 yum install certbot python2-certbot-nginx ################################################################################ # 申请证书并配置 ################################################################################ # 申请 Nginx 证书,并自动修改 Nginx 配置 certbot --nginx # 仅仅生成证书,不修改配置 # certbot certonly --nginx # 配置证书自动续期 echo "0 0,12 * * * root python -c 'import random; import time; time.sleep(random.random() * 3600)' && certbot renew" \ | tee -a /etc/crontab > /dev/null ################################################################################ # 验证配置正确 ################################################################################ # 访问站点确认 HTTPS 是否生效
Debian 8 (jessie)
#!/bin/sh ################################################################################ # 安装 Certbot 工具 ################################################################################ apt-get remove certbot wget https://dl.eff.org/certbot-auto mv certbot-auto /usr/local/bin/certbot-auto chown root /usr/local/bin/certbot-auto chmod 0755 /usr/local/bin/certbot-auto ################################################################################ # 申请证书并配置 ################################################################################ # 申请证书 /usr/local/bin/certbot-auto --nginx # /usr/local/bin/certbot-auto certonly --nginx # 或者仅仅生成证书,不修改配置 # 配置证书自动续期 echo "0 0,12 * * * root python -c 'import random; import time; time.sleep(random.random() * 3600)' && /usr/local/bin/certbot-auto renew" \ | tee -a /etc/crontab > /dev/null ################################################################################ # 验证配置正确 ################################################################################ # 访问站点确认HTTPS是否生效
常见问题汇总
#1 卡在 installing python packages 步骤
no response "Installing Python packages" #2516
问题描述:在Debian中,执行/usr/local/bin/certbot-auto --nginx命令后,它会调用pip命令安装相关Python包,这是时候会卡住。
问题原因:在执行pip命令时,它访问官方仓库,由于网络原因导致无法正常快速下载。
解决办法:修改$HOME/.pip/pip.conf文件,配置如下内容(使用阿里云镜像):
[global] index-url = http://mirrors.aliyun.com/pypi/simple/ [install] trusted-host=mirrors.aliyun.com
附加说明
自动重启服务
在自动证书续期后,可能需要重启服务以加载证书:
#!/bin/sh certbot -q renew --renew-hook "/etc/init.d/nginx reload"
相关文章
「Certbot」- SERVFAIL looking up CAA for
「Certbot」- ocsp.int-x3.letsencrypt.org Read timed out
「Certbot」- The manual plugin is not working
「Certbot」- ImportError: 'pyOpenSSL' module missing required functionality
「Certbot」- 在内网中申请证书的方法
参考文献
certbot instructions
Let’s Encrypt: Reload Nginx after Renewing Certificates
Let's Encrypt and Certbot