Самодельное штемпелевание времени с Docker: Timestamp GIT

2026-09-22 timestamp git blockchain proof

Самостоятельный хостинг отметок времени с помощью Docker: Timestamp GIT

Если вы рассматриваете самостоятельный хостинг отметок времени с помощью Docker, значит, вы уже прошли этап «зачем» и перешли к вопросу «какой вариант развертывания соответствует нашим требованиям соответствия и инфраструктуры». Решение о покупке больше не сводится к тому, должны ли хеши Git-коммитов быть закреплены в Bitcoin. Вопрос в том, где работает конвейер закрепления: на управляемой инфраструктуре Timestamp GIT или внутри вашей собственной Docker-среды. Это руководство подробно описывает, что именно вы получаете с вариантом самостоятельного хостинга, чем он отличается от управляемого GitHub App и как выглядит соотношение затрат и выгод для разработчиков, стартапов, агентств и команд по соответствию требованиям.

Зачем размещать отметки времени Git на собственном хостинге?

Самостоятельный хостинг имеет смысл, когда стандартная управляемая SaaS-модель создает препятствия для определенной аудитории — обычно разработчиков и команд по соответствию внутри крупных организаций. Три ситуации подталкивают команды к развертыванию через Docker:

Суверенитет данных: вся инфраструктура обработки должна находиться в вашей собственной сети, а не на стороннем SaaS.
Изолированные или ограниченные среды: ваши сборочные серверы или инфраструктура репозиториев не могут взаимодействовать с внешними сервисами, кроме необходимых публичных сетевых вызовов.
Внутренние требования соответствия: ваша служба безопасности хочет иметь автономный журнал аудита, даже если криптографическое закрепление по-прежнему опирается на публичный блокчейн Bitcoin.

Управляемый GitHub App Timestamp GIT — это вариант с нулевой настройкой. Вы устанавливаете его один раз, подключаете репозиторий, и каждый коммит автоматически группируется и закрепляется каждую ночь. Вариант самостоятельного хостинга через Docker сохраняет ту же автоматизацию, но предоставляет вам контейнеризированное приложение, службу очередей и том данных внутри вашей собственной инфраструктуры.

Основная ценность не меняется в зависимости от режима развертывания: Timestamp GIT создает криптографическое доказательство предшествующего уровня техники, закрепленное в Bitcoin, никогда не читая ваш исходный код. В режиме самостоятельного хостинга обрабатываются и закрепляются только хеши коммитов. Исходный код никогда не покидает вашу среду.

Что вы получаете с самостоятельным хостингом Timestamp GIT

Версия для самостоятельного хостинга поставляется в виде Docker-образа с сопутствующим экземпляром Valkey для управления очередью. Минимальный docker-compose.yml выглядит так:

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 и настройку экземпляра. Это тот же опыт первого запуска, что и у управляемого продукта, но мастер записывает конфигурацию в ваш собственный том.

В развертывание для самостоятельного хостинга включены те же уровни автоматизации, что и в управляемом сервисе:

Интеграция с GitHub App — подключите приложение и автоматически отслеживайте репозитории.
Автоматическое ночное закрепление — хеши коммитов собираются, группируются, объединяются в дерево Меркла и закрепляются в Bitcoin через протокол OpenTimestamps.
Бейджи верификации — встраиваемые бейджи Shields.io для публичного отображения статуса.
REST API — публичные конечные точки статуса, экспорт журнала аудита в CSV и загрузка PDF-сертификатов.
Журналы аудита — полный реестр аудита, который можно экспортировать в CSV.

Архитектура с нулевым разглашением остается неизменной в режиме самостоятельного хостинга. Timestamp GIT никогда не читает, не копирует и не хранит ваш исходный код. Конвейер работает только с хешами Git-коммитов. При развертывании через Docker вы контролируете контейнер, том и сетевой путь, что дает командам по соответствию дополнительный уровень уверенности в том, что исходный код не покидает среду.

Лицензирование Docker-образа отделено от управляемых тарифов. Демонстрационная лицензия с ограниченным сроком действия доступна после отправки формы запроса на странице Docker License с указанием вашего имени, компании, электронной почты и, при желании, номера телефона. После оценки для производственного использования требуется полная лицензия. Страница продукта по адресу https://timestampgit.dev/docker-license содержит актуальную форму запроса и инструкции по быстрому старту.

Соотношение затрат и выгод и ROI самостоятельного хостинга

Управляемые тарифные планы просты:

