Git系列之git ssh

原创 已于 2025-11-22 17:59:25 修改 · 1.4k 阅读 · 38 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#git #git ssh

于 2025-11-12 07:15:00 首次发布

ModelEngine·创作计划征文活动 10w+人浏览 1.3k人参与

 个人主页：云纳星辰怀自在

座右铭：“所谓坚持，就是觉得还有希望！”

Git SSH 完整配置与操作指南

1. SSH 基础概念与原理

1.1 SSH 协议概述

SSH（Secure Shell）是一种加密的网络传输协议，用于在不安全的网络中为网络服务提供安全的传输环境。Git 使用 SSH 协议实现安全的远程仓库访问和代码传输。

1.2 Git SSH 工作流程

  • •身份验证：通过非对称加密技术验证用户身份
  • •数据传输：所有数据传输都经过加密，防止中间人攻击
  • •操作授权：基于密钥的访问控制，确保只有授权用户可以操作仓库

2. SSH 密钥生成与配置

2.1 生成 SSH 密钥对

# 生成 RSA 密钥对，-t 指定密钥类型，-b 指定密钥长度，-C 添加注释
ssh-keygen -t rsa -b 4096 -C "wangxiaoming@company.com"

# 执行过程详解：
# 1. 提示保存位置：直接回车使用默认路径 (/home/wangxiaoming/.ssh/id_rsa)
# 2. 设置密钥密码：输入强密码（建议8位以上包含大小写字母、数字和特殊字符）
# 3. 确认密码：再次输入相同密码

2.2 密钥文件说明

# 查看生成的密钥文件
ls -al ~/.ssh/

# 文件说明：
# id_rsa      - 私钥文件（必须严格保密，权限设置为600）
# id_rsa.pub  - 公钥文件（需要添加到GitLab服务器）
# known_hosts - 已知主机列表（自动记录连接过的主机密钥）

2.3 设置正确的文件权限

# 设置SSH目录权限（仅用户可读写执行）
chmod 700 ~/.ssh

# 设置私钥文件权限（仅用户可读写）
chmod 600 ~/.ssh/id_rsa

# 设置公钥文件权限（用户可读写，其他用户只读）
chmod 644 ~/.ssh/id_rsa.pub

# 设置已知主机文件权限
chmod 644 ~/.ssh/known_hosts

3. GitLab SSH 密钥配置

3.1 获取公钥内容

# 查看公钥内容
cat ~/.ssh/id_rsa.pub

# 输出示例：
# ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQCw... wangxiaoming@company.com

3.2 GitLab 配置步骤

  1. 登录 GitLab：访问 http://175.15.61.142
  2. 进入个人设置：点击右上角头像 → Settings
  3. 导航到 SSH Keys：左侧菜单选择 SSH Keys
  4. 添加新密钥：
    • •点击 "Add new key" 按钮
    • •在 Key 字段粘贴公钥内容
    • •在 Title 字段填写 "wangxiaoming's SSH Key"
    • •设置过期时间（可选）
    • •点击 "Add key" 完成添加

3.3 验证 SSH 配置

# 测试 SSH 连接到 GitLab 服务器
ssh -T git@175.15.61.142

# 成功响应示例：
# Welcome to GitLab, @wangxiaoming!

4. SSH 客户端配置优化

4.1 创建 SSH 配置文件

# 创建 SSH 配置目录（如果不存在）
mkdir -p ~/.ssh

# 编辑 SSH 配置文件
vim ~/.ssh/config

4.2 配置内容

# GitLab 服务器配置
Host 175.15.61.142
    HostName 175.15.61.142
    User git
    Port 22
    IdentityFile ~/.ssh/id_rsa
    PreferredAuthentications publickey
    # 连接超时设置（单位秒）
    ConnectTimeout 10
    # 保持连接心跳（防止超时断开）
    ServerAliveInterval 60
    ServerAliveCountMax 3
    # 压缩传输（加快大文件传输）
    Compression yes
    # 日志级别（调试时使用）
    # LogLevel DEBUG3

4.3 配置验证

# 测试配置是否正确
ssh -G git@175.15.61.142

# 检查特定主机的配置
ssh -G 175.15.61.142

5. Git 全局配置

