DNS 核心层架构

DNS 接口定义

文件位置: server/src/lib/dns/DnsInterface.ts

职责: 定义 DNS 服务商适配器的标准接口

核心接口

interface DnsAdapter {
  check(): Promise<boolean>
  getDomainList(page: number, pageSize: number): Promise<PageResult<DomainInfo>>
  getDomainRecords(domain: string, page: number, pageSize: number): Promise<PageResult<DnsRecord>>
  addDomainRecord(domain: string, record: DnsRecord): Promise<string | null>
  updateDomainRecord(domain: string, recordId: string, record: DnsRecord): Promise<boolean>
  deleteDomainRecord(domain: string, recordId: string): Promise<boolean>
  setDomainRecordStatus(domain: string, recordId: string, status: 'enable' | 'disable'): Promise<boolean>
  getError(): string
}

DNS 适配器工厂

文件位置: server/src/lib/dns/DnsHelper.ts

职责: 根据服务商类型创建对应的适配器实例

// 创建适配器实例
createAdapter(type: string, config: Record<string, string>, domain?: string, zoneId?: string): DnsAdapter

// 获取所有支持的服务商
getProviders(includeStub?: boolean): ProviderInfo[]

服务商注册表

文件位置: server/src/lib/dns/providers/registry.ts

职责: 集中管理所有 DNS 服务商的定义和配置

Provider 定义

export interface ProviderDefinition {
  type: string;
  name: string;
  capabilities: ProviderCapabilities;
  configFields: ProviderConfigField[];
  adapterFactory: (config: Record<string, string>) => DnsAdapter;
}

export interface ProviderCapabilities {
  remark: boolean;        // 支持备注
  status: boolean;        // 支持状态切换
  redirect: boolean;      // 支持重定向
  log: boolean;           // 支持日志
  weight: boolean;        // 支持权重
  line: boolean;          // 支持线路
  cnameFlattening: boolean; // 支持 CNAME 拉平
}

export interface ProviderConfigField {
  key: string;
  label: string;
  type: 'text' | 'password';
  required: boolean;
  group?: string;
}

支持的服务商列表

类型 名称 能力
aliyun 阿里云 status, log, line
dnspod 腾讯云-DNSPod status, log, line
huawei 华为云 status, line
baidu 百度云 status, line
huoshan 火山引擎 status, line
jdcloud 京东云 status, line
cloudflare Cloudflare remark, redirect, weight, line, cnameFlattening
dnsla DNS.LA status, weight, line
west 西部数码 status, line
qingcloud 青云 status, line
namesilo NameSilo line
bt 宝塔 status, line
spaceship Spaceship line
powerdns PowerDNS status, line
aliyunesa 阿里云ESA status, line
tencenteo 腾讯EdgeOne status, line
dnshe DNSHE line
rainyun 雨云 line

服务商别名映射

文件位置: server/src/lib/dns/providerAlias.ts

创建/更新 DNS 账号时，API 会将 lego-style provider 名称归一化为内部 provider 类型。

内部类型 支持别名
aliyun aliyun, alidns
aliyunesa aliesa
baidu baiducloud
huawei huaweicloud
huoshan huoshan, volcengine
west westcn
cloudflare cloudflare
jdcloud jdcloud
namesilo namesilo
rainyun rainyun
powerdns powerdns, pdns
dnspod dnspod, tencentcloud
tencenteo tencenteo, edgeone

添加新的 DNS 服务商

1. 创建适配器

在 server/src/lib/dns/providers/myprovider.ts 中创建新的适配器：

import { DnsAdapter, DomainInfo, DnsRecord, PageResult } from '../DnsInterface';

export class MyProviderAdapter implements DnsAdapter {
  private config: Record<string, string>;
  private error: string = '';

  constructor(config: Record<string, string>) {
    this.config = config;
  }

  async check(): Promise<boolean> {
    // 验证配置是否正确
    return true;
  }

  async getDomainList(page: number, pageSize: number): Promise<PageResult<DomainInfo>> {
    // 获取域名列表
    return { total: 0, list: [] };
  }

  async getDomainRecords(domain: string, page: number, pageSize: number): Promise<PageResult<DnsRecord>> {
    // 获取解析记录列表
    return { total: 0, list: [] };
  }

  async addDomainRecord(domain: string, record: DnsRecord): Promise<string | null> {
    // 添加解析记录
    return null;
  }

  async updateDomainRecord(domain: string, recordId: string, record: DnsRecord): Promise<boolean> {
    // 更新解析记录
    return false;
  }

  async deleteDomainRecord(domain: string, recordId: string): Promise<boolean> {
    // 删除解析记录
    return false;
  }

  async setDomainRecordStatus(domain: string, recordId: string, status: 'enable' | 'disable'): Promise<boolean> {
    // 设置记录状态
    return false;
  }

  getError(): string {
    return this.error;
  }
}

2. 注册到注册表

在 server/src/lib/dns/providers/registry.ts 中添加：

import { MyProviderAdapter } from './myprovider';

const providerDefinitions: ProviderDefinition[] = [
  // ... 其他服务商
  {
    type: 'myprovider',
    name: 'My Provider',
    capabilities: { remark: false, status: true, redirect: false, log: false, weight: false, line: true, cnameFlattening: false },
    configFields: [
      { key: 'apiKey', label: 'API Key', type: 'text', required: true },
      { key: 'apiSecret', label: 'API Secret', type: 'password', required: true },
    ],
    adapterFactory: (config) => new MyProviderAdapter(config),
  },
];

3. 导出适配器

在 server/src/lib/dns/providers/index.ts 中添加：

export { MyProviderAdapter } from './myprovider';

Cloudflare 特殊字段

DNS 记录仍保留通用 line 字段以兼容历史逻辑。对于 Cloudflare，请使用请求/响应中的服务商专用字段：

创建/更新优先级

  1. 如果提供 cloudflare.proxied，则优先使用
  2. 否则回退到 line（'1' = 代理，'0' = 仅 DNS）