就这样吧... Golang 的模块管理是现代化 Go 项目的基础， 但当你的项目依赖于内部或私有的模块时就需要更细致的配置才能保证顺利构建。本文将手把手教你怎样设置 Golang 的本地私有仓库，让你的项目能够较高效地获取所需依赖。

为哪些需要私有模块仓库？

在公司内部或组织中， 很更多代码库都是私有的，出于可靠、版本控制和合规性的原因，不允许直接从公共网络下载。 搞一下... 采用私有模块仓库能够避免依赖于公共代理，提升可靠性、减较低延迟并更良好地控制代码的版本。

配置步骤

步骤一：设置模块路径区分私有仓库

先来看，你需要告诉 Go 工具链哪些路径是私有的。这能够通过周边环境变量 `GOPRIVATE` 来实现。举个例子， 如果你的 说白了就是... 私有仓库域名是 `gitlab.example.com` 和 `mycompany.com/modules` ，你能够这样设置：

go env -w GOPRIVATE=gitlab.example.com,mycompany.com/modules

注意：更多个不同域名或路径用逗号分隔即可。

步骤二：配置 GOPRIVATE 跳过代理和校验

`GOPRIVATE` 还会作用于 Go 在下载模块时有没有采用代理和校验和验证。默认情况下Go 会尝试采用公共代理来验证 checksums。如果你的私有仓库没有，你需要禁用此功能。同样通过周边环境变量：

go env -w GOPRIVATE_SKIP_CHECK=true

步骤三：SSH 或 HTTPS 配置

根据你的私有仓库的协议选择合适的配置方式:，是不是？

• SSH 方式
• 确保你的 Git 客户端已正确配置 SSH key 并添加到相应的平台。
• 私有仓库 URL 需要是 SSH 格式

HTTPS 方式 如果你的私有仓库采用 HTTP/HTTPS 协议，则无需修改 SSH 配置。 Go 会自动尝试连接并验证证书，一阵见血。。

步骤四：GOSUMDB 配置

GOSUMDB 控制 Go 有没有采用官方的 sum.golang.org 来验证 checksums 。对于非官方的 sum.golang.org+ private-key 或者其他自定义源, 你需要手动指定或者禁用校 等..…. 验过程: go env -w GOSUMDB=off //禁用校验过程 或 go env -w GOSUMDB=sum.golang.org+ private-key /private-key ...

特殊情况处理

1x665: Go 下载模块依赖实际情况是是通过 Git 克隆代码

2x12:golang174:.org下载模块,并验证其校验和

4x43:Go Modules 采用 git 命令拉取代码

临时替换本地路径

在开发周边环境下有时会临时将本地路径指向本地文件系统以便测试或其他原因。

CI 构建时的注意事项

在持续集成 周边环境中构建时 如果未正确设置 `GOPRIVATE` ，有可能会引起 CI 构建失利。这是因为 CI 周边环境通常没有全局的 SSH key 配置，而 Go 默认会尝试 checksums 。 为了避免这种情况，需要在 CI 构建脚本中明确设置 `GOPRIVATE` 和禁用 checksum validation 。具体方法如下:

• 确保 CI 周边环境的用户名和邮箱已添加到 Git 平台的部署密钥中

并且在CI配置文件中添加: bash script go env -w GOPRIVATE=gitlab.* go env -w GOPRIVATE_SKIP_CHECK=true 脚本

Indirect Dependencies 处理

我好了。 当一个 module 是另一个 module 的 dependency 时它的路径会自动匹配到父module 的 GOPRIVATE 中定义的 private paths 。 举个例子 a 是 b 的 indirect dependency ， b 通过 c 发布到 public repositories ，a 能够通过 c 的 package path 直接访问到 b 。 但需要注意的是 local development 时如果采用了 replace 指向本地路径引起 build 时 git 去公共代理查找失利.

选择合适的代码托管服务

在搭建私有库之前, 你需要考虑代码托管服务的选择. Gitea 是一个轻巧量级的自托管Git服务, 它包含了较大一部分GitLab的功能, 而且安装配置更加简洁. 其他方案包括 GitLab CE、 GitHub Enterprise 等等. 选择哪种方案取决于你的需求、预算以及技术手段能力. 注意点: * 镜像存储: 选择合适的镜像存储解决方案 。* 访问控制: 设置严格的访问权限控制策略，不堪入目。。

配置 Golang 本地私有模块仓库涉及更多个不同方面：路径区分、 周边环境变量设置、协议选择等。掌握这一些技巧后你就能更良好地管理项目的依赖关系，提升开发效率和可靠性。 希望这篇文章能协助你成功搭建 Golang 私有仓库，我爱我家。！

---