Skip to content

快速上手 acme.sh 泛解析域名

安装 acme.sh

以本网站域名 hacxy.cn 为例

在服务器中执行安装命令

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

TIP

这一步会把 acme.sh 安装到你的 home 目录下~/.acme.sh/

之后可以手动创建 一个 shell 的 alias, 例如 .bashrc 方便你的使用:

alias acme.sh=~/.acme.sh/acme.sh

生成 DNSPod Token

登录 DNSPod https://www.dnspod.cn/login?s_url=https://console.dnspod.cn/

点击右上角头像(我的账号) => 安全设置 => 点击 API 密钥页面 => 点击进入 DNSPod token => 点击创建密钥 => 输入名称点击确认 => 保留弹窗中的 id 和 token 用作下一步

创建账户文件

在指定位置创建 account.conf 文件,或其他名称都可以,主要是为了记录 DNSPod 的 ID 和 Token 信息

sh
# 这里直接放到 .acme.sh 的目录下
vim ~/.acme.sh/account.conf

修改内容:

sh
export DP_Id="上个步骤中生成的 ID"
export DP_Key="上个步骤中生成的 Token"
# 开启自动升级
AUTO_UPGRADE='1'

修改完成保存退出

生成 ssl 证书

通过 accountconf 指定账户文件,也可以不通过此方式来做,可通过 export 环境变量的方式实现

sh
acme.sh --issue --accountconf ~/.acme.sh/account.conf --server letsencrypt --dns dns_dp -d hacxy.cn -d *.hacxy.cn -k ec-384 --debug

TIP

-d 指定证书中需要包含的域名信息

-k 指定密钥类型,这里使用了 ECDSA 算法,P-384 类型的密钥

--debug 是为了打印详细日志,方便出错时排查

安装和使用

证书签发后,可通过下方的命令快速安装到对应位置,我这里以 nginx 为例,安装到 /etc/ngtinx/ssl/hacxy.cn 目录下,后续配置 nginx 时,可直接使用该位置的证书

sh
acme.sh --install-cert -d hacxy.cn --ecc --key-file /etc/nginx/ssl/hacxy.cn/hacxy.cn.key  --fullchain-file /etc/nginx/ssl/hacxy.cn/fullchain.cer --reloadcmd "service nginx force-reload"

TIP

--reloadcmd 指定安装后强制更新 nginx

后续更新

可通过添加定时任务,在证书快到期时自动更新

sh
# 执行该命令,进入定时任务编辑界面
crontab -e

其他

移除不需要更新的或过时的站点证书:

sh
# --ecc 指定删除 ecc 密钥对的记录,默认会删除 RSA 密钥对的证书
acme.sh --remove -d hacxy.cn --ecc

Nginx https 站点配置示例:

server {
        listen       443 ssl;
        listen       [::]:443 ssl;
        server_name hacxy.cn www.hacxy.cn;
        ssl_certificate /etc/nginx/ssl/hacxy.cn/fullchain.cer;
        ssl_certificate_key /etc/nginx/ssl/hacxy.cn/hacxy.cn.key;
        ssl_session_cache shared:SSL:1m;
        ssl_session_timeout  10m;
        ssl_ciphers HIGH:!aNULL:!MD5;
        ssl_prefer_server_ciphers on;
        root /root/Projects/hacxy-blog;
        location / {
                index index.html index.htm;
                try_files $uri $uri/ /index.html;
        }
}

server {
        listen       80;
        listen       [::]:80;
        root /root/Projects/blog;
        server_name   hacxy.cn  www.hacxy.cn;

        location / {
                index index.html index.htm;
                try_files $uri $uri/ /index.html;
        }
        return 301 https://$host$request_uri;
}

上次更新于: