为什么你的 Git 日志不能作为证据——以及如何让它防篡改
问自己一个具体的问题:如果律师、审计师或专利流氓的律师要求你证明某个特定提交在某个特定日期存在,你实际能交给他们什么?
git log 的截图?GitHub 活动的导出?这两者都很容易被驳回。如果你想要用比特币实现真正的 Git 历史防篡改证明,答案不是更好的导出——而是一个连你自己都无法回溯或篡改的时间戳。本指南将剖析你的日志为何无法作为证据的机制,然后给出使其具备防篡改性的确切步骤,由 GitHub App 在夜间完成工作。
为什么你的 Git 日志不能防篡改(以及这对合规意味着什么)
Git 是内容寻址的,这让人误以为历史是不可变的。事实并非如此。每个提交哈希都是对树、父提交、消息和元数据的哈希——但这些哈希的链条存在于你无法控制的服务器上的仓库中。有三件事破坏了证据价值:
- 历史在设计上就是可重写的。
git rebase、git commit --amend和强制推送会用新哈希替换提交。旧对象会一直存在,直到垃圾回收,然后就消失了。拥有推送权限的维护者可以在一分钟内重写数月的历史。 - 日期是自我报告的。 作者和提交者时间戳只是你可以设置的元数据。任何记录时间的内部日志,其可信度只取决于写入它的机器。
- 日志存在于别人的基础设施上。 你的 GitHub 组织、CI 数据库、内部 wiki——全都可以编辑,全都在你的控制之下。在法律审计中,这使它们成为"自利"证据,很容易被质疑。
最后一点比开发者预期的更重要。一个你本可以更改的记录,就是对方会主张你确实更改过的记录。解决办法不是增加日志——而是将证明外部化到一个任何单一方都无法重写其历史的系统。
这就是密码学在先发明的理念:你取用 Git 已经产生的指纹(提交哈希),将它们批量处理,再次将批次哈希成 Merkle 树,并通过 OpenTimestamps 协议将根锚定到比特币区块链中。有人可以重写你的仓库,但他们无法重写一个比特币区块。
Timestamp GIT 自动化了整个链条——无需 CLI 工具、无需 OpenTimestamps 命令、无需更改开发者工作流程。如需更深入的背景,请参阅如何在没有专利的情况下为软件创意证明在先发明和区块链时间戳是否是法律上有效的证据。
前提条件:锚定第一个提交之前你需要什么
- 一个 GitHub 仓库(公开或私有),你拥有管理员权限,以便安装 Timestamp GIT GitHub App。
- 一个 Timestamp GIT 账户——开源/公开仓库免费,私有仓库使用 Pro Agency($49/月),GitHub Actions 模式使用 Enterprise ZK($199/月)。
- 一个用于证明的目标仓库。 可以是同一仓库中的分支,也可以是单独的影子仓库。GitHub 权限模型要求至少对源仓库有只读访问权限(没有"仅提交哈希"的范围),以及对目标仓库的读写权限。
- 对于 Enterprise ZK 模式: 一个 GitHub Actions 工作流和一个 API 密钥。这里只需要对目标仓库的读写访问权限——源仓库完全不需要读访问权限。
- 对于自托管: Docker 和 Docker Compose,以及来自 Docker 许可证页面的限时演示许可证。
开发者机器上不需要安装任何东西。
分步指南:使用 Timestamp GIT 让你的 Git 历史防篡改
第 1 步——安装 GitHub App 并连接仓库
在你的组织上安装 Timestamp GIT GitHub App,并选择要监控的仓库。授予源仓库只读访问权限,授予目标仓库(分支或影子仓库)读写权限。该应用会注册 webhook 并自动检测新提交——你的团队无需对每个提交进行操作。
在标准模式下,该应用只读取每个被监控仓库的 HEAD 提交哈希。它从不读取工作树、差异或文件内容。
第 2 步——(可选)切换到 Enterprise ZK 模式
如果连提交哈希离开你的网络都难以接受,Enterprise ZK 模式会用在你自己的 runner 上运行的简短 GitHub Action 替代 webhook 路径。它只推送哈希——服务永远不会获得对源仓库的读访问权限。
name: Timestamp commit hash
on:
push:
jobs:
anchor:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Push HEAD hash to Timestamp GIT
env:
TSGIT_API_KEY: ${{ secrets.TSGIT_API_KEY }}
run: |
HASH=$(git rev-parse HEAD)
# POST $HASH + repo metadata to the Timestamp GIT API.
# The workflow is generated for you by the Enterprise setup wizard
# at https://timestampgit.dev/enterprise/{phase}.
这就是全部的接触面:一个哈希,一个经过身份验证的请求。
第 3 步——让夜间 cron worker 完成锚定
你在这里什么都不用做。每晚,一个 worker 会:
- 将内存队列中所有待处理的提交哈希分组。
- 为每个仓库构建一个清单
.txt。 - 在批次上原生构建 Merkle 树。
- 使用公共 OTS 日历创建 OpenTimestamps 证明。
- 将 Merkle 根锚定到比特币区块链中。
批处理是关键——一百个仓库中的一千个提交只需一次锚定。
第 4 步——收集 .ots 收据和清单
比特币确认后,清单和 .ots 收据文件会被推送回你专用的时间戳分支或影子仓库。比特币确认通常需要约 3 小时,因此证明会在夜间运行后几小时落地——不是立即。请相应地规划你的预期,尤其是在向合规部门演示时。
第 5 步——嵌入验证徽章
从你的仓库连接页面(/connected/{user}/{repo})获取代码片段,它会渲染一个实时的 Shields.io 预览:
[](https://timestampgit.dev/status/acme/payments-service)
点击进入的任何人都会到达公共状态仪表板。私有仓库会在 URL 后附加一个加密的 HMAC——特定于实例——因此只有授权查看者才能看到数据。
第 6 步——(替代方案)使用 Docker Compose 自托管
对于气隙或最大控制的环境,同一管道以 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 许可证页面的演示许可证放入相应位置。
如何确认它有效:验证和审计追踪
四项检查,按严格程度递增:
1. 状态仪表板。 访问 /status/{user}/{repo} 查看证明持久性、最早锚定日期、每日规律性,以及每个批次背后的比特币区块和交易数据。日历热图让缺口一目了然——当审计师问"这是连续的吗?"时很有用。
2. 验证页面。 /verification/{user}/{repo}/{date} 逐步引导你完成多级 Merkle 链。所有计算都在你的浏览器本地进行:零知识,没有人能看到你验证的内容。这是在会议上有人质疑时间戳时要打开的页面。
3. 审计导出。 为合规提取结构化记录:
# Full audit ledger as CSV
curl -O https://timestampgit.dev/api/audit/acme/payments-service
# PDF certificate for a specific anchored date
curl -OJ https://timestampgit.dev/api/report/acme/payments-service/2026-10-30
# Raw Merkle chain data for local verification
curl https://timestampgit.dev/api/verify/acme/payments-service/2026-10-30
4. 独立验证。 由于证明仅依赖 SHA-256 和比特币区块数据,任何人都可以使用标准 OpenTimestamps 验证工具对照区块链验证 .ots 收据——离线进行,无需 Timestamp GIT。这就是供应商独立性保证:如果公司明天消失,你的证明仍然可以验证。
常见问题排查
- App 已安装但没有监控任何内容。 重新检查权限:源仓库只读,目标仓库读写。Enterprise ZK 模式是例外——它只需要对目标仓库的读写权限,不需要对源仓库的读访问权限。
- 推送后证明"丢失"。 它们没有丢失。比特币确认需要几个小时,证明文件之后才会写入。在提交 bug 之前,先检查状态页面上的待处理锚定。
- 私有仓库上徽章返回 404。 URL 包含特定于你的服务器实例的加密 HMAC。从
/api/badgeLink/{user}/{repo}复制链接,而不是手动构建。 - 自托管容器启动但向导失败。 确认
./data已正确挂载且可写,然后检查docker compose logs -f timestampgit。大多数首次运行失败是权限或卷问题,而不是应用问题。
常见问题
使用 Timestamp GIT 后我还能重写 Git 历史吗? 可以——你可以在本地变基、修改或强制推送。但比特币中锚定的提交哈希保持不可变。对原始提交的任何篡改都会变得显而易见,因为比特币锚定的哈希不会与更改后的历史匹配。
Timestamp GIT 能访问我的源代码吗? 不能。在标准模式下,GitHub App 只读取 HEAD 提交哈希。在 Enterprise ZK 模式下,GitHub Action 只将提交哈希推送到 API。你的源代码永远不会离开你的环境。
如果 Timestamp GIT 倒闭了怎么办?
你的证明是供应商独立的。.ots 收据文件加上比特币区块链数据,让任何人都可以使用标准 OpenTimestamps 工具离线验证时间戳,无需依赖 Timestamp GIT。
提交被锚定需要多长时间?
提交每晚批量处理。批次锚定后,比特币确认通常需要约 3 小时,证明文件会在几小时后写入。你会在仓库的时间戳分支中找到 .ots 收据。
结论
你的 Git 日志是操作记录,不是证据。它位于你控制的基础设施上,包含你可以设置的日期,并且可以被任何拥有推送权限的人重写——这正是审计师不重视它的原因。将提交哈希锚定到比特币中,可以将该记录转化为你无法控制、也无法更改的东西。
Timestamp GIT 做到了这一点,而无需要求你的开发者学习协议:安装一次 GitHub App,让夜间 worker 进行锚定,嵌入徽章,并保留 .ots 收据和审计导出,以备你真正需要它们的那一天。
下一步: 今天就在你最关键的业务仓库上安装该应用。你拥有的最古老的锚定,就是你今晚创建的那个。