一篇文章彻底弄懂Golang私有仓库配置问题

已于 2023-07-20 20:15:48 修改
阅读量4k 收藏 2
点赞数 5
分类专栏： go golang 后端 文章标签： golang 开发语言 后端
于 2023-06-14 14:32:42 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/pillar04/article/details/131206819
版权
golang 同时被 3 个专栏收录
2 篇文章 0 订阅
订阅专栏
go
1 篇文章 0 订阅
订阅专栏
后端
1 篇文章 0 订阅
订阅专栏

引言：

一般通过 go get 拉取的是公共仓库的代码(如: github.com中的代码)，是不需要任务权限就能拉下来。但当我们配置的私有仓库一般都需要用户名密码来登录才能拉取代码，所以私有仓库主要是解决认证问题。

了解 go get

在早期版本的Go中，“go get”用于构建和安装包。现在，“go get”专门用于调整go.mod中的依赖项，即下载所需要的包。'go install'可以用来构建和安装命令。go get通常也是使用 git、svn等工具进行拉取所需要的包。怎么决定使用哪个工具呢？

1. 通过静态方式

1.1 通过仓库域名

例如：go get github.com/example/pkg

域名为github.com go就直接使用 git 工具进行拉取。

1.2 通过后缀

例如：go get github.com/example/pkg.git

后缀为.git，也直接使用 git 工具进行拉取。

2. 通过动态方式

选择动态方式是因为域名和后缀都无法判断仓库类型，所以一般私有的仓库会使用动态方式。

通过在go get 命令中加 -v参数能够看到将请求的结果 go get -v git.test.com/example/pkg

2.1 询问仓库

go get 时，go 会先使用 //git.test.com/example/pkg?go-get=1 请求再从结果中判断使用哪个工具拉取。

2.2 分析结果

返回结果如下：

<html>
	<head>
		<meta name="go-import" content="git.test.com/example/pkg git http://git.test.com/example/pkg.git" />
		<meta name="go-source" content="git.test.com/example/pkg http://git.test.com/example/pkg http://git.test.com/example/pkg/-/tree/master{/dir} http://git.test.com/example/pkg/-/blob/master{/dir}/{file}#L{line}" />
	</head>
	<body>go get http://git.test.com/example/pkg</body>
</html>

其中：<meta name="go-import" content="git.test.com/example/pkg git http://git.test.com/example/pkg.git" /> 的content的值分3段，格式为：

<meta name="go-import" content="root-path vcs repo-url" />

  • root-path: 模块名字，如：git.test.com/example/pkg

  • vcs: 使用的管理工具，如: git

  • repo-url：指的是模块原代码存放在哪个仓库下面，该仓库就需要是协议加仓库地址的形式。如：http://git.test.com/example/pkg.git

那么go就知道使用哪个工具拉取包了。

git认证

知道从哪里拉取、怎么拉取，正常就可以拉取go包了，但私有仓库需要git认证。git拉取代码认证的方式有3种：

URI的完整格式：

schema://username:password@host:port?query#fragment

  • •

    schema: 协议，如http/https/ftp等

  • •

    username: 用户名

  • •

    password: 密码

  • •

    host: ip或域名

  • •

    port: 端口

  • •

    query: 查询字符串

  • •

    fragment: 锚点

1. 用户名、密码

需要在拉取时输入用户名密码，但go get时禁止交互（弹框，提示输入用户名密码），我们可以参考URI格式使用 URL中添加用户名密码，即可。但我们go get时也没办法去改这个呀，后面介绍使用 git的 insteadof解决。

如：http://root:passpwd@git.test.com/example/pkg

2. 用户名、access token（推荐使用）

作用和功能同1中的用户名、密码。只是一般用户名密码是用来登录的，如果把密码暴露了（因为这种认证会保存在git配置中，后面会介绍）就不太好了，本来只想让程序去拉取一个仓库代码，结果别人知道密码了，直接登录上去了。token生成时是可以设置权限的，更为安全，使用在拉取代码时只给 read_repository权限即可。

3. ssh

可以在本地创建非对称的加密对（ssh-keygen）。把公钥放到仓库里面去。

