Timestamp GIT

← All posts

2026-11-02

Git 提交时间戳并非防篡改——什么才是

Git 提交时间戳并非防篡改——什么才是
timestamp git blockchain proof

Git 提交时间戳并非防篡改——什么才是

打开终端并运行 git log。你会看到每个提交旁边都有一个日期。现在想象一下,一位律师、审计师或收购你公司的 CTO 问了一个简单的追问:“我怎么知道那个日期是真实的?”

诚实的答案是:你无法证明它。用 git log 不行,用你的 GitHub 活动动态不行,用你的内部审计数据库也不行。这些都是你自己控制的记录,而你自己控制的记录是可以被编辑的。本文解释了“防篡改”的真正含义、为什么 Git 时间戳无法通过这一检验,以及通过 Timestamp GIT 自动实现的比特币密码学锚定如何解决这个问题。

问题:你真的能信任 Git 提交时间戳吗?

每个 Git 提交都带有两个时间戳:作者日期和提交者日期。以下是查看两者的方法:

git log -1 --format='commit  %H%nauthor  %an <%ae>  %ad%ncommitter %cn <%ce>  %cd' --date=iso

这些日期来自运行 git commit 的那台机器的时钟。它们是输入,而非观测结果。Git 不会查询可信时间源,也不会向任何外部方作证。

这意味着你可以把它们设成任何你想要的值:

GIT_AUTHOR_DATE="2026-01-14T09:12:00+00:00" \
GIT_COMMITTER_DATE="2026-01-14T09:12:00+00:00" \
git commit -m "Add billing reconciliation job"

这不是漏洞利用。这是有文档记载的、有意为之的行为——正是同一机制让你能够导入一个旧仓库并保留其原始历史。

所以当我们说防篡改时,我们指的是一个具体而严格的定义:

  • 任何人——不是同事,不是平台管理员,不是攻击者,甚至不是你自己——都无法在事后更改记录。
  • 任何人都可以验证它,而无需信任产生它的那一方。

Git 时间戳两个条件都不满足。原因如下,以及什么才能满足。

为什么 Git 时间戳仅在理论上防篡改

Git 的完整性模型是一条哈希链。每个提交都包含其父提交的哈希,因此更改任何提交的内容都会改变下游的每一个哈希。这是真正的密码学完整性——针对内容而言。

时间戳只是提交对象内部的一个字段。没有任何外部事物将提交的存在固定到某个时间点。这条链证明的是“此内容与此历史一致”,而不是“此内容在某个日期存在”。

任何拥有写权限的人都可以重写历史以及随之而来的日期:

# Amend the most recent commit with an arbitrary date
git commit --amend --no-edit --date="2025-06-01T08:00:00"

# Rewrite every commit in every branch with a new date
git filter-branch --env-filter '
  export GIT_AUTHOR_DATE="2025-06-01T08:00:00"
  export GIT_COMMITTER_DATE="2025-06-01T08:00:00"
' -- --all

即使在托管平台上,强制推送也会整体替换历史。而平台侧的日志——webhook 投递、审计追踪、活动动态——存在于管理员和攻击者都能触及的数据库中。在争议中,“我们自己的日志里有记录”恰恰是对方律师会斥为自利证据的那类证据。

类比: Git 时间戳是你自己日记里用铅笔写下的日期。它可能完全准确。它可能是世界上最诚实的日记。但任何拿着橡皮擦的人都能更改它,而且没有第三方看到你写下它。密码学锚定相当于把那一页日记拿到公证人面前,让它被盖入一个公共账本,此后任何人——包括公证人——都无法重写。

密码学锚定如何使时间戳防篡改

解决办法是把你的工作的指纹发布到你无法控制的地方。就这样。这就是全部思路。

第 1 步——指纹

当你提交时,Git 会将整个仓库状态哈希成一个唯一标识符(SHA-1 或 SHA-256)。该哈希是一个单向指纹:它标识你确切的代码状态,而不泄露代码本身的任何信息。

第 2 步——锚定

Timestamp GIT 将某个仓库的提交哈希收集到一个每日清单文件中,对该清单进行哈希,在这批数据上构建一棵 Merkle 树,并使用 OpenTimestamps 协议将 Merkle 根嵌入一笔比特币交易。比特币区块链是仅追加的,并复制到数千个节点上——一旦你的根在一个区块中得到确认,“此哈希在某个日期之前已存在”的记录就是永久的。

第 3 步——证明

你会得到一个不可变的 .ots 收据文件。它通过 Merkle 树将你的提交哈希链接到一个特定的比特币区块。任何人都可以沿着这条链对照公共区块链进行验证,确认时间戳——无需信任你,也无需信任 Timestamp GIT。

最后一点比听起来更重要。该产品的保证刻意保持平淡无奇:

  • 零知识:你的源代码永远不会被读取、复制或存储。只有哈希离开你的仓库。
  • 供应商独立:证明使用 SHA-256 和比特币区块数据。没有专有格式,没有锁定。如果 Timestamp GIT 明天消失,你的 .ots 文件仍然可以验证。
  • 无需在开发者机器上安装任何东西。

自己动手实现这一点的困难方式是亲自操作 OpenTimestamps 协议和比特币交易——这本身就是一个项目,另在 Timestamp GIT 与 OpenTimestamps CLI 对比 中单独介绍。Timestamp GIT 的存在就是为了让你不必这么做。

为什么这很重要:常见误解与真实风险

误解:“Git 时间戳对审计来说足够好了。” 内部日志通常会被视为可操纵而不予采信。你自己生成并存储的审计追踪证明的是意图,而非存在。

误解:“区块链时间戳只适用于加密项目。” 任何提交哈希都可以被锚定——一个 Rails 单体应用、一个固件仓库、一个内部交易系统。这项技术不关心代码里有什么。

