Timestamp GIT

← Tutti gli articoli

2026-10-20

Alternativa a OpenTimestamps: GitHub App gestita per ogni commit

Alternativa a OpenTimestamps: GitHub App gestita per ogni commit
timestamp git blockchain proof

OpenTimestamps 替代方案:为每次提交打造的托管式 GitHub App

你已经决定要将 Git 历史锚定到比特币上。这一点已经确定——密码学上的在先证明,是"我们先做出来的,相信我们"与律师可以呈交给法官的证据之间的区别。悬而未决的问题是如何实现:自己运行 OpenTimestamps、搭建自己的时间戳流水线,还是把整个工作交给一个替你与 GitHub 对接的托管服务。

本文讨论的正是这一购买决策。如果你是一名开发者或合规负责人,需要为每一次提交提供可重复、可审计的证明——而不是一个周末的业余科学项目——那么下面的标准才是真正重要的。Timestamp GIT 是本文评估的托管方案,我们会明确指出它在哪些方面胜出,在哪些方面不然。

购买决策:托管服务 vs. 自建 OpenTimestamps

OpenTimestamps 是一个开放协议,这是它的特性,而非缺陷。没有人能把它从你手中夺走,也没有人能把你的证明扣为人质。但"开放协议"也意味着"你就是运营者"。自建给你最大程度的控制权,同时也交给你一长串杂务:每台需要打时间戳的机器上都要装工具、要考虑日历服务的可用性、证明要归档在三年后你仍然找得到的地方,还要在律师要求时能随时复现验证。

托管服务则把这种权衡颠倒过来。你只需安装一次 GitHub App,把它指向仓库,剩下的管道工作——哈希、批处理、Merkle 构建、锚定、证明交付——都会按你无需操心的日程自动完成。

这一对比面向的是开发者和合规团队:他们需要的是结果(可证明、带日期、可独立验证的在先证明),而不是成为 OpenTimestamps 的运营者。下面的选择标准是:设置便捷性、自动化、代码访问、验证与证据,以及价格/部署。结论部分会把每个选项对应到一个角色。

全景:实际存在哪些 OpenTimestamps 替代方案

现实中有三大类别,外加一种混合方案。

原生 OpenTimestamps CLI。 免费、开放,完全由你掌控。你要自己在每台机器上、为每个仓库打时间戳、验证和管理证明。这是硬核路线——协议层面的路径。对单个工程师做原型来说确实没问题,但一旦你有十个仓库和一项合规要求,就会变得很痛苦。

自托管时间戳服务。 基础设施由你运行:批处理逻辑、Merkle 流水线、比特币锚定、证明存储。你获得隐私和对数据流的完全控制,同时也承担所有故障模式。比特币确认延迟、日历服务中断、证明保留策略,全都变成你的值班轮班。

带 GitHub App 的托管 SaaS。 安装一次,提交每晚自动锚定,证明回落到你的仓库。协议仍在底层运行——自始至终都是 OpenTimestamps 和比特币——但你永远不必碰它。

Docker 自托管作为混合方案。 Timestamp GIT 也提供 Docker 镜像,用于气隙或最高安全级别的环境。你获得托管式工作流,而运行时在你自己的边界之内。

托管式 OpenTimestamps 服务的选择标准

五个问题可以区分真正的托管服务与仍需你自己干活的包装层。

  • 设置便捷性。 它是否需要在开发者机器上安装 CLI 工具,还是一个 GitHub App 安装一次就能永久运行?任何需要每位开发者各自配置工具的方案都会逐渐失效——新员工会跳过它,证明链恰好会在你最需要它连续的地方出现缺口。
  • 自动化。 提交是否无需开发者操作即可自动锚定(例如每晚)?如果必须有人记得按一下按钮,那就不是自动化。
  • 安全与代码访问。 服务能看到你的源代码,还是只能看到提交哈希?这是合规团队最先问的问题,而正确答案是"只能看到哈希"。
  • 验证与证据。 第三方能否独立验证?是否有徽章、PDF 证书和审计 CSV,还是只有一行你必须信任的数据库记录?
  • 价格与部署。 是否有面向开源的免费档、面向私有仓库的付费档,以及在你安全政策要求时可用的自托管路径?

并排对比:OpenTimestamps CLI vs. 自托管 vs. Timestamp GIT

OpenTimestamps CLI 自托管时间戳 Timestamp GIT
设置工作量 每台打时间戳的机器上都要安装并维护工具 你要构建并运营批处理、Merkle 和锚定流水线 每个仓库安装一次 GitHub App
持续的手动步骤 你自己打时间戳、验证并归档证明 你运营并监控基础设施 无——每晚的 cron worker 处理每一个待处理的哈希
代码访问 本地;任何东西都不离开机器 完全取决于你构建了什么 标准模式下仅监控仓库的 HEAD 提交哈希;在企业 ZK 模式下,GitHub Action 只推送哈希,因此服务对源代码没有读取权限
验证 手动,对照比特币区块数据 取决于你自己编写的工具 可嵌入徽章、基于浏览器的验证器、PDF 报告、CSV 审计账本——外加对照比特币的完全本地验证
证明存储 你决定放在哪里 你自己的存储 专用的 timestamps 分支或影子仓库,包含清单和 .ots 收据
定价 免费(协议) 你的基础设施账单 公开仓库免费,Pro Agency $49/月,Enterprise ZK $199/月;提供 Docker 自托管许可证
最适合 一个工程师、一个仓库、完全控制 有气隙或本地部署需求且具备运维能力的团队 希望获得法庭可用证据而无需承担协议开销的开发者、初创公司、代理机构和合规团队

