一个现代化的 DNS 聚合管理平台，前端使用 React + TailwindCSS，后端使用 Node.js + TypeScript。

• 多服务商支持: 可管理 18 家 DNS 服务商的解析记录：

  • 阿里云 (Aliyun), DNSPod (腾讯云), 华为云 (Huawei Cloud), 百度云 (Baidu Cloud)
  • 火山引擎 (Volcengine), 京东云 (JD Cloud), Cloudflare, DNS.LA
  • 西部数码 (West Digital), 青云 (Qingcloud), NameSilo, 宝塔面板 (BT Panel)
  • Spaceship, PowerDNS, 阿里云 ESA (Aliyun ESA), 腾讯 EdgeOne (Tencent EdgeOne)
  • DNSHE, 雨云 (Rainyun)

• 多用户与团队管理: 基于角色的访问控制（admin/member），团队共享域名

• 完整的 DNS 记录管理: 支持所有记录类型的增删改查（A、AAAA、CNAME、MX、TXT、SRV、CAA 等）

• 现代化 UI: React 18 + TailwindCSS，响应式设计

• API 文档: Swagger UI 位于 /api/docs

• 可扩展架构: 抽象 DNS 接口，易于添加新服务商

DNSMgr/
├── server/          # Node.js + TypeScript 后端
│   ├── src/
│   │   ├── lib/dns/ # DNS 服务商适配器（抽象接口）
│   │   ├── routes/  # REST API 路由
│   │   ├── middleware/ # 认证（JWT）、校验
│   │   ├── service/ # 业务逻辑服务
│   │   └── db/      # 三层数据库架构
│   │       ├── business-adapter.ts  # 业务适配器层（函数式 API）
│   │       ├── core/                # 数据库抽象层
│   │       ├── drivers/             # 数据库驱动（MySQL/PostgreSQL/SQLite）
│   │       └── schemas/             # 数据库 Schema
├── client/          # React + Vite + TailwindCSS 前端
    └── src/
        ├── pages/   # 页面
        ├── components/ # 复用组件
        └── api/     # API 客户端

DNSMgr 实现了严格的三层数据库架构：

路由/服务层 → 业务适配器层 → 核心层 → 驱动层 → 数据库

第一层：业务适配器层 (db/business-adapter.ts)

• 函数式 API：query()、get()、execute()、insert()、run()
• 业务操作模块：UserOperations、DnsAccountOperations 等
• 所有数据库操作必须通过此层
• 自动日志记录和性能监控

第二层：数据库抽象层 (db/core/)

• 统一类型定义
• 连接管理器（单例模式）
• 数据库配置管理

第三层：驱动层 (db/drivers/)

• MySQL 驱动（连接池）
• PostgreSQL 驱动（连接池）
• SQLite 驱动（better-sqlite3）

// ✅ 正确 - 使用业务适配器函数
import { query, get, execute, insert, UserOperations } from '../db';

const user = await get<User>('SELECT * FROM users WHERE id = ?', [userId]);
const users = await query<User>('SELECT * FROM users WHERE status = ?', ['active']);
const id = await insert('INSERT INTO users (name, email) VALUES (?, ?)', [name, email]);

// 使用业务操作模块
const user = await UserOperations.getById(1);

详见 ARCHITECTURE.md 获取详细架构文档。

• Node.js >= 18
• pnpm

pnpm install

使用单个命令同时启动前后端（分别运行在不同端口）：

# 同时启动后端（端口 3001）与前端（端口 5173）
pnpm dev

访问地址：http://localhost:5173

首次启动提示：如果系统尚未初始化，请访问初始化向导 http://localhost:5173/setup（单端口模式为 http://localhost:3001/setup）配置数据库并创建首个管理员。

在独立终端中分别启动前后端：

# 终端 1 - 仅后端（端口 3001）
cd server && pnpm dev

# 终端 2 - 仅前端（端口 5173）
cd client && pnpm dev

pnpm build

前后端在同一个端口（3001）运行 - 后端同时提供静态文件服务：

# 步骤 1：先构建前端
pnpm --filter client build

# 步骤 2：仅启动后端（同时提供 API 和前端页面，端口 3001）
cd server && pnpm dev

访问地址：http://localhost:3001

此模式适用于以下场景：

• 只需暴露一个端口
• 与 Docker 部署行为保持一致
• 简化反向代理配置

Docker 部署使用一体化模式（前后端合并在一个容器中）。

# 使用 GitHub Container Registry 的预构建镜像
docker run -d \
  -p 3001:3001 \
  -v $(pwd)/data:/app/data \
  --name dnsmgr \
  ghcr.io/hipm-tech/dnsmgr:latest

或使用 Docker Compose：

# 下载编排文件
curl -O https://raw.githubusercontent.com/HiPM-Tech/DNSMgr/main/docker-compose.yml

# 启动服务
docker-compose up -d

# 构建并运行
docker build -t dnsmgr .
docker run -d \
  -p 3001:3001 \
  -v $(pwd)/data:/app/data \
  --name dnsmgr \
  dnsmgr

