1. 系统环境#

• CentOS 7 / 8（其他 Linux 发行版类似）
• 已安装 Nginx
• 域名 xhwen.cn 的 DNS 托管在阿里云

2. 确保 80 / 443 端口可用#

ss -ltnp | grep -E ':80|:443'

安装前说明#

• 不依赖 Python / Docker
• 不会修改系统配置
• 所有文件默认安装在当前用户目录（~/.acme.sh）
• 不需要 root 权限（推荐使用普通用户）

下载并安装 acme.sh#

先把脚本下载成文件，在服务器上执行：

cd /root
curl -L -o acme.sh.tar.gz https://github.com/acmesh-official/acme.sh/archive/refs/heads/master.tar.gz
ls -lh acme.sh.tar.gz

解压并安装

tar -xzf acme.sh.tar.gz
cd acme.sh-master
./acme.sh --install --home /root/.acme.sh

做成全局命令

ln -s /root/.acme.sh/acme.sh /usr/local/bin/acme.sh

验证是否安装成功#

ls -la /root/.acme.sh | head
ls -la /root/.acme.sh/dnsapi | head
acme.sh --version

你必须能看到：

• /root/.acme.sh/acme.sh 存在
• /root/.acme.sh/dnsapi/ 存在（里面会有很多 dns_*.sh，包括 dns_ali.sh）
• 能输出版本号

自动升级与定时任务说明#

acme.sh 在安装时会自动创建 cron 定时任务，用于：

• 定期检查证书是否即将过期
• 自动续期证书
• 在续期成功后执行你配置的 reload 命令（如重载 Nginx）

可以查看 cron 任务：

crontab -l

看到类似：

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

• 每天自动运行一次
• 不需要手动处理续期，acme.sh 会自动完成

（推荐）设置默认 CA 为 Let’s Encrypt

为了避免使用测试 CA，建议显式指定默认 CA：

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

创建阿里云 AccessKey#

登录阿里云控制台 → 右上角头像 → 访问控制（RAM）

创建 RAM 用户

• 登录名称：acme-dns（示例，随意）
• 显示名称：acme-dns
• 访问方式一定要勾选：编程访问（AccessKey），不需要勾选「控制台访问」

创建完成后，阿里云会 立刻显示：

• AccessKey ID
• AccessKey Secret

注意事项

请妥善保存 Secret，只会显示一次

给用户绑定 DNS 权限（最小权限原则）#

进入刚创建的用户 → 权限管理 → 添加权限：

推荐权限策略：

• AliyunDNSFullAccess

个人博客用这个策略就够了。

在服务器上配置环境变量（关键步骤）#

在服务器上执行（以 root 用户为例）：

export Ali_Key="你的AccessKeyID"
export Ali_Secret="你的AccessKeySecret"

将环境变量写入 bashrc

避免重启或新会话失效：

cat >> ~/.bashrc << 'EOF'
export Ali_Key="你的AccessKeyID"
export Ali_Secret="你的AccessKeySecret"
EOF

然后立即生效：

source ~/.bashrc

验证环境变量是否生效

echo $Ali_Key

如果能正确输出（不是空），说明配置成功。

使用 acme.sh 申请通配符证书#

acme.sh --issue \
  --dns dns_ali \
  -d xhwen.cn \
  -d '*.xhwen.cn'

说明:

• --issue：申请证书
• --dns dns_ali：使用阿里云 DNS 插件
• -d xhwen.cn：主域名
• -d '*.xhwen.cn'：通配符子域名

执行过程中，acme.sh 会自动调用阿里云 DNS API、创建 TXT 记录、等 Let’s Encrypt 验证、验证完删除 TXT 记录。

申请成功的标志#

如果成功，你会看到类似输出（关键信息）：

Your cert is in: /root/.acme.sh/xhwen.cn/xhwen.cn.cer
Your key is in: /root/.acme.sh/xhwen.cn/xhwen.cn.key
The intermediate CA cert is in: /root/.acme.sh/xhwen.cn/ca.cer
And the full chain certs is there: /root/.acme.sh/xhwen.cn/fullchain.cer

并且没有 error / failed 字样。

这一步完成后，证书已经成功签发，但还没有部署到 Nginx。

查看当前已签发的证书#

acme.sh --list

你会看到类似输出（关键信息）：

Main_Domain: xhwen.cn
SAN_Domains: *.xhwen.cn

说明通配符证书已生效。

创建 Nginx 证书目录#

mkdir -p /etc/nginx/ssl/xhwen.cn

推荐目录结构：

/etc/nginx/ssl/
└── xhwen.cn/
    ├── fullchain.pem
    └── privkey.pem

使用 acme.sh 安装证书#

由于我申请的是 ECC 证书，所以必须带上 --ecc 参数。

acme.sh --install-cert \
  -d xhwen.cn \
  --ecc \
  --key-file       /etc/nginx/ssl/xhwen.cn/privkey.pem \
  --fullchain-file /etc/nginx/ssl/xhwen.cn/fullchain.pem \
  --reloadcmd     "nginx -s reload"

注册自动续期回调：证书续期成功后自动执行 nginx -s reload，更新过程 Nginx 不会中断服务。

执行一次模拟续期：

acme.sh --renew -d xhwen.cn --ecc --force

能在输出中看到：

Reloading nginx

并且 Nginx 没有报错。

配置 Nginx 使用证书#

编辑站点配置文件（示例）：

vi /etc/nginx/conf.d/blog.conf

配置 HTTPS 服务器（443 端口）并把 80 重定向到 https#

1
# 80 端口：强制跳转到 HTTPS
2
server {
3
    listen 80;
4
    server_name xhwen.cn blog.xhwen.cn;
5

6
    return 301 https://$host$request_uri;
7
}
8

9
# 443 端口：真正提供网站内容
10
server {
11
    listen 443 ssl http2;
12
    server_name xhwen.cn blog.xhwen.cn;
13

14
    # 证书（通配符证书也可以用在 blog.xhwen.cn，只要证书包含 *.xhwen.cn）
15
    ssl_certificate     /etc/nginx/ssl/xhwen.cn/fullchain.pem;
16
    ssl_certificate_key /etc/nginx/ssl/xhwen.cn/privkey.pem;
17

18
    # TLS 配置（够用且安全）
19
    ssl_protocols TLSv1.2 TLSv1.3;
20
    ssl_session_cache shared:SSL:10m;
21
    ssl_session_timeout 10m;
22

23
    # 其他配置...
24
}

验证 Nginx 配置并生效#

nginx -t
systemctl reload nginx

若看到：

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

说明配置无误。

浏览器验证#

访问 https://blog.xhwen.cn ，看到浏览器 🔒 锁标志，说明 HTTPS 配置成功。

命令行验证#

openssl s_client -connect xhwen.cn:443 -servername xhwen.cn

若看到：

• 证书链完整
• 使用 ECC（如 ECDSA）
• 没有证书错误

说明 HTTPS 配置成功。