配置Git认证、设置GOPRIVATE、使用私有代理可安全拉取Go私有模块。1. 用SSH密钥或HTTPS+PAT配置Git凭证；2. 设置GOPRIVATE避免公共代理访问；3. 可选自建Athens等私有代理组合认证；4. go.mod中正确声明私有模块路径。

Go 模块在企业开发中常需要访问私有仓库，比如公司内部的 GitLab、GitHub 私有项目或自建代码服务器。默认情况下，Go 的模块代理（如 proxy.golang.org）无法获取私有内容，因此必须配置身份验证和访问控制机制。下面介绍几种常见方式，帮助你在 Golang 项目中安全地拉取私有模块。

配置 Git 凭据管理器处理私有仓库

大多数 Go 私有模块基于 Git 托管服务（如 GitHub、GitLab、Bitbucket），Go 命令行工具会通过 Git 协议拉取代码。你需要确保 Git 能自动认证。

使用 SSH 密钥是最常见的做法：

• 生成 SSH 密钥对并添加公钥到你的代码平台账户
• 确保 ~/.ssh/config 正确配置 Host 别名（可选）
• 使用 git@github.com:your-org/your-module.git 格式作为模块路径

另一种方式是使用 HTTPS + 个人访问令牌（PAT）：

• 在 GitHub/GitLab 创建具有读取权限的 Token
• 配置 Git 凭据存储：
  git config --global credential.helper store
• 首次克隆时输入用户名和 Token，之后自动缓存

设置 GOPRIVATE 环境变量绕过代理

Go 默认会尝试通过公共代理下载模块，但私有模块不能公开访问。你需要告诉 Go 哪些模块是私有的，不应走代理。

设置 GOPRIVATE 环境变量来排除特定域名：

也可以在命令行中临时设置：

这样 Go 就会直接使用 Git 命令拉取这些域名下的模块，跳过 proxy.golang.org 和 checksum 验证。

自定义 GOPROXY 并组合私有代理

对于大型团队，推荐搭建私有 Go 模块代理，如 Athens 或 JFrog Artifactory，既能缓存公共模块，又能集成私有仓库访问。

你可以将多个代理组合使用：

顺序表示优先级。如果前一个代理返回 404 或 403，Go 会尝试下一个。最后的 off 可用于完全禁用代理（仅限可信网络）。

私有代理通常支持以下认证方式：

• OAuth2 或 API Token 认证
• 与 LDAP/SSO 集成
• 基于 IP 白名单的访问控制

go.mod 中正确声明私有模块路径

确保模块路径与实际仓库地址一致，并符合导入语义化规范。

例如：

module gitlab.company.com/team/project/v2

require gitlab.company.com/team/lib v1.0.0

同时，在 go get 或 go mod tidy 时，Go 会解析该路径为 Git 地址。若使用非标准端口或协议，可在 .gitconfig 中重写：

基本上就这些。只要配置好 Git 认证、GOPRIVATE 和可选的私有代理，Golang 就能顺利拉取私有模块。关键是让工具链知道哪些地址是私有的，并提供正确的访问凭证。不复杂但容易忽略细节。