cf-doh：從前端 javascript 尋找 DNS 記錄

最近在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 庫的東西，它抽象化了查找伺服器。

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中文網其他相關文章！