跳到主要内容

使用自己的域名提供护照

最后更新:2026年10月19日

此域名的用途

每份已发布的护照都已有一个可用的 passportcraft.com 网址,因此您可以自行决定是否配置域名。自定义域名上线后,客户看到的护照页面和新下载的 QR 码将使用您的子域名,例如 dpp.yourbrand.com。您连接的是自己已经拥有的域名。PassportCraft 不向您出售域名,也不管理域名注册;您仍需在自己的注册商处维护注册。

此功能适用于所有产品类型,包括电池。每个工作区单独设置自己的域名。如果您管理多个品牌,需要为各自的工作区分别设置。合作伙伴组织自己的工作区,即其演示空间,没有自定义域名页面。合作伙伴需要在客户的工作区中设置自定义域名;参见管理客户。

对于电池护照,法律要求即使负责的企业不再存在,护照也必须保持可访问。如果护照使用您自己的域名,持续维护该域名的注册也是这项责任的一部分。

开始之前

您需要拥有一个域名,并能够访问其 DNS 设置。

持续维护域名注册,地址才能继续使用

Passportcraft.com 能够持续使用,是因为我们维护其注册。使用您自己的域名后,这项责任由您承担:域名必须保持注册有效,并指向 PassportCraft。如果域名过期,或子域名不再指向 PassportCraft,已经印有该域名的 QR 码将无法使用,直到您解决问题。

域名完成设置时就会公开可查

为域名签发的每一张证书都会进入公开的证书透明度日志,任何人都可以查询。您的域名通过验证后也会如此,即使尚未上线。如果您不希望自己的子域名在正式宣布前被公开发现,请考虑这一时间安排。

添加域名

  1. 打开设置 > 自定义域名。页面会显示护照页面和新下载 QR 码当前使用的地址。
  2. 输入您的子域名,例如 dpp.yourbrand.com,然后确认。
  3. 页面会显示一条 CNAME 记录,包含主机记录和记录值。请在管理您 DNS 的服务商处添加,并始终复制页面当前显示的值。
  4. CNAME 上方会显示一条 TXT 记录,其主机记录以 _passportcraft-verify 开头。它用于证明您能够编辑该域名的 DNS,每个域名都必须添加。如果域名之前关联过其他 Vercel 账户,可能还会显示第二条 TXT 记录;该记录也必须添加。
  5. 在 DNS 服务商处添加页面显示的所有记录,然后返回并点击检查 DNS。

DNS 更改可能需要几分钟到几小时才能生效。如果检查 DNS未能立即成功,请稍后重试。打开页面时也会自动检查,但不会每次访问都检查。因此,修改记录后请点击检查 DNS,而不是反复刷新页面。

检查会做什么

检查 DNS会检查 CNAME 是否指向正确位置、证明域名控制权的 TXT 记录是否存在,以及能否为域名签发安全证书。这三项必须全部通过。如果 TXT 记录还不可见,域名将保持等待 DNS 生效状态。请添加记录后再次点击检查 DNS。

DNS 验证通过并不代表域名已经开始提供护照页面,您还需要支付方案费用。验证通过后,可以打开 DNS 设置查看当前的 CNAME 记录。已完成验证的 TXT 记录不再显示。请在 DNS 服务商处保留您添加的所有记录。

DNS 验证后,可点击检查连接再次检查。打开 DNS 设置只会显示记录,不会触发检查。上次尝试检查表示最近一次尝试检查的时间,并不代表持续监控。

了解域名状态

页面会显示当前护照地址和下一步操作:

  • 等待 DNS 生效:记录尚未确认。页面会继续显示需要添加的记录。
  • DNS 已验证:试用期间的设置已完成。点击开通 Pro 并上线,查看方案并支付 Pro 或 Scale 费用。在域名上线之前,护照页面和 QR 码仍使用 passportcraft.com。
  • 等待激活:DNS 已设置完成,正在等待方案激活。点击刷新状态可加载最新状态。
  • 已上线:域名正在提供您的护照页面。新下载的 QR 码会使用此域名。之前使用 passportcraft.com 的 QR 码仍通过原地址正常使用。

上线后,请分享您自己域名下的护照地址,并在之后制作的印刷品中使用新的 QR 码。搜索引擎也会将此地址作为首选网址。同一护照页面仍会保留在 passportcraft.com 上,供持有旧 QR 码的人访问。

如果显示连接需要检查,请查看 DNS 设置中的 CNAME 记录,在 DNS 服务商处更新后,再点击检查连接。一次请求失败并不能单独证明域名已断开连接;您可以点击重试再次请求。

打开护照会打开您域名下的一份已发布护照,复制护照链接会复制其地址。查看护照会打开目录,您可以在其中选择护照并下载 QR 码。如果尚未发布护照,请先发布一份,即可在此查看。

移除域名的影响

移除域名后:

  • 已经在标签、吊牌或包装上印有该域名的 QR 码将无法使用,直到您将子域名指向其他位置。这些 QR 码不会自动改用 passportcraft.com。
  • 经销商或零售商可能已在自己的系统或材料中保存 QR 码的数字副本。您无法收回这些副本,需要通知持有者进行更新。

更换域名时,也必须先移除旧域名,再添加新域名,不能直接替换。

自定义域名不能替代什么

使用自己的域名,意味着您可以控制 QR 码指向哪里。但它不会为护照数据创建独立的备份副本。如果您所属产品类别的规则要求通过独立方式提供护照信息,仅连接自己的域名不能满足这一要求:护照仍由 PassportCraft 托管。请确认适用于您产品类别的具体要求。

相关文章

常见问题

可以使用主域名,而不是子域名吗?

不可以。请使用您已拥有的域名下的子域名,例如 dpp.yourbrand.com,而非 yourbrand.com 本身。系统不接受根域名,因为将整个域名指向 PassportCraft 会影响您网站的其他部分,包括电子邮件。

哪些方案包含此功能?

Pro 和 Scale 均包含,Pro 试用期间也可以设置。试用期间,域名可以达到“DNS 已验证”状态,但只有在支付 Pro 或 Scale 费用后才会开始提供护照页面。如果试用先结束,域名会被移除,您需要在升级后重新添加。

之前下载的 passportcraft.com QR 码会怎样?

它们仍可正常使用。添加、启用或移除自定义域名,都不会更改已有 QR 码中的网址。只有在自定义域名上线后下载的 QR 码才会使用新域名。

两个工作区可以共用一个域名吗?可以连接多个域名吗?

都不可以。每个工作区只能连接一个域名;已被其他工作区或其他地方使用的域名会被拒绝。如需更换域名,请先移除旧域名,再添加新域名。