git的insteadof

git的insteadof在拉取代码，发送请求前替换请求地址。格式如下：

git config --global url."https://$GIT_USER:$GIT_TOKEN@$GOPRIVATE".insteadOf "https://$GOPRIVATE"

表示在请求 https://$GOPRIVATE 仓库时，会被替换成 https://$GIT_USER:$GIT_TOKEN@$GOPRIVATE，即包含了用户名和密码，所以会拉取成功。

注：必须设置成 --global 与 --system，git 支持 --global、--local、--system。

  • --system 作用范围太大了，此机器的其他用户或项目都使用了此设置。

  • --local只能针对当前项目（所以必须在项目所在目录，它会找.git目录中的设置），go使用git命令时目录可能存在问题。【未验证】

例如：

git config --global url."https://root:VUQsGPQdxy5CDQ9xEs24@git.test.com".insteadOf "http://git.test.com"

表示在请求http://git.test.com私有仓库的包时会被替换成https://root:VUQsGPQdxy5CDQ9xEs24@git.test.com，这里的root是仓库的用户名，VUQsGPQdxy5CDQ9xEs24是access token，

注：网上有人说 insteadOf后面的域名必须带 /即http://git.test.com/，insteadOf前端字符串必须带:，即：https://root:VUQsGPQdxy5CDQ9xEs24@git.test.com:。可能是平台或配置原因。根据自己的实际情况替换即可。

例如：

go get -v git.test.com/example/pkg 前，先通过 //git.test.com/example/pkg?go-get=1 进行访问，看返回的页面的实际协议，如我这里body中的：go get http://git.test.com/example/pkg