Open Source — бесплатно, для публичных репозиториев.
Pro Agency — $49/месяц, для приватных репозиториев.
Enterprise ZK — $199/месяц, для режима с нулевым разглашением на основе GitHub Actions.

Лицензия для самостоятельного хостинга через Docker не имеет фиксированной цены на публичной странице тарифов. Она предлагается как демонстрация с ограниченным сроком действия для оценки, а производственное лицензирование оформляется через поставщика. Тариф Enterprise ZK за $199/месяц может включать варианты самостоятельного хостинга, но точные условия следует уточнить у Timestamp GIT.

При сравнении самостоятельного хостинга и облака основной компромисс — это контроль против накладных расходов на обслуживание. Управляемый GitHub App снимает все инфраструктурное бремя: вы устанавливаете его один раз, а сервис обрабатывает группировку, построение дерева Меркла, доказательства OpenTimestamps и доставку доказательств. Самостоятельный хостинг дает вам тот же автоматизированный конвейер, но вы владеете контейнером, экземпляром Valkey, томом данных и графиком обновлений.

Для команд, которые уже используют Docker в производстве, предельные затраты на обслуживание часто невелики. Небольшой контейнер и очередь Valkey не создают значительной операционной нагрузки. Взамен вы получаете:

Полный контроль над конвейером отметок времени — включая то, где хранятся файлы доказательств и как они доставляются.
Более прозрачную историю соответствия — приложение находится внутри вашей сети, что может упростить проверки безопасности.
Отсутствие зависимости от стороннего SaaS для доступа к репозиториям — хотя GitHub App по-прежнему использует систему разрешений GitHub, серверная часть обработки принадлежит вам.

ROI неизменяемого предшествующего уровня техники проще выразить в терминах рисков, чем в терминах выручки. Один спор с патентным троллем может стоить шестизначных сумм до урегулирования. Один спор об авторстве с уходящим подрядчиком может занять недели инженерного и юридического времени. Timestamp GIT создает квитанцию .ots, которую можно независимо проверить по блокчейну Bitcoin. Это доказательство превращает «у нас был этот код в какой-то момент» в «этот хеш коммита существовал не позднее этого блока Bitcoin».

Для стартапов ценность проявляется во время due diligence. Проверяемая история отметок времени укрепляет портфель интеллектуальной собственности и сокращает техническую проверку. Для агентств доказательство дат поставки устраняет неоднозначность в спорах об оплате. Для предприятий самостоятельный хостинг сохраняет ту же возможность доказывания, удовлетворяя при этом внутренние политики развертывания.

Путь обновления: от облака к самостоятельному хостингу

Естественная последовательность для многих команд выглядит так:

Начните с бесплатного GitHub App на публичных репозиториях. Убедитесь, что ночной рабочий процесс закрепления вписывается в ваш ритм разработки.
Перейдите на Pro Agency, когда приватным репозиториям потребуется то же доказательство. Конвейер хешей коммитов идентичен; меняется только видимость репозитория.
Перейдите на самостоятельный хостинг через Docker, когда этого требуют требования соответствия, суверенитета данных или внутренней инфраструктуры.

Миграция не делает недействительными существующие доказательства. Файлы квитанций .ots и манифесты из управляемого сервиса остаются действительными, поскольку они закреплены в Bitcoin. Вы мигрируете не доказательство, а конвейер, который создает будущие доказательства. Вы можете экспортировать существующие доказательства из журнала аудита и хранить их в собственной инфраструктуре. После повторного подключения репозиториев в экземпляре самостоятельного хостинга новые коммиты продолжают закрепляться каждую ночь. История отметок времени остается непрерывной, а самая ранняя дата закрепления сохраняется.

Ключевой момент, который стоит подчеркнуть: все доказательства Timestamp GIT не зависят от поставщика. Базовые квитанции — это стандартные файлы OpenTimestamps .ots. Их можно проверить по данным блоков Bitcoin без какого-либо сервера, API или лицензии Timestamp GIT. Если компания исчезнет, если вы перейдете из облака на самостоятельный хостинг или снова смените модель развертывания, доказательства останутся действительными.

Для команд, которые хотят нулевой доступ к коду, но не готовы эксплуатировать собственное развертывание Docker, режим Enterprise ZK — это промежуточный путь. GitHub Action из 12 строк работает в вашей инфраструктуре и отправляет только хеш коммита в API Timestamp GIT. Timestamp GIT не получает доступа на чтение к исходному репозиторию. Этот вариант дает большую часть преимуществ минимизации данных самостоятельного хостинга без запуска полного контейнеризированного сервиса.

Начало работы с самостоятельным хостингом Timestamp GIT через Docker

