Home
Softono

Kldns

Open source PHP
GitHub
488
Stars
214
Forks
11
Issues
18
Watchers
3 months
Last Commit
DNS & Domain Tools Internal Tools & Admin

 About Kldns

KLDNS 是一个面向二级域名分发场景的 DNS 管理系统，适用于主域开放、用户自助申请前缀、解析记录维护、积分控制、审核流和统一运维管理。

Platforms

Web Self-hosted

Languages

PHP

Links

Source Code

Need Help Installing Kldns?

We provide expert installation service for this software. Our team will install, configure, and secure Kldns on your server. plans start at just $30.

Hire an Expert
Published by
klsf
Visit View Profile

Kldns

View on GitHub

KLDNS 4.0.2

KLDNS 是一个面向二级域名分发场景的 DNS 管理系统，适用于主域开放、用户自助申请前缀、解析记录维护、积分控制、审核流和统一运维管理。

当前版本已经完成前后台 Vue 3 + Element Plus 重构，并补齐了主域解析类型限制、备案状态、审核流、开放 API、操作日志和多平台 DNS 接入能力。

核心能力

  • 多用户、多主域、多解析平台统一管理
  • 用户前台自助新增、修改、删除解析记录
  • 主域级别控制开放用户组、消耗积分、备案状态和说明文案
  • 主域级别限制可用解析类型
  • 主域级别支持自动通过或人工审核
  • 支持开放 API、API Token 管理和审核状态查询
  • 支持全站解析操作日志审计
  • 支持自动检测、异常内容巡检和记录清理
  • 前后台统一深色主题，适配桌面端和移动端

当前支持的解析平台

  • DNSPod
  • 阿里云 DNS
  • DNS.com
  • DNSLA
  • DnsDun
  • 西部数码
  • 华为云 DNS
  • 百度智能云 DNS
  • Amazon Route 53
  • Google Cloud DNS

技术栈

  • Laravel
  • Vue 3
  • Element Plus
  • MySQL

运行要求

  • PHP >= 8.2
  • MySQL 5.7+ 或兼容版本
  • 需要开启伪静态
  • 建议启用扩展：
    • OpenSSL
    • PDO
    • Mbstring
    • Tokenizer
    • XML
    • Ctype
    • JSON
    • BCMath

安装说明

  1. 将项目部署到站点目录。
  2. 确保入口为 public/index.php，或按当前项目部署方式正确指向 public/。
  3. 配置伪静态。
  4. 访问 /install 完成环境检测、数据库配置和初始化安装。
  5. 安装完成后，先进入后台配置 DNS 接口，再导入主域并设置开放策略。

Nginx

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Apache

确认启用 mod_rewrite，并允许 .htaccess 生效。

升级说明

如果你是从旧版本升级到 4.0.2，建议至少确认以下内容：

  1. 已执行对应升级 SQL。
  2. storage/install/version.php 已更新到 4.0.2。
  3. kldns_domains 表已存在以下字段：
    • record_types
    • review_mode
    • beian
  4. 已创建以下新表：
    • kldns_domain_record_reviews
    • kldns_api_tokens
    • kldns_operation_logs
  5. 已清理浏览器静态资源缓存。

如需手动补字段，可参考：

ALTER TABLE `kldns_domains`
ADD COLUMN `record_types` varchar(255) NOT NULL DEFAULT 'A,CNAME' AFTER `groups`,
ADD COLUMN `review_mode` tinyint(1) unsigned NOT NULL DEFAULT '0' AFTER `record_types`,
ADD COLUMN `beian` tinyint(1) unsigned NOT NULL DEFAULT '0' AFTER `review_mode`;

推荐初始化顺序

  1. 在“接口配置”中接入 DNS 平台
  2. 在“域名列表”中导入主域
  3. 设置用户组、可解析类型、备案状态、审核模式和积分策略
  4. 按需配置系统参数和自动检测
  5. 最后开放注册和前台自助解析

平台配置说明

  • 华为云 DNS：填写 AccessKeyId 和 SecretAccessKey
  • 百度智能云 DNS：填写 AccessKeyId 和 SecretAccessKey
  • Amazon Route 53：填写 AccessKeyId 和 SecretAccessKey，临时凭证再补 SessionToken
  • Google Cloud DNS：可选填写 ProjectId，并粘贴完整服务账号 JSON 到 ServiceAccountJson
  • 西部数码：填写 Username 和 ApiPassword

开放 API

用户可以在“用户中心 -> 开放 API”中创建令牌，并通过 Authorization: Bearer <token> 调用接口。

API 列表

  • GET /api/v1/domains 获取当前账号可用主域
  • GET /api/v1/records 获取当前账号解析记录
  • GET /api/v1/reviews 获取当前账号审核记录
  • POST /api/v1/records 新增解析记录
  • PUT /api/v1/records/{id} 修改解析记录
  • DELETE /api/v1/records/{id} 删除解析记录

如果主域开启人工审核，API 发起的新增、修改、删除也会先进入审核流程。

目录结构

  • app/：控制器、模型、服务和 DNS 平台适配器
  • resources/views/：前后台 Blade 页面
  • public/js/main.js：Vue 3 / Element Plus 公共运行层
  • public/css/style.css：全站主题与组件样式
  • install/：安装 SQL 与升级 SQL
  • storage/install/：安装后的数据库配置与版本信息

4.0.2 版本更新

  • 前后台统一重构到 Vue 3 + Element Plus
  • 移除 jQuery 和 layer 依赖
  • 全站表格、按钮、弹窗、表单样式统一
  • 移动端布局、侧栏和弹窗交互优化
  • 新增主域可用解析类型限制
  • 新增主域备案状态配置与前后台展示
  • 新增解析值前后端格式校验
  • 新增主域人工审核流
  • 新增用户审核记录页和后台审核处理页
  • 新增用户 API Token 管理与开放 API
  • 新增全站解析操作日志
  • 新增西部数码接入支持
  • 新增华为云 DNS、百度智能云 DNS、Amazon Route 53、Google Cloud DNS 接入支持
  • Google Cloud DNS 支持直接粘贴服务账号 JSON

反馈