# Certbot DNS 阿里云插件
这是一个用于 Certbot 的阿里云 DNS 插件，支持通过阿里云 DNS API 进行 DNS-01 验证来获取 SSL 证书。支持泛域名。
## 功能特性
- 支持通过阿里云DNS API自动管理DNS记录
- 支持泛域名
- 支持certbot 3 版本(更低没测试)
- 兼容 Python 3.8+(含)版本
- 支持 DNS-01 验证方式
- 自动清理临时DNS记录
- 完善的错误处理和日志记录
## 安装
### 从 PyPI 安装
```bash
pip3 install certbot-dns-aliyun-next
```
## 配置文件
```ini
dns_aliyun_next_access_key_id = ??
dns_aliyun_next_access_key_secret = ??
dns_aliyun_next_region_id = cn-hangzhou
```
修改配置文件权限(假如文件是~/aliyun.ini)
`chmod 600 ~/aliyun.ini`
## 运行
```bash
certbot certonly \
--authenticator dns-aliyun-next \
--dns-aliyun-next-credentials ~/aliyun.ini \
--dns-aliyun-next-propagation-seconds 30 \
-d "*.example.com" \
-d "example.com"
```
## 阿里云权限配置
确保您的阿里云AccessKey具有以下权限：
AliyunDNSFullAccess 或自定义权限策略包含：
* alidns:AddDomainRecord
* alidns:DeleteDomainRecord
* alidns:DescribeDomainRecords
* alidns:UpdateDomainRecord
Raw data
{
"_id": null,
"home_page": "https://github.com/tiyee/certbot-dns-aliyun-next",
"name": "certbot-dns-aliyun-next",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "certbot-dns, certbot-plugin, certbot-dns-plugin, certbot-dns-authenticator, certbot-aliyun",
"author": "tiyee",
"author_email": "tiyee <tiyee@live.com>",
"download_url": "https://files.pythonhosted.org/packages/09/24/aebf37cb48e927531495d29267b7ee70cb8c15c6f4eced1b03cebed4f128/certbot_dns_aliyun_next-1.0.6.tar.gz",
"platform": null,
"description": "# Certbot DNS \u963f\u91cc\u4e91\u63d2\u4ef6\n\n\u8fd9\u662f\u4e00\u4e2a\u7528\u4e8e Certbot \u7684\u963f\u91cc\u4e91 DNS \u63d2\u4ef6\uff0c\u652f\u6301\u901a\u8fc7\u963f\u91cc\u4e91 DNS API \u8fdb\u884c DNS-01 \u9a8c\u8bc1\u6765\u83b7\u53d6 SSL \u8bc1\u4e66\u3002\u652f\u6301\u6cdb\u57df\u540d\u3002\n\n## \u529f\u80fd\u7279\u6027\n\n- \u652f\u6301\u901a\u8fc7\u963f\u91cc\u4e91DNS API\u81ea\u52a8\u7ba1\u7406DNS\u8bb0\u5f55\n- \u652f\u6301\u6cdb\u57df\u540d\n- \u652f\u6301certbot 3 \u7248\u672c(\u66f4\u4f4e\u6ca1\u6d4b\u8bd5)\n- \u517c\u5bb9 Python 3.8+(\u542b)\u7248\u672c\n- \u652f\u6301 DNS-01 \u9a8c\u8bc1\u65b9\u5f0f\n- \u81ea\u52a8\u6e05\u7406\u4e34\u65f6DNS\u8bb0\u5f55\n- \u5b8c\u5584\u7684\u9519\u8bef\u5904\u7406\u548c\u65e5\u5fd7\u8bb0\u5f55\n\n## \u5b89\u88c5\n\n### \u4ece PyPI \u5b89\u88c5\n\n```bash\n\npip3 install certbot-dns-aliyun-next\n\n```\n\n## \u914d\u7f6e\u6587\u4ef6\n\n\n```ini\ndns_aliyun_next_access_key_id = ??\ndns_aliyun_next_access_key_secret = ??\ndns_aliyun_next_region_id = cn-hangzhou\n\n```\n\n\u4fee\u6539\u914d\u7f6e\u6587\u4ef6\u6743\u9650(\u5047\u5982\u6587\u4ef6\u662f~/aliyun.ini)\n\n`chmod 600 ~/aliyun.ini`\n\n\n## \u8fd0\u884c\n\n```bash\n\ncertbot certonly \\\n --authenticator dns-aliyun-next \\\n --dns-aliyun-next-credentials ~/aliyun.ini \\\n --dns-aliyun-next-propagation-seconds 30 \\\n -d \"*.example.com\" \\\n -d \"example.com\"\n\n```\n\n\n## \u963f\u91cc\u4e91\u6743\u9650\u914d\u7f6e\n\n\u786e\u4fdd\u60a8\u7684\u963f\u91cc\u4e91AccessKey\u5177\u6709\u4ee5\u4e0b\u6743\u9650\uff1a\n\nAliyunDNSFullAccess \u6216\u81ea\u5b9a\u4e49\u6743\u9650\u7b56\u7565\u5305\u542b\uff1a\n\n* alidns:AddDomainRecord\n* alidns:DeleteDomainRecord\n* alidns:DescribeDomainRecords\n* alidns:UpdateDomainRecord\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "\u963f\u91cc\u4e91DNS\u63d2\u4ef6\uff0c\u7528\u4e8eCertbot\u7684DNS-01\u9a8c\u8bc1",
"version": "1.0.6",
"project_urls": {
"Homepage": "https://github.com/tiyee/certbot-dns-aliyun-next",
"Issues": "https://github.com/tiyee/certbot-dns-aliyun-next/issues",
"Repository": "https://github.com/tiyee/certbot-dns-aliyun-next"
},
"split_keywords": [
"certbot-dns",
" certbot-plugin",
" certbot-dns-plugin",
" certbot-dns-authenticator",
" certbot-aliyun"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "2832bb8e8ffcd589713c8779d780169827ef6e2a958e30c384d828464681f7cb",
"md5": "e182c11cf2822a873a2ab0fa7bfc42a3",
"sha256": "b049d09e6475da801222b43e9ea45eda98e0dd1bd18d97da44e85ab962dfceec"
},
"downloads": -1,
"filename": "certbot_dns_aliyun_next-1.0.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e182c11cf2822a873a2ab0fa7bfc42a3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 7683,
"upload_time": "2025-07-30T11:28:33",
"upload_time_iso_8601": "2025-07-30T11:28:33.893993Z",
"url": "https://files.pythonhosted.org/packages/28/32/bb8e8ffcd589713c8779d780169827ef6e2a958e30c384d828464681f7cb/certbot_dns_aliyun_next-1.0.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0924aebf37cb48e927531495d29267b7ee70cb8c15c6f4eced1b03cebed4f128",
"md5": "67b6e43f2e303d98a19439e696b99fcf",
"sha256": "4b588f1cee0cf0f728749574691b721e2ebaf0785ab484e8405a5bcecd5598b6"
},
"downloads": -1,
"filename": "certbot_dns_aliyun_next-1.0.6.tar.gz",
"has_sig": false,
"md5_digest": "67b6e43f2e303d98a19439e696b99fcf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 6903,
"upload_time": "2025-07-30T11:28:35",
"upload_time_iso_8601": "2025-07-30T11:28:35.332009Z",
"url": "https://files.pythonhosted.org/packages/09/24/aebf37cb48e927531495d29267b7ee70cb8c15c6f4eced1b03cebed4f128/certbot_dns_aliyun_next-1.0.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-30 11:28:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tiyee",
"github_project": "certbot-dns-aliyun-next",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "certbot",
"specs": [
[
">=",
"3.0.0"
]
]
},
{
"name": "zope",
"specs": []
},
{
"name": "alibabacloud-alidns20150109",
"specs": [
[
">=",
"3.0.0"
]
]
},
{
"name": "alibabacloud-tea-openapi",
"specs": [
[
">=",
"0.3.0"
]
]
},
{
"name": "alibabacloud-tea-util",
"specs": [
[
">=",
"0.3.0"
]
]
},
{
"name": "alibabacloud-endpoint-util",
"specs": [
[
">=",
"0.0.3"
]
]
},
{
"name": "setuptools",
"specs": [
[
">=",
"60.0.0"
]
]
}
],
"lcname": "certbot-dns-aliyun-next"
}
JSON
