DNS配置基础版

输入格式

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux

依赖项

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

export API_KEY=${API_KEY:?请设置环境变量}

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

核心能力

本Skill提供DNS配置的基础检查与提示能力:

• TTL迁移提示: 迁移前48小时将TTL降至300秒,迁移稳定24小时后恢复至3600-86400秒
• SPF基础检查: 确认SPF为单条TXT记录,结尾为 -all 或 ~all
• DMARC基础配置: 配置 _dmarc.example.com TXT "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com"
• dig基础诊断: 使用 dig example.com、dig TXT example.com、dig MX example.com 查询记录
• www规范化: apex与www需同时配置或互转,HTTPS重定向需双域名证书

TTL迁移提示

针对TTL迁移提示,自动解析输入参数、调度任务队列、格式化输出,返回结构化响应. 输入: 用户提供TTL迁移提示相关的配置参数、输入数据和处理选项. 输出: 返回TTL迁移提示的处理结果。- 验证返回数据的完整性和格式正确性

• 参考TTL迁移提示的配置文档进行参数调优

SPF基础检查

针对SPF基础,自动解析输入参数、调度任务队列、格式化输出,返回结构化响应. 输入: 用户提供SPF基础检查相关的配置参数、输入数据和处理选项. 输出: 返回SPF基础检查的处理结果。- 验证返回数据的完整性和格式正确性

• 参考SPF基础检查的配置文档进行参数调优

DMARC基础配置

针对DMARC基础,自动解析输入参数、调度任务队列、格式化输出,返回结构化响应. 输入: 用户提供DMARC基础配置相关的配置参数、输入数据和处理选项. 输出: 返回DMARC基础配置的处理结果。- 验证返回数据的完整性和格式正确性

• 参考DMARC基础配置的配置文档进行参数调优

快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

使用流程

1. 环境确认: 确认Agent平台已加载本skill，检查依赖说明中的环境要求
2. 指令输入: 向Agent描述需要执行的任务，引用dns-free的相关能力
3. 执行处理: Agent按照核心能力章节的指令执行任务
4. 结果验证: 检查输出结果是否符合预期，参考错误处理章节处理异常

适用场景

场景一： 个人域名迁移前TTL预热

• 输入: 待迁移域名 example.com,当前TTL=86400s
• 处理: 用 dig +nocmd +noall +answer example.com 探测当前缓存TTL;将TTL降至300s;等待原TTL过期后再切换
• 输出: 当前TTL状态 + 降级建议 + 切换时机提示

场景二： SPF/DMARC基础配置检查

• 输入: 域名 example.com,邮件发送后进入垃圾箱
• 处理: 用 dig TXT example.com 检查SPF是否为单条TXT;检查结尾是否为 -all/~all;配置DMARC基础记录 _dmarc.example.com"
• 输出: SPF配置状态 + DMARC配置建议

场景三： www子域访问排查

• 输入: 用户反馈 www.example.com 无法访问,但 example.com 正常
• 处理: 用 dig www.example.com 检查是否有A记录;确认apex与www是否同时配置;检查HTTPS重定向是否双域名证书
• 输出: www记录状态 + 修复建议

调试命令参考

dig基础命令

• dig example.com: 查询A记录,验证域名解析
• dig TXT example.com: 查询TXT记录,验证SPF/DMARC配置
• dig MX example.com: 查询MX记录,验证邮件路由
• dig +nocmd +noall +answer example.com: 精简输出,快速查看TTL与记录值
• dig @8.8.8.8 example.com: 指定Google解析器查询,对比缓存状态

诊断基础策略

1. 用 dig TXT example.com 确认SPF为单条TXT记录
2. 用 dig +nocmd +noall +answer example.com 探测当前缓存TTL
3. 用 dig @8.8.8.8 与 dig @1.1.1.1 对比,判断缓存传播进度

案例展示

案例1: 迁移后部分用户访问旧IP

背景: 将 example.com 迁移到新DNS商,A记录已更新,但部分用户仍命中旧IP. 诊断过程:

