阿里云好好的一年免费证书变成了3个月换新,还弄个限额,每年也就20张的量。目前心种子的网站算上子站点一共5个,每个季度换一张,一年20张的配额正好用完。既然够用,我也就忍了。
之后为了申请谷歌的广告联盟,开通了阿里云的全站加速,又得用ssl证书,完全不够用了好不好。用付费的证书,无论用哪种,费用都比我的服务器租金还贵。只能考虑其他方法来申请证书,优先考虑acme,貌似口碑不错。
以下内容部分摘自官方文档,并结合网上的其他内容和自己的实际操作整合而成。

1. 安装 acme.sh

安装很简单,一个命令:

curl https://get.acme.sh | sh -s email=my@example.com

普通用户和 root 用户都可以安装使用。

如果你用的是国内的VPS,可能会出现在线安装失败的情况,可以使用源码直接安装:

git clone https://github.com/acmesh-official/acme.sh.git
cd ./acme.sh
./acme.sh --install -m my@example.com

安装过程进行了以下几步:

  1. 把 acme.sh 安装到你的 home 目录下:

    ~/.acme.sh/

并创建 一个 shell 的 alias,例如 .bashrc,方便你的使用: alias acme.sh=~/.acme.sh/acme.sh

  1. 自动为你创建 cronjob,每天 0:00 点自动检测所有的证书,如果快过期了,需要更新,则会自动更新证书。

安装过程不会污染已有的系统任何功能和文件,所有的修改都限制在安装目录中: ~/.acme.sh/

2. 生成证书

acme.sh 实现了 acme 协议支持的所有验证协议。一般有两种方式验证: http 和 dns 验证。

1. http 方式需要在你的网站根目录下放置一个文件,来验证你的域名所有权,完成验证。然后就可以生成证书了。

acme.sh --issue -d mydomain.com -d www.mydomain.com --webroot /home/wwwroot/mydomain.com/

只需要指定域名,并指定域名所在的网站根目录。acme.sh 会全自动的生成验证文件,并放到网站的根目录,然后自动完成验证。最后会聪明地删除验证文件。整个过程没有任何副作用。

如果你用的 apache服务器,acme.sh 还可以智能的从 apache 的配置中自动完成验证,你不需要指定网站根目录:

acme.sh --issue -d mydomain.com --apache

如果你用的 nginx服务器,或者反代,acme.sh 还可以智能的从 nginx 的配置中自动完成验证,你不需要指定网站根目录:

acme.sh --issue -d mydomain.com --nginx

注意,无论是 apache 还是 nginx 模式,acme.sh在完成验证之后,会恢复到之前的状态,都不会私自更改你本身的配置。好处是你不用担心配置被搞坏,也有一个缺点,你需要自己配置 ssl 的配置,否则只能成功生成证书,你的网站还是无法访问https。但是为了安全,你还是自己手动改配置吧。

如果你还没有运行任何 web 服务,80 端口是空闲的,那么 acme.sh 还能假装自己是一个webserver,临时听在80 端口,完成验证:

acme.sh --issue -d mydomain.com --standalone

2. 手动 dns 方式,手动在域名上添加一条 txt 解析记录,验证域名所有权。

这种方式的好处是,你不需要任何服务器, 不需要任何公网 ip,只需要 dns 的解析记录即可完成验证。 坏处是,如果不同时配置 Automatic DNS API,使用这种方式 acme.sh 将无法自动更新证书,每次都需要手动再次重新解析验证域名所有权。

acme.sh --issue --dns -d mydomain.com \
 --yes-I-know-dns-manual-mode-enough-go-ahead-please

然后,acme.sh 会生成相应的解析记录显示出来,你只需要在你的域名管理面板中添加这条 txt 记录即可。

等待解析完成之后,重新生成证书:

acme.sh --renew -d mydomain.com \
  --yes-I-know-dns-manual-mode-enough-go-ahead-please

注意第二次这里用的是 --renew

dns 方式的真正强大之处在于可以使用域名解析商提供的 api 自动添加 txt 记录完成验证。

acme.sh 目前支持 cloudflare、dnspod、cloudxns、godaddy 以及 ovh 等数十种解析商的自动集成。

