终于有人把SSL证书申请做成了Python SDK：fastssl 项目体验记

兄弟们，我搞网站这么多年，最头疼的一件事就是给域名搞SSL证书。你说Let‘s Encrypt吧，免费是免费，但那套命令行工具、各种参数、环境变量，每次都得翻文档，稍微不注意就报错。特别是要搞泛域名证书，还要手动去DNS解析服务商那里加TXT记录，来回切换页面，眼睛都看花了。

直到前两天，我在逛GitHub的时候发现了一个叫 

 的Python SDK项目。好家伙，这玩意儿直接把证书申请、验证、下载变成几行Python代码了。我今天就用它申请了一个 

 的泛域名证书，整个过程丝滑得像德芙巧克力。

 就是 XinSSL 平台开放出来的Python工具包。你不需要在服务器上装乱七八糟的证书管理工具，也不用去搞什么复杂的ACME协议配置，只要在Python环境里 pip 装上这个包，拿着API Key就能干活了。它背后接了好几家CA机构，像Let‘s Encrypt、Google Trust Services、ZeroSSL都能选，自由度很高。

终于可以把证书申请流程写进自动化脚本里了

。以前每次证书快到期，都得手动操作一遍，现在直接脚本跑起来，甚至还能集成到CI/CD流水线里，省心省力。

第一步：申请证书，拿到订单号

拿到API Key之后，我第一件事就是跑申请流程。下面这段代码就是干这个活的，它会把订单创建好，然后把需要配置的DNS验证信息打印出来给你看。

from fastssl import FastSSLClient
 
client = FastSSLClient(api_key="xssl_9b3ae12dc3dcf21ae64f8e22646f225f573f86df31d9545d")
 
domain = "*.test.api.xinssl.com"
 
# 1. 申请证书（创建订单）
order = client.create_certificate(
    certificate_domain=domain,
    channel_type="letsencrypt",   # letsencrypt / google / zerossl
    validation_method="dns",      # dns / file
    days=90,
)
 
if not order.get("success"):
    raise SystemExit(f"申请失败：{order.get('message')}")
 
data = order["data"]
order_id = data["order_id"]
print(f"订单已创建：{order_id}")
print(f"品牌：{data.get('brand_name')}")
print(f"验证方式：{data.get('validate')}")
 
# 2. 获取验证值（DNS TXT 记录 或 文件验证信息）
challenge = client.get_challenge(order_id)
 
print("\n请按以下记录配置 DNS / 文件：")
for r in challenge.get("data", {}).get("records", []):
    print(f"  类型：{r.get('auth_type')}")
    print(f"  主机记录：{r.get('host_record')}")
    print(f"  完整记录：{r.get('host_full')}")
    print(f"  记录值：{r.get('value')}")
    print()
 
print(f"配置完成后，运行 step2_verify.py，并传入该 order_id：{order_id}")

 一定要保存好，后面验证和下载证书都得靠它。我一般直接复制粘贴到记事本里，或者干脆就把这个ID写死在下一阶段的脚本里，省事。

拿到DNS记录值之后，我就去我的域名解析控制台加了一条TXT记录。这里提醒一下各位，

泛域名证书的验证记录主机名一般是 

，别搞错了。记录加好之后，等个一两分钟让解析生效，然后跑下面这个验证脚本。

import sys
from fastssl import FastSSLClient
 
client = FastSSLClient(api_key="xssl_9b3ae12dc3dcf21ae64f8e22646f225f573f86df31d9545d")
 
# 从命令行读取，或直接写死
order_id = sys.argv[1] if len(sys.argv) > 1 else "XSSL799BF68FA3724283"
 
# 触发 CA 校验域名权属
verify = client.verify_certificate(order_id)
 
if not verify.get("success"):
    raise SystemExit(f"请求失败：{verify.get('message')}")
 
data = verify.get("data", {})
 
if data.get("verified"):
    print(f"✓ 验证通过，证书已签发，状态：{data.get('status')}")
    print(f"  到期时间：{data.get('expires_at')}")
    print(f"  运行 step3_get.py 获取证书内容：py example_step3_get.py {order_id}")
else:
    print(f"✗ 验证未通过，状态：{data.get('status')}")
    print("请按以下 challenge 记录继续配置后重试 (若解析添加成功请稍等几分钟和再尝试）：")
    for r in data.get("challenge", []):
        print(f"  {r.get('auth_type')} | {r.get('host_record')} = {r.get('value')}")


第一次跑的时候我没等解析生效就急着验证了，结果返回的是验证未通过。后来等了两分钟再跑，马上就提示 

第三步：下载证书，拿到PEM和私钥

验证通过之后，证书就已经在CA那边签好了。最后一步就是把证书内容拉回来，fastssl 提供了两种方式：一种是直接输出证书PEM、证书链和私钥的文本，另一种是直接下载ZIP包。我比较喜欢直接拿文本，方便放到Nginx或者Apache的配置文件里。

import sys
from fastssl import FastSSLClient
 
client = FastSSLClient(api_key="xssl_9b3ae12dc3dcf21ae64f8e22646f225f573f86df31d9545d")
 
order_id = sys.argv[1] if len(sys.argv) > 1 else "XSSL799BF68FA3724283"
 
# 1. 获取证书 PEM / Bundle / 私钥
cert = client.get_certificate(order_id)
 
if not cert.get("success"):
    raise SystemExit(f"获取失败：{cert.get('message')}")
 
data = cert["data"]
print(f"订单：{data.get('order_id')}")
print(f"域名：{data.get('domain')}")
print(f"状态：{data.get('status')}")
print(f"到期：{data.get('expires_at')}")
 
print("\n证书（certificate）：")
print(data.get("certificate", ""))
print("\n证书链（certificate_bundle）：")
print(data.get("certificate_bundle", ""))
print("\n私钥（private_key）：")
print(data.get("private_key", ""))
 
# 2. 也可下载 ZIP 包（取消注释即可）
# client.download_certificate(order_id, f"{data.get('domain')}.zip")
# print(f"\nZIP 已下载到 {data.get('domain')}.zip")

跑完这段脚本，证书和私钥就整整齐齐地打印在屏幕上了。我直接复制粘贴到服务器的证书文件里，重启一下Nginx，网站秒变绿锁。

用了一天下来，fastssl 有几个地方让我觉得特别舒服：

如果你跟我一样经常跟证书打交道，或者想把证书申请流程自动化，fastssl 绝对值得一试。尤其是配合上Python的定时任务，每三个月自动续签一次，再也不用半夜爬起来折腾证书了。

API Key 千万别直接写在代码里传到公开仓库

，最好用环境变量或者配置文件单独管理。安全第一嘛。

好了，我要去把剩下的几个子域名也配上证书了。各位如果感兴趣，可以尝试看看，拿到API Key开始玩耍了。下一篇我准备研究一下怎么把它集成到Docker容器启动脚本里，到时候再来分享。

fastssl 项目体验记

编程语言

开发工具

安全

fastssl Python SDK让SSL证书申请自动化变得前所未有的简单，只需几行代码即可完成泛域名证书的申请、DNS验证和下载。支持Let's Encrypt、Google Trust Services、ZeroSSL多家CA，可轻松集成CI/CD流程，实现证书到期自动续签，大幅提升运维效率。

命令行工具

服务器

容器

Python

GitHub

Nginx

2026上云采购 | AI焕新·智启新局

热销域名限时优惠，新客首年免费！


domain

DNS解析新购特惠59元起，续费优惠低至5.3折！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

fastssl 项目体验记

fastssl 项目体验记

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