前言
阿里云函数计算大大简化了开发部署的工作量, 用户只需聚焦于业务逻辑的开发,编写最重要的 "核心代码"; 不再需要关心服务器购买、负载均衡、自动伸缩等运维操作; 极大地降低了服务搭建的复杂性,有效提升开发和迭代的速度。
但是在使用过程中发现,对SSL证书的支持需要支付额外费用, 具体体现在
- 免费证书从原来的1年免费缩短到3个月, 极大增加了维护工作量。 所有1年有效期的证书都需要收费。
- 自动化的托管SSL部署需要额外收费。 否则只能手动部署,也太痛苦了。
上面这笔费用虽然不多, 但对于小微企业/个人开发者来说也是一笔费用。因此设法实现了一套全自动, 全免费的SSL证书申请, 续证并部署到函数计算的方案。
基本思路
- 自动向Let's Encrypt申请ssl证书
- 用阿里云OpenAPI提供的updatecustomdomain,自动更新证书
- 证书到期之前自动申请新的ssl证书
系统环境
本人用的系统环境描述如下:
- 服务端,FastAPI, Python 3.10, Linux
- 开发者电脑, Windows 11, Win-Acme, Visual Studio, .NET Core
具体步骤
1. 自动向Let's Encrypt申请ssl证书
到win-acme官网下载并安装win-acme
官网下载分推荐版本和全插件版本,如果下载的是推荐版本,里面不包括dns验证插件,为了实现自动dns验证, 还需要单独下载岸装自动验证插件,我的域名托管在阿里云所以用阿里云插件,插件在这里下载, 仅需下载针对aliyun的即可。 其他域名服务商下载对应的插件。下载后解压缩到win-acme的根目录。
工具都准备好之后,以管理员身份启动Windows Command, 进入win-acme安装目录, 并运行
.\wacs.exe
在上述命令后面加上--verbose, 显示详细信息, 加上--nocache, 可在同一天内重复申请同一个域名(调试时特别有用)
启动后第一个界面如下
这里选择M
** 选择2或者直接Enter **
** 直接Enter选择默认**
这里选择2
此处要注意选择6, [dns] Create verification records in ALiYun DNS
** 然后win-acme问你所使用的阿里云dns服务器名称, 这里是名称列表, 复制粘贴过来
** 这里是询问阿里云OpenAPI的accessKey和accessSecret. 点击阿里云右上角的登录头像,然后选择"AccessKey 管理"。 可以创建accesskey. **
** 把accessKey和accessSecret复制粘贴过来,并根据提示保存到vault供以后使用。此处我在之前的操作中已经保存到了vault,所以直接使用了**
** Private Key类型, 直接选择默认**
** 选择证书存储位置,我们把证书保存为PEM文件,故选择2, 并提供文件位置c:\ssl\WinAcme**
** 输入证书密码,我选择不需要密码**
** 证书保存后的后续步骤, 这里先选择3,等准备好证书部署程序后再修改。 最后, 如果该host已经有了renew任务,还会询问是否覆盖。 选y覆盖已有, 选n创建新的renew任务**
最后,申请并下载证书成功, 在c:\ssl\WinAcme中可看到证书文件已经生成。
2. 用阿里云OpenAPI提供的updatecustomdomain接口,自动更新证书
接口文档在此处可以找到
预置条件
由于使用的是UpdateCustomDomain接口, 因此需要先配置好自定义域名, 但不需要启用Https证书,设置自定义域名比较简单,请自行查阅文档。不在此赘述。
使用OpenAPI调试工具,测试UpdateCustomDomain的调用结果。 调用成功后下载所擅长语言的sdk,直接获得可执行的脚本/程序。
但这样获得的脚本/程序只能做为测试用,放在生产环境还不行,因为Certificate和Private Key硬编码在代码中, 而最佳情况是从证书文件中直接读取。 此外还需要记录日志,方便以后排查。
因此我对C#版本的sdk程序做了以下改进
- 接收domain name做为输入参数
- appSettings中增加证书文件目录配置
- 用NLog记录日志
- 升级到了.net 6
修改后的代码下载地址: gitee.com/flyspirit99...
运行命令,进行测试
UpdateSsl.exe yourhost.yourdomain.com
通过查看日志中记录的OpenAPI请求返回的HttpStatusCode, 以及阿里云中显示的证书名,可以确认请求是否成功, 成功的请求会更新文件名为{yourhost.yourdomain.com}-yyyyMMddhhmmss
至此,完成了读取证书文件并更新函数的证书。
3.证书到期之前自动申请新的ssl证书
在第一步中实现证书申请时,win-acme自动生成一个renew任务, 该任务每天重复运行,检查证书日期,如果临近过期则重新申请。
但是重新申请的证书只是存放在指定目录中, 现在需要把前两步的工作连接起来。申请证书之后自动调用UpdateSsl程序。
当被询问
Which installation step should run first?:
选择2, 运行一个程序,填入自己的可执行目录路径
参数填写证书域名: yourhost.yourdomain.com
这样,当申请证书成功之后,会自动调用UpdateSsl把证书更新到函数上。
注意: 要把程序的sppSettings.json和NLog.config复制到win-acme根目录,因为此时的工作路径是win-acme目录。
最后
用上述方法可以扩展到申请任何你名下域名的证书, 或者通配符证书,并部署到函数计算。
全面费,全自动,完美。