以 dnspod 为例,你需要先登录到 dnspod 账号,生成你的 api id 和 api key,都是免费的。然后:

export DP_Id="1234"

export DP_Key="sADDsdasdgdsf"

acme.sh --issue --dns dns_dp -d aa.com -d www.aa.com

证书就会自动生成了。这里给出的 api id 和 api key 会被自动记录下来,将来你在使用 dnspod api 的时候,就不需要再次指定了。直接生成就好了:

acme.sh --issue -d mydomain2.com --dns  dns_dp

3. copy/安装 证书

前面证书生成以后, 接下来需要把证书 copy 到真正需要用它的地方。

注意, 默认生成的证书都放在安装目录下: ~/.acme.sh/,请不要直接使用此目录下的文件,例如:不要直接让 nginx/apache 的配置文件使用这下面的文件。这里面的文件都是内部使用,而且目录结构可能会变化。

正确的使用方法是使用 --install-cert 命令,并指定目标位置,然后证书文件会被copy到相应的位置,例如:

Apache 示例

acme.sh --install-cert -d example.com \
--cert-file      /path/to/certfile/in/apache/cert.pem  \
--key-file       /path/to/keyfile/in/apache/key.pem  \
--fullchain-file /path/to/fullchain/certfile/apache/fullchain.pem \
--reloadcmd     "service apache2 force-reload"

Nginx 示例

acme.sh --install-cert -d example.com \
--key-file       /path/to/keyfile/in/nginx/key.pem  \
--fullchain-file /path/to/fullchain/nginx/cert.pem \
--reloadcmd     "service nginx force-reload"