5.1 设置用户信息

# 设置全局用户名（必须与 GitLab 账户一致）
git config --global user.name "wangxiaoming"

# 设置全局邮箱（必须与 GitLab 注册邮箱一致）
git config --global user.email "wangxiaoming@company.com"

# 设置默认文本编辑器
git config --global core.editor vim

# 设置默认分支名称
git config --global init.defaultBranch main

5.2 跨平台兼容性配置

# Windows 用户需要设置换行符转换
git config --global core.autocrlf true

# Linux/Mac 用户设置
git config --global core.autocrlf input

# 设置文件权限处理
git config --global core.filemode false

# 启用颜色显示
git config --global color.ui auto

5.3 验证配置

# 查看所有全局配置
git config --global --list

# 查看特定配置项
git config --global user.name
git config --global user.email

6. 仓库克隆与初始化

6.1 克隆指定分支的仓库

# 克隆 dev 分支的 hcu 仓库
git clone -b dev git@175.15.61.142:SwDev_BSW/pfm/hcu.git

# 进入仓库目录
cd hcu

# 查看远程仓库信息
git remote -v

# 查看当前分支状态
git status

# 查看分支列表
git branch -a

6.2 仓库初始化（新项目）

# 初始化新仓库
git init hcu-project
cd hcu-project

# 添加远程仓库地址
git remote add origin git@175.15.61.142:SwDev_BSW/pfm/hcu.git

# 拉取远程分支
git fetch origin

# 切换到开发分支
git checkout -b dev origin/dev

7. 日常开发工作流程

7.1 标准开发流程

# 1. 确保在开发分支
git checkout dev

# 2. 拉取最新代码（避免冲突）
git pull origin dev

# 3. 创建功能分支（基于最新开发分支）
git checkout -b feature/wangxiaoming-new-feature

# 4. 进行代码开发...
# （编辑文件、添加功能等）

# 5. 查看变更状态
git status

# 6. 添加修改文件到暂存区
git add .

# 7. 提交更改（使用规范的提交信息格式）
git commit -m "feat: 添加新功能模块

- 实现用户认证功能
- 添加数据库迁移脚本
- 更新API文档

由 wangxiaoming 开发"

# 8. 推送到远程仓库
git push -u origin feature/wangxiaoming-new-feature

7.2 提交信息规范

类型(范围): 简要描述

详细描述（可选）

- 变更点1
- 变更点2

关联issue: #123

常用类型说明：

  • •feat: 新功能
  • •fix: 修复bug
  • •docs: 文档更新
  • •style: 代码格式调整
  • •refactor: 重构代码
  • •test: 测试相关
  • •chore: 构建过程或辅助工具变动

8. 分支管理与协作

8.1 分支操作命令

# 查看本地分支
git branch

# 查看远程分支
git branch -r

# 查看所有分支（本地+远程）
git branch -a

# 创建新分支
git branch feature/wangxiaoming-branch

# 切换分支
git checkout feature/wangxiaoming-branch

# 创建并切换分支
git checkout -b feature/wangxiaoming-new

# 删除本地分支
git branch -d feature/old-branch

# 强制删除分支
git branch -D feature/old-branch

# 删除远程分支
git push origin --delete feature/old-branch

8.2 分支合并与变基

# 合并分支到当前分支
git merge feature/wangxiaoming-feature

# 变基操作（重写提交历史）
git rebase dev

# 交互式变基（合并、修改提交）
git rebase -i HEAD~3

9. 高级操作与故障排除

9.1 SSH 连接问题诊断

# 详细调试模式（显示完整连接过程）
ssh -vvv git@175.15.61.142

# 测试特定端口连接
ssh -p 22 -T git@175.15.61.142

# 检查网络连通性
ping 175.15.61.142

# 检查端口连通性
telnet 175.15.61.142 22

9.2 密钥管理问题

# 启动 SSH 代理
eval "$(ssh-agent -s)"

# 添加密钥到代理
ssh-add ~/.ssh/id_rsa

# 查看已加载的密钥
ssh-add -l

# 删除特定密钥
ssh-add -d ~/.ssh/id_rsa

# 清空所有密钥
ssh-add -D

9.3 Git 操作问题解决

