Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zxlie/website-ssl.sh
低门槛跨入Https大门！网站ssl证书自动生成工具（http到https的转变），燥起来吧！
https://github.com/zxlie/website-ssl.sh
https https-auto-support nginx shell ssl website-ssl
Last synced: about 2 hours ago
JSON representation
低门槛跨入Https大门！网站ssl证书自动生成工具（http到https的转变），燥起来吧！
- Host: GitHub
- URL: https://github.com/zxlie/website-ssl.sh
- Owner: zxlie
- Created: 2016-03-14T13:53:30.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2020-10-02T13:02:33.000Z (about 4 years ago)
- Last Synced: 2024-11-07T22:42:36.991Z (7 days ago)
- Topics: https, https-auto-support, nginx, shell, ssl, website-ssl
- Language: Python
- Homepage: https://www.baidufe.com
- Size: 31.3 KB
- Stars: 197
- Watchers: 14
- Forks: 73
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
website-ssl.sh：低门槛跨入Https大门
----
## 一、简介
网站`https化`已是大势所趋，个人blog也都可以把`https`玩儿起来！
[Jerry Qu](https://imququ.com/post/letsencrypt-certificate.html)大神研究的很深，我把自己的操作步骤整合了一下，做成一个小工具，也许对大家有用！
## 二、使用方式
### 1、下载
```bash
# 下载工具
curl -so website-ssl.sh https://raw.githubusercontent.com/zxlie/website-ssl.sh/master/website-ssl.sh
chmod 0755 website-ssl.sh
```
没错，就这么下载了就能用了！当然，github源文件的下载，你也可以用你熟悉的任何方式！
注意：此工具会使用到`openssl`命令，请务必保证你的机器上已安装此工具！
### 2、配置
#### 2.1 wsl.cnf.sh的配置
首次执行`website-ssl.sh`的时候，工具会自动在当前目录下创建配置文件：`wsl.cnf.sh`
```bash
./website-ssl.sh
```
得到结果：
您的配置文件「wsl.cnf.sh」配置不正确或还未进行配置，请检查！
你可用任意编辑工具打开`wsl.cnf.sh`文件，针对头部的如下几个配置项进行`按需配置`：
```bash
# ************************ 配置区域 START ******************************
# 你的ssl主目录位置
ssl_dir="/home/work/www/ssl"
# nginx中配置的，给 Let's Encrypt 验证用的
challenges_dir="/home/work/www/challenges/"
# 按照你的需求进行配置，多个域名用空格分开
websites="your-website.com www.your-website.com"
# ************************ 配置区域 END ********************************
```
#### 2.2 nginx conf文件的配置
本工具是用`Let's Encrypt`来实现的`https`，所以证书的申请需要一个域名验证的过程；
也就是需要对目标站点的Nginx增加一个`location`，形如：
```nginx
# CA认证
location ^~ /.well-known/acme-challenge/ {
# 注：这里的$challenges_dir请替换成你自己的真实目录，如：/home/work/www/challenges/
alias $challenges_dir;
try_files $uri =404;
}
```
### 3、使用
```bash
# 直接执行脚本，获取帮助信息
./website-ssl.sh
```
结果：
网站ssl自动化工具（v1.0）使用方法:
usage: ./website-ssl.sh -v | csr | pem | nginx | renew | crontab | upgrade
-v 查看工具的版本号
csr 根据域名配置生成csr证书文件（For pem）
pem 生成 Let's Encrypt 认可的pem证书文件
nginx 获取nginx配置文件Demo
renew 更新ssl证书文件
crontab 自动更新pem证书文件的crontab任务
upgrade 升级「website-ssl.sh」工具到最新版
### 4、实际使用案例
#### step1：创建`pem`文件
```bash
./website-ssl.sh pem
```
注：这一步会自动为我们创建`domain.key`文件和`ssl-encrypt.pem`文件
#### step2：获取`nginx`配置的Demo
```bash
./website-ssl.sh nginx
```
注：如果自己知道怎么配置nginx，这一步都可以忽略
#### step3：配置自己的`nginx conf`文件
核心就是配置一下这个：
```nginx
server {
listen 443 ssl;
server_name your-website.com;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_ciphers EECDH+CHACHA20:EECDH+CHACHA20-draft:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES
ssl_prefer_server_ciphers on;
ssl_certificate /home/work/www/ssl/ssl-encrypt.pem;
ssl_certificate_key /home/work/www/ssl/domain.key;
ssl_session_timeout 5m;
...
}
```
#### step4：重新载入`nginx`配置文件，`https`完美启用
```bash
service nginx reload
```
### 5、`csr`文件强制更新
此种情况，只针对「需要走https的域名有增减」的情况，我们可以手动执行命令来更新`csr`文件：
```bash
./website-ssl.sh csr
```
只更新`csr`文件是没用的，还需要再次更新`pem`文件：
```bash
./website-ssl.sh pem
```
### 6、ssl证书有效期问题
由`Let's Encrypt`机构颁发的证书，默认只有90天的有效期，所以我们需要有一个证书更新的机制：
```bash
./website-ssl.sh renew
```
此命令会重新生成签名证书，并重启nginx，使得站点的`https`寿命延续
下面是`baidufe.com`站点的证书自动更新日志：
[root@www-baidufe-com ssl]# ./website-ssl.sh renew
Parsing account key...
Parsing CSR...
Registering account...
Already registered!
Verifying baidufe.com...
baidufe.com verified!
Verifying static.baidufe.com...
static.baidufe.com verified!
Verifying www.baidufe.com...
www.baidufe.com verified!
Signing certificate...
Certificate signed!
ssl-encrypt.pem文件创建成功！
Reloading nginx!
ssl证书自动更新成功！Nginx已重启！
当然，我们完全可以不用手动来做这件事情，用`crontab`，省事又省心：
```bash
./website-ssl.sh crontab
```
把输入的内容，添加到root账号下的crontab列表中，即可：
```crontab
# Let’s Encrypt 签发的证书只有90天有效期，可以设置为每个月自动更新
0 0 1 * * cd /home/work/www/ssl/ && ./website-ssl.sh renew >/dev/null 2>&1
```
到此，你可以开开心心的用了！
### 7、工具升级方法
但凡是个工具，都可能会有bug、或者新功能迭代，等等，所以，咱们可以通过如下方式，将工具升级到最新版本：
```bash
./website-ssl.sh upgrade
```
当然，要查看工具的版本号，也是有命令的：
```bash
./website-ssl.sh -v
#或者
./website-ssl.sh version
```
## 三、疑难杂症
如果使用`bash website-ssl.sh`出现shell脚本执行报语法错，那就试试这样：
```bash
chmod 0755 website-ssl.sh
./website-ssl.sh
```
## 四、意见反馈
Site: https://www.baidufe.com
Mail: [email protected]