如何从Docker部署的自托管GitLab实例推送、克隆仓库

一、克隆GitLab仓库到本地 #

根据你的Docker部署配置（SSH端口映射为宿主机8080），提供两种克隆方式：

HTTP/HTTPS 方式 #

• 打开浏览器进入你的GitLab实例（比如http://你的服务器IP或https://你的服务器IP），找到目标仓库。
• 点击仓库页面的「克隆」按钮，选择「HTTP」或「HTTPS」，复制对应的克隆地址，格式类似 http://你的服务器IP/用户名/仓库名.git。
• 在本地终端执行克隆命令：

git clone http://你的服务器IP/用户名/仓库名.git

• 首次克隆会提示输入GitLab的用户名和密码，输入你的GitLab账号信息即可完成克隆。

SSH 方式 #

由于Docker将容器22端口映射到了宿主机8080，SSH克隆需要指定端口：

1. 生成本地SSH密钥（未生成过的话）：

ssh-keygen -t ed25519 -C "你的邮箱地址"

一路回车使用默认设置即可。
2. 复制本地SSH公钥内容，公钥默认路径为~/.ssh/id_ed25519.pub（RSA密钥则是id_rsa.pub），可通过以下命令查看并复制：

cat ~/.ssh/id_ed25519.pub

3. 回到GitLab页面，点击右上角头像→「设置」→「SSH密钥」，粘贴公钥到输入框，填写标题后点击「添加密钥」。
4. 回到仓库页面，复制SSH克隆基础地址（类似git@你的服务器IP:用户名/仓库名.git）。
5. 执行带端口的克隆命令：

git clone ssh://git@你的服务器IP:8080/用户名/仓库名.git

或者修改本地SSH配置文件自动指定端口：创建/编辑~/.ssh/config，添加以下内容：

Host 你的服务器IP
    HostName 你的服务器IP
    User git
    Port 8080

保存后即可直接用基础地址克隆：

git clone git@你的服务器IP:用户名/仓库名.git

二、推送本地仓库到GitLab实例 #

本地已有Git仓库的情况 #

• 先在GitLab创建对应空仓库（不要勾选「初始化仓库」选项）。
• 进入本地仓库目录：

cd 本地仓库路径

• 添加GitLab作为远程仓库：
  • HTTP/HTTPS方式：

  git remote add origin http://你的服务器IP/用户名/仓库名.git
  

  • SSH方式（已配置SSH config可直接用基础地址）：

  git remote add origin ssh://git@你的服务器IP:8080/用户名/仓库名.git
  

• 推送代码到GitLab主分支（通常为main或master）：

git push -u origin main

-u参数会关联本地与远程分支，后续直接执行git push即可。

本地未初始化Git仓库的情况 #

cd 项目目录
git init
git add .
git commit -m "初始化提交"
# 执行上述添加远程仓库和推送的步骤即可

内容的提问来源于stack exchange，提问作者Zakaria Ait Yakoub