Timestamp GIT

← All posts

2026-10-19

自托管 Git 时间戳:Docker 部署与许可证指南

自托管 Git 时间戳:Docker 部署与许可证指南
timestamp git blockchain proof

自托管 Git 时间戳:Docker 部署与许可证指南

你已经了解 GitHub App 如何在夜间将每次提交锚定到比特币中。现在到了采购问题:你是让 Timestamp GIT 托管整条流水线,还是在自己的网络内运行 Docker 镜像并自行管理许可证?

本指南面向采购决策,而非密码学。如果你正在权衡 Timestamp GIT Docker 自托管许可证与托管套餐,以下内容将说明每种方案实际能给你带来什么、部署过程是什么样的,以及升级路径通向何处。

采购决策:自托管 Git 时间戳何时才有意义

两种部署模式都会生成同样可用于法庭的 .ots 收据,并锚定在比特币中。这个决策是运营层面的,而非密码学层面的——你选择的是处理流水线运行在哪里,而不是它生成什么证明。

自托管通常在三种情况下胜出:

  • 气隙或受限网络。 你的构建基础设施无法访问第三方 SaaS,但可以通过受控出口访问比特币和日历流量。
  • 受监管行业。 合规团队希望提交哈希——甚至哈希本身——留在有明确数据流记录的界定边界内。
  • 数据驻留要求。 当服务运行在你自己的机架上时,“任何元数据都不得离开本地区”的政策更容易满足。

这里有一个常见的误解值得澄清:自托管并不意味着你的团队要手动运行时间戳协议。你不需要在开发者机器上安装工具,也不需要针对区块链编写任何脚本。Docker 镜像将完整的托管工作流——提交检测、夜间批处理、Merkle 树构建、比特币锚定——打包在一个设置向导之后。困难的做法是教会每位开发者使用协议 CLI;产品的做法则是一个 Docker Compose 文件。

如果你的团队仍在决定密码学证明是否值得购买,请先阅读什么是密码学在先技术?软件团队指南,然后再回到这里计算许可证成本。

各套餐内容:开源、Pro Agency、Enterprise ZK 与 Docker 自托管

套餐 价格 你将获得
开源 免费 公共仓库、GitHub App 安装、自动夜间锚定
Pro Agency $49/月 私有仓库、验证徽章、REST API 访问、审计 CSV 和 PDF 证书下载
Enterprise ZK $199/月 一个 12 行的 GitHub Action,仅从你的基础设施推送提交哈希
Docker 自托管 需要许可证 以 Docker 镜像形式提供的同一产品,附带用于评估的限时演示许可证

开源套餐是诚实的评估路径。在公共仓库上安装 GitHub App,观察夜间锚定落地,在花钱之前先看看这套工作流是否适合你的团队。

Pro Agency 是大多数代理机构和产品公司最终选择的套餐:私有仓库、徽章和 REST API 接口,以及法律和采购团队会要求的可下载合规产物——审计账本 CSV 和按日期的 PDF 证书。

Enterprise ZK 是云与自托管之间的中间地带。一个小的 GitHub Action 在你的 runner 上运行,仅将提交哈希推送到 Timestamp GIT API。该服务永远没有对源仓库的读取权限,因此你的代码留在自己的边界内,而锚定流水线仍由托管方管理。

关于安装机制——OAuth 流程、仓库选择、权限——请参阅 GitHub App 区块链时间戳设置:一次安装,永久时间戳。本文聚焦于自托管许可证及其对比。

成本、收益与 ROI:为什么密码学证明比诉讼更便宜

自托管许可证是可以纳入预算的支出项。知识产权纠纷则不是。

将许可证成本与下行风险对比:专利流氓的索赔,而你明明在申请之前几个月就实现了该技术,却只有可编辑的内部日志;员工署名纠纷,而唯一证据只是关于某个功能何时被构思的“各执一词”;以及来自声称独立开发的竞争对手的净室抗辩。18 个月前的时间戳正是这些主张撞上的墙。

有两个特性使这种证明足够持久,值得为之付费:

  • 供应商独立性。 该证明仅依赖 SHA-256 和比特币区块数据。即使供应商消失,它仍可离线验证。对于风险厌恶的采购团队来说,这确实是难得可贵的说法。
  • 零知识安全。 在 Docker 自托管模式下,整条流水线在你的基础设施上运行。在 Enterprise ZK 模式下,只有提交哈希离开你的环境。源代码永远不会被该服务读取、复制或存储。

还有一项大多数团队忘记核对的成本:按席位计费的工具。Timestamp GIT 不需要在开发者机器上安装任何东西。无需分发 CLI,无需维护 IDE 插件,无需重新培训以应对工作流中断——这意味着真正的成本是许可证,而不是推广部署。

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 并配置实例——无需手动编辑配置文件。