1. 用 dig @8.8.8.8 example.com 与 dig @1.1.1.1 example.com 对比,发现Google解析器仍返回旧IP
2. 检查原TTL,发现迁移前未降TTL(仍为86400s),旧缓存需24小时才过期

修复:

• 在旧DNS商保留记录同步至新IP,直到新DNS全球生效
• 下次迁移前48小时将TTL降至300s

案例2: SPF配置多条TXT导致邮件被拒

背景: 配置了SPF但向Gmail发送邮件仍被拒收. 诊断过程:

1. 用 dig TXT example.com 发现存在两条SPF TXT记录,这是无效配置
2. 检查SPF结尾,原为 +all(允许所有),需改为 -all

修复:

• 合并为单条TXT: "v=spf1 include:_spf.google.com -all"
• SPF结尾强制为 -all 或 ~all,禁止 +all/?all

异常处理

1. dig返回SERVFAIL

原因: 权威服务器故障或DNSSEC签名问题 处理: 用 dig +dnssec example.com 查看DNSSEC状态;联系DNS托管商确认权威服务器健康

2. SPF记录被截断

原因: 单条TXT记录超过255字节或配置了多条SPF TXT 处理: 使用 include: 引用减少长度;SPF必须为单条TXT记录

3. DMARC报告未收到

原因: rua邮箱配置错误或目标域未授权接收 处理: 确认 rua=mailto: 邮箱可接收外部邮件;检查目标域授权配置

4. TTL修改后立即生效但随后回退

原因: 缓存层TTL未过期,存在中间缓存层独立缓存 处理: 用 dig @ns1.provider.com example.com 确认权威记录已更新;等待各缓存层TTL自然过期

5. www子域无法访问

原因: apex与www未同时配置,或HTTPS重定向缺少双域名证书 处理: 为apex和www分别配置记录;HTTPS重定向前确保证书覆盖两个域名

FAQ

Q1: 迁移前TTL应该提前多久降低?

A: 至少提前48小时将TTL降至300秒,确保旧TTL完全过期后再切换。降TTL前先用 dig +nocmd +noall +answer example.com 探测当前缓存TTL.

Q2: SPF可以配置多条TXT记录吗?

A: 不可以。SPF必须为单条TXT记录,多条SPF TXT无效。多个发送源使用 include: 串联,如 "v=spf1 include:_spf.google.com -all".

Q3: DMARC的p=none/quarantine/reject有什么区别?

A: p=none 仅监控;p=quarantine 隔离至垃圾箱;p=reject 直接拒绝。建议从none开始观察,逐步升级.

Q4: dig +trace和dig @ns有什么区别?

A: dig +trace 从根服务器逐级解析,展示完整解析链;dig @ns1.provider.com 直接查询权威服务器,绕过缓存。两者配合可定位缓存与权威不一致问题.

错误处理

已知限制

• 无法直接修改DNS托管商记录,需配合控制台操作
• 不支持DKIM签名配置与CAA证书锁定(需升级付费版)
• 不支持Cloudflare代理行为分析与CNAME扁平化诊断(需升级付费版)
• DMARC的rua报告解析需额外工具,本版本不提供
• TTL传播时间受全球ISP缓存策略影响,无法精确预测

升级提示

以上为基础版能力,如需以下进阶功能,请升级到付费版 dns:

• DKIM签名配置与完整三件套(SPF/DKIM/DMARC)链路诊断
• CAA证书锁定与iodef安全事件告警通道
• Cloudflare橙云/灰云代理行为分析与CNAME扁平化迁移诊断
• dig +trace完整解析链路与权威/缓存响应比对
• 通配符记录规则与多级子域配置
• 通配符SSL证书DNS-01挑战签发指导
• 8个领域特定异常处理与6个深度FAQ
• 4个真实案例展示与完整调试命令参考

输出格式

{
  "success": true,
  "data": {
    "result": "DNS配置基础版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "dns"
    }
  },
  "execution_log": [
    "解析输入参数",
    "执行核心处理",
    "格式化输出结果"
  ],
  "error": null
}