Coding

域名DNS管理免费版

Try it

域名DNS管控免费版是一款面向个人开发者与小团队的域名管控Skill,封装Cloudflare、DNSimple、Namecheap三大平台的常用操作。Use. 适用于需要domain dns manager相关能力的开发场景,包含结构化的工作流程和可复用的模板,帮助用户快速完成任务并保持代码质量.

What it does

域名DNS管控免费版是一款面向个人开发者与小团队的域名管控Skill,封装Cloudflare、DNSimple、Namecheap三大平台的常用操作。Use. 适用于需要domain dns manager相关能力的开发场景,包含结构化的工作流程和可复用的模板,帮助用户快速完成任务并保持代码质量.

The skill document

域名DNS管理免费版(Domain DNS Manager Free)

概述

管理多个域名注册商与DNS服务商是一件繁琐的事:登录不同控制台、切换不同界面、记住不同操作流程。本Skill将Cloudflare、DNSimple、Namecheap三大平台的常用操作统一为标准化工作流,配合验证步骤确保每步操作正确生效. 设计原则:

  1. 标准流程:统一的接入、配置、验证三步工作流
  2. 可验证:每步操作后用dig确认生效,不靠"应该好了"
  3. 可回滚:记录操作前状态,支持快速回退
  4. 安全优先:API Token通过环境变量管理,不硬编码

核心能力

支持的平台与操作

平台接入域名DNS记录管理Nameserver切换HTTPS重定向
Cloudflare✅ 创建zone✅ 增删改查✅ Page Rule
DNSimple✅ 查询域名✅ 增删改查
Namecheap✅ 查询域名❌(需通过CF)

处理: 解析支持的平台与操作的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回支持的平台与操作的响应数据,包含状态码、结果和日志.

DNS记录类型支持

记录类型用途示例
AIPv4指向example.com → 192.0.2.1
AAAAIPv6指向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秒上手

  1. 配置API Token:设置Cloudflare/DNSimple/Namecheap的环境变量
  2. 确认域名注册商:查询域名的当前注册商与nameserver
  3. 执行操作:按标准工作流接入或配置DNS
  4. 验证生效:用dig确认DNS记录已生效

标准接入流程

步骤1:Cloudflare创建zone

输入格式

参数名类型必填说明
inputstring域名DNS管理免费版处理的输入数据或指令
optionsobject附加配置选项,如模式选择、格式偏好等
callback_urlstring异步处理完成后的回调通知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.comMX10 mail.example.com邮件服务器
example.comTXT"v=spf1 include:_spf.example.com ~all"SPF防伪造
dkim._domainkeyTXT"v=DKIM1; k=rsa; p=MIGfMA0..."DKIM签名
_dmarcTXT"v=DMARC1; p=quarantine; rua=mailto:..."DMARC策略

网站接入配置

记录(续)类型说明
example.comA192.0.2.1主域名(Cloudflare代理)
wwwCNAMEexample.comwww别名
apiA203.0.113.50API服务器(不代理)
cdnCNAMEcdn.provider.comCDN指向

Cloudflare代理IP说明

使用Cloudflare代理时,A记录可使用以下占位IP(Cloudflare会自动替换为实际代理IP):

  • 192.0.2.1 - 用于DNS占位,确保HTTPS可终止

优秀实践

  1. 先配置后切换:在新DNS配好所有记录后再切换nameserver,避免服务中断
  2. 逐项验证:每添加一条记录后用dig验证,不要批量添加后才发现问题
  3. TTL设置:临时调试用短TTL(60秒),生产环境用默认TTL(300秒)
  4. 代理状态:对外服务开启Cloudflare代理(橙色云),内部服务关闭代理(灰色云)
  5. HTTPS强制:接入Cloudflare后开启"Always Use HTTPS",全站强制加密
  6. API Token权限:Cloudflare Token仅授予需要的zone权限,最小权限原则
  7. 操作记录:保留操作命令记录,便于回溯与审计
  8. nameserver确认:切换nameserver后等待全球生效(通常24-48小时)

常见问题

Q1:nameserver切换后多久生效?

A:通常24-48小时全球生效。可通过dig @1.1.1.1 example.com NSdig @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 APIAPI必需由Agent平台内置LLM提供
cli4CLI工具Cloudflare操作必需pip install cloudflare-cli4
dig系统命令验证必需安装bind-utils或dnsutils
curl系统命令验证必需系统自带
jq系统命令可选sudo apt install jq

API Key 配置

  • Cloudflare Token:通过环境变量CLOUDFLARE_API_TOKENCF_API_TOKEN配置
  • DNSimple Token:通过环境变量DNSIMPLE_ACCESS_TOKEN配置
  • Namecheap API:通过环境变量NAMECHEAP_API_USERNAMECHEAP_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
}

Related skills

面向个人开发者与小型网站的Namecheap DNS管理工具。支持A/CNAME/ MX/TXT等常用DNS记录的创建、查询、更新与删除。Use when 需要代码生成、编程辅助、调试测试、开发部署时使用。不适用于无明确技术栈的模糊需求。Use when 需要代码生成、编程辅助、调试测试、开发部署时使用。不适用于无明确技术栈的模糊需求。

1 installs

火山引擎DNS管理工具免费版,面向个人开发者的轻量级DNS记录管理工具。核心能力: - 域名区记录查询 - DNS记录增删改操作 - TTL 约束与回滚值保留 - 传播验证(权威与递归检查) 适用场景: - 个人域名的DNS记录维护 - 服务迁移时的DNS切换 - DNS记录的日常查询与验证 差异化: 免费版聚焦核心DNS记录管理能力,去除所有外部平台与作者引用,强化中文本地化与适用关键词,适合个人用户零成本上手

1 installs

基础 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...

8 installs

DNSFilter (dnsfilter.com). Use this skill for ANY DNSFilter request — searching and reading data. Whenever a task involves DNSFilter, use this skill instead...

3 installs