免密码推送内容到 Gitee 的详细教程,基于 SSH 密钥认证实现:
一、前置准备
安装 Git
- Linux 系统执行:
yum install git
- Windows 系统需下载安装包(推荐使用 Git for Windows)
- Linux 系统执行:
配置 Git 全局信息
设置提交用户名和邮箱(需与 Gitee 账号绑定的邮箱一致):git config --global user.name "你的Gitee用户名" git config --global user.email "绑定的邮箱地址"
若邮箱设置为“不公开”,需使用 Gitee 提供的专用提交邮箱(如
xxx@xxx.gitee.com
)
二、生成 SSH 密钥对
生成密钥
执行以下命令生成 SSH 密钥(按回车使用默认路径和空密码):ssh-keygen -t ed25519 -C "绑定邮箱地址"
ed25519
为加密算法,兼容性较好;也可用rsa
(-t rsa
)
查看并复制公钥
cat ~/.ssh/id_ed25519.pub # 查看公钥内容
复制输出的公钥字符串(以
ssh-ed25519 AAA...
开头)
三、绑定 SSH 公钥到 Gitee
登录 Gitee 账号
进入 Gitee 设置 → 安全设置 → SSH 公钥 → 添加公钥。填写公钥信息
- 标题:自定义(如
My-Linux-Server
)。 - 密钥内容:粘贴复制的公钥。
- 点击 确定 完成绑定
- 标题:自定义(如
四、测试 SSH 连接
执行命令验证配置是否成功:
ssh -T git@gitee.com
若返回类似 Hi <用户名>! You've successfully authenticated...
,则配置成功
五、初始化本地仓库并推送
创建本地仓库
mkdir my_project && cd my_project git init echo "# 项目说明" > README.md git add README.md git commit -m "Initial commit"
添加远程仓库地址
使用 SSH 协议地址(非 HTTPS):git remote add origin git@gitee.com:用户名/仓库名.git
若已有仓库,需先删除原有远程地址:
git remote remove origin
推送代码
git push -u origin master # 首次推送需加 `-u`,后续可直接 `git push`
六、常见问题解决
推送时报错
Permission denied
- 检查公钥是否粘贴完整(含换行符)。
- 确认远程仓库地址为 SSH 协议(以
git@gitee.com:
开头)
多设备免密推送
每台设备需单独生成 SSH 密钥并绑定到 Gitee 账号。修改提交邮箱
若需切换邮箱,执行:git config --global user.email "新邮箱"
并确保该邮箱已在 Gitee 绑定或使用专用提交邮箱
附:SSH 协议优势
- 安全性:基于密钥对加密,避免密码泄露风险。
- 便捷性:推送/拉取无需重复输入密码。
- 多仓库支持:同一密钥可管理多个 Gitee 仓库
通过以上步骤,即可实现免密推送代码到 Gitee。若需进一步自动化(如 CI/CD),可结合 SSH 密钥配置持续集成工具。
发表留言 取消回复