怎么用

1 · DDNS（路由器自动改 IP）

群晖 DSM、OpenWrt（ddns-scripts）、爱快、pfSense/OPNsense、UniFi 默认就支持这个协议。用户名填登录邮箱，密码填子域名卡片里那串密钥，或者用 API Token。

GET https://panel.1r.mom/nic/update?hostname=yourname.1r.mom&myip=1.2.3.4

返回：good 成功 · nochg IP 没变 · badauth 账号或密码错 · nohost 名字不存在或已过期 · notfqdn 域名格式不对 · 911 太频繁。

2 · 为什么同一个名字 5 分钟内只写一次

每个名字最多每 5 分钟真正写一次 DNS。IP 变化更频繁时更新会排队，下一次巡检时补上，客户端仍然收到 good。这样既不浪费上游 API 配额，也避免 DNS 被你刷爆。

3 · REST API

curl -H "Authorization: Bearer $TOKEN" \
  https://panel.1r.mom/api/v1/names

• GET /api/v1/names 列出（含剩余天数）
• POST /api/v1/names 领号：{"label":"nas","type":"A","content":"1.2.3.4"}
• PUT /api/v1/names/<label>/record 改记录：{"type":"A","content":"1.2.3.5"}
• POST /api/v1/names/<label>/renew 续期

4 · 30 天规则

一个名字活 30 天，续期免费，只是把到期日往后推。提前续不亏：多出来的天数叠在原有剩余之上，但最多只能囤到 60 天后。

到期时记录从 DNS 摘除；7 天内续期可以立刻恢复；超过就释放，谁都能重新领。

5 · 这个服务不会做的事

• 不托管网页、不做跳转 —— 只做 DNS
• 不卖数据、不塞广告
• 不收钱（代码库里没有计费）