配置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）：
立即学习“go语言免费学习笔记（深入）”；
- 在 GitHub/GitLab 创建具有读取权限的 Token
- 配置 Git 凭据存储：
git config --global credential.helper store - 首次克隆时输入用户名和 Token，之后自动缓存
设置 GOPRIVATE 环境变量绕过代理
Go 默认会尝试通过公共代理下载模块，但私有模块不能公开访问。你需要告诉 Go 哪些模块是私有的，不应走代理。
设置 GOPRIVATE 环境变量来排除特定域名：
export GOPRIVATE=gitlab.company.com,*.internal.example.com也可以在命令行中临时设置：
GO111MODULE=on GOPRIVATE=gitlab.mycompany.com go mod tidy这样 Go 就会直接使用 Git 命令拉取这些域名下的模块，跳过 proxy.golang.org 和 checksum 验证。
自定义 GOPROXY 并组合私有代理
对于大型团队，推荐搭建私有 Go 模块代理，如 Athens 或 JFrog Artifactory，既能缓存公共模块，又能集成私有仓库访问。
你可以将多个代理组合使用：
export GOPROXY=https://proxy.golang.org,https://your-athens-proxy.internal,off顺序表示优先级。如果前一个代理返回 404 或 403，Go 会尝试下一个。最后的 off 可用于完全禁用代理（仅限可信网络）。
私有代理通常支持以下认证方式：
- OAuth2 或 API Token 认证
- 与 LDAP/SSO 集成
- 基于 IP 白名单的访问控制
go.mod 中正确声明私有模块路径
确保模块路径与实际仓库地址一致，并符合导入语义化规范。
例如：
module gitlab.company.com/team/project/v2require gitlab.company.com/team/lib v1.0.0
同时，在 go get 或 go mod tidy 时，Go 会解析该路径为 Git 地址。若使用非标准端口或协议，可在 .gitconfig 中重写：
[url "ssh://git@gitlab.company.com:2222/"]insteadOf = https://gitlab.company.com/
基本上就这些。只要配置好 Git 认证、GOPRIVATE 和可选的私有代理，Golang 就能顺利拉取私有模块。关键是让工具链知道哪些地址是私有的，并提供正确的访问凭证。不复杂但容易忽略细节。
