解决 Git 通过 SSH 克隆仓库时自动转换为 HTTPS 的问题

news2025/4/3 5:59:51

解决 Git 通过 SSH 克隆仓库时自动转换为 HTTPS 的问题

在使用 Git 通过 SSH 协议克隆私有仓库时，如果遇到类似以下错误：

fatal: unable to access 'https://itlab.stack.net:stack.git/': Could not resolve host: gitlab.stack

这通常是因为 Git 配置错误或 URL 格式不正确导致协议自动转换。本文将详细分析原因并提供解决方案。

问题分析

错误核心

主机名拼接错误：Git 将 gitlab.stack 错误识别为一个主机名（缺少分隔符 /）。
协议自动转换：Git 可能被配置为将 SSH URL 强制转换为 HTTPS，导致路径格式错误。

解决方案

1. 检查 Git 协议转换配置

Git 可能被全局配置为将 SSH 转换为 HTTPS。执行以下命令检查配置：

git config --global --get-regexp insteadof

如果输出类似以下内容：

url."https://".insteadOf ssh://

说明 Git 被强制将 SSH 转换为 HTTPS。解决方法：

# 移除错误的配置
git config --global --unset-all url."https://".insteadOf

2. 确保 SSH URL 格式正确

正确的 SSH URL 格式应为：

git@gitlab.stack.git

注意：

使用 : 分隔主机和路径。
路径中的组名和项目名需正确（如 stack）。

3. 验证 SSH 连接

确保 SSH 密钥已正确配置并添加到 Git 账户：

# 测试 SSH 连接
ssh -T git@gitlab.stack.net

如果成功，会看到类似以下提示：

Hi username! You've successfully authenticated...

如果失败：

生成新的 SSH 密钥：

ssh-keygen -t ed25519 -C "your_email@example.com"

将公钥（~/.ssh/id_ed25519.pub）添加到 GitLab/GitHub 账户的 SSH Keys 设置中。

启动 SSH 代理并加载密钥：

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

4. 检查 DNS 解析

确认仓库域名可以被解析：

ping gitlab.stack.net
nslookup gitlab.stack.net

如果 DNS 失败：

检查网络连接或防火墙设置。
联系管理员确认域名是否正确。

5. 明确指定协议（可选）

在 URL 中强制使用 SSH 协议：

git clone ssh://git@gitlab.stack.net:stack.git

6. 确认仓库路径和权限

访问 https://gitlab.stack.net/stack 确认仓库存在。
确保你有权限访问该仓库（如私有仓库的访问权限）。

完整操作步骤

# 1. 移除协议转换配置
git config --global --unset-all url."https://".insteadOf

# 2. 测试 SSH 连接
ssh -T git@gitlab.stack.net

# 3. 重新尝试克隆
git clone git@gitlab.stack.net:stack.git

# 4. 检查 DNS
ping gitlab.stack.net
nslookup gitlab.stack.net

# 5. 如果 DNS 问题，联系网络管理员或使用正确的域名