Timestamp GIT

← All posts

2026-10-28

Timestamp GIT 与 OpenTimestamps CLI:哪个更适合你的团队?

Timestamp GIT 与 OpenTimestamps CLI:哪个更适合你的团队?
timestamp git blockchain proof

Timestamp GIT 对比 OpenTimestamps CLI:哪个更适合你的团队?

你已经做出了那个有趣的决定:将 Git 历史锚定到比特币区块链上,这样在几个月或几年后,你就能证明某个提交在特定日期就已存在。这个决定很明智。

接下来是一个无聊——而且昂贵得多——的决定:由谁来运营这条流水线?

你可以基于 OpenTimestamps CLI 自己搭建,也可以把整个循环交给托管服务。两条路线最终都会得到比特币锚定的证明。它们在工程时间、运维看护和审计文书工作给团队带来的负担上差异巨大。本文是对两者的买方视角对比,面向将负责流水线的开发者和将负责证据的合规人员。

购买决策:手动 CLI 对比托管自动化

OpenTimestamps 协议是开放且免费的。没有什么能阻止你把它封装进自己的脚本:收集哈希、批量处理、生成收据、存到某个持久的地方,然后指望有人记得检查每个证明最终是否在比特币区块中得到确认。

那个“指望有人记得”正是关键所在。时间戳流水线启动不难,但要在多年里保持正确却出奇地难。比特币锚定是异步的——证明在创建的那一刻并不是最终状态;在区块中确认需要数小时。必须有人跟踪待处理的证明、重新检查它们、存储结果,并在人员流动中保持整个系统运转。

Timestamp GIT 把这一循环隐藏在一个 GitHub App 背后。你安装它、选择仓库,每个提交哈希都会每晚自动锚定。开发者机器上没有 CLI,没有你自己拥有的 cron 任务,也没有手动验证仪式。

这种权衡是对称且诚实的:

  • CLI: 最大控制权、零许可成本、所有运维风险由你承担。
  • Timestamp GIT: 对内部细节的控制较少、成本可预测、运维风险(以及那些无聊的部分)由供应商处理。

本对比停留在运维和合规层面。如果你想要协议理论,请先阅读比特币时间戳能证明你代码的什么?——本文其余部分假设你知道为什么需要证明,而不是哈希如何工作。

全景:Git 提交时间戳有哪些可选方案?

实践中会出现三种现实的配置:

1. OpenTimestamps CLI(自己动手)。 一套免费、开源的工具链,用于为文件创建和检查时间戳证明。它确实是好软件,也是其他所有人构建所基于的同一协议。但它不知道 Git 是什么。你来写胶水代码:一个脚本提取提交哈希、批量处理、调用工具、把生成的 .ots 收据上传到某个持久的地方,以及第二个进程跟踪每个证明直到它落入比特币区块。这是艰难的方式,而且是一项永久的维护成本项。

2. Timestamp GIT(托管)。 一个带 GitHub App 的 SaaS。它读取受监控仓库的 HEAD 提交哈希,在午夜批量处理所有客户的所有待处理哈希,为每个仓库构建 Merkle 树,并通过 OpenTimestamps 协议把 Merkle 根锚定到比特币。清单和 .ots 收据会被推回你自己的仓库——要么是一个专门的 timestamps 分支,要么是一个单独的影子仓库。在此之上还有验证徽章、公开状态仪表盘、审计 CSV/PDF 导出和 REST API。

3. 混合。 用托管服务持续覆盖所有发布的内容,再加上手动流程处理偶尔不在 Git 中的产物(设计文档、规格说明、固件二进制)。这很常见也很合理。证明是兼容的;混合使用时不会出问题。

有一点值得直说:你无法事后为 Git 历史打时间戳并获得同样的价值。证明在持续且无聊时最有价值——覆盖每一个提交,包括那个十八个月后在专利纠纷中变得重要的提交。

选择标准:如何评估你的选项

实践中由五个标准决定。在看价格标签之前,先按每个标准给两个选项打分。

