一、这是什么服务
MaskTT DDNS(下称「本服务」,域名 api.masktt.com)是一个
动态解析中转服务:你的设备把当前公网 IP 报给我们,我们替你调用你所选云厂商的
DNS 接口,把这个 IP 写进你自己的域名。
请先弄清楚这三件事,它们决定了下面所有条款的边界:
- 域名是你的。我们不出售、不出租、不托管域名,也不提供二级域名。你必须自己拥有一个域名,并且它的解析在阿里云、DNSPod 或 Cloudflare 其中一家。
- 解析记录也是你的。记录最终写在你自己的云厂商账号里,我们只是替你发那个 API 请求。你随时可以登录云厂商后台自己改或者删掉。
- 我们只做中转。我们不是你的域名注册商,也不是你的 DNS 服务商。域名过期、解析商故障、记录被别人改掉,这些都不在本服务的范围内。
之所以需要中转,是因为路由器固件普遍做不了云厂商要求的 HMAC 签名。原理详见
接入文档。
本服务完全免费,面向所有人开放注册。我们不收费,也不打算在将来对现有功能收费。
二、账号
- 注册需要一个能收信的邮箱。邮箱用于验证身份、找回密码和必要的服务通知,我们不会拿它发广告,也不会提供给第三方。
- 请填写你实际在用的邮箱。填错或填一次性邮箱导致收不到验证信、找不回密码,我们无法帮你恢复账号。
- 一人一号。不要批量注册。多个账号用于规避频率限制的,会被一并停用。
- 你的密码和推送密钥(脚本里那串
u=)由你自己保管。拿到推送密钥的人就能改你的解析记录,泄露后请立刻到控制台重置。
- 用你账号发生的一切操作,视为你本人的操作。密码或密钥泄露请立刻修改,由此造成的损失由你自己承担。
三、域名与密钥归你
这是本服务和大多数 DDNS 平台最不一样的地方,也是你最该看清楚的一条:
你的云厂商密钥(阿里云 AccessKey、DNSPod Token、Cloudflare API Token)不保存在我们的服务器上。
- 控制台的脚本生成页是纯前端的。你填的密钥只在你自己浏览器的内存里被拼进脚本文本,从不提交给我们。你可以打开浏览器开发者工具的网络面板自行验证。
- 生成好的脚本存在你自己的设备上(路由器、NAS、服务器)。每次上报时,设备把密钥随请求发过来,我们用完即丢,不落盘、不入库、不记日志。
- 我们的访问日志只记录请求路径,不记录查询参数,因此密钥不会出现在任何日志文件里。
这个设计对你意味着两件事,好处和代价各一件:
- 好处:我们的数据库即使被拖走,里面也没有任何人的云厂商密钥。
- 代价:我们无法替你找回密钥。密钥丢了只能到云厂商后台重新生成一把。
请务必使用权限最小的子账号密钥。阿里云请建只有 DNS 权限的 RAM 子账号,Cloudflare 请用限定到单个域名的 API Token,
不要用主账号 AccessKey 或 Global API Key。这样即使密钥泄露,损失也仅限于该域名的解析记录。具体做法见
接入文档。
密钥要经过我们的服务器转发这一点,在技术上是无法回避的 —— 签名必须在服务端算。
如果你不接受这一点,请不要使用本服务,改用能在本地完成签名的方案(例如 ddns-go、OpenWrt 的 ddns-scripts)。
四、使用规范
以下行为会导致账号被停用,严重的会直接封禁 IP:
- 把服务用于违法用途,或用于传播违法、侵权内容的站点。
- 拿本服务当攻击跳板:利用中转接口探测、扫描或攻击云厂商接口。
- 高频刷接口:明知 IP 没变仍然按秒级频率上报,或用脚本制造无意义请求。建议的上报间隔是 5 分钟,最短不要低于 1 分钟。
- 批量注册账号,或用多账号规避频率限制。
- 转售或包装本服务:把本服务的接口转卖、以自有品牌对外提供,或接入到商业产品里分发给终端用户。个人和小团队自用不受限制。
- 试图绕过限制:包括但不限于爆破他人推送密钥、伪造来源 IP、攻击本站。
- 填写不属于你的域名。你只能解析你自己拥有或已获授权管理的域名。
我们保留在发现上述行为时不经通知直接停用账号的权利。
如果你认为被误判了,来信说明情况,我们会复查。
五、频率限制
为了让所有人都能稳定用,服务端有以下限制。正常使用碰不到这些数字。
| 限制项 | 阈值 | 说明 |
| 单个 IP 上报 | 30 次 / 分钟 | 同一个出口 IP 下所有设备共享 |
| 单条解析记录 | 10 次 / 分钟 | 同一个域名 + 主机记录 |
| 登录尝试 | 20 次 / 小时 | 按 IP 计 |
| 注册 | 5 次 / 天 | 按 IP 计 |
| 连续失败冷却 | 连错 20 次 | 暂停该记录 10 分钟,防止拿错的密钥一直打云厂商接口 |
另外,当上报的 IP 和上次相同时,我们会直接返回成功,不调用云厂商接口。
这既省你的 API 配额,也省我们的资源。看到「IP 未变」不是错误,是正常的。
超出限制的请求会被拒绝并返回相应错误码,不影响你已有的解析记录。限制阈值可能随运营情况调整,调整后此页面同步更新。
六、我们记录什么
坦白讲清楚,免得你猜。
会存的
| 数据 | 为什么要存 | 保留多久 |
| 邮箱 | 登录、找回密码、服务通知 | 直到你注销账号 |
| 密码 | 登录校验。以不可逆哈希存储,我们看不到原文 | 同上 |
| 域名、主机记录、记录类型、线路 | 识别你要更新哪一条记录 | 同上 |
| 推送密钥 | 识别请求来自你 | 同上,可随时重置 |
| 设备上报的 IP | 判断 IP 有没有变、限流、你自己排查问题 | 30 天 |
| 每次上报的时间和结果 | 让你在控制台看到推送记录 | 30 天 |
| 云厂商返回的错误信息 | 出错时你能直接看到原因 | 30 天 |
| 注册与最后登录时间、IP | 安全审计 | 直到你注销账号 |
不会存的
- 云厂商密钥 —— 见第三条,用完即丢。
- 请求的查询参数 —— 访问日志只记路径,因为参数里带着密钥。
- 你的解析记录内容之外的任何东西 —— 我们不知道你的域名指向什么服务,也不去探测。
超过 30 天的推送日志由定时任务自动清理。统计页面上的累计数字来自聚合计数器,
不含任何可以定位到个人的信息。
七、隐私
- 我们不向任何第三方出售、出租或共享你的邮箱、域名和 IP 记录。
- 站点不接入任何第三方统计和广告脚本,也不使用追踪 Cookie。唯一的 Cookie 是登录会话,登出即失效。
- 邮件由 Resend 投递,发信时你的邮箱地址会经过该服务商。除此之外没有其它第三方接触你的数据。
- 你的每次上报请求会转发到你自己选择的云厂商(阿里云 / DNSPod / Cloudflare),这是服务本身要做的事。这些厂商如何处理数据适用它们自己的隐私政策。
- 依法配合调查除外:收到有管辖权的执法机关依法出具的正式要求时,我们会在法律要求的范围内提供相关记录。
- 你可以随时在控制台删除自己的解析任务和推送日志。需要注销整个账号请来信,我们会在确认身份后删除你的全部数据。
八、可用性
本服务免费提供,按「现状」提供,不做任何可用性承诺,没有 SLA。
我们会尽力保持稳定,但下面这些情况随时可能发生:
- 服务器维护、升级导致的短时中断
- 机房网络、上游线路故障
- 云厂商接口变更、限流或故障
- 不可抗力
如果你的业务对解析连续性有要求,请不要把本服务当作唯一依赖。
建议同时配置一个备用方案,或者直接使用能在本地完成签名的客户端。
计划内的维护会提前在首页公告。突发故障会尽快处理,但不承诺修复时限。
九、责任限制
在法律允许的最大范围内:
- 本服务不对以下情况造成的任何损失承担责任:解析未能及时更新、解析被更新为错误的值、服务中断、数据丢失、密钥泄露(因你自身保管不当造成的)、云厂商侧的任何问题。
- 本服务不对因使用或无法使用本服务而产生的任何直接或间接损失承担责任,包括但不限于业务中断、收入损失、数据损失。
- 你使用本服务解析的域名所承载的内容,由你自己负责,与本服务无关。
说人话:这是一个免费的个人项目,请按免费服务的预期来使用它。
我会认真维护它,但如果你拿它跑关键业务出了事,我赔不起,也没有收你的钱去承担这个责任。
十、账号终止
你可以随时停止使用:把设备上的脚本删掉,再到控制台删除解析任务即可。需要彻底注销账号请来信。
我们会在以下情况下停用账号:
- 违反第四条使用规范
- 账号长期无任何上报记录(超过 12 个月),且邮箱未验证
- 被用于攻击本服务或其他系统
账号被停用后,你的解析记录仍然留在你自己的云厂商账号里,不受影响,只是不再自动更新。
你随时可以登录云厂商后台自己管理。
十一、条款变更
条款可能随服务调整而更新,更新后此页面顶部的日期会变。
涉及你权利的重大变更(例如开始收费、改变密钥处理方式)会提前通过邮件和首页公告告知。
变更生效后继续使用本服务,视为接受新条款。不接受的话,删掉脚本停用即可。
遇到问题、发现 bug、发现安全漏洞,或者要注销账号,都可以直接来信:
support@masktt.com
报告安全漏洞的,请在标题里写明「安全」,我们会优先处理。
请先看一遍接入文档的故障排查,大部分问题那里已经有答案了。
本条款适用中华人民共和国法律。条款的任何一条若被认定无效,不影响其余条款的效力。