为私有 Go 模块创建自定义导入路径

将内部仓库路径和服务器 IP 隐藏在简洁、稳定的 vanity URL 之后。
一条命令即可设置,兼容任意 Git 托管平台。

// 之前 — 私有仓库
import "github.com/yourorg/private-module"

// 之前 — 自建 Git 服务器
import "192.168.1.100/yourorg/private-module"

// 之后
import "gomod.io/your/private-module" // gomod.io(默认)
import "go.yourcompany.com/private-module" // 自定义域名

30 秒完成安装与使用

第一步。 安装 CLI:

curl -fsSL gomodvanityurls.com/install.sh | bash

Windows 用户? 支持 Git BashWSL/WSL2 和 MSYS2。PowerShell 用户请直接下载 .exe

第二步。 添加 vanity URL:

gvu add gomod.io/private-module https://github.com/yourorg/private-module.git

第三步。 配置 Go 环境:

export GOPRIVATE=gomod.io

第四步。 开始使用:

import "gomod.io/private-module"

重要提示: 你的模块 go.mod 中的 module path 必须声明为 vanity URL(如 module gomod.io/private-module),而不是原始仓库地址如 github.com/yourorg/private-module

第一步。 安装 CLI 并创建账户:

curl -fsSL gomodvanityurls.com/install.sh | bash
gvu auth signup
gvu auth bind user@example.com

Windows 用户? 支持 Git BashWSL/WSL2 和 MSYS2。PowerShell 用户请直接下载 .exe

第二步。 配置 DNS 解析(必须在添加路由前完成):

go.yourcompany.com  CNAME  gomodvanityurls.com

第三步。 添加自定义域名路由:

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

第四步。 配置 Go 环境:

export GOPRIVATE=gomod.io,go.yourcompany.com

第五步。 开始使用:

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

重要提示: 你的模块 go.mod 中的 module path 必须声明为 vanity URL(如 module go.yourcompany.com/private-module),而不是原始仓库地址如 github.com/yourorg/private-module


功能特性

  • 一条命令搞定 — 安装 CLI、添加路由,完成
  • 自定义域名 — 使用你自己的域名,自动配置 TLS 证书
  • 无密码认证 — 邮箱验证码登录,无需管理密码
  • 凭证留在本地 — access token 和 Git 凭证只保存在你的机器上,服务端不存储你的 SSH 密钥或仓库密码
  • Monorepo 支持 — 通过 Go 1.25 子目录路由(--subdir)从一个仓库服务多个 Go 模块