Timestamp GIT

← All posts

2026-11-16

Git 提交时间戳能作为证据吗?

Git 提交时间戳能作为证据吗?
timestamp git blockchain proof

Git 提交时间戳能作为证据吗?

打开终端,运行 git log,每个提交都带着日期回望着你。它看起来很有权威性——一份永久的、机器生成的记录,证明代码在那个时刻已经存在。因此,当几周或几年后出现一个问题(“谁先拥有这个?”“这到底是什么时候上线的?”)时,人们很容易把这些日期当作证据。

它们并不是。至少在律师、审计师或前员工坐在桌子对面时,这并不成立。

本文直接回答这个问题——Git 提交的时间戳可信吗?——然后展示一个你可以信任的时间戳实际上是什么样子:一个锚定到比特币区块链的提交哈希,由你安装一次的 GitHub App 自动生成。

简短回答:Git 时间戳不是证据

Git 提交时间戳是自我报告的元数据。它们由创建提交的那台机器设置,之后可以被更改,而且 Git 协议中没有任何机制验证它们对应真实世界的时间。

具体来说:

  • Git 将作者日期和提交者日期作为普通字段存储在提交对象内部。任何能创建提交的人都可以把它们设成任何值。
  • 这些字段没有由可信时间源签名。没有共识机制,没有第三方,没有见证者。
  • 历史可以被重写:提交可以被修改、变基,或从头重建并赋予新日期和新哈希。

还有第二个更微妙的问题。即使你从不碰这些日期,“这件事何时发生”的唯一副本也存在于你无法控制的基础设施上——GitHub 的服务器、你的 CI 日志、你笔记本电脑的 reflog。在争议中,内部日志通常会被视为自利证据而不予采信:你的系统当然说你是先做的,因为系统是你写的。

所以这里有一个真正的区别需要划清:

用途 Git 时间戳……
排序提交、阅读历史、二分查找 bug 完全没问题
Slack 消息、变更日志、发布说明 没问题
专利纠纷、知识产权归属主张、付款纠纷、审计 不是证据

Git 时间戳是一种工作流便利。它们从来就不是为作为证据而设计的。

为什么 Git 时间戳如此容易伪造

时钟属于你

Git 读取创建提交那台机器的系统时钟。改时钟,就改时间戳:

GIT_AUTHOR_DATE="2019-03-04T10:00:00" \
GIT_COMMITTER_DATE="2019-03-04T10:00:00" \
git commit -m "Feature that definitely existed in 2019"

那个提交是一个完全有效的 Git 对象。它会推送、克隆,并在 GitHub UI 中正常渲染,不会有任何问题。任何有仓库访问权限的人都能这样做,而且没有审计轨迹显示日期是伪造的。

历史在设计上就是可变的

Git 的历史是一条哈希链,但这条链由你重建:

git commit --amend --date="2019-03-04T10:00:00"
git rebase -i HEAD~10   # reword, squash, reorder, re-date

重写历史会产生新的提交哈希——这正是重点。旧哈希消失,新哈希携带你输入的任意日期,没有任何外部见证这一转变。如果你想知道提交的内容是否防篡改(是的——改一个字节就会改变哈希),那是与日期可信不同的另一个属性。哈希证明代码是什么。它对何时毫无说明。

托管平台不是公证人

GitHub 记录 Git 交给它的日期。它的日志存在于自己的服务器上,并且可以被平台、仓库管理员以及任何重写并强制推送的人更改。在法律语境中,“我们在 GitHub 上的提交历史这么说”是一种断言,不是数学证明。

日记类比

想想日记条目与公证文件。两者都记录日期。读起来都感觉很正式。但只有公证过的那份会被陌生人信任,因为一个与结果无利害关系的第三方确认了日期,并使其之后无法在不被发现的情况下更改。

Git 提交时间戳是日记条目。加密时间戳是公证人。

什么才能真正证明代码在特定时间存在

