17370845950

需配置GOPRIVATE与GONOSUMDB环境变量声明私有域名，并通过~/.netrc文件设置Token认证，使go get自动携带凭证拉取私有模块。

配置Go私有模块仓库的Token认证

Go本身不内置私有模块仓库服务，但可通过支持go get协议的第三方服务（如GitLab、GitHub、Gitea、JFrog Artifactory或自建goproxy）实现私有模块访问控制。核心在于让go命令在拉取模块时能自动携带身份凭证（如Personal Access Token或Basic Auth），避免手动输入密码或401错误。

在GOPRIVATE和GONOSUMDB中声明私有域名

Go需要知道哪些模块路径属于“私有范围”，才不会走公共代理或校验公开checksum。必须提前配置环境变量：

• GOPRIVATE：指定匹配的模块路径前缀（支持通配符），例如GOPRIVATE=git.example.com,github.com/my-org/*
• GONOSUMDB：与GOPRIVATE保持一致，禁用sum数据库校验，例如GONOSUMDB=git.example.com,github.com/my-org/*

推荐写入~/.bashrc或~/.zshrc并执行source生效。未配置会导致go get失败并提示“module not found”或“checksum mismatch”。

设置凭证：netrc或GIT_AUTH_PATH（推荐netrc）

Go CLI通过git底层拉取代码，因此复用Git的凭证机制。最常用且安全的方式是使用~/.netrc文件：

• 创建文件：touch ~/.netrc，并设权限chmod 600 ~/.netrc
• 写入内容（以GitLab为例）：
  machine git.example.com
  login your-username
  password your_personal_access_token
• 确保Git已配置git config --global credential.helper netrc

注意：token需具备read_api和read_repository权限（GitLab）或repo权限（GitHub）。不要使用账号密码，仅限Token。

验证与调试模块拉取行为

运行以下命令确认配置生效：

• go env GOPRIVATE —— 检查是否包含目标域名
• go list -m -u all 2>&1 | grep "private" —— 观察是否有私有模块解析日志
• go get git.example.com/my-team/mylib@v1.2.0 —— 实际触发拉取，观察是否静默成功（无prompt、无403）
• 启用调试：GODEBUG=httptrace=1 go get ... 可查看HTTP请求头是否含Authorization

若仍失败，检查网络能否直连仓库、Token是否过期、仓库是否开启go.mod和go.sum提交，以及模块路径是否与module声明完全一致。