Verified 和 Pro 用户可以使用自己的域名作为 vanity URL 前缀。

前提条件

  • Verified 或 Pro 账户（运行 gvu auth bind <email> 即可升级）
  • 一个你拥有 DNS 管理权限的域名
  • 已安装 gvu CLI — 参见 快速开始（Windows：使用 WSL/WSL2 或下载 .exe）

配置步骤

重要：DNS 必须在运行 gvu add 之前配置好。服务端会在路由创建时验证域名的 CNAME 记录。

1. 配置 DNS

通过 CNAME 将你的域名指向服务：

go.yourcompany.com  CNAME  gomodvanityurls.com

2. 等待 DNS 生效

DNS 变更通常在几秒到几分钟内生效。你可以用以下命令验证：

dig go.yourcompany.com CNAME +short
# 预期输出：gomodvanityurls.com.

3. 添加自定义域名路由

gvu add go.yourcompany.com/private-module https://github.com/yourorg/private-module.git

服务端会验证 CNAME 记录。如果 DNS 尚未生效，会收到 DNS_NOT_CONFIGURED 错误 — 等待传播后重试即可。

4. TLS 自动签发

TLS 证书通过 Caddy On-Demand TLS 自动签发。CLI 在创建路由后会探测该路由，如果 TLS 仍在签发中会给出提示。

5. 开始使用

import "go.yourcompany.com/private-module"

配额

套餐自定义域名总配额（共享）
Anonymous✗5
Verified✓10
Pro✓50

自定义域名路由与 gomod.io 路由共享同一个配额池。例如，一个 Verified 用户如果有 3 个自定义域名路由，则还剩 7 个 gomod.io 路由配额。

域名绑定（仅 Pro）

Pro 用户首次在某个自定义域名下添加路由时，该域名会自动绑定到你的账户。此后只有你可以在该域名下添加路由，防止其他用户使用你的 DNS 配置。

套餐DNS 验证域名绑定
Verified✓✗
Pro✓✓（最多 50 个域名）

注意： 删除域名下的所有路由不会释放域名绑定。如需释放，请联系管理员。

使用技巧

  • 建议使用子域名，如 go.yourcompany.com 或 pkg.yourcompany.com
  • 自定义域名路由不受短路径限制
  • 可以在同一账户中同时使用 gomod.io 和自定义域名路由
  • 不同子域名独立 — go.example.com 和 pkg.example.com 可属于不同用户
  • 域名绑定在 Pro 订阅过期或所有路由删除后仍然有效
  • --subdir 也适用于自定义域名：
    gvu add go.mycompany.com/module-a https://github.com/myorg/monorepo.git --subdir go/module-a

通配路由（仅 Pro）

Pro 用户可以创建通配路由，覆盖自定义域名前缀下的所有仓库，无需逐个添加。

类型语法示例
Repo 通配gvu add '域名/前缀/*' '仓库/*.git'go.mycorp.com/dept/* → github.com/dept/*.git
Subdir 通配gvu add 域名/前缀/仓库 仓库.git '--subdir=*'自动解析 monorepo 子目录

详见通配路由了解优先级规则和完整示例。