机制比听起来更简单:

  1. 对内容做指纹。 对数据运行加密哈希(SHA-256)。哈希是一个固定长度的字符串,如果输入的任何一个字节改变,它就会完全改变。
  2. 公开锚定指纹。 将该哈希写入一个没有任何单一主体控制且无法重写的账本——比特币。
  3. 保留收据。 现在任何持有原始数据的人都可以重新哈希它,与锚定值匹配,并确认它在区块时间戳之时或之前存在。

比特币是正确的锚,因为它是去中心化的:没有任何公司——包括提供服务的公司——能更改已确认的区块。一旦一笔交易被埋入几个区块深,重写它所需的工作量将超过网络产生的总量。

OpenTimestamps 使这在规模上变得可行。它不是把每个哈希直接放到链上,而是将许多哈希批量放入一棵 Merkle 树,只提交根,因此数千个提交共享一笔比特币交易——便宜、快速且保护隐私。结果是一个小的 .ots 收据文件,你可以独立验证。

问题在于操作层面:手动做这件事意味着运行工具、管理日历,并按批次处理收据。那是困难的方式,而这正是 Timestamp GIT 所自动化的。

Timestamp GIT 如何让 Git 时间戳变得可信

Timestamp GIT 是一个围绕 GitHub App 构建的托管服务。你在仓库上安装一次该应用;从那时起,每个提交都会自动锚定到比特币。无需 CLI,无需脚本,开发人员机器上无需运行任何东西。

第 1 步——指纹。 Git 已经为每个提交生成唯一哈希。该哈希是你在那一刻仓库状态的单向指纹。

第 2 步——锚定。 每晚,一个工作进程收集当天待处理的提交哈希,将它们写入每个仓库的清单(.txt),构建一棵 Merkle 树,并通过公共 OpenTimestamps 日历将 Merkle 根锚定到比特币区块中。比特币确认通常需要约三个小时,因此证明文件会在批次运行几小时后落地。

第 3 步——证明。 清单和相应的 .ots 收据文件会被推回你的仓库——放在专用的 timestamps 分支中,或者如果你更愿意将它们分开,则放入单独的影子仓库。你现在持有了一份收据,证明这些哈希在某个特定比特币区块之前已经存在。

这种设计带来的保证:

  • 零知识。 该服务只读取提交哈希。你的源代码永远不会被复制、存储或检查。
  • 供应商无关。 证明是 SHA-256 加上比特币区块数据。没有专有格式,没有锁定——第三方 OpenTimestamps 验证器可以在不涉及我们的情况下检查它。
  • 可离线验证。 .ots 文件是自包含的。如果服务明天消失,证明仍然成立。

对于日常确认,你甚至不需要打开收据。仓库的公共状态页面显示证明持久性、最早锚定日期、每日规律性以及比特币区块和交易数据——外加可下载的审计 CSV 和每个日期的 PDF 证书。有一个基于浏览器的验证页面,逐步走完 Merkle 链,所有计算都在本地进行,因此没有人——包括我们——能看到你在检查什么。一个可嵌入的 Shields.io 徽章可以直接放进你的 README。

如果你想将其接入自己的工具,API 很直接:

# Combined summary (feeds the Shields.io badge)
curl https://timestampgit.dev/api/statusSummary/acme/payments-service

# Latest anchored Bitcoin block
curl https://timestampgit.dev/api/statusLast/acme/payments-service

# Full Merkle chain data for a specific day, for local verification
curl https://timestampgit.dev/api/verify/acme/payments-service/2026-11-15

私有仓库会在这些 URL 后附加加密的 HMAC,因此状态仅对授权用户可见。

关于 Git 和时间戳的常见误解

“Git 提交是不可变的,所以时间戳一定可信。” 不可变性适用于内容,不适用于元数据。更改提交的日期会产生不同的哈希——这正是日期不是证据的原因:你只需用新哈希和新日期创建一个新提交,旧的就会从分支中消失。

“GitHub 的提交历史就足够作为证据。” 平台日志没有以加密方式锚定到平台外的任何东西。它们可以被管理员和强制推送重写,并且在争议中经常被视为自我报告而不予采信。

