Certbot DNS 腾讯云插件
这是一个用于 Certbot 的腾讯云 DNSPod 插件，支持通过腾讯云 DNSPod API 进行 DNS-01 验证来获取 SSL 证书。支持泛域名。
功能特性
- 支持通过腾讯云 DNSPod API 自动管理 DNS 记录
- 支持泛域名
- 支持 Certbot 3 和 5 版本
- 兼容 Python 3.9–3.14（Python 3.9 使用 Certbot 3，Python 3.14 使用 Certbot 5）
- 支持 DNS-01 验证方式
- 自动清理本次创建的临时 DNS 记录，保留已有记录
- 完善的错误处理和日志记录
安装
从 PyPI 安装
pip3 install certbot-dns-tencent
也可以使用 uv 安装（插件与 Certbot 在同一环境中）：
uv tool install --with certbot-dns-tencent "certbot>=5,<6"
Python 3.9 请安装 Certbot 3；已有 Certbot 环境应使用该环境的 Python 安装插件。
配置文件
dns_tencent_secret_id = ??
dns_tencent_secret_key = ??
使用临时凭证时，可额外配置 dns_tencent_token。
修改配置文件权限（假如文件是 ~/tencent.ini）：
chmod 600 ~/tencent.ini
运行
certbot certonly \
--authenticator dns-tencent \
--dns-tencent-credentials ~/tencent.ini \
--dns-tencent-propagation-seconds 30 \
-d "*.example.com" \
-d "example.com"
默认 TXT TTL 为 600 秒，可通过 --dns-tencent-ttl 调整；DNS 传播等待由 --dns-tencent-propagation-seconds 控制。
腾讯云权限配置
确保您的腾讯云 API 密钥（SecretId / SecretKey）具有 DNSPod 的管理权限：
QcloudDNSPodFullAccess，或自定义策略包含以下操作：
dnspod:DescribeDomainListdnspod:CreateRecorddnspod:DeleteRecorddnspod:DescribeRecordList
自动部署
此程序只是 certbot 的 DNS 验证插件，如果需要自动运行申请部署，可以使用 AutoCert。
1 maintainer
Metadata
1 maintainer
Release files for certbot-dns-tencent 2.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| certbot_dns_tencent-2.0.0.tar.gz | 116.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| certbot_dns_tencent-2.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 125.5 kB
Release files / certbot_dns_tencent-2.0.0.tar.gz
| Download URL | certbot_dns_tencent-2.0.0.tar.gz |
|---|---|
| Size | 116.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
eb3458638c1e6fb52d7a77bf7ef8e3b5cc9da1d451000c3b893ff43de1710155
|
|
BLAKE2b-256 checksum How to use checksums |
4db7d9772bf29ab3476d168e4270811ec06fc8ecaa5d4ba311eb50e7675da3fc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / certbot_dns_tencent-2.0.0-py3-none-any.whl
| Download URL | certbot_dns_tencent-2.0.0-py3-none-any.whl |
|---|---|
| Size | 8.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
286418848d6cd3050b6d2656588fa5f5bc3ffeae61e41ed26c1ec7baf20933ec
|
|
BLAKE2b-256 checksum How to use checksums |
e9e3095d2787bf63ae7b864c2df40f70ae62fe998261fd59e20e0d82d57c6aa5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency log