误解:“如果有人改了我们的历史,我们会知道。” 强制推送、变基和管理员级别的编辑在设计上就是悄无声息的。除非你将每个引用与外部记录进行差异比对,否则你不会知道。

真实风险是具体的:

  • 专利流氓。 一个非实施实体就你几个月前已交付的东西提交了一项宽泛的专利。没有带日期、可独立验证的证明,你只能凭记忆争辩。
  • 员工和承包商纠纷。 当一位首席开发者离开时,“这个功能到底是什么时候构建的?”会变成一场可信度竞赛。一个不可变的时间戳可以终结它。
  • “洁净室”主张。 竞争对手声称他们独立开发了相似的逻辑。证明你在 18 个月前就已经完成了可运行的代码,会筑起一道他们无法逾越的墙。
  • 合规与商业秘密。 审计师和法律团队越来越希望获得知识产权和内部系统的存在证明——而不公开源代码。

Timestamp GIT 如何自动化防篡改时间戳

接下来是密码学不再成为你的问题的部分。

安装一次,每晚锚定

在你想要保护的仓库上安装 GitHub App。它通过 webhook 检测新的提交。从那时起,无需运行命令、无需管理文件、无需更改开发者工作流——每个提交每晚都会自动锚定。

在底层,待处理的哈希会排队进入一个内存键值存储。午夜时分,一个工作进程将它们分组,为每个仓库写一个 .txt 清单,构建 Merkle 树,并通过公共 OpenTimestamps 日历将根锚定到比特币中。比特币确认通常需要大约三个小时,因此完成的证明会在每晚运行后几小时内落回你的仓库。

证明落入你的仓库

清单和 .ots 收据文件会被推送到一个专用的 timestamps 分支,或者如果你希望将它们排除在源仓库之外,则推送到一个单独的影子仓库。在标准模式下,GitHub App 需要对源仓库的只读访问权限,以及对目标仓库的读写访问权限。

无需信任任何人即可验证

  • README 徽章显示实时验证状态,并附有任何人都可以点击查看的链接。
  • 仓库状态仪表板(/status/{user}/{repo})展示证明的持久性、最早锚定日期、每日规律性、比特币区块和交易数据、日历热力图,以及可下载的审计 CSV 和 PDF 证书。
  • 验证页面(/verification/{user}/{repo}/{date})逐步展示完整的多级 Merkle 链——所有计算都在你的浏览器本地进行,因此没有人能看到你验证了什么。
  • REST API 以编程方式为你提供相同的数据:
# Last anchored Bitcoin block for a repository (public)
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api | jq

# Total stamped commit count (public)
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api | jq

# Full audit ledger as CSV (used for compliance exports)
curl -sL https://timestampgit.dev/api/audit/acme/payments-api -o audit-ledger.csv

私有仓库会在这些 URL 后附加一个加密的 HMAC,其作用域限定于你的服务器实例,因此只有授权用户才能读取其状态。

企业 ZK 模式

如果你的安全策略完全禁止授予第三方仓库访问权限,企业 ZK 模式会将 GitHub App 替换为一个在你自己的基础设施上运行的小型 GitHub Action。该 Action 将提交哈希推送到 Timestamp GIT API;目标仓库仍会收到证明。你的源仓库永远不会被读取。

面向气隙环境的自托管 Docker

为实现最大程度的控制,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 许可证页面 上的请求表单,可获得限时演示许可证。

常见问题

我可以在事后更改 Git 提交时间戳吗? 可以,Git 时间戳只是由提交者机器设置的元数据。你可以用 git commit --amend --date 修改提交,用 git rebase 重写历史,或直接编辑提交对象。即使在 GitHub 这样的托管平台上,强制推送也可以更改时间戳,因此它们本身并非防篡改。

比特币锚定如何使时间戳防篡改? Timestamp GIT 获取你的提交哈希,构建一棵 Merkle 树,并通过 OpenTimestamps 将根嵌入一笔比特币交易。一旦在比特币区块中得到确认,时间戳就是不可变的——任何人,包括 Timestamp GIT,都无法更改它。你会收到一个 .ots 收据,任何人都可以对照比特币区块链进行验证。

使用 Timestamp GIT 需要运行任何 OpenTimestamps 命令吗? 不需要。Timestamp GIT 是一项托管服务:你安装一次 GitHub App,它每晚自动锚定你的提交。没有 CLI,没有手动盖章,也无需学习 OpenTimestamps 协议。对于气隙环境,提供 Docker 自托管选项。

比特币锚定的时间戳是法律上有效的证据吗? 密码学时间戳提供了强有力的存在证明,在法律语境中越来越被接受,但其有效性取决于司法管辖区以及证据的呈现方式。Timestamp GIT 提供可供法庭使用的 .ots 收据和 PDF 证书,你可以与律师或审计师分享。如需更深入的讨论,请参阅 区块链时间戳是法律上有效的证据吗?

底线

Git 时间戳是一种主张。比特币锚定的时间戳是证据。两者之间的差距,就是“我们先构建了它”与多年后、在一群有充分理由怀疑你的人面前能够证明它之间的区别。

好消息是,弥合这一差距不再需要一项密码学项目。安装一次 GitHub App,让它每晚锚定你的提交,并保留 .ots 收据——外加一个可嵌入的徽章、一个公共状态仪表板,以及一份给任何询问者的 PDF 证书。

套餐从面向公共仓库的免费层级开始,Pro Agency 为私有仓库每月 $49,企业 ZK 为需要 GitHub Action 工作流的团队每月 $199。选择与你的仓库可见性相匹配的那一个,今晚就获得你的第一个锚定。


相关文章

EU label: AI-generated content