设置难易度。 CLI 路线意味着编写脚本、设计证明存储,以及决定依赖哪些 OpenTimestamps 日历服务器。第一版要预算几天时间,之后还要持续投入时间应对漂移。Timestamp GIT 作为 GitHub App 安装:连接仓库,完成。在 Standard 模式下,它需要对源仓库的只读访问(GitHub 没有“仅提交哈希”的权限范围)以及对存储证明的仓库的读写访问。开发者机器上不安装任何东西。

自动化。 使用 CLI 时,时间戳在你的脚本运行时才发生——这意味着 cron 任务、CI 步骤或人工。使用 Timestamp GIT 时,一个午夜 cron worker 会分组所有待处理哈希、写入每个仓库的清单、构建 Merkle 树、创建证明并锚定根。比特币确认通常需要约三小时,因此收据会在午夜后几小时无人值守地出现。

安全与隐私。 自建流水线把所有东西留在内部,但你也拥有每一种失败模式。Timestamp GIT 在设计上是零知识的:它从不查看、复制或存储源代码——只存储提交哈希。两种部署模式覆盖了整个范围:

  • Standard 模式(GitHub App): 自动,对源只读,对证明目标读写。
  • Enterprise ZK 模式: 一个 12 行的 GitHub Action 在你的基础设施上运行,只把提交哈希推送到 API,因此服务永远不需要对源仓库的读访问。

对于气隙或最高安全环境,Docker 自托管许可证可在你自己的网络内运行同一应用。

集成与可审计性。 CLI 给你原始的 .ots 文件,报告留给你自己做。Timestamp GIT 给你可嵌入的 README 徽章、每个仓库的公开状态仪表盘(证明寿命、最早锚定日期、每日规律性、比特币区块和交易数据、日历热力图)、可下载的审计 CSV、按日期的 PDF 证书,以及一个验证页面,其中完整的 Merkle 链在浏览器本地计算。

成本。 CLI 许可免费,但工程小时昂贵——而且这些小时会反复出现。Timestamp GIT 是分层的:Open Source(免费,公开仓库)、Pro Agency($49/月,私有仓库)、Enterprise ZK($199/月,GitHub Actions)。Docker 镜像单独授权,可应要求提供限时演示许可证。详细分解见 Git 提交时间戳服务定价:哪个层级适合你的团队。

并排对比:Timestamp GIT 对比 OpenTimestamps CLI

标准 OpenTimestamps CLI Timestamp GIT
设置工作量 数天的脚本编写:哈希提取、批处理、证明存储、日历配置 安装 GitHub App,选择仓库。零代码改动,开发者机器上无任何东西
自动化程度 你安排什么就是什么——cron、CI 或手动运行 通过午夜 cron worker 自动每晚锚定
安全模型 完全控制;你的基础设施、你的密钥和存储决策 零知识:仅哈希。Standard(GitHub App)或 Enterprise ZK(12 行 GitHub Action);气隙环境用 Docker
证明交付 你自己生成和存储的文件 清单 .txt + .ots 收据推送到 timestamps 分支或影子仓库
验证方法 标准 OpenTimestamps 验证工具,由你运行 本地浏览器内 Merkle 验证页面、徽章链接、PDF 报告——如果你愿意,还可加上标准 OTS 工具
审计与报告 自己构建 状态仪表盘、审计 CSV、PDF 证书、REST API
定价 免费工具;反复的工程时间 Open Source 免费 · Pro Agency $49/月 · Enterprise ZK $199/月 · Docker 许可证
支持 你自己的团队 供应商运营的服务;自托管附带设置向导和文档
供应商锁定 按定义没有 没有:标准 .ots 证明锚定在比特币中,可离线验证

有两点澄清对合规审查者很重要。

第一,两条路径产生同一类证据:锚定在比特币区块中的证明,可对照公开区块数据验证。Timestamp GIT 增加的是便利层——徽章、仪表盘、证书、API——而不是不同的密码学承诺。

