Самостоятельный хостинг временных меток Git с помощью Docker Compose
Ручное проставление временных меток проваливается всегда одинаково. Кто-то пишет runbook, кто-то другой превращает его в скрипт, скрипт работает три недели, диск заполняется или истекает срок действия токена, и никто не замечает этого до того дня, когда юрист просит доказательство того, что ваш репозиторий восемнадцать месяцев назад выглядел определённым образом.
Само по себе анкоринг — не самая сложная часть. Сложная часть — это конвейер вокруг него: обнаружение коммитов, пакетирование хешей, переживание перезапусков, доставка квитанций и сохранение всей цепочки проверяемой спустя годы. Именно это и даёт вам самостоятельно размещённый стек Compose — воспроизводимое, инспектируемое развёртывание, где автоматизация работает в вашей сети, а каталогом данных владеете вы.
В этой статье разбирается развёртывание Timestamp GIT на собственных мощностях с помощью Docker Compose, однократное подключение GitHub App и настройка автоматического ночного воркера, который привязывает хеши ваших коммитов к Bitcoin. Если сначала хотите получить концептуальную основу, прочитайте Cryptographic Prior Art: The Startup Shield Against Patent Trolls.
Зачем самостоятельно размещать временные метки Git?
Ручное выполнение шага проставления временных меток означает, что для каждого репозитория нужно помнить о трёх задачах: получить проставленные хеши коммитов, собрать полученные файлы доказательств и сохранить их в надёжном и проверяемом месте. Пропустите одну — и в цепочке появятся дыры; пропустите шаг хранения — и у вас будут квитанции, которые никто не может найти.
Самостоятельный хостинг закрывает другой класс требований:
- Резидентность данных. Команды комплаенса хотят знать, где обрабатываются метаданные коммитов. С Docker-образом ответ звучит так: «на нашем хосте».
- Ограниченные сети. Некоторые команды не предоставят никакому SaaS-сервису доступ на чтение к репозиториям с исходным кодом — даже только на чтение — независимо от обещаний вендора.
- Развёртывания, близкие к изолированным средам. Вы можете запустить образ на внутреннем хосте; только шагу анкоринга нужен исходящий доступ к публичным календарям OpenTimestamps.
- Операционный контроль. Вы решаете, как часто обновляться, по какому расписанию делать резервные копии и кто может попасть в мастер настройки.
Docker Compose хорошо подходит, потому что вся система — это два контейнера: приложение и экземпляр Valkey, используемый как очередь хешей в памяти. Один pull и один up -d дают вам работающий экземпляр; том ./data сохраняет состояние между перезапусками; обновление — это docker compose pull && docker compose up -d.
Что критично, Docker-образ — это та же автоматизация, что и в хостинговом продукте: обнаружение коммитов через GitHub App, ночной анкоринг в Bitcoin, отправка .ots-квитанций обратно в ваш репозиторий — просто работающая на вашей инфраструктуре.
Однократная настройка: Docker Compose и GitHub App
Предварительные требования
- Docker Engine с плагином Compose.
- Хост с надёжным аптаймом и исходящим доступом в интернет (требуется для анкоринга в Bitcoin через публичные календари OpenTimestamps).
- GitHub App, который вы можете установить на целевые репозитории, и целевой репозиторий (или теневой репозиторий), куда можно записывать ветки с доказательствами.
- Файл лицензии для экземпляра.
Файл Compose
Быстрый стартовый набор 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
Прежде чем идти дальше, обратите внимание на две вещи. Bind-монтирование ./data:/app/data — это долговременное состояние экземпляра; относитесь к нему как к критичным данным, а не как к кешу. А restart: unless-stopped здесь важнее, чем обычно: полуночный воркер должен быть жив в полночь.
Запустите стек:
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
После запуска приложение доступно по адресу http://localhost:8080.
Первый запуск
При первом запуске мастер настройки проведёт вас через подключение GitHub App и настройку экземпляра. Продумайте разрешения до того, как начнёте нажимать кнопки:
- Standard Mode. GitHub App читает только хеш HEAD-коммита каждого отслеживаемого репозитория и записывает доказательства в целевой репозиторий. Модель разрешений GitHub требует как минимум доступа на чтение к исходному репозиторию плюс доступа на чтение и запись к целевому.
- Enterprise ZK Mode. GitHub Action из 12 строк работает на вашей инфраструктуре и отправляет в API только хеш коммита. Вам нужен доступ на чтение и запись к целевому репозиторию и не нужен доступ на чтение к исходному.
Если вы оцениваете это в 2026 году для команды, которая уже стандартизировалась на хостинговом рабочем процессе с GitHub App, шаги настройки покажутся знакомыми — этот путь описан в Automate Git Commit Timestamping With a GitHub App.
Лицензирование
Ограниченная по времени демо-лицензия для оценки доступна по запросу через форму на странице Docker License, где нужно указать имя, компанию, email и, по желанию, номер телефона. Вы можете скачать файл демо-лицензии с ограниченным сроком и загрузить его при настройке Enterprise.
Если экземпляр доступен откуда-либо, кроме localhost, поставьте его за обратный прокси, терминирующий TLS, и ограничьте доступ на сетевом уровне. Мастер настройки — это административная поверхность.
Автоматизированный конвейер: от коммита до доказательства в Bitcoin
После подключения GitHub App конвейер работает сам:
- Обнаружение коммитов. GitHub App получает вебхуки о новых коммитах или — в Enterprise ZK Mode — ваш GitHub Action отправляет хеши коммитов в API.
- Очередь хешей. Хеши коммитов попадают в Valkey, хранилище «ключ-значение» в памяти, используемое для пакетирования.
- Полуночный cron-воркер. Каждую ночь воркер группирует все ожидающие хеши, записывает манифест
.txtдля каждого репозитория, строит дерево Меркла, создаёт доказательства OpenTimestamps с помощью публичных календарей OTS и привязывает корень Меркла к Bitcoin. - Доставка доказательств. Манифест и файлы-квитанции
.otsотправляются обратно в ваш репозиторий в выделенную ветку timestamps или в теневой репозиторий. - Подтверждение. Подтверждение в Bitcoin занимает несколько часов — обычно около трёх, — поэтому запись доказательств завершается через несколько часов после запуска пакета.
Свойство нулевого разглашения структурно, а не декларативно: обрабатываются только хеши коммитов. Работаете ли вы в Standard Mode или в Enterprise ZK Mode, ваш исходный код никогда не покидает вашу сеть. Развёртывание в Docker просто переносит шаг обработки хешей внутрь вашего периметра.
Поскольку корень Меркла привязан к блоку Bitcoin через OpenTimestamps, после подтверждения временная метка становится неизменяемой. Никакая сторона не может её изменить или подделать — включая вендора и включая вас.
Мониторинг и обработка сбоев
Конвейер проставления временных меток отказывает тихо. Хеши коммитов накапливаются в очереди, ошибок нет, и вы обнаруживаете пробел во время аудита. Относитесь к мониторингу как к части развёртывания.
Здоровье контейнера и очереди. Самая полезная проверка — собственный статус приложения для известного репозитория. Направьте на него свой монитор аптайма:
#!/usr/bin/env bash
set -euo pipefail
BASE="http://localhost:8080"
USER="acme"
REPO="platform"
docker compose ps --status running --quiet timestampgit >/dev/null \
|| { echo "timestampgit container is not running"; exit 1; }
curl -fsS "$BASE/api/statusLast/$USER/$REPO" | jq .
GET /api/statusLast/{user}/{repo} возвращает информацию о последнем привязанном блоке Bitcoin. Если этот блок перестаёт продвигаться, воркер застрял.
Публичные значки верификации. Для каждого отслеживаемого репозитория виджет значка создаёт встраиваемый markdown для Shields.io для вашего README. Фрагмент отдаётся через GET /api/badgeLink/{user}/{repo} (с аутентификацией) и выглядит примерно так:
[](https://timestampgit.dev/status/acme/platform)
Любой может перейти по ссылке и проверить временную метку через сайт. Для приватных репозиториев URL статуса содержит зашифрованный HMAC, специфичный для вашего экземпляра сервера, поэтому прочитать статус могут только авторизованные пользователи.
Аудит и отчёты. Выгружайте журнал по расписанию, а не по запросу:
curl -fsS -o audit-$(date +%F).csv "$BASE/api/audit/$USER/$REPO"
curl -fsS -o report-$(date -d yesterday +%F).pdf \
"$BASE/api/report/$USER/$REPO/$(date -d yesterday +%F)"
Так вы получаете CSV-журнал аудита и PDF-сертификат на каждую дату, которые юридические и комплаенс-команды могут подшить в дело, не обращаясь к API самостоятельно.
Задержки подтверждения. Анкоринг обычно завершается примерно за три часа. Задержки случаются; воркер повторяет попытки и доставляет доказательство .ots, как только анкор подтверждён. Настраивайте оповещение на «манифест записан, но квитанции нет через 24 часа», а не на короткие задержки, иначе вы будете поднимать тревогу из-за обычного разброса блоков Bitcoin.
Резервное копирование и восстановление. Делайте резервные копии ./data по расписанию и смонтируйте именованный том для каталога /data Valkey, если хотите, чтобы хеши в очереди переживали пересоздание контейнера. Valkey по своему устройству является хранилищем в памяти — его потеря стоит вам одного ночного пакета, но не существующих доказательств, потому что доставленные доказательства живут в ветке timestamps.
Рекомендации для самостоятельного хостинга временных меток
- Выделите отдельный хост. Воркер запускается в полночь, и ему нужны стабильный аптайм и исходящее подключение. Делить хост с шумной фермой сборок — значит напрашиваться на пропущенный пакет.
- Держите том данных вне эфемерного хранилища. Примонтируйте
./dataк долговременному диску и включите его в ротацию резервных копий. - Ограничьте административную поверхность. Спрячьте мастер и аутентифицированный API за VPN или обратным прокси с надёжной аутентификацией. Не выставляйте порт 8080 в публичный интернет.
- Обновляйтесь осознанно. Выполняйте
docker compose pullпо расписанию, которое контролируете вы; читайте changelog перед тем, как подтягивать новый образ:prod. - Предпочитайте Enterprise ZK Mode, когда разрешения оспариваются. Если ваша команда безопасности не предоставит доступ на чтение к репозиториям с исходным кодом, путь через GitHub Action удовлетворит её без изменения автоматизации.
- Задокументируйте процесс для аудиторов. Запишите, где работает экземпляр, кто им администрирует, как проверяются резервные копии и где хранятся
.ots-квитанции. Доказательство криптографическое; цепочка хранения всё равно требует абзаца. - Проверьте одну верификацию от начала до конца. Выберите привязанную дату и пройдите процесс верификации до того, как он понадобится в споре, а не во время него. О юридической стороне см. Is a Bitcoin Timestamp Admissible as Evidence? A Compliance Guide.
FAQ
Нужно ли раскрывать исходный код Timestamp GIT? Нет. Timestamp GIT обрабатывает только хеши коммитов. В Standard Mode GitHub App читает хеш HEAD-коммита; в Enterprise ZK Mode GitHub Action отправляет только хеш с вашей инфраструктуры. Ваш исходный код никогда не покидает вашу сеть.
Что произойдёт, если подтверждение в Bitcoin займёт больше времени, чем ожидалось?
Полуночный cron-воркер привязывает корень Меркла к Bitcoin через OpenTimestamps. Подтверждение обычно занимает около 3 часов. Если подтверждение задерживается, воркер повторит попытку и доставит доказательство .ots после подтверждения.
Можно ли использовать это в изолированной среде? Да, Docker-образ может работать в изолированной среде, но для анкоринга в Bitcoin через публичные календари OpenTimestamps требуется исходящий доступ в интернет. Вы можете настроить сетевой доступ соответствующим образом.
Как проверить временную метку независимо?
Вы можете скачать файл .ots и проверить его стандартными инструментами верификации OpenTimestamps по блокчейну Bitcoin. Либо воспользуйтесь страницей верификации, предоставляемой Timestamp GIT, которая выполняет локальную проверку в вашем браузере — никто не видит, что вы проверяете.
Заключение
Самостоятельный хостинг временных меток Git — это не недоверие к вендору; это размещение автоматизированного, проверяемого конвейера внутри границы, которую ваша команда комплаенса уже принимает. Два контейнера, один файл лицензии, один GitHub App — и после этого полуночный воркер делает рутинную часть, а вы получаете репозиторий, полный .ots-квитанций, и публичную страницу статуса.
Начните с запроса демо-лицензии на странице Docker License, поднимите стек Compose на staging-хосте и проверьте один привязанный день от начала до конца. Если вы предпочитаете обойтись без инфраструктуры, управляемое приложение Timestamp GIT для GitHub даёт тот же ночной анкоринг без какой-либо настройки — и позже вы сможете перейти на самостоятельный хостинг, не меняя того, что попадает в ваш репозиторий.
Похожие статьи
- Cryptographic Prior Art: The Startup Shield Against Patent Trolls
- Is a Bitcoin Timestamp Admissible as Evidence? A Compliance Guide
- How to Prove You Shipped a Feature Before a Competitor