Timestamp GIT

← Tutti gli articoli

2026-11-06

OpenTimestamps senza CLI: timestamping Bitcoin gestito

OpenTimestamps senza CLI: timestamping Bitcoin gestito
timestamp git blockchain proof

OpenTimestamps 无需 CLI:托管式比特币时间戳

如果你曾经想证明某段代码在特定日期就已存在,你很可能接触过 OpenTimestamps。你很可能也遇到过那些没人写进标题的部分:命令行、日历服务器、.ots 文件,以及一种隐约的感觉——你现在得去理解比特币交易了。

本文是无需 CLI 的 OpenTimestamps 讲解。这并不是因为该协议不好——它确实非常出色——而是因为命令行只是一个实现细节,并非必需。存在一条托管路径:一个 GitHub App 会监视你的仓库,并在你睡觉时把每一次提交锚定到比特币中。你只需安装一次,永远不用输入任何时间戳命令。

我们将介绍 OpenTimestamps 实际做了什么、为什么公证人的类比几乎完美契合、每晚在底层发生了什么,以及那些阻碍团队采用它的误解。本文把原始协议机制当作背景知识;重点是自动化工作流以及它能为你带来什么。

什么是无需 CLI 的 OpenTimestamps?

OpenTimestamps 是一种协议,用于证明某些数据在某个时间点或之前已经存在。它的做法是把数据聚合进一棵 Merkle 树,对根进行哈希,再把该根提交进一个比特币区块。由于比特币区块不可篡改且在全球范围内复制,这个锚点就成为公开的、可防篡改的存在性记录。

CLI 只是该协议的一种接口。一个 Web 服务、一个 GitHub App 或一个定时任务可以做到完全相同的事——而且做得更好,因为批处理和日历处理正是人类不擅长的部分。

托管式方案是这样的:你在一个仓库上安装 Timestamp GIT GitHub App。从那时起,每一次提交都会被自动检测、每晚批量处理,并通过 OpenTimestamps 锚定到比特币中。证明会以收据文件和清单的形式回到你的仓库。无需命令,无需本地工具,无需比特币节点。

明确一下范围:本文解释概念和托管工作流,不会带你逐步操作原始协议。如果你想深入了解相关主题,请参阅如何在浏览器中验证比特币时间戳证明和为什么你的 Git 日志不是证明。

一个简单的类比:为你的代码请一位公证人

想象一位公证人。你递给他一份文件。他不会读它。他会在文件上计算一个防篡改的封印,盖上日期,并把该封印记录在一个任何人都能查阅的公共账本中。之后,如果有人质疑日期,你出示文件、重新计算封印,并指向账本中的记录。

OpenTimestamps 就是那位公证人,但有两项升级:

  • “文件”是哈希,不是你的代码。 Git 已经为每次提交生成唯一的单向哈希(SHA-1 或 SHA-256),代表你仓库在那一刻的确切状态。该哈希就是指纹。Timestamp GIT 只处理指纹。
  • 账本是比特币区块链。 封印不是记录在档案柜里公证人的装订簿中,而是记录在一个由数千个独立节点复制的区块里。没有人——你、我们、法院命令——能改写它。

第三项升级才是日常真正重要的:有了 Timestamp GIT,公证人每晚自动上门。无需预约,无需排队,无需文书。你提交代码;盖章按你从不用操心的日程进行。

底层工作原理(简要)

三个步骤,只有中间一步涉及任何类似基础设施的东西。

第 1 步——指纹。 当你提交时,Git 会为该提交生成唯一哈希。Timestamp GIT 只收集这些哈希。你的源代码永远不会被读取、复制或存储。

第 2 步——锚定。 一个午夜定时任务会汇总所有待处理的哈希,为每个仓库构建一棵原生 Merkle 树,创建一个清单 .txt 文件,并使用公共 OpenTimestamps 日历把 Merkle 根锚定到比特币中。

第 3 步——证明。 清单和 .ots 收据文件会被推回你的仓库——放在专门的 timestamps 分支或单独的影子仓库中。之后,任何人都可以离线对照比特币区块数据进行验证。

两个值得了解的运营细节:

  • 比特币确认需要数小时,通常约三小时。因此证明写入会在每晚批处理之后几小时完成,而不是立即完成。
  • 验证与供应商无关。证明只依赖 SHA-256 和比特币区块数据。没有专有格式,没有锁定。

以下是每晚批处理产物的概念结构:

timestamps/
├── 2026-11-05/
│   ├── manifest.txt        # commit hashes for the day
│   └── manifest.txt.ots    # OpenTimestamps receipt for the Merkle root
└── 2026-11-06/
    ├── manifest.txt
    └── manifest.txt.ots

收据才是你要保留的产物。其他一切都只是便利。

为什么托管式时间戳很重要

自己运行协议是可行的。但它也是一个维护项目:日历可靠性、批处理逻辑、比特币确认处理、收据存储,以及面向审计方的验证方案。对大多数团队来说,这会分散对实际产品的注意力。

托管服务移除了这些活动部件:

  • 无需协议知识。 你不需要学习日历服务器、Merkle 证明或比特币交易结构。艰难的路存在;你被允许跳过它。
  • 可用于法庭、与供应商无关的证明。 证据存在于比特币中,而不是我们的数据库里。任何人都可以在不信任我们的情况下检查它。
  • 契合工作流。 安装一次 GitHub App。之后每次提交都会自动锚定。无需改变习惯,无需在开发者机器上安装任何东西。
  • 合规面。 README 文件的公开验证徽章、可下载的审计 CSV,以及按日期生成的 PDF 证书,让审计方有具体的东西可看。

