Porkbun+ACME免费SSL证书申请全攻略-代码聚汇网

Porkbun+ACME免费SSL证书申请全攻略

黎声旭·2026-08-13·阅读 23 GEO检测（免费）

ACME协议SSL证书Porkbun

|难度：普通|阅读约 10 分钟

1. 为什么选择Porkbun申请ACME证书？

最近在折腾HTTPS证书自动化管理时，发现Porkbun这家域名注册商对ACME协议的支持相当友好。相比传统CA机构动辄几百元的证书费用，通过ACME协议可以免费获取可信的SSL/TLS证书，特别适合个人开发者和小型项目使用。

Porkbun作为ICANN认证的域名注册商，其API完美支持ACME验证所需的DNS-01挑战方式。这意味着我们可以在不暴露服务器IP的情况下完成域名所有权验证，对于没有固定公网IP的开发环境特别实用。我实测从申请到签发全程不超过3分钟，比某些商业CA的人工审核流程高效得多。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. ACME证书申请前的准备工作

2.1 环境需求清单

在开始之前，请确保准备好以下要素：

有效的Porkbun账户（需完成邮箱和手机号验证）
已实名认证的域名（建议使用子域名进行测试）
能够运行ACME客户端的设备（Windows/macOS/Linux均可）
开放53端口的网络环境（DNS验证需要）

重要提示：Porkbun账户必须开启API访问权限。登录后进入Account - API Settings，勾选"Enable API Access"并记录下显示的API Key和Secret。

2.2 客户端工具选型

目前主流的ACME客户端有：

Certbot：Let's Encrypt官方推荐工具，适合大多数Linux服务器
acme.sh：纯Shell实现，跨平台支持更好
Win-acme：Windows原生客户端，带图形界面

考虑到操作简便性和跨平台需求，本文以acme.sh为例演示。它的优势在于：

单文件部署，无需Python环境
内置Porkbun DNS API支持
支持证书自动更新

3. 分步申请流程详解

3.1 安装acme.sh客户端

在Linux/macOS终端执行：

bash复制curl https://get.acme.sh | sh -s email=your@email.com

Windows系统可通过Git Bash或WSL运行相同命令。安装完成后需要重载环境变量：

bash复制source ~/.bashrc

3.2 配置Porkbun API凭证

新建一个专用配置文件：

bash复制mkdir -p ~/.acme.sh/porkbun
cat > ~/.acme.sh/porkbun/credential.ini <<EOF
Porkbun_Key="your_api_key"
Porkbun_Secret="your_api_secret"
EOF
chmod 600 ~/.acme.sh/porkbun/credential.ini

3.3 发起证书申请命令

执行核心申请指令（将example.com替换为你的域名）：

bash复制acme.sh --issue \
  --dns dns_porkbun \
  --dnssleep 60 \
  -d example.com \
  -d *.example.com

参数说明：

--dns dns_porkbun：指定使用Porkbun的DNS验证
--dnssleep 60：等待DNS记录传播的时间（秒）
-d：可同时申请主域名和通配符证书

4. 证书部署与管理技巧

4.1 证书文件位置

申请成功后，证书会存放在：

code复制~/.acme.sh/example.com/

包含以下关键文件：

fullchain.cer：完整证书链
example.com.key：私钥文件
example.com.cer：域名证书

4.2 自动更新配置

acme.sh默认会创建定时任务自动更新证书。如需手动触发更新：

bash复制acme.sh --renew -d example.com --force

推荐将证书导出到固定目录方便应用读取：

bash复制acme.sh --install-cert -d example.com \
  --key-file /etc/nginx/ssl/example.com.key \
  --fullchain-file /etc/nginx/ssl/fullchain.cer \
  --reloadcmd "systemctl reload nginx"

5. 常见问题排查指南

5.1 DNS记录未生效

若遇到"DNS timeout"或"Invalid DNS records"错误：

使用dig命令检查TXT记录：

bash复制dig _acme-challenge.example.com TXT

确认Porkbun控制面板的DNS记录已添加
适当增加--dnssleep参数值（建议120秒以上）

5.2 API权限问题

当看到"Authentication failed"错误时：

检查API Key/Secret是否正确
确认账户没有启用2FA验证（目前API不支持）
尝试在Porkbun后台重新生成API凭证

5.3 证书续期失败

自动续期失败的典型表现：

定时任务日志报错
证书过期前未更新

解决方案：

bash复制acme.sh --remove -d example.com  # 先清理旧配置
acme.sh --issue --dns dns_porkbun -d example.com  # 重新申请

6. 进阶配置与优化建议

6.1 多域名批量管理

对于需要管理大量域名的情况，可以编写批量处理脚本：

bash复制DOMAINS=(domain1.com domain2.net *.sub.domain3.org)
for domain in "${DOMAINS[@]}"; do
  acme.sh --issue --dns dns_porkbun -d "$domain"
done

6.2 证书格式转换

某些应用可能需要特定格式的证书：

转换为PKCS12格式（Java应用常用）：

bash复制openssl pkcs12 -export \
  -in fullchain.cer \
  -inkey example.com.key \
  -out example.com.p12

6.3 监控与告警设置

建议添加证书过期监控：

bash复制# 检查剩余有效天数
openssl x509 -in fullchain.cer -noout -enddate

可以结合crontab设置提前30天告警：

bash复制0 0 * * * openssl x509 -checkend 2592000 -noout -in /path/to/cert.pem || echo "证书即将过期"

通过Porkbun申请ACME证书最大的优势在于其稳定的API响应速度和清晰的文档支持。我在实际使用中发现，相比其他一些DNS服务商，Porkbun的API调用成功率更高，特别是在处理通配符证书时表现更为可靠。对于需要管理多个域名的开发者，这套方案可以节省大量证书管理时间。