(一点小提醒, 这里用的是 service nginx force-reload,不是 service nginx reload,据测试,reload 并不会重新加载证书,所以用的 force-reload

Nginx 的配置 ssl_certificate 使用 /etc/nginx/ssl/fullchain.cer ,而非 /etc/nginx/ssl/.cer ,否则 SSL Labs 的测试会报 Chain issues Incomplete 错误。

--install-cert命令可以携带很多参数,来指定目标文件。并且可以指定 reloadcmd,当证书更新以后,reloadcmd会被自动调用,让服务器生效。

值得注意的是,这里指定的所有参数都会被自动记录下来,并在将来证书自动更新以后,被再次自动调用。

4. 查看已安装证书信息

acme.sh --info -d example.com
# 会输出如下内容:
DOMAIN_CONF=/root/.acme.sh/example.com/example.com.conf
Le_Domain=example.com
Le_Alt=no
Le_Webroot=dns_ali
Le_PreHook=
Le_PostHook=
Le_RenewHook=
Le_API=https://acme-v02.api.letsencrypt.org/directory
Le_Keylength=
Le_OrderFinalize=https://acme-v02.api.letsencrypt.org/acme/finalize/23xxxx150/781xxxx4310
Le_LinkOrder=https://acme-v02.api.letsencrypt.org/acme/order/233xxx150/781xxxx4310
Le_LinkCert=https://acme-v02.api.letsencrypt.org/acme/cert/04cbd28xxxxxx349ecaea8d07
Le_CertCreateTime=1649358725
Le_CertCreateTimeStr=Thu Apr  7 19:12:05 UTC 2022
Le_NextRenewTimeStr=Mon Jun  6 19:12:05 UTC 2022
Le_NextRenewTime=1654456325
Le_RealCertPath=
Le_RealCACertPath=
Le_RealKeyPath=/etc/acme/example.com/privkey.pem
Le_ReloadCmd=service nginx force-reload
Le_RealFullChainPath=/etc/acme/example.com/chain.pem

5. 更新证书

目前证书在 60 天以后会自动更新,你无需任何操作。今后有可能会缩短这个时间,不过都是自动的,你不用关心。

请确保 cronjob 正确安装,看起来是类似这样的:

crontab  -l

56 * * * * "/root/.acme.sh"/acme.sh --cron --home "/root/.acme.sh" > /dev/null

6. 关于修改ReloadCmd

目前修改ReloadCmd没有专门的命令,可以通过重新安装证书来实现修改reloadCmd的目的。 此外,安装证书后,相关信息是保存在~/.acme.sh/example.com/example.conf文件下的,内容就是acme.sh --info -d example.com输出的信息,不过ReloadCmd在文件中使用了Base64编码。理论上可以通过直接修改该文件来修改ReloadCmd,且修改时,无需Base64编码,直接写命令原文acme.sh也可以识别。 不过,example.conf文件的位置和内容格式以后可能会改变!example.conf一直都是内部使用,后面有可能会改为用 sqlite 或者mysql 格式存储。所以一般不建议自己修改。

7. 更新 acme.sh

目前由于 acme 协议和 letsencrypt CA 都在频繁的更新,因此 acme.sh 也经常更新以保持同步。

升级 acme.sh 到最新版:

acme.sh --upgrade

如果你不想手动升级,可以开启自动升级:

acme.sh --upgrade --auto-upgrade

之后,acme.sh 就会自动保持更新了。

你也可以随时关闭自动更新:

acme.sh --upgrade --auto-upgrade  0

8. 出错怎么办

如果出错, 请添加 debug log:

acme.sh --issue  .....  --debug 

或者:

acme.sh --issue  .....  --debug  2

在DNS验证模式下如果debug中出现诸如"timed out"等字样可能是因为GFW拦截了相应请求,需要添加http(s) proxy环境变量。(请按照自己实际设定修改)

export http_proxy="socks5h://localhost:1081" && export https_proxy="socks5h://localhost:1081" 

9.查看/更新/删除 证书

  1. 查看安装证书 acme.sh --list

acme-list.png

  1. 如果需要手动续签,则执行acme.sh --renew -d example.com --force
  2. 删除证书 acme.sh remove <SAN_Domains>

10.其他相关设置

切换证书代理

acme目前默认的证书代理是ZeroSSL(从2021开始),虽说它和Let's Encrypt两者的差别不大,但从网上的某些信息来看,前者在申请证书时可能会遇到一些问题,此时可能就需要考虑切换到后者。

acme.sh --set-default-ca --server letsencrypt

当然acme除了上面提到的两个CA外,还包括另外几项,分别如下:

功能Let's EncryptBuypassZeroSSLSSL.comGoogle Public CA
有效期90天180天90天90天90天
多域名支持最多5个支持收费支持
泛域名支持支持支持收费支持
错误限制5次/时5次/时
SSL管理
ECC 证书链
客户支持论坛收费收费收费收费

切换方法也类似,只要将letsencrypt替换成buypasszerosslssl.comgoogle
注意:切换之后,只对新生成或新安装的证书有效,之前的因为已默认配置了ZeroSSL,所以并不会改变。
如果你只希望某个站点使用特定的CA,那么在生成时加入参数--server letsencrypt即可,比如:

acme.sh --issue -d mydomain.com -d www.mydomain.com --webroot /home/wwwroot/mydomain.com/ --server letsencrypt

有或没有www的设置

其实很多网站现在都将www省略,比如mindseed.cn和www.mindseed.cn指向的都是同一个网站。严格来说,这两者是有很大区别的,前者是属于主域名,而www则属于前者的子域名,就像wiki.mindseed.cn和tech.mindseed.cn,它们都属于同一级。当然站长和用户都默认带不带www指的就是同一个网站(通过重定向功能实现)。
所以在生成ssl证书的时候,需要将两个域名都包含进去,比如上面的示例:

acme.sh --issue -d mindseed.cn -d www.mindseed.cn -w /home/wwwroot/mindseed.cn/ 

此处,将--webroot-w替代。
使用acme.sh --list查看生成列表,Main_Domain显示的是mindseed.cn,SAN_Domains显示的www.mindseed.cn,见前文查看证书中的插图。
注意:如果带不带www都是指向同一个网站,一定不能只生成带www的那个,否则就算是使用重定向功能,可能还是会提示不安全。

泛域名的设置

在上面提到过使用DNS的方式来生成证书,同时这个方法可以用来申请泛域名并且支持自动更新。
首先获取阿里云的操作API 的 AccessKey ID和AccessKey Secret,

export Ali_Key="key值"
export Ali_Secret="key Secret"

给出的 api id 和 api key 会被自动记录下,下次就不用再次执行上述命令


acme.sh --issue --dns dns_ali -d *.example.com --force
最后修改:2024 年 04 月 27 日
如果觉得我的文章对你有用,请随意赞赏