对于代理机构和自由职业者,最后一点在付款纠纷和署名主张中确实有用。对于公司,它是一面盾牌,用来抵御专利流氓对已在内部系统中运行的东西主张权利。

关于 OpenTimestamps 的常见误解

“你需要成为比特币专家。” 你需要信任数学,而不是专业知识。使用托管服务时,复杂性已被处理:批处理、锚定和证明交付都按日程进行。你只需与仪表盘和仓库中的一个分支打交道。

“时间戳会暴露我的源代码。” 不会。只有提交哈希被锚定。服务永远不会看到、复制或存储你的代码——零知识原则是架构性的,而不是政策承诺。在 Enterprise ZK 模式下,哈希提交作为 GitHub Action 在你自己的基础设施上运行,只把哈希推送到 API,因此服务对源仓库完全没有读取权限。

“证明的可靠性只取决于供应商。” 证明是比特币原生的。你可以下载 .ots 收据文件,并使用标准 OpenTimestamps 验证对照区块链离线验证它们。如果 Timestamp GIT 明天消失,你的证明仍然有效。

“它又贵又慢。” 每日批处理意味着许多提交共享一个比特币锚点,这就是经济性成立的原因。确认需要几小时——对于现有技术证据来说可以接受,因为这类证据以月和年为单位评判,而不是以分钟。

无需 CLI 的上手方式

有两种部署模式,都不需要在开发者机器上使用终端。

标准模式(GitHub App)。 在你想监视的仓库上安装 GitHub App。它会自动读取 HEAD 提交哈希,并把证明写入一个专门分支——可以在同一仓库中,也可以在一个单独的目标仓库中。GitHub 的权限模型要求至少对源仓库有只读访问权限(没有仅限提交哈希的权限),外加对目标仓库的读写访问权限。

Enterprise ZK 模式。 一个 12 行的 GitHub Action 在你的基础设施上运行,只把提交哈希推送到 Timestamp GIT API。这里你只需要对目标仓库的读写访问权限,不需要对源的读取权限。当连哈希可见性都必须留在你的边界内时,选择这个模式。

无论哪种方式,安装后的流程都平淡无奇:检测到提交,哈希进入队列,夜间任务锚定它们,证明在比特币确认后几小时出现在你的 timestamps 分支中。

使用 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 License 页面申请,需提供姓名、公司、电子邮件和可选电话号码;许可证文件可立即下载。

运行后你会得到什么

  • 每个仓库的公开状态仪表盘:证明寿命、最早锚定日期、每日规律性、比特币区块和交易数据、日历热力图,以及可下载的审计 CSV 和 PDF 证书。
  • README 的验证徽章,附有任何人都能点击查看时间戳的链接。私有仓库会在 URL 后附加加密的 HMAC,因此只有授权用户才能看到状态。
  • 基于浏览器的验证器,在本地执行多级 Merkle 链检查,因此没人能看到你验证的内容。
  • REST API,如果你想用脚本检查状态:/api/statusLast/{user}/{repo}、/api/statusCount/{user}/{repo}、/api/audit/{user}/{repo} 等等。
# Check the last anchored Bitcoin block for a repo
curl https://timestampgit.dev/api/statusLast/youruser/yourrepo

套餐与你的隐私需求相匹配:Open Source 用于公共仓库,Pro Agency 用于私有仓库,Enterprise ZK 用于基于 GitHub Action 的隔离。详情见定价页面。

常见问题

使用 Timestamp GIT 配合 OpenTimestamps 需要安装任何软件或运行命令吗?

不需要。Timestamp GIT 是一个托管式 GitHub App。你安装一次,它就会每晚自动为你的提交打时间戳。无需安装 CLI 工具,也无需运行命令。

Timestamp GIT 如何确保我的源代码保持私密?

Timestamp GIT 遵循零知识原则:它只处理 Git 提交哈希,从不处理你的实际源代码。在 Enterprise ZK 模式下,连哈希也是通过 GitHub Action 从你的基础设施推送的,因此服务永远没有对你仓库的读取权限。

我可以在不信任 Timestamp GIT 的情况下独立验证时间戳吗?

可以。证明使用 OpenTimestamps 协议锚定在比特币区块链中。你可以下载 .ots 收据文件,并使用标准 OpenTimestamps 验证离线验证它们,或使用内置的本地运行的基于浏览器的验证器。

如果 Timestamp GIT 倒闭了会怎样?

你的证明仍然有效,因为它们已嵌入比特币区块链。验证只依赖比特币和 SHA-256,因此你可以继续独立证明你的代码存在。

结论

OpenTimestamps 解决了一个真实问题——证明数据在特定时间存在——而且它只靠哈希和比特币就解决了。命令行从来不是重点,它只是第一个接口。

托管接口更适合团队的实际工作方式:安装一个 GitHub App,继续提交,让夜间任务锚定哈希。你会得到 .ots 收据、清单分支、验证徽章、审计 CSV 和 PDF 证书——所有这些都由能经受供应商消失的证明支撑。

如果你想要自动化版本,请在一个仓库上安装 Timestamp GIT,然后提交一些东西。这就是全部设置。公证人今晚就会上门。

EU label: AI-generated content