那么说明我的go get git.test.com/example/pkg 将被替换为`go get http://git.test.com/example/pkg（注：go 自动完成）

这时我需要将用户名和access token，添加上，所以要把 http://git.test.com 替换为https://root:VUQsGPQdxy5CDQ9xEs24@git.test.com（需要我们手动配置git config）

最终替换完的结果将是：https://root:VUQsGPQdxy5CDQ9xEs24@git.test.com/example/pkg

这时go会使用最终的地址进行git clone https://root:VUQsGPQdxy5CDQ9xEs24@git.test.com/example/pkg

完整流程

  1. 1.

    在GOPRIVATE环境变量中加入私有仓库地址。

    go env -w GOPRIVATE=git.test.com

    此时另外两个GO的环境变量正常也会自动被设置与GOPRIVATE设置的值相同：（如果没有改过来，请自行检查并修改）

    set GONOPROXY=git.test.com  # 拉取git.test.com时不使用GOPROXY代理服务器
set GONOSUMDB=git.test.com  # 拉取包成功后不进行签名校验，因为我们的私有库没有生成签名

  2. 2.

    设置git config地址替换

    git config --global url."https://root:VUQsGPQdxy5CDQ9xEs24@git.test.com".insteadOf "http://git.test.com"

    这个设置会被保存在git全局的配置文件中。如我的window位置为：C:\Users\lxz\.gitconfig文件

    内容如下：

    ...省略不相关的配置
[url "https://root:VUQsGPQdxy5CDQ9xEs24@git.test.com"]
	insteadOf = http://git.test.com

    小知识点：引号中的内容会被设置在配置项目名称后面，中括号内(如：https://root:...)，不带引号被设置在配置项内部（如: insteadOf）

  3. 3.

    进行拉取即可

    go get git.test.com/example/pkg

其他

1. 有时候配置了 git config 的insteadOf 后还是不好使，可能是因为之前设置过，需要把之前的删除。

先查看所有设置

> git config --global -l

# 结果显示

...省略不相关的配置
url.https://root:VUQsGPQdxy5CDQ9xEs24@git.test.com.insteadof=http://git.test.com
...省略不相关的配置

再进行删除（复制=号之前的所有字符串）

git config --global --unset url.https://root:VUQsGPQdxy5CDQ9xEs24@git.test.com.insteadof

2. 凭证管理

git凭证管理和git本身是两个独立的程序，凭证管理工具位置有git安装目录中，例如我的目录C:\Program Files\Git\mingw64\libexec\git-core下会有:

git-credential-cache.exe
git-credential-cache--daemon.exe
git-credential-manager-core.exe
git-credential-store.exe
git-credential-wincred.exe

查看git使用的凭证管理工具：

> git config --list

...省略不相关的配置
credential.helper=manager-core
credential.helper=store 
...省略不相关的配置

Git 甚至允许你配置多个辅助工具。 当查找特定服务器的凭证时，Git 会按顺序查询，并且在找到第一个回答时停止查询。 当保存凭证时，Git 会将用户名和密码发送给 所有 配置列表中的辅助工具，它们会按自己的方式处理用户名和密码。

注意，这里的manager-core和store分别对应目录C:\Program Files\Git\mingw64\libexec\git-core下的git-credential-manager-core.exe和git-credential-store.exe。当然你也可以自己写一个辅助工具，放在这个目录里。例如你开发一个：foo的工具，你设置时使用git config --global credential.helper foo，你的文件名称应该为：git-credential-foo.exe

git-credential-manager-core.exe是微软开发的工具，它把凭证保存在了windows的凭证管理中。控制面板\用户帐户\凭证管理\管理windows凭证中。所以有时有的人把 git config中的insteadof已经删除了，但还可以正常拉取。是因为系统已经把凭证保存起来了，我们拉取代码的时候git自动从凭证管理功能中获取到凭证，再拼接上进行请求。

3. go mod cache

go get 拉取代码时后在$GOPATH/pkg/下生成缓存，而且会有2级缓存。

第1级缓存：首先会在$GOPATH/pkg/mod/cache目录中下载所需要的包，以压缩所格式保存。

第2级缓存：在$GOPATH/pkg/mod中解压cache中的包，放在与cache目录同级。

这样我们 go get 时会先检查第2级缓存，如果不存在，再去检查第1级缓存，如果都不存在再连网去仓库拉取包，并生成缓存。

可以手动删除缓存或通过命令(命令会将整个$GOPATH/pkg/mod目录删除)：

go clean -modcache

所以有时在认证后拉取的包缓存在了本地，即使认证的access token或密码修改了，再go get或go mod tidy时也可以成功使用包，也可能是使用了之前的缓存。

参考文章

Git - 凭证存储

Git 凭据保存、如何修改_git凭据怎么设置_薛瑄的博客-CSDN博客

私有化仓库的 GO 模块使用实践 - 知乎

Go Modules Reference - The Go Programming Language

点击查看更多文章

更新精彩文章请关注微信公众号：大胡几哥哥

pillar04
关注
  • 5
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
解决golang go get私有仓库的问题
smokelee的博客
03-24 1万+
解决golang go get gitlab私有仓库的问题（1.13） 1. 问题描述 require ( git.xxxxxxx.com/middle/user v0.0.1 ) go mod tidy 导入包失败 go get git.xxxxxxx.com/middle/user 失败 go build 有CHECKSUM过程，无法编译 2. 现象分析 go get 不支持代码支...
golang 使用 viper 读取自定义配置文件
01-21
viper 支持 Yaml、Json、 TOML、HCL 等格式，读取非常的方便。 ... ...创建 config.yaml 文件 database: driver: mysql ...建一个 config.go 用于初始化配置文件 func InitConfig() { path, err := os.Getwd()
go get私有仓库问题集锦
小白菜的专栏
02-09 1558
未提供https go env -w GOINSECURE=gitdemo.com 鉴权问题 get "gitlab.com/xxx/zz": found meta tag get.metaImport{Prefix:"gitlab.com/xxx/zz", VCS:"git", RepoRoot:"https://gitlab.com/xxx/zz.git"} at //gitlab.com/xxx/zz?go-get=1 verifying gitlab.com/xxx/zz@v0.0.1: gitl
完美解决golang go get私有仓库的问题
senlin1202的博客
09-30 5718
这是由于go get在进行获取远程包的时候，没有指定用户以及密码，导致没有权限，故失败。go get 不支持代码支持之外的仓库。3、调整git https===>ssh，注意username换成自己的用户名。1、给释出的仓库打tag比如v0.0.1，这样仓库地址就可以被识别。这种错误是GOPRIVATE 设置错误，使得go去验证库的sum。这种错误为没有配置 git 的https转换为 ssh。下载过程如果机器设置了GOPROXY，会导致下载失败。来指定私有仓库，用于不走代理的方式。
【golang】go mod私有仓库配置
最新发布
Daniel的博客
07-02 1262
当我们新建一个`go`项目时，在项目根目录下执行`go mod init`可以初始化go.mod文件用于管理包依赖。如果我们没有进行配置，则只能访问公共开源仓库。如果想要下载私有仓库依赖包则需要进行一些配置。 一般主流的代码托管站站点如github，gitlab，Gitee等，都默认支持返回站点的golang mod元数据。如果无法对外暴露站点的域名，且甚至无法拥有更改站点访问地址的权限。这时需要配置一个虚拟的域名作为go mod的引用包路径。
Golang使用私有仓库
ijijni的博客
07-19 8460
在开发中我们经常会引用一些我们自己私有的公共项目。比如私有的common包。一般情况下，引用这些包有两种方式。一种是使用传统的go path，还有一种是使用go mod模式，然后加replace。 这两种方式都会有一些弊端，现在推荐第三种方式，go mod+私有仓库的方式。 如图所示，以git.ctyun.cn开头的地址，是我们的私有仓库。执行go get时，会首先去我们配置的私有仓库地址拉取项目，然后再从github.com拉取项目。 配置方式： 1.配置go env的全局变量。 // 配.
golang 配置私有仓库
Jchn lau
03-03 2251
配置使用ssh 访问的仓库 1. go mod 根据go.mod拉取依赖库时，会使用https的方式。为了方便我们也可以通过配置git 全局配置来使用 ssh的方式拉取依赖，下面是配置 https转换为ssh的方式: git config --global url."git@gitee.com:".insteadOf "https://gitee.com/" 2. 配置环境变量，来指定私有仓库，用于不走代理的方式 go env -w GOPRIVATE=gitee.com 这里配置私有仓库是g.
go 私有仓库
zzz_strive的博客
02-26 744
go 私有仓库问题 go获取私有仓库需要的配置 通过修改文件方式，去到当前用户目录修改.gitconfig文件，新增如下: [url "ssh://git@xxx/"] insteadOf = https://xxx/ #区分http与https 通过命令行形式，直接执行命令如下： git config --global url."git@gitlab.xxxx.com:".insteadOf "http://gitlab.xxxx.com/" ...
golang常用库之配置文件解析库-viper使用详解
01-19
viper 配置管理解析库，是由大神 Steve Francia 开发，他在google领导着 golang 的产品开发，他也是 gohugo.io 的创始人之一，命令行解析库 cobra 开发者。总之，他在golang领域是专家，很牛的一个人。 他的github...
vscode golang开发环境配置文件
05-17
vscode配置golang开发环境使用的配置文件，导入该文件即可完成环境配置。
一系列文章和视频，以了解Golang的内部结构。-Golang开发
05-26
Golang内部构件资源这是有关Golang内部构件的精选文章和视频的精选集。 它适用于刚接触Golang并希望了解幕后情况的高级/中级程序员。 Golang内部构件资源这是有关Golang内部构件的精选文章和视频的精选集。 它适用...
Pyroscope是一个开源的连续配置平台。-Golang开发
05-26
高温计高温计是一个开源的连续分析平台。 它目前正在积极开发中，边缘有些粗糙。 试试看，加入我们的Slack-我们很乐意获得一些反馈和/或帮助您入门。 实时演示:fire:Pyroscope实时演示:fire:功能可以存储来自多个...
在golang中引入私有git仓库的pkg包？引入私有Git仓库的包：在Go语言项目中轻松实现
猫头虎：授渔优于赠鱼，兴趣引领智慧，探索之乐尤显珍贵。商务合作：Libin9iOak，共赴知识与乐趣的探索之旅！
08-08 1268
在Go语言开发中，使用第三方包是提高效率和代码复用性的关键。有时，我们需要从私有Git仓库中引入包，以便与团队合作或使用专有功能。本文将指导你如何在Go项目中引入私有Git仓库的包，从设置SSH密钥到导入包和使用包，一步步详细介绍了操作过程。通过这篇博客，我们了解了在Go语言项目中引入私有Git仓库的包的步骤。从设置SSH密钥到获取包、导入包和使用包，我们一步步地指导了整个过程。这将帮助你轻松地与团队成员共享私有代码，并在项目中有效地使用第三方包。
Go导入私有仓库
陈戏猿
04-09 645
这个问题其实分两种情况来看，如果你自己的仓库是一个“正规”的仓库，使用域名访问，不带端口，通过HTTPS访问，唯一的区别是你的仓库是私有的。最后的最后，如果你使用的是GoLand或者IDEA，这类IDE好像有自己的环境变量机制，直接修改系统环境变量有时候不会生效，你需要在IDE里面设置或者在它的命令行通过。接下来就是比较复杂的情况，比如仓库是非标的，通过IP地址访问，或者需要带端口访问，还有只能通过HTTP访问等。如果你只有某个组下的仓库是私有的，可以通过路径指定，多个域名通过逗号分隔。
Golang项目中如何轻松实现私有仓库pkg包的引入
xcbeyond|疯狂源自梦想，技术成就辉煌
08-11 2234
在企业内部创建一个公共的Golang模块工程可以帮助提高代码复用性和开发效率。本文将从如何创建一个公共的Golang工程开始，指导你一步步创建它、并引入到你的工程中。
go 配置国内仓库
风雨三千的博客
06-17 2803
Linux配置 在.bash_profile中增加环境变量，这里使用百度的proxy仓库 export GOPROXY=https://goproxy.baidu.com/ 也可使用： http://goproxy.cn Intellij IDEA配置 goland没用过，不过是同一个公司的IDE，配置应该差不多 Settings ->Language & Frameworks Go -> Go Modules ...
Go-proxy私有仓库配置实践
weixin_38496860的博客
11-03 3213
一 项目背景 目前的golang私有库依赖，可以放在git repo中，需要特别在go.mod中写replace条目，解决多重依赖很麻烦，git 的repo有可能比较大,使用该方案能够支持版本的统一管理（公共依赖和私有依赖都通过go get 获取）。 二 整体流程 前言： 因为私有仓库不能直接go get, 所以需要自己开发一个<代理服务>，参https://segme...
配置GOPRIVATE引用私有仓库
u014659211的专栏
06-13 8392
golang 引用私有仓库
golang 私人仓库
08-28
引用: golang 私人仓库主要是为了解决认证问题。一般通过 go get 拉取的是公共仓库的代码，这些代码是不需要任何认证就可以拉取的，例如在 GitHub 上的公共仓库。但是配置的私人仓库则需要用户名和密码来登录才能拉取代码。因此，私人仓库可以提供更高级的安全性和权限控制。 当我们需要使用私人仓库的代码时，可以使用类似于以下的命令： go get git.example.com/private-repo 其中，git.example.com/private-repo 是私人仓库的地址。根据仓库的配置，可能会需要输入用户名和密码来进行身份验证，以确保只有授权的用户才能访问私人仓库中的代码。 在 Windows 环境下，还可以使用免密登录方式，即在 git config 中配置用户名和密码，这样在执行 go get 时就不需要手动输入用户名和密码了。 需要注意的是，私人仓库的地址需要按照特定的格式来指定，即协议加仓库地址的形式。例如，http://git.example.com/private-repo.git。这是为了确保正确连接到私人仓库并下载代码。<span class="em">1</span><span class="em">2</span><span class="em">3</span> #### 引用[.reference_title] - *1* *3* [一篇文章彻底弄懂Golang私有仓库配置问题](https://blog.csdn.net/pillar04/article/details/131206819)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_2"}}] [.reference_item style="max-width: 50%"] - *2* [Golang使用私有仓库](https://blog.csdn.net/ijijni/article/details/118891606)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_2"}}] [.reference_item style="max-width: 50%"] [ .reference_list ]
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值