https://github.com/liufee/certbot-feehi-hook
let's encrypt certbot hook
https://github.com/liufee/certbot-feehi-hook
certbot certbot-aliyun certbot-qcloud
Last synced: about 1 year ago
JSON representation
let's encrypt certbot hook
- Host: GitHub
- URL: https://github.com/liufee/certbot-feehi-hook
- Owner: liufee
- Created: 2019-11-02T16:56:46.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-07-14T06:50:08.000Z (almost 3 years ago)
- Last Synced: 2025-04-04T09:51:07.415Z (about 1 year ago)
- Topics: certbot, certbot-aliyun, certbot-qcloud
- Language: Go
- Homepage: https://demo.cms.feehi.com
- Size: 12.7 KB
- Stars: 13
- Watchers: 1
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
let's encrypt Certbot hook written in golang
===============================
lets'encrypt的通配符https证书官方推荐使用certbot客户端获取。
certbot验证域名是否属于某人，通过产生一个随机字符串，让用户设置一个TXT记录到此值后，当验证成功后颁发证书。
该证书有效期为3个月，意味着每3个月得更新一次，每次手工设置dns解析及其麻烦，还容易忘记更新证书。
好在certbot提供了一个hook，产生随机后调用hook来自动设置dns记录，官方预制了几家dns服务商的hook，
但是国内的阿里云、腾讯云都不在此例。此插件支持国内阿里云、腾讯云等其他常用dns服务商，
使用golang编写，服务器无需搭建运行环境，直接下载二进制分发程序即可。
支持的DNS服务商
-------
- [x] 阿里云
- [x] 腾讯云
- [x] Namesilo
DNS服务商密钥获取
---------------
1. 阿里云进入管理后台，悬浮右上角的头像，点击下拉菜单的***accesskeys***进入用户信息管理的安全信息管理
AccessKey ID即为ali_AccessKey_ID
Access Key Secret 即为阿里云ACCESS_KEY_SECRET
2. 腾讯云进入管理后台，悬浮右上角账号，点击下拉菜单的***访问管理***，点击左侧的访问密钥，再点击API密钥管理
SecretId即为qcloud_SecretId
SecretKey即为qcloud_SecretKey
3. Namesilo Visit the API Manager page within your account for details
获取插件
---------------
1. 下载二进制发行版 [点此下载](https://resource-1251086492.cos.ap-shanghai.myqcloud.com/opensource/certbot-feehi-hook) 下载后请记得***chmod +x certbot-feehi-hook***给予执行权限
2. 源码编译安装
```bash
$ go get github.com/liufee/certbot-feehi-hook
$ cd $GOPATH/src/liufee/certbot-feehi-hook
$ sh build.sh
```
使用方式
---------------
>为了方便展示，以下shell命令安装均做了变形处理，如执行失败，请手动去掉换行符，将命令调整为单行
>以下示例命令均为dns解析在阿里云的，如果为腾讯云请将所有
--type=aliyun换成--type=qcloud
--ali_AccessKey_ID=阿里云ACCESS_KEY_ID 换成 --qcloud_SecretId=腾讯云secretId
--ali_Access_Key_Secret=阿里云ACCESS_KEY_SECRET 换成 --qcloud_SecretKey=腾讯云secretKey
1. 直接使用
1.1 安装certbot
```bash
$ wget https://dl.eff.org/certbot-auto && mv certbot-auto certbot && chmod +x certbot
$ mv certbot /usr/bin
```
1.2
```bash
$ certbot certonly
-d *.您的域名.com --manual --preferred-challenges dns
--manual-auth-hook "/存放certbot-feehi-hook的目录(下载的certboot-feehi-hook存放目录)/certbot-feehi-hook --type=aliyun --action=add --ali_AccessKey_ID=阿里云ACCESS_KEY_ID --ali_Access_Key_Secret=阿里云ACCESS_KEY_SECRET"
--manual-cleanup-hook "/hook/certbot-feehi-hook --type=aliyun --action=delete --ali_AccessKey_ID=阿里云ACCESS_KEY_ID --ali_Access_Key_Secret=阿里云ACCESS_KEY_SECRET"
```
2. 通过docker certbot/certbot官方镜像
* 申请证书
```bash
$ docker run -it --rm --name certbot
-v "/宿主机证书存放目录:/etc/letsencrypt"
-v "/tmp:/var/log/letsencrypt"
-v "/存放certbot-feehi-hook的目录(下载的certboot-feehi-hook存放目录):/hook"
certbot/certbot certonly
-d *.您的域名.com --manual --preferred-challenges dns
--manual-auth-hook "/hook/certbot-feehi-hook --type=aliyun --action=add --ali_AccessKey_ID=阿里云ACCESS_KEY_ID --ali_Access_Key_Secret=阿里云ACCESS_KEY_SECRET"
--manual-cleanup-hook "/hook/certbot-feehi-hook --type=aliyun --action=delete --ali_AccessKey_ID=阿里云ACCESS_KEY_ID --ali_Access_Key_Secret=阿里云ACCESS_KEY_SECRET"
```
* 更新证书
```bash
$ /path/to/docker run -it --rm --name certbot \
-v "/宿主机证书存放目录:/etc/letsencrypt" \
-v "/tmp:/var/log/letsencrypt"
-v "/存放certbot-feehi-hook的目录(下载的certboot-feehi-hook存放目录):/hook"
certbot/certbot renew
--manual --preferred-challenges dns
--manual-auth-hook "/hook/certbot-feehi-hook.sh --type=aliyun --action=add --ali_AccessKey_ID=阿里云ACCESS_KEY_ID --ali_Access_Key_Secret=阿里云ACCESS_KEY_SECRET"
--manual-cleanup-hook "/hook/certbot-feehi-hook.sh --type=aliyun --action=delete --ali_AccessKey_ID=阿里云ACCESS_KEY_ID --ali_Access_Key_Secret=阿里云ACCESS_KEY_SECRET"
--deploy-hook "service nginx restart"
```
可以配置定时任务每个月执行一次: 0 0 1 * * 上面的命令
当且仅当成功更新证书后会执行--deploy-hook,根据自身web服务器情况进行重启web服务器重新加载新证书
帮助
---------------
1. QQ群 258780872
2. 微信
3. Email job@feehi.com