搭建本地可推拉Git远程仓库及SSH克隆失败问题求助

您好，我看了你遇到的本地Git远程仓库搭建和克隆的问题，咱们一步步来梳理和解决：

你的问题梳理 #

• 核心目标：在本地PC搭建支持推拉操作的Git远程仓库
• 尝试的克隆命令及报错：
  • SSH方式：git clone ssh://user@localhost:/C:/path/to/repo，报错 fatal: ''/C:/path/to/repo'' does not appear to be a git repository
  • Git协议方式：git clone git://localhost:/C:/path/to/repo，报错连接失败
• 仓库现状：非裸仓库（未加--bare参数），已有提交记录，你认为这可能影响推送但不影响克隆
• 已尝试的调整：去掉路径中的冒号改为localhost/C/、尝试添加.git后缀，均未解决问题
• SSH环境：已生成ed25519和RSA 4096密钥对，私钥已完成注册

逐个问题解决建议 #

1. SSH克隆失败的核心原因：路径格式错误

你用的SSH路径格式不符合Windows环境下的SSH解析规则，这里踩了个小坑：

• Windows路径通过SSH访问时，需要转换成类Unix格式：把C:/改成/c/，同时去掉localhost后面的冒号
• 正确的SSH克隆命令应该是：

  git clone ssh://user@localhost/c/path/to/repo
  

• 也可以加上.git后缀（明确指向仓库的Git核心目录）试试：

  git clone ssh://user@localhost/c/path/to/repo.git
  

• 先验证SSH连接是否正常：打开终端输入ssh user@localhost，如果能成功登录到本地，说明SSH配置没问题；如果登录失败，需要检查Windows的OpenSSH SSH Server服务是否开启，或者密钥是否正确添加到本地SSH认证列表。

2. Git协议克隆失败的原因：未启动Git守护进程

Git协议默认使用9418端口，且需要手动启动Git守护进程才能提供服务，直接克隆肯定连不上。如果想用Git协议，步骤如下：

1. 打开终端，进入仓库所在的上级目录（比如/c/path/）
2. 启动Git守护进程（允许读取所有仓库）：

   git daemon --reuseaddr --base-path=/c/path --export-all
   

3. 在另一个终端执行克隆命令，路径简化为仓库名：

   git clone git://localhost/repo
   

不过Git协议默认是只读的，要支持推送还需要额外配置，相对来说SSH协议更适合本地推拉场景，优先推荐解决SSH的问题。

3. 非裸仓库的推送隐患

你提到仓库是非裸仓库，克隆确实不受影响，但后续推送大概率会报错——Git默认禁止推送到非裸仓库的当前分支（避免远程工作区和分支内容冲突）。更推荐把远程仓库改成裸仓库，操作步骤：

1. 创建裸仓库：

   git init --bare /c/path/to/repo.git
   

2. 将现有仓库的内容推送到这个裸仓库：

   cd /c/path/to/your/local/repo
   git remote add origin ssh://user@localhost/c/path/to/repo.git
   git push origin master
   

3. 之后其他地方克隆这个裸仓库，就能正常执行推拉操作了：

   git clone ssh://user@localhost/c/path/to/repo.git
   

4. 关于git@localhost的说明

你看到的git@localhost写法不是GitHub/GitLab专属，它是SSH协议的简写格式，等价于ssh://git@localhost。如果你的本地有git用户可以这么用，要是你用的是自己的系统用户名，换成对应的名字即可（比如你之前的user@localhost），这个写法是有效的，只是需要确保对应用户能通过SSH登录本地。

备注：内容来源于stack exchange，提问作者Forest Lam