小雫DNS 控制台
> 基于 DNSHE Free Domain API 的第三方子域名管理控制台
这是什么
小雫DNS 是一个完整的 DNSHE 子域名管理生态，让你不用忍受 DNSHE 原生 WHMCS 面板的繁琐逻辑，用更清爽的界面和更强大的 CLI 管理你的免费子域名。
包含四个部分：
- Web 控制台 — 浏览器内图形化管理界面
- Python CLI — pip install xndns，零依赖
- Node.js CLI — npm install -g xndns，零依赖
- 三种 API — REST / JSON-RPC / GraphQL
从哪开始
根据你的使用场景，选择对应的教程：
| 场景 | 去看哪里 |
|---|---|
| 我是新手，从头开始 | references/getting-started.md — 从注册 DNSHE 到第一次操作 |
| 我想用命令行 | references/cli-guide.md — CLI 完整使用教程 |
| 我想用 Web 界面 | references/web-guide.md — Web 控制台使用教程 |
| 我想写代码调用 API | references/api-guide.md — REST/RPC/GraphQL API 文档 |
| 我想用 Python SDK | references/sdk-guide.md — Python SDK 编程式调用 |
| 我想了解安全/法律 | references/legal.md — 隐私政策 + 用户协议 + 免责声明 |
| 我遇到了问题 | references/troubleshooting.md — 常见问题排查 |
快速开始（30 秒版）
如果你已经有 DNSHE 的 API Key 和 Secret：
# Python 用户
pip install xndns
xndns login cfsd_xxxxxxxxxxxxxxxx yyyyyyyyyyyyyyyyyyyy --host=https://dnshe.xiaona.cc.cd
xndns quota
# Node.js 用户
npm install -g xndns
xndns login cfsd_xxxxxxxxxxxxxxxx yyyyyyyyyyyyyyyyyyyy --host=https://dnshe.xiaona.cc.cd
xndns quota
或者直接打开 Web 控制台：https://dnshe.xiaona.cc.cd
没有 API Key？
去看 references/getting-started.md 的第 1 步，会教你如何在 DNSHE 客户中心创建 API Key。
核心功能一览
- 子域名管理：注册 / 续费 / 删除 / 搜索 / 筛选
- DNS 记录：A / AAAA / CNAME / MX / TXT / NS / SRV / CAA 全类型
- DNS 模板：一键配置邮箱(ImprovMX/Gmail) / GitHub Pages / Vercel 等
- API 密钥管理：创建 / 重置 / 删除
- WHOIS 查询：任意域名
- 配额查询：剩余可用配额
- 安装检测：检测任意域名是否部署了小雫DNS
- 自动 Fallback：主接口挂了自动切到官方 API
- 改包检测：防止安装了被篡改的版本
支持的根域名
cc.cd / de5.net / bot.cd / ccwu.cc / bbroot.com / ddns.ge / l.cd
相关链接
- Web 控制台: https://dnshe.xiaona.cc.cd
- API 文档: https://dnshe.xiaona.cc.cd/api-docs
- SDK 文档: https://dnshe.xiaona.cc.cd/sdk
- PyPI: https://pypi.org/project/xndns/
- npm: https://www.npmjs.com/package/xndns
- DNSHE 官方: https://my.dnshe.com
License
MIT
