linux gitlab仓库如何配置

下面按常见使用场景给你一个清晰的 Linux + GitLab 仓库配置指南，分为：本地 Git 配置、SSH 配置、克隆/创建仓库、权限与 CI 简单说明。

一、Linux 上基础 Git 环境配置

1. 安装 Git

# CentOS / RHEL
sudo yum install -y git

# Ubuntu / Debian
sudo apt update
sudo apt install -y git

2. 配置用户信息（必须）

git config --global user.name "你的名字"
git config --global user.email "你的邮箱@xxx.com"

3. 检查配置

git config --list

二、GitLab SSH 密钥配置（推荐）

1. 生成 SSH 密钥

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

一路回车即可（默认 ~/.ssh/id_ed25519）

2. 查看公钥

cat ~/.ssh/id_ed25519.pub

3. 添加到 GitLab

• 登录 GitLab
• 右上角头像 → Preferences
• SSH Keys
• 粘贴公钥 → Add Key

4. 测试连接

ssh -T git@gitlab.com

或自建 GitLab：

ssh -T git@your-gitlab-domain

三、克隆 GitLab 仓库

SSH 方式（推荐）

git clone git@gitlab.com:group/project.git

HTTPS 方式

git clone https://gitlab.com/group/project.git

四、本地新建项目并推送到 GitLab

1. 本地初始化

mkdir myproject
cd myproject
git init

2. 添加文件

echo "# My Project" > README.md
git add .
git commit -m "init"

3. 关联 GitLab 仓库

git remote add origin git@gitlab.com:group/project.git

4. 推送

git branch -M main
git push -u origin main

五、GitLab 仓库权限说明

推送失败通常是无 Developer 权限

六、Linux 服务器上使用 GitLab CI（简要）

1. 安装 GitLab Runner

curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh | sudo bash
sudo yum install gitlab-runner

2. 注册 Runner

sudo gitlab-runner register

按提示填写：

• GitLab URL
• Token（项目 → Settings → CI/CD）
• 执行器（shell / docker）

七、常见问题

❌ Permission denied (publickey)

• 没添加 SSH key
• 用了 HTTPS 却以为用 SSH

❌ failed to push

git pull origin main --rebase
git push

如果你能告诉我：

• ✅ 用的是 GitLab.com 还是自建 GitLab
• ✅ 只是拉代码还是配 CI
• ✅ CentOS / Ubuntu / 其他

我可以直接给你对应的一步步命令。