OpenTimestamps 与 Timestamp GIT:手动证明还是 GitHub App?
你已经做出了重要决定:你的 Git 提交应当锚定到比特币上,这样在六个月或六年之后,你就能证明某一行具体的工作在某个具体日期已经存在。现在到了第二个更实际的决定——你是自己驱动 OpenTimestamps 协议,还是让一个托管的 GitHub App 替你完成?
这个问题与密码学无关。两条路径最终都到达同一个地方:通过 OpenTimestamps 将你提交哈希的 Merkle 根嵌入比特币区块。问题在于谁来运营这条流水线、它要消耗多少工程时间,以及你的合规团队必须批准什么。本文按照真正决定采购的标准来比较这两种方法:易用性、自动化、安全模型、集成和成本。
如果你还在为是否要做时间戳建立论据,请先阅读密码学先有技术:初创公司抵御专利流氓的盾牌。本文假设你已经被说服,正在选择工具。
全景:Git 时间戳有哪些选择?
基本上有三条路线。
1. 原始协议。 OpenTimestamps 是一个开放协议,带有参考 CLI 工具。你安装它,把哈希提交到公共日历服务器,跟踪证明文件,并最终在锚定交易于比特币区块中确认后升级这些证明。它免费、不依赖供应商,而且确实是其他一切所依赖的基础。它同时也把整个运营负担——调度、批处理、存储、证明生命周期、确认监控——都放在你身上。
2. 基于该协议的托管服务。 Timestamp GIT 是一个 SaaS 加 GitHub App,自动化整个 OpenTimestamps 工作流。你在仓库上安装该 GitHub App,从那时起,每次提交都会被自动拾取并每晚锚定。开发者机器上无需 CLI,无需手动打时间戳,无需跟踪证明文件。证据会以清单加 .ots 收据的形式回到你自己的仓库,仪表盘则提供徽章、PDF 证书和审计 CSV。
3. 自研脚本和通用时间戳服务。 团队有时会把 cron 任务接到日历服务器上,或者购买一个没有 GitHub 集成的通用文档时间戳服务。这些可以奏效,但通常意味着要么是有人必须维护的定制代码库,要么是每次发布都要手动上传——而这正是导致时间戳在三个月后悄悄停止的摩擦。
对于气隙或严格数据驻留环境,Timestamp GIT 也提供可自行托管的 Docker 镜像。这在用 Docker Compose 自托管 Git 时间戳中有深入介绍;这里的比较是手动协议工作与托管、自动化流水线之间的比较。
选择标准:如何选择正确的方法
设置难易度
使用原始协议时,设置是一个项目:在每台将要打时间戳的机器上安装工具,记录流程,决定批处理策略,并培训团队。Timestamp GIT 的设置则是安装一个 GitHub App。标准模式需要对源仓库的只读访问权限(GitHub 没有“仅提交哈希”的权限范围)以及对写入证明的目标仓库的读写权限。
开发者机器上无需安装任何东西。这正是重点:依赖开发者记得去做某事的时间戳,最终会出现缺口。
自动化
手动打时间戳是由人按提交或按批次完成的工作。Timestamp GIT 自己运行流水线:webhook 检测提交,哈希在内存键值存储中排队,午夜 cron worker 将所有内容分组为按仓库的清单,构建 Merkle 树,生成 OpenTimestamps 证明,并将 Merkle 根锚定到比特币中。
有一个值得提前规划的运营细节:比特币确认通常需要大约三个小时,因此证明会在夜间批次之后几小时落地——而不是在 00:01。
安全与隐私
这是两种模型在性质上而非程度上分道扬镳的地方。自己运行协议给你完全的控制权,但也带来完全的暴露:你拥有密钥材料、日历可用性、证明存储,以及流程悄悄中断的风险。Timestamp GIT 的模型在设计上是零知识的——它从不查看、复制或存储你的源代码,只处理提交哈希。
如果你不想让 SaaS 看到哪怕一个提交哈希,Enterprise ZK 模式会把推送移入你自己的 CI:一个 12 行的 GitHub Action 在你的基础设施上运行,只把哈希发送到 Timestamp GIT API。在该模式下,服务只需要对目标仓库的读写权限,你的源代码永远不会离开你的环境。
集成与验证
原始证明是独立的 .ots 文件——可移植,但你必须存储它们、找到它们,并向律师解释它们。Timestamp GIT 将清单和收据写入专用的 timestamps 分支或影子仓库,并添加展示层:
- 可嵌入 README 的 Shields.io 徽章,带有公开验证链接。
- 仓库状态仪表盘,显示证明寿命、最早锚定日期、每日规律性、比特币区块和交易数据、日历热力图,以及可下载的审计 CSV 和 PDF 证书。
- 一个分步验证页面,在浏览器本地计算完整的 Merkle 链——你验证的任何内容都不会被发送到任何地方。
公开状态数据无需认证即可查询:
# Last anchored Bitcoin block for a repo
curl -s https://timestampgit.dev/api/statusLast/acme/payments-core
# Combined summary, suitable for Shields.io
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-core
而审计产物每个只需一次请求:
# Full audit ledger as CSV
curl -sO https://timestampgit.dev/api/audit/acme/payments-core
# PDF certificate for a specific day
curl -sO https://timestampgit.dev/api/report/acme/payments-core/2026-11-13
私有仓库会在 URL 后附加一个加密的、实例特定的 HMAC,因此只有授权用户才能读取其状态。
成本
OpenTimestamps 本身是免费的。真正的成本是工程时间——初始构建、持续维护,以及流水线悄悄停止的隐性成本。Timestamp GIT 采用分层定价:公共仓库的 Open Source 免费,私有仓库的 Pro Agency 为 $49/月,GitHub Action 模式的 Enterprise ZK 为 $199/月。可预测的单项支出,没有维护积压。
并排比较:OpenTimestamps 与 Timestamp GIT
| 标准 | OpenTimestamps(原始协议) | Timestamp GIT(托管 GitHub App) |
|---|---|---|
| 设置工作量 | 安装 CLI 工具,定义批处理,为团队记录流程 | 安装 GitHub App,连接仓库,完成 |
| 自动化程度 | 按提交或批次手动打时间戳 | Webhook 检测、夜间 cron 批处理、自动锚定 |
| 安全模型 | 自行管理:你拥有密钥、存储、日历、正常运行时间 | 零知识:只处理提交哈希;Enterprise ZK 将哈希保留在你的 CI 内 |
| 验证方法 | 使用协议工具手动处理证明 | 基于浏览器的 Merkle 验证、徽章、仪表盘、PDF 证书、CSV 审计账本 |
| GitHub 集成 | 无原生集成 | 原生 GitHub App;证明写入 timestamps 分支或影子仓库 |
| 成本 | 软件免费,以工程小时付费 | 免费(公共仓库),$49/月 Pro Agency,$199/月 Enterprise ZK |
| 支持 | 社区 | 产品团队 |
对合规最重要的那一行:Timestamp GIT 没有发明专有的证明格式。它使用相同的 OpenTimestamps 协议和相同的比特币区块数据,因此你的 .ots 收据保持供应商无关。如果 Timestamp GIT 明天消失,你仓库中的证明仍然可以用任何兼容 OpenTimestamps 的工具验证。
对于需要在自己的硬件上获得托管体验的团队,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 页面上的请求表单获得限时演示许可证。
结论:谁应该选择哪一个?
选择原始协议,如果你内部有专门的区块链或密码学专业知识,你需要控制流水线的每一步,并且你确实愿意承担随之而来的运营风险——包括在忙碌时期手动打时间戳停止发生的风险。
选择 Timestamp GIT,如果你想要密码学先有技术,而不想把它变成一个副项目。具体来说:
- 初创公司和创始人,需要在专利申请前确保先有技术,并希望拥有可在尽职调查中展示的知识产权成熟度。
- 代理机构和开发商店,需要在付款纠纷中获得可辩护的交付日期,以及专业的作者证书。
- 自由职业者,保护可复用库和作品集作品不被他人声称拥有。
- 合规团队,需要带有审计轨迹的法庭可用证据,而不要求开发者学习协议。
开源仓库的免费层使这成为一个低风险实验:连接一个仓库,等一晚,看看你的 timestamps 分支中会出现什么。
FAQ
我可以在不使用其服务的情况下验证 Timestamp GIT 证明吗?
可以。Timestamp GIT 生成标准的 OpenTimestamps .ots 收据文件,锚定在比特币区块链中。你可以使用任何兼容 OpenTimestamps 的工具独立验证它们,确保供应商无关。
Timestamp GIT 会看到我的源代码吗?
不会。Timestamp GIT 采用零知识模型运营:它只处理提交哈希,从不处理你的源代码。在 Enterprise ZK 模式下,GitHub Action 从你的基础设施推送哈希,因此服务永远没有对你仓库的读取权限。
Timestamp GIT 在法庭上可采纳吗?
这些证明在密码学上可验证,并锚定在比特币区块链中,后者因其不可篡改性而被广泛认可。可采纳性取决于司法管辖区和法律背景;请咨询法律顾问。Timestamp GIT 提供 PDF 证书和审计轨迹以支持证据需求。如需更深入的说明,请参阅比特币时间戳可作为证据采纳吗?合规指南。
如果我停止使用 Timestamp GIT 会怎样?
你现有的证明将永远有效且可验证,因为它们通过 OpenTimestamps 嵌入在比特币区块链中。你不会被锁定;证明是供应商无关的。
结论
两条路径都会将你的工作锚定到比特币中。只有一条能在你的团队忙于交付时继续运行。协议是持久的部分;围绕它的运营纪律是脆弱的部分——而这正是 Timestamp GIT 从你手中接过的部分。
安装 GitHub App,将其指向包含你最有价值逻辑的仓库,让夜间 cron worker 完成其余工作。你的第一份证明会在午夜后几小时到达,从那时起,它就是一个永久的、可验证的记录,你再也不用去想它。从 timestampgit.dev 开始。