功能 · 域名

你的域名,连 HTTPS 一起配好

把你​已有的​域名​连到自己的 app。Tofu 先验证​域名是​你的,​再配好 HTTPS 证书。​等用这个域名​真能​打开你的 app,​才显示​“已​连接”。​如果域名在 Cloudflare,​授权​一次就行。​哪些套餐​包含​这项功能,​定价页上​写着。

查看文档接入 agent

你的 agent 会调用的工具

  • domainConnect
  • domainAuthorize
  • domainAuthorizationStatus
  • domainVerify
  • domainGuidance
claude · ~/franks-kitchen示例

Connect frankskitchen.com

tofu · domainConnect frankskitchen.com

ownership_pending · _tofu TXT record

tofu · domainAuthorize

DNS approval is waiting · approve in your browser

tofu · domainVerify

Connected to your current healthy live version. HTTPS is configured.

域名怎么连上

先验证,​再上线 绝不反过来

每做完​一步,Tofu 都会先查​一遍,​确认​生效了​才做​下一步。​所以控制台和你的 agent 只会告诉你 Tofu 实际​查到的​结果。

  1. 添加域名

    在控制台的​“域名”页​添加,​或者让你的 agent 调用 domainConnect。Tofu 会给你​一条新的 _tofu TXT 验证​记录,​只对这个域名​有效。

  2. 证明域名是你的

    每次检查,Tofu 都会用 DNS-over-HTTPS 重新查​一遍这条​验证​记录。​主域名​验证过,​不代表​它的子​域名​也验证过。​重新添加​域名,​就得​用新的​验证​记录,​旧的​不能再用。
  3. 指向你的 app,​配好 HTTPS 证书

    托管​服务商​要验证​这个域名,DNS 记录​要把它​指向你的 app,​最后​再为它​配好 HTTPS 证书。
  4. 检查通过,​才算上线

    打开​这个域名,​看到的​必须是​你当前​上线、​通过了​健康​检查的​版本。​在这之前,​你的 app 照常用原来的​地址​访问。
证明域名是你的ownership_pending指向你的 appdns_pending配好 HTTPS 证书certificate_pending已上线connected
Cloudflare 一键设置

授权一次就行 DNS 记录由 Tofu 来写

如果你的域名用 Cloudflare 管理 DNS,​就不用自己​复制​记录了。​先登录 Tofu,​打开 Tofu 给你的链接,​再到 Cloudflare 的官方​页面上​授权 Tofu。​之后 Tofu 只在这个域名的 DNS 里写入​这次连接​需要的​记录,​写完​马上检查,​不用再等​一分钟。​一次授权​只写​一个域名的​记录。​跟它​一起带上的 www 或根​域名,​记录要你​自己​添加。

整个过程​不用填 API key,​也没有​地方让你填。​你的授权​本身​就是凭证,Tofu 会加密​保存。​想撤销​授权,​在 Tofu 或 Cloudflare 的控制台里​都可以。

已有的​记录​如果和要写的​不一样,Tofu 绝不​覆盖,​会告诉你​哪一条要你来​处理。DNS 由其他​服务商​管理的​域名,​不会出现​一键设置​按钮,​因为 Cloudflare 的授权​写不进​那边的 DNS。

DNS accessauthorized
Zone
frankskitchen.com one zone
Scopes
zone.read dns.write
Writes
_tofu and the routing record
Proxy
off, on every record
Keys pasted
none

Access approved. Tofu may write DNS records in this one zone.

其他 DNS 服务商

要加的记录​照抄就行, 加完替你检查

Tofu 先只看​不改:​查清你的 DNS 由哪家​服务商管、​这个域名下​已有哪些​记录、​哪些​会和新​记录​冲突。​再列出​要加的​记录,​你说一声​“保存好了”,​就马上替​你检查。

类型名称值
TXT_tofu.frankskitchen.comtofu-verification=⁠…,​只要域名​还连着​就别删
TXT_vercel.frankskitchen.com托管服务商​另外要求的​验证记录,​只在需要时​才出现,​内容原样显示
A 或 CNAMEfrankskitchen.com托管​服务商​推荐的​指向​记录,​内容原样​显示。​用共享​静态​托管的 app 不能连根​域名,​请改连 www 域名
CNAMEwww.frankskitchen.com随根域名​一起连上的 www:​指向记录​要你自己​设置,​如果 www 已经有​记录,​直接修改它,​不要再加一条

有的 DNS 服务商会​自动​在名称​后面补上​域名,​所以每行还附了​不带​域名的短​名称(_tofu、@),​粘贴后​域名​就不会出现​两遍。

你的 agent 可以在你​电脑上,​用你自己的 DNS 工具​把这些记录​加好。Tofu 从不向你要 DNS 密码​或密钥。​如果有 DNS 服务器​在你保存​记录之前​查过​这个域名,​它们​会暂时​记住​“查不到”,​新记录​可能要等​一阵​才能生效。​卡片上​会写明​要等​多久,​还会说明​这个时间​是谁​定的。

规则

一个域名,​只连一个 app 原来的地址还在

  • 每个 app

    最多 10 个域名

    每个域名​都要单独​添加、​单独​验证。​随这个域名​一起连上的 www 或根域名​不占​名额。

  • 每个域名

    在 Tofu 上只能连一个 app

    已验证的​域名,​要等​先连上​它的人​断开​连接,​别的 app 才能再连。

  • 根域名和 www

    添加一次,​两个域名都连上

    连接 frankskitchen.com 时,www.frankskitchen.com 会一起连上,​打开 www.frankskitchen.com 的人​会自动​跳到 frankskitchen.com。​连接 www 也一样,​根域名​会一起连上。​一起连上的​那个域名,​只需你​自己设置​一条指向​记录。​用共享​静态​托管的 app 不能连根​域名,​请改连 www 域名,​再把根​域名​转发到 www 域名。

  • 原来的地址

    trytofu.app 地址照常能用

    域名​只是另外​加的,​不会替换 app 自带的 trytofu.app 地址。

暂不支持

  • 不能购买、​续费或转移​域名。 可以在 Tofu 里搜索​域名、​查看​报价,​但暂时​不能在这里​购买。​先到域名​注册商​买好,​再回来​连接。

  • 一键设置只支持 Cloudflare。 如果用的是​其他 DNS 服务商,​就照 Tofu 列出的​记录手动​添加,​或者让你的 agent 用你自己的 DNS 工具代劳。

Tofu 不做的事

  • 断开连接时,​不删除 Tofu 写入的 DNS 记录。 断开时,Tofu 会先撤回​你在一键​设置时​给的​授权,​再移除​这条连接​和跟它​一起连上的 www 或根​域名。Tofu 不会删除​它写入的 DNS 记录,​而是逐条​列给你,​方便你到 DNS 服务商​那里自己​删掉。

  • 不给还没部署的 app 连域名。 自定义域名指向​线上版本,​所以 app 要先部署。

  • 每次只连​一个完整的​域名。 不支持通​配符、​网址或 IP 地址。​只有根​域名和它的 www 会一起连上,shop.frankskitchen.com 这样的​子域名​要单独​连接。

  • 不改域名​服务器,​也不动邮件​相关的 DNS 记录。 连接域名​不会更换​域名​服务器,​也不会写​入邮件​相关的 DNS 记录。​想让注册​邮件​从你的域名​发出,​要在 send. 子域名下​另外​设置,​详情见登录​与邮件。

粘贴​一段提示词。10 分钟上线

用你​已经在用的 agent,10 分钟,​把 app、​数据库、​域名和​登录​都弄好。

免费开始