Linux怎么配置Git使用GPG签名 Git提交安全认证配置详解

小宇同学_1036

小宇同学_1036

2026-05-23

401人浏览

原创

要真正验证git提交身份,必须用gpg私钥签名并上传公钥至远程平台;需确保gpg环境正常、密钥符合4096位rsa要求、邮箱三者完全一致,且配置signingkey与commit.gpgsign。

linux怎么配置git使用gpg签名 git提交安全认证配置详解

Git 提交默认不带身份认证,user.name 和 user.email 完全可伪造。要真正证明“这个提交确实出自你”,必须用 GPG 私钥签名,且远程平台(GitHub/GitLab/Codeup)只认这个签名。

确认 GPG 已安装并能正常工作

很多问题其实卡在这一步:GPG 装了,但 gpg --version 报错、或签名时卡住不动、或提示 No secret key。不是 Git 配错了,是 GPG 环境没通。

  • 运行 gpg --version,确保输出版本号(如 gpg (GnuPG) 2.4.4);若报 command not found,先装:sudo apt install gnupg(Debian/Ubuntu)或 sudo yum install gnupg2(RHEL/CentOS)
  • 生成密钥前,先检查是否已有可用密钥:gpg --list-secret-keys --keyid-format=long。如果输出为空,说明还没建密钥对
  • 若签名时卡在密码输入环节,大概率是终端绑定失败,立刻执行:export GPG_TTY=$(tty),并加到 ~/.bashrc 里防止下次失效

生成兼容性好、平台认可的 GPG 密钥

不是所有 GPG 密钥都能被 GitHub/GitLab 正常识别。用错算法或过短位数,上传后显示 “Unverified”,但错误信息很隐晦,容易误判为配置问题。

Linux Distros
Linux Distros

Linux发行版游乐场,适用于需要临时Linux沙箱、基于浏览器的Linux虚拟机、一次性终端环境、桌面Linux会话等场景

下载
  • 务必使用 gpg --full-generate-key(不是旧版 gpg --gen-key),它支持现代选项交互
  • 密钥类型选 (1) RSA and RSA(默认),别选 DSA 或 ElGamal —— GitLab 12.3+、GitHub 全面弃用
  • 密钥长度必须 ≥ 3072,强烈建议 4096;有效期建议设为 1y(一年),避免密钥过期后所有新提交变 Unverified
  • 姓名和邮箱必须与 git config user.name / user.email 完全一致,包括大小写和空格;邮箱还必须是已在 GitHub/GitLab 绑定并验证过的地址

配置 Git 自动签名提交(全局生效)

只配 commit.gpgsign true 不够,漏掉 user.signingkey 就会报 error: gpg failed to sign the data,而且这个错误不提示缺哪项,纯靠排查。

  • 从 gpg --list-secret-keys --keyid-format=long 输出中,找以 sec 开头那行末尾的长 ID(例如 ABCDEF1234567890),这就是你要用的密钥 ID
  • 执行两行命令(顺序不能反):
    git config --global user.signingkey ABCDEF1234567890
    git config --global commit.gpgsign true
  • 可选但推荐:显式指定 GPG 程序路径,避免系统有 gpg 和 gpg2 混用冲突:git config --global gpg.program gpg
  • 测试是否生效:git commit -m "test gpg" —— 此时应弹出密码框;成功后运行 git log --show-signature -1,看到 Good signature from "xxx" 才算真正通了

上传公钥到远程平台并验证链路

本地签了没用,远程平台不认识你的公钥,照样显示 “Unverified”。而且上传后不验证,你会以为配置完成了,其实只是半条链路。

  • 导出 ASCII 格式公钥:gpg --armor --export ABCDEF1234567890 > ~/gpg_public.key,然后复制整个 -----BEGIN PGP PUBLIC KEY BLOCK----- 到 -----END PGP PUBLIC KEY BLOCK----- 的内容
  • GitHub:Settings → SSH and GPG keys → New GPG key
    GitLab:Settings → GPG Keys → Add key
    注意:不要传错成私钥,也不要漏掉首尾的 BEGIN/END 行
  • 关键验证动作:推一个新提交后,立刻去 GitHub/GitLab 页面点开该 commit,看右上角是否出现绿色 Verified;如果还是灰色 Unverified,90% 是邮箱不匹配或公钥没上传成功
  • 调试技巧:用 git show --show-signature HEAD 在本地直接看签名解析结果,比等网页刷新快得多

最容易被忽略的是密钥邮箱与 Git 邮箱、平台验证邮箱三者必须一字不差 —— 多一个空格、少一个点,签名就失效,且没有任何明确报错提示。别跳过这一步校验。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

linux git

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

2023.07.05

5859

9

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

2023.07.06

1740

6

git撤销提交的commit
git撤销提交的commit

Git是一个强大的版本控制系统,它提供了很多功能帮助开发人员有效地管理和控制代码的变更,本专题为大家提供git 撤销提交的commit相关的各种文章内容,供大家免费下载体验。

2023.07.24

1014

5

git提交错误怎么撤回
git提交错误怎么撤回

git提交错误撤回的方法:git reset head^:撤回最后一次提交,恢复到提交前状态。git revert head:创建新提交,内容与之前提交相反。git reset :使用提交的 sha-1 哈希撤回指定提交。交互式舞台区:标记要撤回的特定更改,然后提交,排除已撤回更改。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.09

3817

7

git怎么对比两个版本的文件内容
git怎么对比两个版本的文件内容

要对比两个版本的 git 文件,请使用 git diff 命令:git diff 比较工作树和暂存区之间的差异。git diff 比较两个提交或标签之间的差异。git diff 输出显示差异块,其中 + 表示添加的行,- 表示删除的行, 表示修改的行。可使用 gitkraken、meld、beyond compare 等可视化工具更直观地查看差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.09

3541

6

磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

2023.06.21

3930

4

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

2023.06.29

3373

10

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

2023.06.30

2513

5

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

2023.07.05

6090

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习