Sitey — free subdomains

sitey.my

面向开发者的免费子域名服务。几秒钟即可获取子域名——无需信用卡，也没有繁琐步骤。

功能

• 即时 DNS — A、CNAME 和 TXT 记录，几秒钟内生效
• Google 登录 — 无需管理密码
• REST API — 通过 /api/v1/ 以编程方式访问
• 续期 — 子域名按期限借用，点击一下即可保留
• 免费 — 不收费，没有附加条件

子域名的有效期

所有者	期限	提醒
已登录用户	3 个月	到期前 14 天、3 天及到期当天
API 密钥 / Agent	1 个月	无——每次读取都会返回 expires_at

续期会从今天起重新计算期限。停止加载的子域名不会被移除：我们会写信告知您它已无法访问，仅此而已。

快速入门

1. 访问 sitey.my
2. 使用 Google 登录
3. 输入子域名 + IP 地址 → 完成

REST API

面向开发者和 AI Agent 的编程访问方式。

基础 URL： https://sitey.my/api/v1

sitey.one 和 www. 主机名会重定向到此处（/api/* 使用 308 重定向，因此 POST 请求正文会保留）。

身份验证

模式	身份验证	限制
匿名	无（基于 IP）	3 个子域名
API 密钥	Authorization: Bearer styo_xxx	不限

获取 API 密钥：登录 sitey.my → Dashboard → API Keys。

端点

方法	路径	说明
GET	/domains	列出可用的根域名
GET	/check/:subdomain/:domain	检查是否可用
POST	/subdomains	创建 A 或 CNAME 记录
GET	/subdomains	列出您的子域名
PATCH	/subdomains/:sub/:domain	更新记录值
DELETE	/subdomains/:sub/:domain	删除子域名
POST	/subdomains/:sub/:domain/renew	在 expires_at 之前延长期限
POST	/subdomains/:sub/:domain/txt	创建 / 更新 TXT 记录
DELETE	/subdomains/:sub/:domain/txt/:prefix	删除 TXT 记录

示例

# Check availability
curl https://sitey.my/api/v1/check/demo/sitey.my

# Create subdomain
curl -X POST https://sitey.my/api/v1/subdomains \
  -H "Content-Type: application/json" \
  -d '{"subdomain":"demo","domain":"sitey.my","type":"A","value":"1.2.3.4"}'

面向 AI Agent（MCP）

AI Agent 可以使用 free-domain-mcp——一个封装了此 REST API 的 MCP 服务。

claude mcp add --transport http sitey https://your-mcp-server/mcp

技术栈

• 运行时：Node.js + Fastify
• DNS：自托管 BIND9（权威名称服务器）
• 数据库：MySQL
• 身份验证：Google OAuth2 + JWT

工作原理

1. 用户（或 API 调用）请求一个子域名
2. 服务验证输入并检查可用性
3. A/CNAME/TXT 记录会追加到 BIND9 区域文件
4. named-checkzone 验证后，运行 systemctl reload named 应用更改
5. DNS 会在几秒钟内生效

我们运行自己的权威名称服务器（ns1.sitey.one、ns2.sitey.one）——不使用第三方 DNS 提供商。

使用场景

• 将个人项目部署到 myapp.sitey.my
• 为黑客松演示提供真实网址
• 通过 REST API 或 MCP 自动配置域名
• 与队友共享预发布环境

支持

• ☕ 请我喝杯咖啡
• 💬 Telegram 社区

许可证

ISC