在日常开发中，SSH 连接方式相比 HTTPS，优势在于无需每次推送或拉取代码都输入账号密码，既能提升效率，也能避免密码泄露的风险。
本文介绍 Gitee SSH 连接配置流程，涵盖账号准备、仓库创建、密钥生成、配置绑定及克隆验证步骤。
一、前期准备
开始操作前，请确保以下环境就绪：
- 操作系统：Windows 10 / Linux / Mac（终端操作略有差异）
- 浏览器：任意现代浏览器（用于访问 Gitee 官网）
- SSH 工具：Xshell / Putty / FinalShell 或系统自带 PowerShell/终端
- 远程环境：已安装 Linux 系统的服务器或虚拟机
- 基础要求：已安装 Git（Linux 一般自带，Windows 需提前安装）
二、步骤 1：注册并登录 Gitee 账号
若已有账号可直接跳过。新用户需完成注册：
- 填写昵称、用户名（建议英文 + 数字）
- 绑定手机号并获取验证码
- 设置强密码
- 勾选《Gitee 服务协议》后点击【立即注册】
登录后进入个人主页。
三、步骤 2：创建第一个 Gitee 远程仓库
- 点击右上角【+】按钮，选择【新建仓库】。
- 填写基础配置：
- 仓库名称：自定义（建议英文，如 ssh-test-repo）
- 描述：可选
- 仓库类型：私有或公开
- 初始化选项：勾选'添加 README 文件'和'.gitignore'
- 点击【创建】。
分支模型默认单分支即可。
四、步骤 3：SSH 密钥配置
3.1 获取 Gitee 绑定邮箱
在【个人设置】->【邮箱管理】中确认已绑定邮箱，后续生成密钥需用到。
3.2 在 Linux 机器上生成 SSH 密钥对
打开终端执行命令（将邮箱替换为实际地址）：
ssh-keygen -t rsa -C "你的 Gitee 绑定邮箱"
按回车确认默认路径 /root/.ssh/id_rsa，不设置 passphrase 则直接回车。
成功生成后，目录内包含 id_rsa（私钥）和 id_rsa.pub（公钥）。
3.3 复制公钥内容
查看公钥内容：
cat /root/.ssh/id_rsa.pub
复制输出的整行字符（从 ssh-rsa 开头到邮箱结尾）。
3.4 在 Gitee 上配置 SSH 公钥
- 进入【个人设置】->【SSH 公钥】。
- 填写标题（如 hadoop102-SSH 密钥）。
- 粘贴公钥内容，点击【确定】。
- 输入登录密码进行安全验证。
3.5 测试 SSH 连接
在终端执行：
ssh -T [email protected]
首次连接提示时输入 yes。若显示 Hi XXX! You've successfully authenticated...，说明连接成功。
五、步骤 4：克隆远程仓库
4.1 获取 SSH 地址
进入仓库页面，点击【克隆/下载】，切换到【SSH】标签，复制地址。
4.2 在 Linux 机器上克隆
创建目录并进入：
mkdir -p /opt/ssh-test
cd /opt/ssh-test
执行克隆命令：
git clone 你的仓库 SSH 地址
若显示 Cloning into 'ssh-test-repo'... done，表示克隆成功。
六、常见问题排查
- command not found：未安装 ssh 工具包。CentOS 执行
yum install openssh-clients -y，Ubuntu 执行apt install openssh-client -y。 - Permission denied (publickey)：公钥配置错误或未生效。重新复制
id_rsa.pub内容，删除旧公钥后重新添加。 - 连接超时：网络不通或防火墙屏蔽 22 端口。检查
ping gitee.com，必要时临时关闭防火墙systemctl stop firewalld。 - Host key verification failed：未信任主机。按提示输入完整
yes确认。
七、总结
- SSH 连接核心是密钥对配对，私钥本地保存，公钥配置至 Gitee。
- 关键步骤：生成密钥→复制公钥→Gitee 配置→测试连接→克隆仓库。
- 遇到问题优先排查公钥完整性、网络连通性及端口开放情况。