访问地址：http://localhost:3001

将 .env.example 复制为 server/.env：

cp server/.env.example server/.env

变量	默认值	说明
PORT	3001	服务端端口
NODE_ENV	development	运行环境
JWT_SECRET	未设置	JWT 基础密钥；若不设置会回退到不安全默认值（生产环境必须设置）
DB_PATH	./dnsmgr.db	SQLite 数据库路径
DB_TYPE	sqlite	数据库类型：sqlite、mysql 或 postgresql
DB_HOST	-	数据库主机（MySQL/PostgreSQL 使用）
DB_PORT	-	数据库端口（MySQL/PostgreSQL 使用）
DB_NAME	-	数据库名称（MySQL/PostgreSQL 使用）
DB_USER	-	数据库用户（MySQL/PostgreSQL 使用）
DB_PASSWORD	-	数据库密码（MySQL/PostgreSQL 使用）
DB_SSL	false	MySQL/PostgreSQL 是否启用 SSL

• JWT 实际签名密钥为：JWT_SECRET + runtime_secret（runtime_secrets 表）。
• 若运行时密钥不存在，系统会自动生成并落库。
• 初始化流程创建首个管理员后，会主动轮换运行时密钥。
• 运行时密钥变化后，旧 JWT 会失效。

• /api/init/* 仅用于未初始化阶段。
• 当系统已初始化（数据库结构就绪且存在用户）后，/api/init/database 会返回 403，拒绝再次初始化。
• 管理员账号通过初始化向导/API（/api/init/admin）创建，不存在固定默认账号。

服务启动后访问：http://localhost:3001/api/docs

• DNS 记录仍保留通用 line 字段以兼容历史逻辑。
• 对于 Cloudflare，请使用请求/响应中的服务商专用字段：
  • cloudflare.proxied: 代理开关（true = 代理，false = 仅 DNS）
  • cloudflare.proxiable: 当前记录类型是否支持代理
• Cloudflare 创建/更新的优先级：
  • 如果提供 cloudflare.proxied，则优先使用
  • 否则回退到 line（'1' = 代理，'0' = 仅 DNS）

1. 在 server/src/lib/dns/providers/myprovider.ts 中创建新的适配器并实现 DnsAdapter
2. 在 server/src/lib/dns/DnsHelper.ts 中注册（加入 DNS_PROVIDERS 映射）
3. 在 server/src/lib/dns/providers/index.ts 中导出

适配器需要实现 DnsAdapter 接口：

interface DnsAdapter {
  check(): Promise<boolean>;
  getDomainList(...): Promise<PageResult<DomainInfo>>;
  getDomainRecords(...): Promise<PageResult<DnsRecord>>;
  addDomainRecord(...): Promise<string | null>;
  updateDomainRecord(...): Promise<boolean>;
  deleteDomainRecord(...): Promise<boolean>;
  setDomainRecordStatus(...): Promise<boolean>;
  // ...
}

创建/更新 DNS 账号时，API 会将 lego 风格 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

后端:

• Node.js + TypeScript
• Express.js
• SQLite (better-sqlite3)、MySQL (mysql2)、PostgreSQL (pg)
• JWT 认证
• Swagger/OpenAPI 文档

前端:

• React 18 + TypeScript
• Vite
• TailwindCSS v3
• React Router v6
• @tanstack/react-query
• Axios
• lucide-react

MIT

DNSMgr 使用 react-i18next 进行国际化（i18n）支持。目前已支持的语言包括：英文、简体中文、西班牙语和日语。

我们非常欢迎社区参与多语言的共建！如果你想添加新的语言支持，请参考以下步骤：

1. 复制现有的语言文件（例如 client/src/i18n/locales/zh-CN.ts）并重命名为新的语言代码，如 fr.ts（法语）。
2. 将文件中的对应字符串翻译为目标语言。
3. 在 client/src/i18n/index.ts 中引入你的新文件，并添加到 resources 对象中。
4. 在 client/src/pages/Settings.tsx 中的语言选择器里添加你的新语言选项。

提示： 我们强烈推荐使用 VS Code 插件 i18n-ally。本项目已经内置了 .vscode/settings.json 配置，你可以利用它直接在编辑器中查看翻译缺失情况并高效管理多语言键值。

我们开箱即支持多个 DNS 提供商（Cloudflare, 阿里云, 腾讯云, 华为云, DNSPod, GoDaddy）。如果你使用的提供商尚未支持，你可以很方便地自行添加：

1. 实现适配器：在 server/src/lib/dns/providers/ 下创建一个新文件，实现 DnsAdapter 接口。
2. 注册适配器：在 server/src/lib/dns/DnsHelper.ts 的工厂方法中添加你的适配器。
3. 更新前端：在 client/src/pages/Accounts.tsx 的 PROVIDERS 列表中添加你的提供商及其所需的配置字段。
4. 提交 PR：我们非常欢迎 Pull Requests！请确保你的代码符合现有的代码风格并能通过测试。