配置goprivate并设置git认证可使Go Modules拉取私有仓库，推荐使用ssh或PAT认证，确保git能访问仓库，必要时搭建私有代理服务。

Go Modules 是 Go 语言官方推荐的依赖管理方式，从 Go 1.11 开始支持。在实际开发中，我们经常需要引入私有仓库（如 github、gitlab、gitee 的私有项目）作为模块依赖。本文将详细说明如何配置 Go Modules 支持私有仓库，并完成私有模块的环境搭建。

配置 GOPRIVATE 跳过校验

默认情况下，Go 会尝试通过公共代理（如 proxy.golang.org）下载模块，并对模块进行 checksum 校验。对于私有仓库，这些操作会导致拉取失败。你需要通过 GOPRIVATE 环境变量告诉 Go 哪些模块是私有的，无需通过代理和校验。

设置方法：

go env -w GOPRIVATE=git.yourcompany.com,github.com/yourname/private-repo

你也可以使用通配符：

立即学习“go语言免费学习笔记（深入）”；

go env -w GOPRIVATE=*.yourcompany.com,github.com/yourname/*

该配置确保 Go 直接通过 git 协议拉取代码，跳过代理和 checksum 检查。

配置 Git 凭据访问私有仓库

Go Modules 使用 git 命令拉取代码，因此必须确保本地 git 能够认证并访问私有仓库。常用方式有 SSH 和 Personal access Token（PAT）两种。

使用 SSH 方式（推荐）：

• 生成 SSH 密钥：ssh-keygen -t ed25519 -C “your-email@example.com”
• 将公钥（~/.ssh/id_ed25519.pub）添加到你的代码平台（GitHub/GitLab/Gitee）账户中
• 测试连接：ssh -T git@github.com
• 模块引用使用 SSH 地址：github.com/yourname/private-module v1.0.0

使用 https + Token：

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

27

查看详情

• 创建 Personal Access Token（权限需包含 repo）
• 配置 git 凭据存储：

git config –global credential.helper store

下次执行 git pull 时输入用户名和 token，凭据将被保存。

模块导入路径使用 HTTPS 格式即可。

验证私有模块引用

在 go.mod 中直接 require 私有模块：

require github.com/yourname/private-module v1.0.0

执行命令触发拉取：

go mod tidy

如果提示认证失败，请检查：

• GOPRIVATE 是否包含模块域名
• SSH 是否配置正确或 Token 是否有效
• git 是否能手动 clone 该仓库

企业级私有模块服务（可选）

对于团队协作，可以搭建私有 Go Module 服务：

• 使用 Athens proxy：部署私有模块缓存代理，支持鉴权和审计
• 自建版本控制平台：GitLab 自带 Go Proxy 支持（启用了的话）
• 配置 GOSUMDB=off（仅限内部可信网络）

这类方案适合大型组织统一管理依赖源和安全策略。

基本上就这些。只要设置好 GOPRIVATE 并确保 git 认证可用，Go Modules 就能顺利拉取私有模块。不复杂但容易忽略细节。建议团队内部统一规范模块路径和认证方式，避免协作问题。