结论:谁该选哪个选项

选择原生 OpenTimestamps CLI,如果你想要最大程度的控制、享受流水线工作,并且能自在地手动管理证明文件和验证。它免费,而且完全属于你。请诚实地评估:十八个月后你还会继续这么做吗?

选择自托管,如果你需要气隙或本地部署运行,并且有运维能力端到端地拥有整条流水线。这在受监管环境中是真实需求,也是真实成本。

选择 Timestamp GIT,如果你想要零设置、自动化、可独立验证的每次提交证明,且不涉及代码访问。把它对应到角色:

  • 初创公司和创始人,在专利申请前确保在先证明,或在不公开任何内容的情况下保护商业秘密。
  • 开发工作室和代理机构,需要在付款纠纷中证明交付日期。
  • 自由职业者,保护可复用库代码和作品集。
  • 合规团队,需要可重复、可审计的证据链,而不是一张 Git 日志的截图。

关于普通 Git 历史为何在审计中是弱证据的更深层推理,参见 Git 提交时间戳在法律证明中可靠吗?。

Timestamp GIT 如何交付托管式 OpenTimestamps

工作流刻意保持简短。

  1. 安装一次 GitHub App。 它只读取被监控仓库的 HEAD 提交哈希。仅此而已。
  2. 提交进入队列。 哈希落入内存键值存储中以供批处理。
  3. 每晚的 cron worker 运行。 它把所有待处理的哈希分组,为每个仓库写入一份清单(.txt),原生构建一棵 Merkle 树,使用公共 OTS 日历创建 OpenTimestamps 证明,并把 Merkle 根锚定进比特币。
  4. 证明回到你手中。 清单和 .ots 收据文件被推送到专用的 timestamps 分支或影子仓库。比特币确认通常需要几个小时——一般约 3 小时——因此证明写入发生在每晚运行后的几个小时。

你无需离开终端即可查看状态:

curl https://timestampgit.dev/api/statusSummary/{user}/{repo}

该端点是为 Shields.io 构建的,徽章在 README 中只需一行。仓库状态页会展示证明寿命、最早锚定日期、每日规律性、比特币区块和交易数据、日历热力图,以及可下载的审计 CSV 和 PDF 证书。基于浏览器的验证器会完全在本地逐步走完多级 Merkle 链——没有人能看到你验证的内容。

如果你想要完整的设置演练,GitHub App 区块链时间戳设置:安装一次,永久打戳 从头到尾都有覆盖。

企业 ZK 模式面向那些安全政策禁止第三方持有源代码仓库读取权限的团队。在该模式下,一个 12 行的 GitHub Action 在你的基础设施上运行,只把提交哈希推送到 Timestamp GIT API。只需要对目标仓库的读写权限——不需要对源的读取权限。

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 页面上的表单,附上你的姓名、公司和邮箱,申请限时演示许可证。更多细节参见 自托管 Git 时间戳:Docker 设置与许可证指南。

常见问题

我可以在没有托管服务的情况下使用 OpenTimestamps 吗?

可以。OpenTimestamps 是一个开放协议,你可以用 CLI 工具自己运行。这给你完全的控制权,但需要你在每台机器上手动打时间戳、验证和管理证明。像 Timestamp GIT 这样的托管服务把同一协议自动化在 GitHub App 背后,因此你无需 CLI 步骤即可获得比特币锚定的证明。

Timestamp GIT 会看到我的源代码吗?

不会。在标准模式下,GitHub App 只读取被监控仓库的 HEAD 提交哈希,完成其工作所需也不过这个哈希。在企业 ZK 模式下,一个 12 行的 GitHub Action 在你的基础设施上运行,只把提交哈希推送到 Timestamp GIT API,因此该服务从不对源代码仓库有读取权限。你的源代码永远不会离开你的环境。

一次提交要多久才能锚定进比特币?

提交哈希会每晚批处理并锚定。比特币区块链确认通常需要几个小时——一般约 3 小时——因此证明文件会在每晚运行后的几个小时写回你的仓库。

我可以在没有 Timestamp GIT 的情况下验证证明吗?

可以。证明仅依赖 SHA-256 和比特币区块数据,因此与供应商无关。你可以下载 .ots 收据,并用标准 OpenTimestamps 验证工具对照比特币区块链在本地验证。Timestamp GIT 也提供基于浏览器的验证器、PDF 报告和 CSV 审计账本以方便使用。本地验证的分步指南 会带你走完整个流程。

有自托管选项吗?

有。Docker 自托管许可证可用于气隙和最高安全级别的部署,使用上面展示的 Compose 设置。

结语:通往比特币锚定证明的托管之路

选择归结为你想把精力放在哪里。自己运行 OpenTimestamps 免费且完全由你掌控——但它把协议永远放在你团队的肩上。托管式 GitHub App 把结果放在你团队的肩上,而协议则完全不在。

Timestamp GIT 就是那条托管之路:安装一次 GitHub App,被监控仓库的每一次提交都会每晚自动锚定进比特币,.ots 收据被推回专用分支。验证是公开且本地的——为你的 README 提供徽章、浏览器验证器、PDF 证书和 CSV 审计账本——而且即使服务消失,证明仍然可验证。

公开仓库免费。私有仓库使用 Pro Agency,$49/月;Enterprise ZK 为 $199/月,为不愿授予源代码读取权限的团队增加 GitHub Action 工作流。如果你需要一切都在自己的边界之内,先安装 GitHub App 开始,或申请限时 Docker 演示许可证,先评估自托管路径。

相关文章

EU label: AI-generated content