# 重置本地修改（危险操作）
git reset --hard HEAD

# 清理未跟踪文件
git clean -fd

# 查看操作日志
git reflog

# 恢复误删的分支
git checkout -b recovered-branch <commit-hash>

10. 自动化脚本与工具

10.1 自动化部署脚本

#!/bin/bash
# deploy_hcu.sh - HCU项目自动化部署脚本

set -e  # 遇到错误立即退出

echo "=== HCU项目部署脚本 ==="
echo "执行用户: wangxiaoming"
echo "开始时间: $(date)"

# 变量定义
PROJECT_DIR="/home/wangxiaoming/projects/hcu"
BRANCH="dev"
REMOTE="origin"

# 进入项目目录
cd "$PROJECT_DIR" || { echo "项目目录不存在"; exit 1; }

# 检查Git状态
echo "1. 检查Git工作状态..."
if ! git status > /dev/null 2>&1; then
    echo "错误：不是有效的Git仓库"
    exit 1
fi

# 拉取最新代码
echo "2. 拉取最新代码..."
git fetch "$REMOTE"
git checkout "$BRANCH"
git pull "$REMOTE" "$BRANCH"

# 安装依赖（根据项目实际情况调整）
echo "3. 安装项目依赖..."
if [ -f "package.json" ]; then
    npm install
elif [ -f "requirements.txt" ]; then
    pip install -r requirements.txt
fi

# 运行测试
echo "4. 执行测试套件..."
if [ -f "pytest.ini" ]; then
    pytest
elif [ -f "jest.config.js" ]; then
    npm test
fi

# 构建项目
echo "5. 构建项目..."
if [ -f "build.gradle" ]; then
    ./gradlew build
elif [ -f "pom.xml" ]; then
    mvn package
fi

echo "=== 部署完成 ==="
echo "完成时间: $(date)"

10.2 日常开发辅助脚本

#!/bin/bash
# daily_dev.sh - 日常开发辅助脚本

# 切换到项目目录
cd /home/wangxiaoming/projects/hcu

# 更新代码库
echo "更新代码库..."
git fetch origin
git pull origin dev

# 创建每日开发分支
BRANCH_NAME="feature/wangxiaoming-$(date +%Y%m%d)"
echo "创建分支: $BRANCH_NAME"
git checkout -b "$BRANCH_NAME"

# 打开开发环境（根据实际环境调整）
# code .  # VS Code
# idea .  # IntelliJ IDEA

echo "开发环境准备就绪！"

11. 安全最佳实践

11.1 密钥安全管理

  • •定期更换密钥：建议每6-12个月更换一次SSH密钥
  • •使用强密码：为SSH密钥设置复杂的密码短语
  • •限制密钥使用范围：在GitLab中设置密钥的过期时间和访问范围

11.2 访问控制

# 检查当前用户的权限
groups
id wangxiaoming

# 查看仓库权限
git ls-remote --heads origin

11.3 审计与监控

# 查看操作历史
git log --oneline --graph --decorate --all

# 查看特定用户的提交
git log --author="wangxiaoming"

# 查看最近一周的提交
git log --since="1 week ago"

12. 性能优化建议

12.1 Git 配置优化

# 启用文件系统缓存（提高性能）
git config --global core.preloadindex true
git config --global core.fscache true
git config --global gc.auto 256

# 大文件处理（如果项目中有大文件）
git config --global http.postBuffer 2097152000

12.2 SSH 连接优化

# 在SSH配置中添加以下优化参数
Host 175.15.61.142
    # 启用压缩（对于慢速网络）
    Compression yes
    # 连接复用（减少握手次数）
    ControlMaster auto
    ControlPath ~/.ssh/control:%h:%p:%r
    ControlPersist 600

通过以上完整的配置和操作指南，wangxiaoming 可以安全、高效地使用 SSH 协议进行 Git 仓库的日常开发工作。这套方案涵盖了从基础配置到高级优化的各个方面，确保开发流程的顺畅和安全。

