ipv6-ddns-aliyun

能力概述

本 Skill 实现了一个完整的 IPv6 DDNS（动态域名解析）解决方案，自动将本机获取到的公网 IPv6 地址同步到阿里云云解析 DNS。

工作流程

检测本机公网 IPv6 地址
- 过滤 fe80::/10（链路本地）
- 过滤 ::1/128（回环地址）
- 筛选出公网可路由的 IPv6 地址
- 验证公网可达性：
  - 通过 curl 6.ipw.cn 获取出口 IPv6 地址
  - 与本机网卡 IPv6 地址比对
  - 如匹配成功，确认为公网地址
- 如无公网 IPv6，报错退出
检查 aliyun-domain-skill 依赖
- 检查本地是否存在 domain/SKILL.md
- 如不存在，执行安装命令： npx skills add shigzz/aliyun-skills --skill aliyun-domain-skill
读取或询问 DDNS 配置
- 检查当前目录 .aliyun-config.json
- 如有配置且用户确认，直接使用
- 如无配置，交互式询问：
  - 根域名（如 example.com）
  - 主机记录（如 ddns 或 @）
  - TTL（默认 60 秒）
验证域名归属
- 通过 aliyun-domain-skill 查询账号域名列表
- 确认用户指定的根域名在列表中
- 如不存在，提示用户先去阿里云注册域名
查询现有 AAAA 记录
- 通过 aliyun-domain-skill 查询域名解析记录
- 筛选 Type=AAAA，RR=主机记录的记录
- 获取记录 ID 和当前 IP 值
更新或新增解析记录
- 如现有记录 IP == 本机 IPv6：提示无需更新，退出
- 如存在记录但 IP 不同：更新记录
- 如不存在记录：新增 AAAA 记录
- 更新成功后保存配置到 .aliyun-config.json

依赖说明

本 Skill 依赖 aliyun-domain-skill 提供的域名管理能力：

查询账号域名列表
管理 DNS 解析记录（查询、新增、修改 AAAA 记录）

如未安装，请执行：

npx skills add shigzz/aliyun-skills --skill aliyun-domain-skill

配置存储

DDNS 配置保存在当前工作目录的 .aliyun-config.json，支持两种格式：

单项目配置（对象格式）

{ "version": 1, "ddns": { "domain_name": "example.com", "rr": "ddns", "ttl": 60, "record_id": "12345678901234567", "last_ip": "2408:4002:1c2f:8d00::1", "last_update": "2026-03-28T15:30:00+08:00" } }

多项目配置（数组格式）

支持在同一仓库中管理多个 DDNS 配置（如多域名或多主机）：

[ { "project": "nas-home", "version": 1, "ddns": { "domain_name": "example.com", "rr": "nas", "ttl": 60, "record_id": "12345678901234567", "last_ip": "2408:4002:1c2f:8d00::1", "last_update": "2026-03-28T15:30:00+08:00" } }, { "project": "router-office", "version": 1, "ddns": { "domain_name": "company.com", "rr": "router", "ttl": 60, "record_id": "98765432109876543", "last_ip": "2408:4002:1c2f:8e00::1", "last_update": "2026-03-28T10:00:00+08:00" } } ]

字段说明：

project：string，多项目时必需，项目标识名，用于区分不同配置 version：int，必需，配置格式版本，当前为 1 ddns.domain_name：string，必需，根域名，用于 DNS 解析 ddns.rr：string，必需，主机记录，如 ddns 或 @ ddns.ttl：int，否，DNS 记录 TTL，默认 60 秒 ddns.record_id：string，否，阿里云 DNS 记录 ID ddns.last_ip：string，否，上次更新的 IP 地址 ddns.last_update：string，否，ISO 8601 格式最后更新时间

配置复用

对象格式：若配置存在且字段完整，本次可直接复用，无需再次询问
数组格式：提示用户选择要使用的项目（按 project 字段区分），选定后仅更新该项目配置
若用户要求更换域名或主机记录，或新增项目配置，则重新交互确认。

前置检查

阿里云凭证

需要阿里云 AccessKey，配置方式见 aliyun-domain-skill：

环境变量方式（推荐）：

export ALIBABA_CLOUD_ACCESS_KEY_ID="your-access-key-id" export ALIBABA_CLOUD_ACCESS_KEY_SECRET="your-access-key-secret"

.env 文件方式：

cp .env.example .env

编辑 .env 填入凭证

使用方法

作为 Claude Code Skill 调用：

设置本机的 IPv6 DDNS
更新我的 DDNS 记录

错误处理

无公网 IPv6：退出并提示用户检查网络配置
aliyun-domain-skill 未安装：提示用户安装依赖 skill
域名不存在于账号：提示用户去阿里云注册域名
DNS 操作权限不足：提示用户配置 RAM 权限后重试

注意事项

IPv6 要求：本机必须有公网可路由的 IPv6 地址（非 fe80:: 开头的链路本地地址）
公网验证：通过 curl 6.ipw.cn 获取出口 IPv6，与本机网卡地址比对，确认地址为公网可达
TTL 设置：建议设置为 60 秒，以便 IP 变化时快速生效
域名归属：域名必须在当前阿里云账号下，且使用阿里云云解析 DNS
首次配置：首次运行需要交互式输入域名和主机记录，后续可从 .aliyun-config.json 读取
多 IPv6 地址：如本机有多个公网 IPv6，默认使用第一个

技能介绍

编辑 .env 填入凭证