import { AbstractDnsProvider, CreateRecordOptions, DomainRecord, DnsResolveRecord, IsDnsProvider, RemoveRecordOptions } from "@certd/plugin-cert"; import { CloudflareAccess } from "./access.js"; import { Pager, PageRes, PageSearch } from "@certd/pipeline"; export type CloudflareRecord = { id: string; type: string; name: string; content: string; ttl: number; proxied: boolean; zone_id: string; zone_name: string; created_on: string; modified_on: string; }; // 这里通过IsDnsProvider注册一个dnsProvider @IsDnsProvider({ name: "cloudflare", title: "cloudflare", desc: "cloudflare dns provider", icon: "simple-icons:cloudflare", // 这里是对应的 cloudflare的access类型名称 accessType: "cloudflare", }) export class CloudflareDnsProvider extends AbstractDnsProvider { access!: CloudflareAccess; usePunyCode(): boolean { //是否使用punycode来添加解析记录 //默认都使用原始中文域名来添加 return true; } async onInstance() { //一些初始化的操作 // 也可以通过ctx成员变量传递context this.access = this.ctx.access as CloudflareAccess; } async getZoneId(domain: string) { this.logger.info("获取zoneId:", domain); const url = `https://api.cloudflare.com/client/v4/zones?name=${domain}`; const res = await this.access.doRequestApi(url, null, "get"); if (res.result.length === 0) { throw new Error(`未找到域名${domain}的zoneId`); } return res.result[0].id; } /** * 创建dns解析记录,用于验证域名所有权 */ async createRecord(options: CreateRecordOptions): Promise { /** * fullRecord: '_acme-challenge.test.example.com', * value: 一串uuid * type: 'TXT', * domain: 'example.com' */ const { fullRecord, value, type, domain } = options; this.logger.info("添加域名解析:", fullRecord, value, type, domain); const zoneId = await this.getZoneId(domain); this.logger.info("获取zoneId成功:", zoneId); // 给domain下创建txt类型的dns解析记录,fullRecord const url = `https://api.cloudflare.com/client/v4/zones/${zoneId}/dns_records`; const res = await this.access.doRequestApi(url, { content: value, name: fullRecord, type: type, ttl: 60, }); let record: any = null; if (res == null) { //重复的记录 this.logger.info(`dns解析记录重复,无需重复添加`); record = await this.findRecord(zoneId, options); } else { record = res.result as CloudflareRecord; this.logger.info(`添加域名解析成功:fullRecord=${fullRecord},value=${value}`); this.logger.info(`dns解析记录:${JSON.stringify(record)}`); } //本接口需要返回本次创建的dns解析记录,这个记录会在删除的时候用到 record.zone_id = zoneId; return record; } async findRecord(zoneId: string, options: CreateRecordOptions): Promise { const { fullRecord, value } = options; const url = `https://api.cloudflare.com/client/v4/zones/${zoneId}/dns_records?type=TXT&name=${fullRecord}&content=${value}`; const res = await this.access.doRequestApi(url, null, "get"); if (res.result.length === 0) { return null; } return res.result[0] as CloudflareRecord; } /** * 删除dns解析记录,清理申请痕迹 * @param options */ async removeRecord(options: RemoveRecordOptions): Promise { const { fullRecord, value } = options.recordReq; const record = options.recordRes; this.logger.info("删除域名解析:", fullRecord, value); if (!record) { this.logger.info("record为空,不执行删除"); return; } //这里调用删除txt dns解析记录接口 const zoneId = record.zone_id; const recordId = record.id; const url = `https://api.cloudflare.com/client/v4/zones/${zoneId}/dns_records/${recordId}`; await this.access.doRequestApi(url, null, "delete"); this.logger.info(`删除域名解析成功:fullRecord=${fullRecord},value=${value}`); } async getDomainListPage(req: PageSearch): Promise> { const pager = new Pager(req); let url = `https://api.cloudflare.com/client/v4/zones?page=${pager.pageNo}&per_page=${pager.pageSize}`; if (req.searchKey) { url += `&name=${req.searchKey}`; } const ret = await this.access.doRequestApi(url, null, "get"); let list = ret.result || []; list = list.map((item: any) => ({ id: item.id, domain: item.name, })); const total = ret.result_info.total_count || list.length; return { total, list, }; } async getRecordListPage(domain: string, req: PageSearch): Promise> { const pager = new Pager(req); const zoneId = await this.getZoneId(domain); let url = `https://api.cloudflare.com/client/v4/zones/${zoneId}/dns_records?page=${pager.pageNo}&per_page=${pager.pageSize}`; if (req.searchKey) { url += `&name=${req.searchKey}`; } const ret = await this.access.doRequestApi(url, null, "get"); let list = ret.result || []; list = list.map((item: any) => { const hostRecord = item.name === domain ? "@" : item.name.slice(0, item.name.length - domain.length - 1); return { id: item.id, hostRecord, fullRecord: item.name, type: item.type, value: item.content, }; }); const total = ret.result_info.total_count || list.length; return { total, list, }; } } //实例化这个provider,将其自动注册到系统中 new CloudflareDnsProvider();