有两个细节对无人值守运行很重要:

  • 卷挂载。 ./data:/app/data 是持久化证明存储所在的位置。请像对待仓库数据一样严格地备份它;正是它让你的实例在主机故障后可复现。
  • 重启策略。 restart: unless-stopped 让夜间 cron worker 在重启后依然存活,这正是“设置后即可忘记”这一说法真正成立的原因。

要在承诺生产许可证之前进行评估,请在 Docker 许可证页面提交申请表,填写你的姓名、公司、邮箱和可选电话号码。可下载一个限时演示许可证文件,让你先针对真实仓库运行一个真实实例。

自托管 vs. 托管云:选择你的升级路径

托管 SaaS 路径。 安装一次 GitHub App。提交通过 webhook 检测,由午夜 cron worker 批处理,并自动锚定。清单和 .ots 收据文件被推送回专用的 timestamps 分支或影子仓库。徽章、状态仪表板和 REST API 均包含在内。

Enterprise ZK 路径。 相同的自动化,但提交哈希的推送源自你自己的 GitHub Action。该服务仅需要对目标仓库的读写权限——不需要对源仓库的读取权限。

Docker 自托管路径。 同样是相同的自动化,处理流水线完全在你的基础设施上运行,以实现最大程度的控制。

三种方案的时序预期完全相同:夜间 worker 批处理待处理的哈希,原生构建 Merkle 树,使用公共 OTS 日历创建证明,并将 Merkle 根锚定到比特币中。比特币确认通常需要约三小时,因此证明写入会在 cron 运行后几小时内完成。无需熬夜等待。

购买后的验证、徽章与审计产物

验证是本地且零知识的。基于浏览器的验证页面 /verification/{user}/{repo}/{date} 会逐步计算 Merkle 链,所有计算都在浏览器中进行。没有人能看到你验证的内容。关于密码学流程本身,请阅读如何在本地验证比特币时间戳证明——本节讲的是你购买后获得的产物。

  • 公共状态仪表板(/status/{user}/{repo}):证明寿命、最早锚定日期、每日规律性、比特币区块和交易数据,以及日历热力图。
  • 审计账本 CSV:拉取完整账本以供合规审查。
curl -o audit.csv "https://timestampgit.dev/api/audit/your-user/your-repo"
  • 按日期的 PDF 证书:下载单日证书以供法律审查。
curl -o certificate.pdf "https://timestampgit.dev/api/report/your-user/your-repo/2026-10-18"
  • 用于 README 的 Shields.io 徽章,设置期间可在 /connected/{user}/{repo} 实时预览,markdown 片段来自 /api/badgeLink/{user}/{repo}。私有仓库会在徽章 URL 后附加加密的 HMAC,因此只有授权用户才能看到状态。

像 /api/statusSummary/{user}/{repo} 这样的公共状态端点正是徽章的数据来源,因此嵌入内容可以显示已验证的锚定,而不暴露其他任何信息。

常见问题

如果我自己托管 Docker 镜像,是否需要自己运行 OpenTimestamps 命令? 不需要。Docker 镜像打包了完整的托管工作流——提交检测、夜间批处理、Merkle 树构建,以及通过公共 OTS 日历进行的比特币锚定。你通过设置向导进行配置,并自动收到 .ots 收据。底层协议保持隐藏,与托管 SaaS 中完全一样。

如何获得自托管 Docker 部署的许可证? 在 Docker 许可证页面提交申请表,填写你的姓名、公司、邮箱和可选电话号码。可下载一个限时演示许可证文件,让你在承诺生产许可证之前评估该实例。

自托管是否意味着我的源代码会暴露给供应商? 不会。在 Docker 自托管模式下,整条流水线在你的基础设施上运行。在托管 Enterprise ZK 模式下,一个 12 行的 GitHub Action 仅推送提交哈希,因此该服务永远没有对源仓库的读取权限。两种情况下源代码都不会离开你的环境。

自托管会改变证明的法律效力吗? 不会。该证明基于比特币。.ots 收据和清单文件无论由哪种部署生成,都可对照比特币区块数据进行验证,因此部署模式是运营选择,而非证据选择。

如果我停止使用该服务,我的证明会怎样? 你的 .ots 收据文件和清单文件存放在你的仓库或影子仓库中,可使用标准 OpenTimestamps 工具对照比特币区块链离线验证。该证明仅依赖 SHA-256 和比特币区块数据,因此即使供应商消失也依然有效。

结论

当合规、网络隔离或数据驻留要求需要时,自托管 Docker 镜像。当你想要托管锚定但不希望仓库被读取时,选择 Enterprise ZK。当运营简便性比边界控制更有价值时,留在托管套餐。三种情况下,你最终持有的收据都是一样的。

准备好评估了吗?申请限时演示许可证,用上面的 Compose 文件启动实例,然后看着你的第一次夜间锚定在 cron 运行后几小时内落地。

相关文章

EU label: AI-generated content