mac 生成 git ssh key 命令
AI天才研究院
03-22 954
【代码】mac 生成 git ssh key 命令。
Git 创建 SSH 密钥
Async Cipher
09-08 1326
你可以把它交给任何需要的地方（如 GitHub, GitLab, 远程服务器等），相当于锁孔，公钥只能用来加密数据或验证你的私钥签名，无法反向推导出私钥。它的用途是：为你创建的 Git commit 或 tag 提供一个密码学签名，证明这个提交确实是你本人创建的，而不是别人冒充的。输入一个你能记住但别人猜不到的密码（输入时屏幕不会显示任何字符，这是正常的），然后按。: 是现代的首选，在安全性、速度和效率方面都有优势，是目前推荐的新标准。：生成的私钥和公钥文件比传统的 RSA 密钥要小很多，更方便管理。
git 如何生成SSH key
张紫娃的博客
12-10 3万+
公钥：id_rsa.pub。
git ssh 配置
streamsunshine的博客
04-09 3222
可以指定存储的文件位置，不指定则使用默认位置。连续回车即可生成两个文件 id_rsa.pub 文件中的内容便是公钥。id_rsa 为私钥。注意：此命令后面执行的会替换前面的，可以通过直接编辑文件添加 http 的配置，在命令行 code .gitconfig。将 id_rsa.pub 拷贝到网站上。
Git SSH Key 配置
tengGongBoYe的博客
03-16 3058
记录如何配置 Git SSH Key，配置后可以免密码操作 Git 仓库。
git ssh 查看
weixin_47582800的博客
06-11 2798
文件（如果存在的话）来查看是否为特定的主机配置了特定的密钥。这个文件通常包含 SSH 客户端的配置信息。如果你使用了不同的密钥名称或路径，请相应地替换命令中的文件名和路径。如果你想查看 SSH 密钥的内容（通常用于验证或备份目的），你可以使用。命令来查看私钥文件。但请注意，私钥是敏感的，你不应该将其分享给任何人。Git 本身并不直接存储 SSH 密钥的路径，但你可以通过检查。要查看已配置的远程仓库的 SSH 地址，你可以使用。注意：私钥和公钥的命令很相似，公钥多了pub。命令来查看这个文件的内容。
Git介绍以及SSH配置
MCC_MCC_MCC的博客
11-09 1776
本文对Git的基本原理、主要功能、优缺点做了简要的介绍，同时介绍了Git的安装，以及SSH的配置。
配置git-ssh
m0_59066523的博客
05-27 3670
面向企业提供一站式研发管理解决方案，包括代码管理、项目管理、文档协作、测试管理、CICD、效能度量等多个模块，支持SaaS、私有化等多种部署方式，帮助企业有序规划和管理研发过程，提升研发效率和质量。（2）使用命令 cat ~/.ssh/id_rsa.pub，出现的就是密钥。命令执行完毕后就会在本地的C盘的用户目录下的.ssh下生成两个文件。（1）在生成的id_rsa.pub文件中，打开该文件即是生成的密钥。Gitee - 基于 Git 的代码托管和研发协作平台。（1）打开gitee，进行注册登录。
【Git】保姆级详解：Git配置SSH Key（密钥和公钥）到github
热门推荐
Yaoyao2024的博客
08-05 6万+
Git是一个开源的分布式版本控制系统，可以有效、高速的处理从很小到非常大的项目版本管理1。Git 是 Linus Torvalds 为了帮助管理 Linux 内核开发而开发的一个开放源码的版本控制软件。SSH (Secure Shell) 密钥是用于身份验证和加密通信的一对加密密钥。私钥（private key）和公钥（public key）。这对密钥是通过非对称加密算法生成的，其中私钥用于加密数据，而公钥用于解密数据。在 SSH 中，私钥应该保持在你的本地计算机上，并且必须保持安全和保密。
git配置SSH KEY
斯特凡今天也很帅的博客
04-29 1818
到代码仓库如GitHub，gitlab等配置SSH KEY，将密钥复制上去添加即可。目录查看生成的密钥文件。结尾的文件即是密钥文件。
git配置ssh key
chenchuanhai04的博客
06-20 4476
打开终端，输入命令，-C 后是git邮箱，在后可以输入公钥和私钥对保存路径及文件名，默认是，其它的全部按回车即可。公钥和私钥对保存路径及文件名不是默认的需要配置 config。
Git 创建SSH秘钥
czjnoe的博客
10-27 3606
5、讲自己电脑对应目录下的 ~/.ssh/id_rsa.pub 文件内容复制到git上面，点击Add SSH Key 即可创建成功。2、系统提示你“Enter a file in which to save the key”，直接按回车键。3、再提示你输入密码的时候直接按回车键，创建没有密码的SSH密钥。4、密钥对创建后，可以在自己电脑对应的。
【git】ssh配置提交 gitcode-ssh提交
m0_64014551的博客
03-07 715
之前一直用的是gitee和阿里云的仓库，前两天想在gitcode上面备份一下我的打洞代码和一些资料 就直接使用http克隆了下来。在提交的时候他一直会让我输入账号和密码，但是我之前根本没有设置过这个，根本没法搞，后来试了登陆的账号和密码也不是，找了半天也找不到，后来还是干脆配置一下ssh算了在这里设置：我用的是RSA类型。
【知识沉淀】ssh连接git仓库，git解决分支冲突
2203_75565612的博客
06-29 767
git pull origin/master拉取远程更新的代码；）添加到远程Git服务器的账户设置中（如GitHub、GitLab等）。通常，你可以在账户设置中找到“SSH和GPG keys”部分，然后添加新的SSH key。git push origin HEAD:refs/for/agent_x1_protocol_v45_upgrade 推送到远程。或其他需要认证的操作时，你的SSH密钥已经正确添加到SSH代理并且远程服务器已正确配置。执行git fetch origin 更新远程的分支信息到本地。
Git配置SSH公钥
Zmaomao_的博客
07-19 2781
而用户的 key 则是针对用户的，用户添加了 key 就对用户名下的仓库和用户参加了的仓库具有权限，一般而言，用户的key具有推送和拉取的权限，而仓库的 key 则只具有拉取权限。仓库的 sshkey 只针对仓库，且我们仅对仓库提供了部署公钥，即仓库下的公钥仅能拉取仓库，这通常用于生产服务器拉取仓库的代码。Gitee 提供了基于 SSH 协议的 Git 服务，在使用 SSH 协议访问仓库仓库之前，需要先配置好账户 SSH 公钥。和仓库"只读"权限的 SSH Key 相比，账户的 SSH Key 同时具备。
Git物联网开发
最新发布
2509_93939357的博客
11-21 247
用上Git，每个人在自己的分支上工作，通过Pull Request（或者Merge Request）发起代码合并请求，团队成员可以进行代码评审，确认无误后再合并。当然，文件得配置好，别把那些编译产生的中间文件、大的二进制依赖库给提交上去，不然仓库很快就爆炸了。你不可能在开发新功能的时候，直接在主分支上动刀，万一搞挂了，连个能烧录的稳定版本都没有。这样，主分支的代码永远是可用的，心里不慌。这样一来，任何时候你想回溯历史，编译V1.2.3这个版本的固件，直接就行了，精准无误，再也不怕找不到北。
Git Stash 核心做了什么
qq_43499921的博客
11-19 904
git stash的核心就是一个临时储藏区（栈），它允许你快速地“清理”你的工作目录，去处理其他紧急事务，然后再安全地“取回”你之前的工作。它完美地解决了“我代码写了一半，不能提交，但我又必须切换分支”这个经典难题。
DevOps在政府项目中的实施
2509_93943125的博客
11-20 160
更让我欣慰的是，当初在会议室吵架的开发和运维团队，现在共同运营着内部知识库，连机关食堂的餐补系统都开始借鉴我们的部署模式。其实政府项目做DevOps最难的不是技术，而是让每个人相信：那些看似固化的流程，完全可以用更优雅的方式运转。在政务系统里谈"失败容忍度"需要技巧，我们把"故障"改称为"应急演练案例"，把"回滚"叫作"版本策略性回调"。但越是这样的环境，越需要引入DevOps思维来破局。"这句话点醒了我们——政府项目的DevOps落地，本质上是让技术回归服务本质，让每个参与者都能有尊严地工作。
gitea启用状态检查结合jenkins工作流实现pr门禁
a66920164的博客
11-20 607
如何通过Jenkins与Gitea状态检查的结合实现代码门禁功能
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

云纳星辰怀自在

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值