第二,这意味着没有锁定。如果供应商明天消失,你仓库中的证明仍可使用比特币区块数据离线验证。你也可以通过产品自己的 API 交叉核对它们:

# Latest anchored block + totals for a repo (public)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-service

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

# Download the complete audit ledger as CSV
curl -LO https://timestampgit.dev/api/audit/acme/payments-service

# PDF certificate for one date
curl -LO https://timestampgit.dev/api/report/acme/payments-service/2026-10-14

徽章是你能发布的最便宜的合规信号。GET /api/badgeLink/{user}/{repo} 返回徽章 URL 以及可直接粘贴到 README 的 Markdown 块,这样任何审查仓库的人都能点击进入公开状态页面。私有仓库的 URL 会附加一个加密的 HMAC,作用域限定在服务器实例,因此只有授权人员才能读取状态。

结论:谁该选哪个?

选择 OpenTimestamps CLI,如果 你有专门的工程时间并打算长期保持,你需要对流水线每个部分的步骤级控制,并且时间戳是偶尔的需求而非对每个提交的持续覆盖。

选择 Timestamp GIT,如果 你希望流水线存在但不由你拥有:每个提交每晚锚定、证明提交回你自己的 Git、给审计员的徽章和仪表盘,以及可以交给律师的 PDF 证书。大多数把需求描述为“我们需要在纠纷中证明这一点”的团队会落到这里。

选择 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 并配置实例。

一条实用的迁移路径:从公开仓库的免费 Open Source 层级开始,确认每晚的收据确实落入你的 timestamps 分支,然后在私有仓库进入范围时升级到 Pro Agency。

常见问题

我可以同时使用 Timestamp GIT 和 OpenTimestamps CLI 吗?

可以。Timestamp GIT 生成与 OpenTimestamps 协议兼容的标准 .ots 证明文件。如果你愿意,可以使用标准 OpenTimestamps 验证工具验证 Timestamp GIT 证明,但你不必这样做——Timestamp GIT 提供自己的验证仪表盘和 PDF 证书。

Timestamp GIT 会把我锁定在专有格式中吗?

不会。Timestamp GIT 使用 OpenTimestamps 协议将证明锚定在比特币区块链中。证明与供应商无关,可使用比特币区块数据离线验证。你不会被锁定。

Timestamp GIT 如何处理私有仓库?

在 Standard 模式下,GitHub App 需要对源仓库的只读访问以读取提交哈希,以及对存储证明的目标仓库的读写访问。对于更严格的零知识要求,Enterprise ZK 模式使用一个 GitHub Action,只把提交哈希推送到 Timestamp GIT API,因此服务永远没有对你源代码的读访问。

Timestamp GIT 有自托管选项吗?

有。Timestamp GIT 提供用于自托管的 Docker 镜像,非常适合气隙或高安全环境。快速开始的 Docker Compose 配置包括 Timestamp GIT 镜像(rue1401/timestampgit:prod)和 Valkey 镜像(valkey/valkey:8)。可应要求提供限时演示许可证。

对一个五人团队来说,哪个选项更便宜?

这取决于你计算什么。CLI 没有许可费,但工程小时每月都会反复出现,而且流水线必须在人员变动中存活。把它与私有仓库的 Pro Agency $49/月相比——并记住两种情况下证明输出都是同一类证据。

结论

当控制是需求且你有人员来维持它时,OpenTimestamps CLI 是正确答案。对大多数团队来说,需求实际上是覆盖:每个提交、每晚,无需任何人记得去运行什么。这是一个运维问题,也正是 Timestamp GIT 被构建来吸收的问题——安装一次 GitHub App,让午夜 worker 把你的提交哈希锚定到比特币中,然后发布徽章,证明已经在你的仓库里。

今天在一个测试仓库上安装 GitHub App,明天早上检查收据是否在那里。这个五分钟的实验比任何对比表都能告诉你更多。

相关文章

EU label: AI-generated content