跳转到正文

自定义域名

使用您自己的主机名,例如 updates.example.com,用于处理您应用的 Live Update API 请求,同时 Capgo 继续管理您的渠道、bundle 和发布。

自定义域名功能适用于 企业版套餐。组织管理员可以在 Console 中添加 Live Update API 主机名,发布提供的 DNS 记录,并检查其激活状态。

  1. 打开 Capgo 控制台 并选择您的组织。
  2. 前往 设置 → 组织 → 常规 并找到 自定义域名。您需要拥有更新组织设置的权限,以及有效的 Enterprise 套餐才能添加域名。
  3. 输入主机名,例如 updates.example.com,不能包含 https://、路径或通配符。
  4. 点击 添加域名。Console 会显示需要发布的 DNS 记录,以及一个 待验证 状态。

每个组织只能配置一个 Live Updates API 主机名。您必须能够编辑其 DNS 记录。

如果 自定义域名 该选项不可用,请联系您的企业支持联系人或发送邮件至 support@capgo.app 并附上您的组织、应用 ID、期望的主机名以及 DNS 提供商。如果您需要 特定的数据驻留区域 或用于 bundle 下载的自定义主机名,请在配置前联系支持团队。

在 DNS 提供商处,添加 Console 中显示或由支持团队提供的记录。请原样复制记录类型、名称和值,包括 CNAME 以及任何所有权或证书验证 TXT 记录。点击 Console 中的值即可复制。如果你使用 Cloudflare DNS,请将 CNAME 保持为 仅 DNS 除非支持团队确认了其他设置。

请使用提供的目标地址,不要想当然地认为指向 plugin.capgo.app 的 CNAME 就够了。域名使用期间请保留这些 DNS 记录。

DNS 传播完成后,点击 刷新状态。控制台显示 活跃 仅在主机名及其 HTTPS 证书均处于激活状态时;随后提供 复制更新器配置。如需支持协助配置,请联系支持确认激活。你也可以通过以下命令检查 DNS 并验证 TLS 连接:

终端窗口
dig updates.example.com
curl -v https://updates.example.com/updates

替换 updates.example.com 使用你已配置的主机名。该 curl 命令会检查 DNS、TLS 和 HTTP 连接;对 /updates 的 GET 请求不是有效的更新检查,可能会返回 API 错误。请在步骤 4 中使用原生测试构建验证实际的更新流程。

域名激活后,从控制台复制更新器配置,并将三个 URL 全部合并到 capacitor.config.ts。对于已按标准 Capgo API 路径配置的主机名,请使用:

import type { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = {
appId: 'com.example.app',
appName: 'My App',
webDir: 'dist',
plugins: {
CapacitorUpdater: {
autoUpdate: 'atBackground',
updateUrl: 'https://updates.example.com/updates',
statsUrl: 'https://updates.example.com/stats',
channelUrl: 'https://updates.example.com/channel_self',
},
},
};
export default config;

请将示例 URL 替换为控制台显示或支持团队确认的准确 URL。保留现有的应用设置和其他插件选项。

设置用途
updateUrl检查是否有可用的 bundle。
statsUrl上报更新统计信息。
channelUrl处理设备 channel 操作。

将配置同步到您的原生项目中:

终端窗口
npx cap sync

构建并安装原生测试版本,然后:

  1. 将测试 bundle 上传到 测试通道 使用你平常的 Capgo 工作流。
  2. 检查原生设备日志,确认更新请求能到达你的自定义主机名,并且 bundle 能成功下载和安装。
  3. 确认更新统计信息出现在 Console 中;如果你的应用用到了测试通道相关操作,也一并测试。
  4. 通过你平常的应用商店分发流程发布新的原生应用版本。

旧的原生安装会继续使用其配置的端点 URL,直到用户安装新的原生版本。更新器的默认主机名为 plugin.capgo.app,由 Capgo 管理。如果你正从你控制的另一个自定义主机名迁移,请保持其 DNS 记录和服务处于启用状态,直到这些用户完成迁移。Channels、bundle 上传和回滚仍会使用你平常的 Capgo Console 和 CLI 工作流。

要移除域名,请使用 移除域名 → 确认移除 在 Organization 设置中。请先发布一个使用替代端点的原生应用版本,并让用户完成迁移:旧安装将无法再通过已移除的主机名访问。请在删除其所属 Organization 之前移除该域名。

  • DNS 解析失败: 请核对记录名称和目标值是否与支持团队提供的一致,并检查 DNS 提供商的解析生效情况。
  • HTTPS 失败: 在发布 Native Build 之前,请联系支持团队检查主机名激活和证书签发情况。
  • 请求仍在使用 plugin.capgo.app: 请确认这三个 URL,运行 npx cap sync,重新构建并安装新的原生版本。
  • Bundle 下载使用的是其他主机名: 更新响应中会提供下载 URL。如需自定义 Bundle 交付方式,请咨询支持团队,或查看 自定义存储 如果你想自行管理 Bundle 存储。
  • HTTPS 正常但更新失败: 共享应用 ID、通道、原生版本、请求时间戳和原生日志给 Capgo 支持.

查看 更新器设置 以获取完整的配置参考以及 数据位置 以了解区域端点要求。