使用帮助

1. URL 模板

GET https://aliddns.xiaotiancloud.com/update/{device_id}/{ip}
GET https://aliddns.xiaotiancloud.com/update/{device_id}

device_id：仅允许字母、数字、下划线，1-64 字符。
ip：标准 IPv4 或 IPv6 地址，可省略——省略时服务端以请求来源 IP 作为上报 IP。

2. 设备端示例

Linux 通用 / 群晖 NAS（省略 IP，自动取请求来源 IP）

curl -sf "https://aliddns.xiaotiancloud.com/update/mi_home"

OpenWrt / DD-WRT crontab

*/5 * * * * /usr/bin/curl -sf "https://aliddns.xiaotiancloud.com/update/mi_home" >/dev/null

Windows 计划任务

powershell -Command "Invoke-WebRequest -UseBasicParsing 'https://aliddns.xiaotiancloud.com/update/server01/1.2.3.4'"

3. 返回码

状态码	含义
200 OK no-change	IP 与上次一致，未调用阿里云
200 OK updated N/M	IP 变化，已调用阿里云成功 N 条
200 WARN partial	部分成功（部分域名未找到等）
201 created	未登记设备已自动建档（需开启 auto_register）
404 unknown device	设备未在 admin 登记
400 invalid ip	IP 格式不合法
502 Aliyun API error	阿里云 API 调用失败

4. 故障排查

• 返回 404 unknown device → 在 admin 控制台登记该 device_id，或在 /admin/settings 开启自动注册。
• 返回 502 Aliyun API error → 检查 /admin/settings 中 AK/SK 是否正确，账号是否对 zone 有写权限。
• 返回 WARN partial → 部分域名 not-found，表示 zone 中不存在该 RR 记录。请到阿里云 DNS 控制台添加解析。
• 所有调用记录可在 /admin/devices/{id}/logs 查看。