{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/83", "result": {"data":{"issuesJson":{"id":"d108370a-c943-5eb5-b5f3-439712449692","title":"opsre/cloud_dns_exporter: 自动获取DNS提供商的域名及解析列表，同时自动获取每个域名解析的证书信息，并导出为Prometheus Metrics。","number":83,"bodyHTML":"

\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Repos	opsre/cloud_dns_exporter
Views	$\"views\"$
Stars	$\"stars\"$
Forks	$\"forks\"$
License	$\"license\"$
UpdatedAt	$\"last-commit\"$
CreatedAt	$\"create-at\"$

\n\n

\n

\n

\n

English | 简体中文

\n

\n

Cloud DNS Exporter

\n

$\"Auth\"$
\n $\"GitHub$
\n $\"GitHub$
\n $\"GitHub$
\n $\"HitCount\"$
\n $\"GitHub$
\n $\"\"$

\n

🧰 自动获取DNS提供商的域名及解析列表，同时自动获取每个域名解析的证书信息。🧰

\n

\n

\n

$\"cloud_dns_exporter\"$

\n\n

项目简介

\n

在我们维护网站的时候，偶尔可能会犯一些相对低级的错误，莫过于忘记更换域名证书而使网站无法访问。然而当我们记得并更换了证书，却又因为遗漏了某些解析而导致网站无法访问。这些都是令人难受的错误。

\n

这个项目，希望能够让你轻松掌握到每个域名解析的证书信息，从而在更换证书时，不会遗漏任何一个解析。

\n

支持多种 DNS 提供商，且支持单提供商多账号管理，同时支持自定义配置文件获取证书信息。

\n

如何使用

\n

可以直接在 Release 发布页面下载二进制，然后更改配置文件，直接运行即可。

\n

默认端口监听在 21798，为什么选择这个端口，因为项目对应在 Grafana 中的仪表板ID就是 21798。

\n

你也可以选择使用 Docker 部署，部署时把 config.yaml 在本地配置好，然后运行时，通过挂载(-v ./config.yaml:/app/config.yaml)覆盖容器内默认配置即可。

\n

镜像地址：

\n

国外: eryajf/cloud_dns_exporter
国内: registry.cn-hangzhou.aliyuncs.com/eryajf/cloud_dns_exporter

\n

目前应用还提供了-v参数，用于打印当前所使用的版本信息。

\n

快速体验

\n

本项目提供了 docker-compose.yml 配置文件用于快速体验。在启动前，请先在 docker-compose.yml 中配置好你的DNS服务商的AK/SK 相关信息，并确保你的 docker-compose 的版本不低于2.23.0。

\n

然后在docker-compose.yml所在目录下执行以下命令:

\n

docker-compose up -d

\n

\n
不懂docker-compose的用户,可以参考: docker-compose官方教程或中文教程
\n

\n

docker-compose.yml 中定义了三个容器，分别是:

\n

cloud_dns_exporter: 用于获取域名和解析/证书信息
grafana: 用于展示域名和解析/证书信息
prometheus: 用于持久化存储域名和解析/证书信息

\n

使用docker-compose.yml启动后，通过 http://localhost:3000 访问 Grafana，使用默认的用户名和密码admin/admin登录。

\n

Grafana 中添加 Prometheus 类型的数据源，地址为 http://prometheus:9090，然后保存。再导入Grafana Dashboard 21798，数据源选择刚才添加的 prometheus 数据源，即可看到 UI 展示效果。

\n

一些注意

\n

为了提高请求指标数据时的效率，项目设计为通过定时任务提前将数据缓存的方案，默认情况下，域名及解析记录信息为30s/次，证书信息在每天凌晨获取一次。如果你想重新获取，则重启一次应用即可。
解析记录的证书信息获取，会受限于不同的网络访问场景，因此请尽可能把本程序部署在能够访问所有解析记录的地方。
很多域名证书可能与域名没有match，是因为取到了所在负载服务监听的443对应的证书信息，可根据自己的情况选择忽略或进行处理。
因为域名注册与解析管理可能不在同一个云账号下，因此会存在 domain_list 指标中域名创建时间和到期时间标签为空的情况。

\n

\n
如果发现证书获取不准确或错误的情况，请提交issue交流。
\n

\n

指标说明

\n

本项目提供指标有如下几项：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

名称	说明
`domain_list`	域名列表
`record_list`	域名解析记录列表
`record_cert_info`	解析记录证书信息列表

\n

指标标签说明：

\n

<!-- 域名列表 -->\ndomain_list{\n    cloud_provider=\"DNS提供商\",\n    cloud_name=\"云账号名称\",\n    domain_id=\"域名ID\",\n    domain_name=\"域名\",\n    domain_remark=\"域名备注\",\n    domain_status=\"域名状态\",\n    create_data=\"域名创建日期\",\n    expiry_date=\"域名到期日期\"} 99 (此value为域名距离到期的天数)\n\n<!-- 域名记录列表 -->\nrecord_list{\n    cloud_provider=\"DNS提供商\",\n    cloud_name=\"云账号名称\",\n    domain_name=\"域名\",\n    record_id=\"记录ID\",\n    record_type=\"记录类型\",\n    record_name=\"记录\",\n    record_value=\"记录值\",\n    record_ttl=\"记录缓存时间\",\n    record_weight=\"记录权重\",\n    record_status=\"状态\",\n    record_remark=\"记录备注\",\n    update_time=\"更新时间\",\n    full_record=\"完整记录\"} 0\n\n<!-- 域名记录证书信息 -->\nrecord_cert_info{\n    cloud_provider=\"DNS提供商\",\n    cloud_name=\"云账号名称\",\n    domain_name=\"域名\",\n    record_id=\"记录ID\",\n    full_record=\"完整记录\",\n    subject_common_name=\"颁发对象CN(公用名)\",\n    subject_organization=\"颁发对象O(组织)\",\n    subject_organizational_unit=\"颁发对象OU(组织单位)\",\n    issuer_common_name=\"颁发者CN(公用名)\",\n    issuer_organization=\"颁发者O(组织)\",\n    issuer_organizational_unit=\"颁发者OU(组织单位)\",\n    created_date=\"颁发日期\",\n    expiry_date=\"过期日期\",\n    cert_matched=\"与主域名是否匹配\",\n    error_msg=\"错误信息\"} 30 (此value为记录的证书距离到期的天数)\n

\n

已支持 DNS 服务商

\n

Tencent DnsPod
Aliyun Dns
Godaddy
DNSLA
Amazon Route53
Cloudflare

\n

Grafana 仪表板

\n

项目对应的 Grafana Dashboard ID: 21798

\n

概览与域名列表：

\n

\n

解析记录与证书详情列表：

\n

\n

其他说明

\n

如果觉得项目不错，麻烦动动小手点个 ⭐️star⭐️!
如果你还有其他想法或者需求，欢迎在 issue 中交流！
特别欢迎贡献新的DNS服务商，我所遇到的场景并不全面，需要大家一起来完善项目。我花了大量的精力，让项目扩展一个新的模块儿变得非常容易，快行动起来吧。

\n

捐赠打赏

\n

如果你觉得这个项目对你有帮助，你可以请作者喝杯咖啡 ☕️

\n\n\n\n\n\n\n\n\n\n\n\n\n\n

支付宝	微信
$\"\"$	$\"\"$

","updatedAt":"2025-05-21T15:52:20Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"Prometheus-Exporter","color":"367acb"}},{"node":{"name":"opsre","color":"23f0d5"}}]},"comments":{"edges":[]}}},"pageContext":{"number":83,"previous":{"title":"clklog/clklog: 一款记录用户行为分析和画像的免费可商用开源软件，技术人员可快速搭建私有的应用系统。","number":82},"next":{"title":"yunionio/cloudpods: 开源、云原生的多云和混合云融合平台","number":84}}}, "staticQueryHashes": ["151096407","2861350382"]}