“区块链时间戳需要深厚的加密知识或手动工具。” 原始操作确实需要。使用托管服务则不需要:安装 GitHub App,锚定就会按你从不需要考虑的夜间计划进行。加密是真实的;操作负担为零。

“时间戳会暴露我的代码。” 只有哈希离开你的仓库。提交的哈希不会透露其内容的任何信息——你无法逆转它,而且除非你已经拥有原始数据,否则你无法将其与任何东西比较。

何时需要加密证明(以及何时不需要)

对于日常开发,Git 时间戳没问题。你不会为每个 bugfix 分支做锚定,也不应该这样做。

当某个日期可能必须经受对抗性对话时,才需要加密证明:

  • 专利纠纷。 一个非实施实体对你几个月前已上线的东西申请宽泛专利。锚定的现有技术是使该主张无效的方式。(更多内容见加密现有技术:初创公司对抗专利流氓的盾牌。)
  • 员工知识产权主张。 一位即将离职的首席开发人员对某个功能的构思时间提出争议。不可变的时间戳终结各执一词。
  • 客户付款纠纷。 代理机构可以证明交付日期,而不是争论发票时间线。
  • 自由职业者剽窃。 证明某个库或作品集是你的在先作品。
  • 合规与审计。 展示代码何时更改的可验证、第三方锚定记录——而无需交出源代码。

此类证明是否可采纳取决于司法管辖区和具体情况;那是你律师要谈的事,我们在比特币时间戳可作为证据采纳吗?中涵盖了细微差别。

定价反映了这种划分:对公共开源仓库的时间戳是免费的,私有仓库和更大团队有付费计划。

在你自己的网络内运行

对于受监管环境或气隙设置,Timestamp GIT 以你自己托管的 Docker 镜像形式提供。一个快速开始的 Docker Compose 设置如下:

services:
  timestampgit:
    image: rue1401/timestampgit:prod
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
    restart: unless-stopped
  valkey:
    image: valkey/valkey:8
    restart: unless-stopped
docker compose pull
docker compose up -d
docker compose logs -f timestampgit

应用会在 http://localhost:8080 启动;首次启动时的设置向导会引导你连接 GitHub App。可通过 Docker License 页面上的请求表单获得限时演示许可证。完整部署细节见使用 Docker Compose 自托管 Git 时间戳。

常见问题

我可以直接更改系统时钟来伪造 Git 提交日期吗? 可以。Git 使用你的本地时钟,你可以将其设置为任何日期——或者之后通过 amend 或 rebase 重写日期。这正是仅凭 Git 时间戳不能可靠证明任何事情的原因。

GitHub 是否为提交提供可信的时间戳? GitHub 记录 Git 提供的日期,但这些日期没有以加密方式锚定。它的日志存在于自己的服务器上,可以被更改,并且在法律语境中可能被视为自利证据而不予采信。

Timestamp GIT 如何在不查看我代码的情况下证明我的代码在某个时间存在? 它只处理提交哈希——你仓库状态的加密指纹。这些哈希被批量处理并通过 OpenTimestamps 锚定到比特币。你的源代码永远不会离开你的仓库。

来自 Timestamp GIT 的证明在法庭上可采纳吗? 该证明依赖于比特币的不可变账本和标准 SHA-256 哈希,这些在法律语境中正日益得到认可。可采纳性仍取决于你的司法管辖区和具体情况——请咨询法律专业人士。更深入的讨论见我们的文章比特币时间戳的可采纳性。

底线

Git 提交时间戳回答的是“这些更改在这台机器上以什么顺序发生?”它们不回答“你能向陌生人证明这段代码在这个日期存在吗?”对于第二个问题,你需要一个锚定在你无法控制之处的指纹——而获得它的实用方式是停止将时间戳视为手动杂务。

安装一次 GitHub App,让夜间批次完成工作,仓库中的每个提交都会得到比特币区块的支持。你可以在 timestampgit.dev 查看整个流程——以及随之而来的验证页面和徽章。


相关文章

EU label: AI-generated content