面向个人开发者与小型网站的Namecheap DNS管理工具。支持A/CNAME/ MX/TXT等常用DNS记录的创建、查询、更新与删除。Use when 需要代码生成、编程辅助、调试测试、开发部署时使用。不适用于无明确技术栈的模糊需求。Use when 需要代码生成、编程辅助、调试测试、开发部署时使用。不适用于无明确技术栈的模糊需求。
编程
域名DNS管理免费版
试用域名DNS管控免费版是一款面向个人开发者与小团队的域名管控Skill,封装Cloudflare、DNSimple、Namecheap三大平台的常用操作。Use. 适用于需要domain dns manager相关能力的开发场景,包含结构化的工作流程和可复用的模板,帮助用户快速完成任务并保持代码质量.
它能做什么
域名DNS管控免费版是一款面向个人开发者与小团队的域名管控Skill,封装Cloudflare、DNSimple、Namecheap三大平台的常用操作。Use. 适用于需要domain dns manager相关能力的开发场景,包含结构化的工作流程和可复用的模板,帮助用户快速完成任务并保持代码质量.
技能文档
域名DNS管理免费版(Domain DNS Manager Free)
概述
管理多个域名注册商与DNS服务商是一件繁琐的事:登录不同控制台、切换不同界面、记住不同操作流程。本Skill将Cloudflare、DNSimple、Namecheap三大平台的常用操作统一为标准化工作流,配合验证步骤确保每步操作正确生效. 设计原则:
- 标准流程:统一的接入、配置、验证三步工作流
- 可验证:每步操作后用dig确认生效,不靠"应该好了"
- 可回滚:记录操作前状态,支持快速回退
- 安全优先:API Token通过环境变量管理,不硬编码
核心能力
支持的平台与操作
| 平台 | 接入域名 | DNS记录管理 | Nameserver切换 | HTTPS重定向 |
|---|---|---|---|---|
| Cloudflare | ✅ 创建zone | ✅ 增删改查 | ✅ | ✅ Page Rule |
| DNSimple | ✅ 查询域名 | ✅ 增删改查 | ✅ | ❌ |
| Namecheap | ✅ 查询域名 | ❌(需通过CF) | ✅ | ❌ |
处理: 解析支持的平台与操作的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回支持的平台与操作的响应数据,包含状态码、结果和日志.
DNS记录类型支持
| 记录类型 | 用途 | 示例 |
|---|---|---|
| A | IPv4指向 | example.com → 192.0.2.1 |
| AAAA | IPv6指向 | example.com → 2001:db8::1 |
| CNAME | 别名指向 | www → example.com |
| MX | 邮件服务器 | example.com → mail.example.com |
| TXT | 文本记录 | SPF/DKIM/DMARC/验证 |
| NS | 域名服务器 | 委托子域 |
处理: 解析DNS记录类型支持的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回DNS记录类型支持的响应数据,包含状态码、结果和日志.
核心功能执行
用input_params参数进行配置.
处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志.
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作 能力覆盖范围:本skill的核心能力覆盖以下场景关键词:的域名与、支持单域名接入与、基础记录操作、管理免费版是一款、面向个人开发者与、小团队的域名管理、三大平台的常用操、Use、when、需要项目管理、任务规划、进度跟踪、团队协作时使用、不适用于实际人员、绩效评估、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.
使用场景
场景一:新域名接入Cloudflare
购买新域名后,需要接入Cloudflare享受CDN与防护。标准流程:(1)Cloudflare创建zone;(2)在注册商切换nameserver到Cloudflare;(3)配置DNS记录;(4)验证生效.
场景二:配置HTTPS重定向
将http://example.com重定向到https://example.com。使用Cloudflare Page Rule,一条规则搞定全站HTTPS.
场景三:添加邮件DNS记录
配置企业邮箱时,需要添加MX记录指向邮件服务器,TXT记录配置SPF防止伪造。本Skill提供标准配置模板.
场景四:域名迁移
将域名从旧DNS迁移到新DNS。先在新DNS配置好所有记录,再切换nameserver,确保迁移过程中服务不中断.
场景五:开发调试DNS
开发环境需要临时DNS记录指向本地服务器。快速添加A记录,调试完成后删除,避免影响生产.
快速开始
120秒上手
- 配置API Token:设置Cloudflare/DNSimple/Namecheap的环境变量
- 确认域名注册商:查询域名的当前注册商与nameserver
- 执行操作:按标准工作流接入或配置DNS
- 验证生效:用dig确认DNS记录已生效
标准接入流程
步骤1:Cloudflare创建zone
输入格式
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | 域名DNS管理免费版处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
cli4 --post name=example.com /zones
步骤2:确认zone创建
cli4 --get name=example.com /zones
步骤3:切换nameserver(以Namecheap为例)
# 将nameserver切换到Cloudflare
namecheap-set-ns example.com emma.ns.cloudflare.com scott.ns.cloudflare.com
步骤4:配置DNS记录
# 添加A记录(指向Cloudflare代理IP)
cli4 --post type=A name=example.com content=192.0.2.1 proxied=true /zones/:zone_id/dns_records
# ...
# 添加CNAME记录
cli4 --post type=CNAME name=www content=example.com proxied=true /zones/:zone_id/dns_records
步骤5:配置HTTPS重定向
# Page Rule: HTTP -> HTTPS
cli4 --post targets=example.com/* actions=ssl=off,redirect_to=https://example.com /zones/:zone_id/pagerules
步骤6:验证
# DNS验证
dig +short example.com @1.1.1.1
# ...
# HTTPS重定向验证
curl -I https://example.com
# 期望返回 301 重定向
示例
API Token配置
# Cloudflare Token(二选一)
export CLOUDFLARE_API_TOKEN="${KEY:?请设置环境变量}"_here"
# 或
export CF_API_TOKEN="${KEY:?请设置环境变量}"_here"
# ...
# DNSimple Token
export DNSIMPLE_ACCESS_TOKEN=${ACCESS_TOKEN:?请设置环境变量}
# ...
# Namecheap API
export NAMECHEAP_API_USER="your_username"
export NAMECHEAP_API_KEY=${API_KEY:?请设置环境变量}
DNS记录配置模板
企业邮件配置:
| 记录 | 类型 | 值 | 说明 |
|---|---|---|---|
| example.com | MX | 10 mail.example.com | 邮件服务器 |
| example.com | TXT | "v=spf1 include:_spf.example.com ~all" | SPF防伪造 |
| dkim._domainkey | TXT | "v=DKIM1; k=rsa; p=MIGfMA0..." | DKIM签名 |
| _dmarc | TXT | "v=DMARC1; p=quarantine; rua=mailto:..." | DMARC策略 |
网站接入配置:
| 记录(续) | 类型 | 值 | 说明 |
|---|---|---|---|
| example.com | A | 192.0.2.1 | 主域名(Cloudflare代理) |
| www | CNAME | example.com | www别名 |
| api | A | 203.0.113.50 | API服务器(不代理) |
| cdn | CNAME | cdn.provider.com | CDN指向 |
Cloudflare代理IP说明
使用Cloudflare代理时,A记录可使用以下占位IP(Cloudflare会自动替换为实际代理IP):
192.0.2.1- 用于DNS占位,确保HTTPS可终止
优秀实践
- 先配置后切换:在新DNS配好所有记录后再切换nameserver,避免服务中断
- 逐项验证:每添加一条记录后用dig验证,不要批量添加后才发现问题
- TTL设置:临时调试用短TTL(60秒),生产环境用默认TTL(300秒)
- 代理状态:对外服务开启Cloudflare代理(橙色云),内部服务关闭代理(灰色云)
- HTTPS强制:接入Cloudflare后开启"Always Use HTTPS",全站强制加密
- API Token权限:Cloudflare Token仅授予需要的zone权限,最小权限原则
- 操作记录:保留操作命令记录,便于回溯与审计
- nameserver确认:切换nameserver后等待全球生效(通常24-48小时)
常见问题
Q1:nameserver切换后多久生效?
A:通常24-48小时全球生效。可通过dig @1.1.1.1 example.com NS与dig @8.8.8.8 example.com NS对比不同DNS的返回结果判断生效进度.
Q2:Cloudflare显示"invalid nameservers"?
A:确认域名注册商是否正确。常见错误是在错误的注册商控制台修改nameserver。先通过WHOIS查询确认注册商.
Q3:能批量管理多个域名吗?
A:免费版支持单域名操作。批量域名接入、多供应商编排属于专业版能力,详见domain-dns-manager-pro.
Q4:支持Worker路由配置吗?
A:免费版仅支持Page Rule重定向。Worker路由、Rulesets、Bulk Redirects属于专业版能力.
Q5:DNS记录修改后多久生效?
A:取决于记录TTL。TTL未过期前各DNS返回缓存值。可使用短TTL(60秒)加快生效,或等待TTL自然过期.
Q6:如何关闭"Block AI Bots"?
A:在Cloudflare控制台或使用API:cloudflare-ai-bots disable。部分场景下AI爬虫访问需要放行.
已知限制
本免费体验版限制以下高级功能:
- ❌ 批量域名管理(>1个域名/次)
- ❌ 多供应商编排与切换
- ❌ Worker路由配置
- ❌ Rulesets与Bulk Redirects
- ❌ DNS变更审计日志
- ❌ 定时健康检查与告警
- ❌ 变更回滚机制
- ❌ 多账号管理
解锁全部功能请使用专业版:domain-dns-manager-pro
- 当前为免费版本,如需完整功能请升级到付费版获取全部能力
依赖说明
运行环境
- Agent平台:支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统:Linux / macOS / Windows
- 网络:可访问Cloudflare/DNSimple/Namecheap API
依赖详情
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent平台内置LLM提供 |
| cli4 | CLI工具 | Cloudflare操作必需 | pip install cloudflare-cli4 |
| dig | 系统命令 | 验证必需 | 安装bind-utils或dnsutils |
| curl | 系统命令 | 验证必需 | 系统自带 |
| jq | 系统命令 | 可选 | sudo apt install jq |
API Key 配置
- Cloudflare Token:通过环境变量
CLOUDFLARE_API_TOKEN或CF_API_TOKEN配置 - DNSimple Token:通过环境变量
DNSIMPLE_ACCESS_TOKEN配置 - Namecheap API:通过环境变量
NAMECHEAP_API_USER与NAMECHEAP_API_KEY配置 - 禁止:在SKILL.md或脚本中硬编码API Token
- 建议:Token存储在
./.env或系统密钥管理器中
可用性分类
- 分类:MD+EXEC(Markdown指令驱动,API调用与验证需要exec命令行能力)
- 说明:域名DNS管理Skill,支持Cloudflare/DNSimple/Namecheap三平台的单域名操作
错误处理
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |
输出格式
{
"success": true,
"data": {
"result": "域名DNS管理免费版处理结果",
"execution_time": "0.5s",
"metadata": {
"version": "1.0",
"processor": "domain dns manager"
}
},
"execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
"error": null
}
相关技能
火山引擎DNS管理工具免费版,面向个人开发者的轻量级DNS记录管理工具。核心能力: - 域名区记录查询 - DNS记录增删改操作 - TTL 约束与回滚值保留 - 传播验证(权威与递归检查) 适用场景: - 个人域名的DNS记录维护 - 服务迁移时的DNS切换 - DNS记录的日常查询与验证 差异化: 免费版聚焦核心DNS记录管理能力,去除所有外部平台与作者引用,强化中文本地化与适用关键词,适合个人用户零成本上手
基础 DNS 记录配置工具,支持 TTL 管理、邮件认证与迁移前准备,适合个人站点。Use when 需要消息发送、通知推送、邮件短信、通信集成时使用。不适用于垃圾信息群发。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互,无需复杂配置即开即用。输出结果可直接使用,减少二次加工成本。提供结构化输出和错误处理机制。
使用dig工具解析域名A/AAAA/CNAME/MX记录,支持基础正反向查询与文档输出。Use when 需要数据库操作、SQL查询、数据存储管理时使用。不适用于数据库架构设计决策。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互,无需复杂配置即开即用。输出结果可直接使用,减少二次加工成本。
Cloudflare DNS (cloudflare.com). Use this skill for ANY Cloudflare DNS request — reading, creating, updating, and deleting data. Whenever a task involves Clo...
DNSFilter (dnsfilter.com). Use this skill for ANY DNSFilter request — searching and reading data. Whenever a task involves DNSFilter, use this skill instead...