讲师中心 微信公众号
AI工具推荐 视频效率加速

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

小宇同学_1036

小宇同学_1036

发布时间:2026-05-23 13:07:00

|

401人浏览过

|

来源于php中文网

原创

要真正验证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 邮箱、平台验证邮箱三者必须一字不差 —— 多一个空格、少一个点,签名就失效,且没有任何明确报错提示。别跳过这一步校验。

热门AI工具

更多
火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

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

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

5879

2023.07.05

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

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

1740

2023.07.06

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

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

1014

2023.07.24

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

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

3817

2024.04.09

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

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

3541

2024.04.09

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

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

3930

2023.06.21

如何安装LINUX
如何安装LINUX

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

3373

2023.06.29

linux find
linux find

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

2533

2023.06.30

Kratos框架HTTP与gRPC服务开发教程
Kratos框架HTTP与gRPC服务开发教程

本专题围绕Kratos框架双协议服务开发,涵盖HTTP路由与处理器编写、参数获取、gRPC服务实现与客户端调用、metadata上下文传递、encoding编解码注册、统一响应封装、超时控制与流式响应实现方法。

0

2026.10.10

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn