跳转到主要内容
用 App Builder 发布的每个应用,都会在你部署的域名下获得一个独立地址:
这个地址本身就在你自己的域名下。如果想换地址,有两种方式:

修改访问链接

修改立即生效,不需要改 DNS 或证书。
  1. 在应用编辑器中打开应用,点击发布。
  2. 在访问链接旁边点击编辑图标。
  3. 输入新名称(小写字母、数字或连字符,并以字母或数字开头和结尾),点击确认。
已发布应用的发布面板:访问链接旁的编辑图标,以及带取消和确认按钮的名称输入框 应用随即可以通过 https://<新名称>.app.<你的域名> 访问。如果之前改过名称,旧名称会失效,已经分享出去的链接需要相应更新。

让应用使用独立域名

当应用必须放在 Teable 域名之外时使用,例如把客户门户放在 portal.example.org。访问者在地址栏里看到的始终是你的域名,不会发生跳转。 请求流程:访问者打开 portal.example.org,DNS 将其指向你的 Teable 服务器,服务器再把请求转给访问链接为 portal.app.teable.example.com 的应用 你需要准备:
  • 平台版本 v2026.11.5 或更高(更新日志)。需要登录的应用要在登录后回到这个域名,还需要 2026-11-05 及以后发布的 Teable 版本。
  • 应用当前的访问链接,例如 portal.app.teable.example.com。
  • 独立域名的 DNS 管理权限。
  • 部署环境的服务器权限(Docker)或 Helm values(Kubernetes)。

第 1 步:把域名指向你的部署

为独立域名添加一条 DNS 记录: 继续之前先检查:dig +short portal.example.org 应返回你的访问链接或服务器 IP。

第 2 步:把域名映射到应用

在部署目录的 .env 中添加映射,多条映射用英文逗号分隔,不要加空格:
.env
应用配置:
证书会自动处理:
  • 如果你自己的证书(TLS_CERT_FILE)已经包含该域名,直接使用它。
  • 否则会自动申请并续期 Let’s Encrypt 证书。前提是域名已解析到服务器,且 80 和 443 端口可以从公网访问。
如果部署在不能从公网访问的内网,请把该域名加进你在 TLS_CERT_FILE 中提供的证书。

第 3 步:验证

打开 https://portal.example.org,应用正常加载,地址栏保持为 portal.example.org。也可以在终端检查:
应用原来的访问链接仍然可用。需要登录的应用,访问者登录后会回到这个域名;如果多个域名指向同一个应用,会回到排在最前面的那个。

修改或移除域名

  • 把域名改给另一个应用:把映射的访问链接改成另一个应用的,然后重新应用配置。
  • 应用改名或下线之后,及时更新或删除对应映射:释放出来的访问链接可能被其他应用占用。
  • 移除域名:删除对应映射并重新应用配置,再删除 DNS 记录。

常见问题

最后修改于 2026年11月5日