Начните с получения демонстрационной лицензии на странице Docker License. Затем создайте docker-compose.yml, показанный выше, в чистой директории.

Загрузите и запустите стек:

docker compose pull
docker compose up -d

Откройте http://localhost:8080 и следуйте указаниям мастера настройки. Мастер выполняет три основных шага настройки:

Подключите ваш GitHub App. Экземпляру самостоятельного хостинга требуется та же интеграция с GitHub App, что и управляемому продукту. Мастер проведет вас через OAuth и установку.
Выберите репозитории. Отметьте, какие репозитории должны отслеживаться для автоматического ночного проставления отметок времени.
Подтвердите расписание ночного закрепления. Рабочий процесс запускается один раз в день, группирует ожидающие хеши коммитов, строит дерево Меркла и закрепляет корень в Bitcoin. Подтверждение обычно занимает несколько часов.

Убедитесь, что установка работает, проверив журналы:

docker compose logs -f timestampgit

Затем откройте панель статуса для одного из подключенных репозиториев. Вы должны увидеть самую раннюю дату закрепления, данные блока и транзакции Bitcoin, а также календарную тепловую карту закрепленных дней. Загрузите PDF-сертификат для любой конкретной даты в качестве первого подтверждения того, что весь путь доказательства работает от начала до конца.

Если вам нужно публично отобразить статус, используйте конечную точку встраивания бейджа. Экземпляр самостоятельного хостинга предоставляет те же данные бейджей, совместимые со Shields.io, что и управляемый сервис.

FAQ

Каковы системные требования для запуска Timestamp GIT в Docker?

Timestamp GIT работает как Docker-контейнер с минимальным потреблением ресурсов. Предоставленный docker-compose.yml включает приложение и экземпляр Valkey для управления очередью. Вам потребуются Docker Engine и Docker Compose, установленные на Linux-хосте или в совместимой среде. Приложение по умолчанию слушает порт 8080 и хранит данные в смонтированном томе.

Как версия для самостоятельного хостинга обрабатывает закрепление в Bitcoin?

Версия для самостоятельного хостинга выполняет тот же процесс ночного закрепления, что и управляемый сервис. Она собирает хеши коммитов, строит дерево Меркла, создает доказательства OpenTimestamps с использованием публичных календарей и закрепляет корень Меркла в блокчейне Bitcoin. Доказательства хранятся локально и могут быть отправлены в ваш репозиторий или сохранены в вашей инфраструктуре. Подтверждение Bitcoin обычно занимает несколько часов.

Лицензия для самостоятельного хостинга бессрочная или по подписке?

Лицензия для самостоятельного хостинга через Docker доступна как демонстрация с ограниченным сроком действия для оценки. Для производственного использования необходимо запросить полную лицензию у Timestamp GIT. На странице тарифов указан Enterprise ZK за $199/месяц, что может включать варианты самостоятельного хостинга; свяжитесь с поставщиком для уточнения точных условий.

Могу ли я проверить отметки времени, не полагаясь на серверы Timestamp GIT?

Да. Доказательства — это стандартные квитанции OpenTimestamps в формате файла .ots. Их можно независимо проверить по блокчейну Bitcoin с помощью инструментов, совместимых с OpenTimestamps. Timestamp GIT также предоставляет страницу верификации в браузере, которая выполняет все вычисления локально, поэтому верификация никогда не отправляет данные вашего репозитория на сервер.

Заключение

Самостоятельный хостинг отметок времени с помощью Docker и Timestamp GIT — правильная покупка, когда вы хотите тот же конвейер ночного закрепления с нулевой настройкой, что и управляемый GitHub App, но с контейнером, очередью и томом данных под вашим собственным контролем. Вариант самостоятельного хостинга сохраняет основное обещание: криптографически закреплять хеши Git-коммитов в Bitcoin, доказывать предшествующий уровень техники и никогда не раскрывать исходный код. Модель лицензирования начинается с демонстрации с ограниченным сроком действия, чтобы вы могли проверить развертывание до перехода к производственному использованию.

Начните с демонстрационной лицензии, запустите стек compose, подключите репозиторий и проверьте свой первый PDF-сертификат. Если самостоятельный хостинг окажется большей инфраструктурой, чем вам нужно, управляемый GitHub App и режим Enterprise ZK остаются доступными как более простые или более легкие варианты.

Разверните Timestamp GIT на собственной Docker-инфраструктуре и сделайте историю ваших коммитов юридически защитимой.

Самодельное штемпелевание времени с Docker: Timestamp GIT