如何独立验证 Git 提交时间戳
无法自行核查的时间戳不是证明——而是供应商的承诺。一旦有人要求你证明代码在某个时间点就已存在,这一区别就至关重要:无论是合规审计员、专利纠纷中的对方律师,还是进行技术尽职调查的收购方。
本文介绍如何使用 Timestamp GIT 的证明产物和工具独立验证 Git 提交时间戳:公共状态页面、基于浏览器的 Merkle 验证页面、REST API、验证徽章以及可下载的报告。无需任何源代码离开你的代码仓库,也无需信任任何人——包括供应商——结果依然成立。
为什么独立验证很重要
每一个加密时间戳的强度,都取决于你能否按自己的方式审计它。
- 验证不能依赖供应商是否存续。 Timestamp GIT 的证明仅依赖 SHA-256 和比特币区块数据。即使服务已不复存在,你也可以离线验证它们。
- 监管机构、审计员和法院期望可复现的证据。 “仪表盘上是这么显示的”不是证据。与比特币区块匹配的 Merkle 根才是。
- 尽职调查会提出尖锐的问题。 在收购或融资过程中,知识产权的成熟度会受到审查。能够交出可验证的证明链,与交出一张截图截然不同。
- 你的源代码保持私密。 验证只需要两样东西:证明文件(清单和
.ots收据)以及公开的区块链数据。不需要你的实现,也不需要你的商业机密。
本文的其余部分就是这份实用清单。
Timestamp GIT 证明是什么样的
一天的提交会产生一组小而明确的产物:
- 每日清单文件(
.txt),包含当天为该仓库收集的提交哈希。 - Merkle 根,基于清单计算得出。该根是代表批次中每一个提交的单一值。
.ots收据文件——一份 OpenTimestamps 证明,将该 Merkle 根以加密方式链接到特定的比特币区块。
这些产物存放在专用的 timestamps 分支或影子仓库中,刻意与你的源代码分离。这种分离正是关键所在:证明独立于它所保护的代码而流转。
除了这些文件,记录还包含锚定该批次的比特币区块高度和交易 ID。正是这两个值让任何人——你、律师、外部审计员——都能确认数据在该区块被挖出时就已存在。
分步指南:使用 Timestamp GIT 的工具进行验证
时间戳是自动生成的:安装一次 GitHub App,连接仓库,每晚每个提交都会被锚定,无需任何手动步骤。验证则是你接手的地方——你有五种方式可以完成。
1. 公共状态页面
打开 https://timestampgit.dev/status/{user}/{repo}。该仪表盘显示:
- 证明的持久性和最早的锚定日期,
- 每日规律性(日历热力图让缺口一目了然),
- 每个锚定的比特币区块高度和交易 ID。
这是最快的健全性检查。如果对方质疑连续性,热力图就是答案。
2. 基于浏览器的验证页面
要查看特定某一天,请访问 https://timestampgit.dev/verification/{user}/{repo}/{date}。该页面逐步展示多级 Merkle 链,并且所有计算都在你的浏览器中本地进行——零知识。没有人能看到你验证了什么,这在仓库本身属于机密时非常有用。
这是可以在审计员面前打开的页面,因为链的每一级都被展示出来,而非仅仅给出摘要。
3. 验证 API
当验证需要脚本化或归档时,拉取原始链:
curl -s "https://timestampgit.dev/api/verify/acme-corp/payments-api/2026-10-05" \
-H "Accept: application/json" | jq .
响应包含当天时间戳的完整 Merkle 链数据,因此你可以在本地重新计算,而不必信任渲染出来的页面。
4. 验证徽章
在仓库连接页面上,你会获得一个可嵌入的 Shields.io 徽章及其 markdown 代码片段。把它放进你的 README:
[](BADGE_LINK)
点击徽章的任何人都会进入你仓库的验证视图。这是一个公开的、始终最新的存在性证明声明——而且由于该链接指向可验证的数据而非静态图片,它不仅仅是装饰。
5. 报告和审计导出
两个端点覆盖了文书工作方面:
# Per-day PDF certificate
curl -sL "https://timestampgit.dev/api/report/acme-corp/payments-api/2026-10-05" \
-o certificate-2026-10-05.pdf
# Full audit ledger as CSV
curl -sL "https://timestampgit.dev/api/audit/acme-corp/payments-api" \
-o audit-ledger.csv
PDF 是你附在法律文件上的东西。CSV 是你输入内部审计档案或交给尽职调查团队的电子表格的东西。
请注意,私有仓库会在其 URL 后附加加密的 HMAC,因此只有授权用户才能打开其状态和验证页面。底层的证明没有改变——它仍然锚定在比特币中,任何持有证明文件的人仍然可以验证。
解读验证结果和边缘情况
验证成功意味着一个具体的事情:你从清单重新计算出的 Merkle 根,与 .ots 收据所引用的比特币区块中锚定的值相匹配。这一匹配证明这组提交哈希在该区块的时间戳之前就已存在。谁运行检查、在哪里运行都无关紧要。
在向任何人承诺验证结果之前,有四种边缘情况值得了解:
- 当天很可能还无法验证。 锚定每晚运行,而比特币确认需要几个小时(通常约 3 小时)。今天提交的证明可能还不存在,前一晚的批次可能仍在等待确认。请围绕这个时间窗口安排审计。
- 私有仓库需要 HMAC。 验证的工作方式与公共仓库完全相同,但 URL 带有特定于服务器实例的加密 HMAC。没有 HMAC,就没有状态页面。
- 时间戳证明存在性,而非作者身份。 该证明表明某个提交哈希在特定时间存在。它本身并不能确定是谁编写了代码,也不能证明代码具有新颖性。请将其用作现有技术证据,而非所有权链的替代品。
- 任何人都可以验证,即使没有 Timestamp GIT。 由于证明建立在开放标准之上,一个有足够动力的工程师可以用标准的 OpenTimestamps 工具对照比特币区块链验证
.ots文件。这是一个特性:它意味着你的证据在供应商消失后依然有效。
不使用 SaaS 进行验证:困难的方式(以及为什么你不需要它)
原则上你可以自己搭建这条流水线——运行 OpenTimestamps 工具、查询比特币节点、手动核对 Merkle 证明。但在实践中,这意味着要为一个并非你产品的任务维护基础设施和专业知识。
Timestamp GIT 的存在就是为了让你不必这么做。在一个受监控的仓库上安装一次 GitHub App,每晚每个提交都会自动锚定到比特币中——无需 CLI,无需手动步骤,无需协议知识。验证则是一个链接、一个徽章或一次 API 调用。对于需要将所有内容保留在自己硬件上的组织,可以通过 Docker 镜像进行自托管:
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 并配置实例。
在工作流中自动化验证
手动验证对于纠纷来说没问题。对于持续的合规性,请将其自动化。
以锚定状态作为 CI/CD 的门禁。 组合摘要端点正是为此设计的:
curl -sf "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api" -o summary.json
cat summary.json
一个小检查脚本就能把它变成构建门禁:
import json
import sys
import urllib.request
URL = "https://timestampgit.dev/api/statusSummary/acme-corp/payments-api"
with urllib.request.urlopen(URL) as response:
summary = json.load(response)
print(json.dumps(summary, indent=2))
# Fail loudly if the summary reports no anchored Bitcoin block yet.
if not any("block" in key.lower() for key in summary):
sys.exit("No Bitcoin anchor reported for this repository yet.")
把它接入一个定时工作流,这样缺失的锚定就会变成一张工单,而不是审计期间的意外:
name: Timestamp anchor check
on:
schedule:
- cron: "0 8 * * *"
workflow_dispatch:
jobs:
verify-anchor:
runs-on: ubuntu-latest
steps:
- name: Check anchor status
run: |
curl -sf "https://timestampgit.dev/api/statusSummary/${{ github.repository_owner }}/${{ github.event.repository.name }}" \
-o summary.json
cat summary.json
按计划归档证明。 每月拉取审计 CSV 并存储到你的记录系统中:
curl -sL "https://timestampgit.dev/api/audit/acme-corp/payments-api" \
-o "audit-ledger-$(date +%Y-%m).csv"
发布徽章。 它只需在 README 中占一行,就能让对方向自助核查你的声明。
如果要求仓库内容不进入服务,Enterprise ZK 部署模式会在你自己的基础设施上运行一个简短的 GitHub Action,将提交哈希推送到 Timestamp GIT API。验证行为相同;只有摄取路径发生变化。
常见问题
我需要信任 Timestamp GIT 才能验证时间戳吗?
不需要。证明仅依赖 SHA-256 和比特币区块数据。即使 Timestamp GIT 已不复存在,你也可以使用 .ots 文件和标准 OpenTimestamps 工具对照比特币区块链独立验证它。
提交时间戳需要多久才能变得可验证? 在每晚的锚定过程之后,证明会被写入你的仓库。比特币确认通常需要约 3 小时,之后时间戳就不可变且可验证。
我可以验证私有仓库的时间戳吗? 可以。私有仓库使用附加在 URL 后的加密 HMAC,因此只有授权用户才能访问状态页面和验证工具。底层证明仍然锚定在比特币中,任何持有证明文件的人都可以验证。
Timestamp GIT 提供哪些验证工具? 一个公共状态页面、一个在本地计算一切的基于浏览器的验证页面、用于 Merkle 链数据和审计报告的 REST API 端点,以及可嵌入的 Shields.io 徽章。所有这些都设计用于无需供应商参与的独立验证。
结论
独立验证是时间戳与营销声明的分水岭。使用 Timestamp GIT,你可以从状态页面获取证明链,在浏览器中重新计算 Merkle 路径,在 CI 中脚本化同样的检查,并为文件导出 PDF 证书——所有这些都无需暴露一行源代码。
如果你希望在自己的仓库上运行这一切,托管服务只需一次性设置:安装 GitHub App,连接仓库,然后让每晚的锚定完成其余工作。对于气隙或自托管需求,Docker 自托管许可证也覆盖了这条路径。从 timestampgit.dev 开始,亲自验证一个仓库。
相关文章
- Automatic Nightly Git Commit Anchoring to Bitcoin, Zero Manual Steps
- Code Timestamping Service Pricing for Private Repos
- OpenTimestamps Alternatives: Managed Git Timestamping