最近在archival工作时,我发现自己需要检查域的dns记录。
背景
archival pro 允许用户在存档站点上指向自定义域。为了为这些网站启用 https,我们在颁发 ssl 之前使用基于 txt 记录的域验证器来验证所有权。为了使这个过程更简单,我需要查询记录以检查 cname 和 txt 记录是否配置正确,如果不正确,则显示一些有用的消息。
在 node.js 或类似 c 的环境中,这非常简单,因为每个操作系统都有本地 dns 缓存和查找工具。但是,我在 cloudflare worker 中运行它,它实际上是 v8 隔离,因此无法访问操作系统的 dns 系统。事实上,即使打开了nodejs_compat,来自node的stdlib的dns库也只会返回一个空对象。
https 上的 dns
经过一些研究,我意识到现代 dns-over-https 非常适合解决这个问题,并且在我的狭隘案例之外也有用途。然而,对于这个用例,我不喜欢 npm 上的任何库 - 我想要的是更类似于 node 的 dns 库的东西,它抽象了查找服务器。
立即学习“Java免费学习笔记(深入)”;
cloudflare 提供了 dns-over-https 解决方案,您可以在此处阅读:https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/
此 api 的主要缺点是它对普通用户来说有点不透明 - 状态代码以映射到规范的数字形式返回,响应格式采用问答格式,并包含细粒度数据,虽然很有用,但对于大多数休闲使用来说有点过分了。
一个简单的包
为了让我自己和其他人更容易做到这一点,我发布了 cf-doh。
这是一个简单的库,可以让从浏览器、cloudflare 工作人员或 javascript 运行的任何其他地方查询记录变得超级简单。它取决于本机获取实现,并且如果您还没有,则允许设置一个,因此如果您愿意,您甚至可以在带有 polyfilled whatwg 获取实现的节点中运行 - 但是如果您在节点中,您也可以有 node:dns 这可能就是你想要的。
除了包装 fetch 调用之外,该库还提供整个规范的完整类型,处理带引号的字符串响应,并将 http 错误和状态响应转换为异常。
使用很简单:
import { querydns } from "cf-doh"; const records = await querydns("_verification.jesseditson.com", "txt"); records.foreach((r) => console.log(r));
如果您更喜欢键入值,您甚至可以导入所有有效的记录类型并使用它们而不是字符串:
import { querydns, dnsrecordtype } from "cf-doh"; const records = await querydns("_verification.jesseditson.com", dnsrecordtype.txt);
如果您想处理除 noerror 之外的状态,您可以使用较低级别的 api:
import { queryDNSRecords, DNSRecordType, DOHStatus, DOHStatusMessage } from "cf-doh"; const response = await queryDNSRecords("_verification.jesseditson.com", DNSRecordType.TXT); switch (response.status) { case DOHStatus.NoError: console.log("This record exists!"); break; case DOHStatus.NXDomain: console.log("Domain wasn't found"); break; default: console.log(DOHStatusMessage[response.status]); break; }
要将其添加到您的项目中,只需运行 npm install --save cf-doh。如果您对源代码或完整的 api 界面感到好奇,请查看存储库:
https://github.com/jesseditson/cf-doh
以上就是cf-doh:从前端 javascript 查找 DNS 记录的详细内容,更多请关注php中文网其它相关文章!