VCS

02/03/2026

GitLab Web IP ≠ GitLab SSH Repo IP (and Why Your ~/.ssh/config Probably Lies to You)

The IP you get when you ping gitlab.yourcompany.com (or whatever your instance is) is almost never the actual IP that your Git remotes are talking to over SSH.

Quick way to find the real SSH host IP + port:

Create a throwaway test repo on your GitLab instance
Go to the repo’s “Code” button → “Clone with SSH”
Copy the git@xxx line — the hostname right after the @ is your real SSH server IP (or hostname), and the port is usually right there too (often 22, but self-hosted instances love 2222, 8022, etc.)

Common mistake that bites almost everyone:

You do this in ~/.ssh/config:

Host gitlab.jhso.cn
    HostName 172.16.1.33
    User git
    Port 2222
    IdentityFile ~/.ssh/id_ed25519_jhso

Then git clone git@gitlab.jhso.cn:group/project.git fails with

fatal: unable to access ‘git@gitlab.jhso.cn:group/project.git/’: …

Why? Because ssh is connecting to whatever A/AAAA record gitlab.jhso.cn currently resolves to — which is usually the web frontend/load-balancer IP, not the actual gitaly/ssh server.

Correct way (the ugly but working way):

Host 172.16.1.33
    HostName 172.16.1.33
    User git
    Port 2222
    IdentityFile ~/.ssh/id_ed25519_jhso

And now your remotes become git@172.16.1.33:group/project.git (yes, IP as hostname in the URL — it feels dirty but it reliably bypasses the wrong DNS target).

Moral: When GitLab is self-hosted/behind weird proxies/CDNs/firewalls, trust the SSH clone URL it literally shows you, not the pretty domain you use in the browser.

24/02/202625/02/2026

gitlab网站的IP地址不一定是gitlab远程代码仓库的IP地址

gitlab网站的IP地址不一定是gitlab远程代码仓库的IP地址，如何获取远程代码仓库的真实IP地址和端口？只需在gitlab网站上创建一个测试仓库，然后在“代码”->“使用SSH克隆”界面就能看到远程仓库的真实IP地址和端口号了：

然后在~/.ssh/config文件里，不能使用gitlab网站的域名作为Host配置项的值，例如：

Host gitlab.jhso.cn
    HostName 172.16.1.33
    User git
    Port 2222
    IdentityFile ~/.ssh/id_ed25519_jhso

否则你在本地git clone远程代码仓库时，会报错说“fatal：无法访问远程代码仓库”。

应该使用远程代码仓库的真实IP地址作为Host配置项的值，例如：

Host 172.16.1.33
    HostName 172.16.1.33
    User git
    Port 2222
    IdentityFile ~/.ssh/id_ed25519_jhso

13/02/202624/02/2026

GOVCS环境变量配置哪些包使用哪个版本控制软件来下载

$go help vcs

go get命令可以运行类似git这样的版本控制命令来下载代码。这个功能对非中心化（分布式）存储的Go包生态系统很重要，可以从任意服务器下载Go包代码，但是这也有一个潜在的安全问题，例如一个恶意的服务器故意让go get下载并运行恶意代码。

为了均衡考虑功能和安全性，go get命令默认只会使用git或hg从公共服务器下载代码。但它也会使用任意知名的版本控制系统（bzr、 fossil、git、hg、svn）来从私有服务器下载代码，私有服务器的网址由GOPRIVATE环境变量给出（更多信息参见go help private命令的输出）。只使用Git或Mercurial下载公共服务器里的Go包代码的理由是，这两个版本控制系统最关注作为不受信任的服务器的客户端运行时的相关问题。相反，Bazaar、Fossil和Subversion主要用于受信任的有权限的环境，但并没有在安全性方面做好工作。

当只有直接从版本控制系统下载代码的时候，版本控制命令才会受到一点限制。当从一个代理下载模块代码时，go get使用代理协议来下载。默认情况下，go get下载公共包会从Go模块镜像站（proxy.golang.org）下载，除非遇到因法律等原因无法从该镜像站下载的公共包或者私有包。默认情况下，go get能从Bazaar、Fossil或Subversion这些版本控制系统里下载代码，也是从Go模块镜像站下载，但是通过冒一定的安全性风险使用一个定制的沙盒运行代码版本控制命令。

GOVCS环境变量可用于更改特定包（由模块或导入路径标识）的允许的版本控制系统。GOVCS环境变量在模块模式和GOPATH模式下构建包时都适用。使用模块模式时，GOVCS环境变量的值会去匹配模块路径；使用GOPATH模式时，匹配版本控制存储库的根目录对应的导入路径。

GOVCS环境变量的值的一般形式是以逗号分隔的模式匹配列表：vcslist规则。该模式匹配是一个glob模式，必须与模块或导入路径的一个或多个前导元素匹配。vcslist是允许的版本控制命令的管道分隔列表，或用“all”表示允许使用任何已知的命令，或用“off”表示禁用所有命令。请注意，如果某个模块与vcslist为“off”的模式匹配，则如果源服务器使用“mod”方案，则该模块仍可能被下载，该方案指示go命令使用GOPROXY协议下载该模块。优先使用GOVCS列表中最前面（左边）列出的匹配模式，即使后面的模式也可能匹配。

例如：

GOVCS=github.com:git,evil.com:off,*:git|hg

通过这一设置，导入路径以github.com/开头的Go模块只能使用git下载，导入路径以evil.com开头的Go模块不能被任何版本控制命令下载，其他所有包（*号匹配所有）只能使用git或hg下载。

特殊的模式”public”和”private”分别匹配公共的或私有的模块或导入路径。如果某个包路径匹配GOPRIVATE环境变量的值，那这个包就是私有的，否则就是公共的。

如果在GOVCS环境变量里没有列出任何匹配规则，go get命令就会使用它的默认规则——用GOVCS来表达就是”public:git|hg,private:all”。

要不受限制地使用任意版本控制系统下载任意Go包，使用：GOVCS=*:all

要禁用所有版本控制系统，使用：GOVCS=*:off

go env -w命令可以用来设置GOVCS环境变量的值，给未来的go命令使用。

标签： VCS

常用的.gitignore文件写法

GitLab Web IP ≠ GitLab SSH Repo IP (and Why Your ~/.ssh/config Probably Lies to You)

gitlab网站的IP地址不一定是gitlab远程代码仓库的IP地址

GOVCS环境变量配置哪些包使用哪个版本控制软件来下载