Timestamp GIT

← All posts

2026-11-04

Как проставить временные метки для Git-коммитов без командной строки

Как проставить временные метки для Git-коммитов без командной строки
timestamp git blockchain proof

Как ставить временные метки на коммиты Git без командной строки

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

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

Без CLI. Без локального узла Bitcoin. Без необходимости знать протокол.

Зачем отказываться от командной строки при простановке временных меток Git?

Сложный путь существует, и вы, вероятно, догадываетесь, как он выглядит: установить клиент OpenTimestamps на свою машину, выполнить команду для файла, который вы сконструировали, сохранить полученную квитанцию где-нибудь и повторять это всякий раз, когда вспомните. Сразу следуют три сценария отказа:

  • Это привязано к машине. Подключение нового разработчика означает повторное объяснение ритуала. Вашему CI-раннеру это тоже нужно. Вашей замене ноутбука это понадобится снова.
  • Это привязано к моменту. Временные метки покрывают только то, что вы вспомнили проставить. Коммиты, которые вы забыли, — обычно самые интересные, сделанные в аврал, — это именно те, которые вам понадобятся в споре.
  • Это хрупкое доказательство. Квитанция, лежащая в чьём-то домашнем каталоге без цепочки сохранности, — не аудиторский след.

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

О том, почему обычный git log в принципе не является доказательством, см. Why Your Git Log Isn’t Proof. Эта статья — практическое руководство.

Предварительные требования

Перед началом убедитесь, что у вас есть:

  • Учётная запись GitHub и репозиторий — публичный или приватный, — для которого вы хотите ставить временные метки.
  • Права администратора на этом репозитории или на организации, которой он принадлежит, чтобы вы могли установить GitHub App.
  • Для приватных репозиториев — платный план: Pro Agency ($49/мес) или Enterprise ZK ($199/мес). Публичные репозитории бесплатны в рамках плана Open Source.
  • Больше ничего. Ни локального ПО, ни установки OpenTimestamps, ни узла Bitcoin, ни кошелька. Браузер — это весь инструментарий.

Одно замечание о разрешениях, потому что это первый вопрос, который задают люди. В модели разрешений GitHub нет области «только хеш коммита», поэтому Standard Mode требует доступа только на чтение к исходному репозиторию и доступа на чтение и запись к целевому репозиторию, куда записываются доказательства. Если даже доступ на чтение к источнику для вас неприемлем, Enterprise ZK Mode использует вместо этого GitHub Action и вообще не требует доступа на чтение к источнику. Подробнее об этом в шаге 6.

Пошагово: ставим временные метки на коммиты без командной строки

Шаг 1: Установите GitHub App Timestamp GIT

Установите приложение из GitHub Marketplace или с timestampgit.dev. Во время установки вас спросят, какие репозитории приложение может видеть, и вы предоставите два набора разрешений, описанных выше: только чтение для исходного репозитория, чтение и запись для репозитория, который будет получать файлы доказательств.

Если вы ставите метки для целой организации, установите приложение один раз на уровне организации, а не репозиторий за репозиторием.

Шаг 2: Выберите репозитории для мониторинга

Откройте панель управления по адресу https://timestampgit.dev/repos и выберите, какие репозитории отслеживаются. Как только репозиторий подключён, приложение обнаруживает новые коммиты через вебхуки GitHub — ничего не нужно настраивать для каждого коммита и ничего не нужно помнить.

Вы можете сразу проверить подключение. Публичные эндпоинты статуса возвращают JSON, CLI не нужен:

# Last anchored Bitcoin block for a repo
curl -s https://timestampgit.dev/api/statusLast/your-user/your-repo

# How many commits have been stamped so far
curl -s https://timestampgit.dev/api/statusCount/your-user/your-repo

Совершенно новый репозиторий законно будет возвращать нулевые счётчики, пока не завершится первый ночной запуск.

Шаг 3: Коммитьте как обычно

Это весь шаг «изменения рабочего процесса», и он пуст. Вы пишете код, делаете git commit, пушите. Timestamp GIT захватывает хеш коммита, который доставляет вебхук, — не diff, не файлы, не исходный код. Сервис никогда не видит, не копирует и не хранит ваш фактический код; только SHA, идентифицирующий состояние репозитория.

На практике это означает, что вашим разработчикам не нужно обучение, а у вашей проверки безопасности есть короткий ответ: единственные данные, покидающие репозиторий, — это хеш, а хеш — это односторонний отпечаток.

Шаг 4: Позвольте ночному cron выполнить привязку

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

Из этого дизайна следуют две вещи:

  • Пакетирование дёшево и приватно. Привязывать тысячи коммитов по отдельности было бы абсурдом. Один корень Меркла на репозиторий в день означает, что одна привязка покрывает всё, что было закоммичено в этот день, а отдельные хеши остаются скрытыми внутри дерева.
  • Доставка доказательств не мгновенна. Манифест и файлы квитанций .ots отправляются обратно в выделенную ветку timestamps или теневой репозиторий после подтверждения Bitcoin, которое обычно занимает около трёх часов. Запуск, начавшийся в полночь, обычно завершается ранним утром.

Хеши коммитов ожидают запуска в хранилище «ключ-значение» в памяти, поэтому репозиторий, который затих на день, просто не создаёт новый файл доказательства — это не ошибка.

Шаг 5: Встройте значок проверки (необязательно)

Откройте страницу Repository Connected для вашего репозитория — https://timestampgit.dev/connected/{user}/{repo} — и используйте виджет значка. Он отображает живой предпросмотр и выдаёт фрагмент Markdown для вставки в README, чтобы заявление о происхождении было публичным и кликабельным, а не абзацем утверждений.

<!-- Paste the exact snippet generated by the badge widget -->
[![Timestamped with Timestamp GIT](BADGE_URL)](https://timestampgit.dev/status/your-user/your-repo)

Любой, кто нажмёт на значок, попадёт на публичную страницу статуса, куда также захотят попасть аудиторы.

Шаг 6: Разверните у себя или перейдите на zero-knowledge (необязательно)

Для команд с более строгими требованиями существуют два альтернативных варианта развёртывания.

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

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

Как убедиться, что всё сработало

Не принимайте значок за доказательство. Проверьте на трёх уровнях в порядке возрастания строгости.

1. Страница статуса репозитория. Откройте https://timestampgit.dev/status/{user}/{repo}. Вы увидите срок жизни доказательств, самую раннюю привязанную дату, ежедневную регулярность, данные блока и транзакции Bitcoin, лежащие в основе каждой привязки, и календарную тепловую карту, показывающую, в какие дни создавались доказательства. Тепловая карта — самый быстрый способ заметить пробелы.

2. Артефакты аудита. Со страницы статуса или из API получите журнал аудита или сертификат на конкретную дату:

# Full audit ledger as CSV
curl -s -o audit.csv https://timestampgit.dev/api/audit/your-user/your-repo

# PDF certificate for a specific date
curl -s -o certificate.pdf https://timestampgit.dev/api/report/your-user/your-repo/2026-11-03

Это документы, которые вы передаёте юристу или аудитору, а CSV — это то, что команда комплаенса будет фактически сверять с внутренними записями.

3. Локальная криптографическая проверка. Страница проверки по адресу https://timestampgit.dev/verification/{user}/{repo}/{date} проходит по цепочке Меркла шаг за шагом, и все вычисления происходят локально в вашем браузере. Ничего из того, что вы проверяете, не передаётся. Файл квитанции .ots за тот же день лежит в вашей ветке timestamps, и любой может независимо проверить его по блокчейну Bitcoin стандартными инструментами OpenTimestamps — без учётной записи, без API-ключа, без зависимости от существования Timestamp GIT.

Последний пункт стоит повторить для юристов: доказательство — это SHA-256 плюс данные блока Bitcoin. В цепочке доверия нет проприетарного формата.

Устранение типичных проблем

Доказательства ещё не появились. Прежде чем проверять что-либо ещё, проверьте время. Привязка требует подтверждения Bitcoin, которое обычно занимает около трёх часов после полуночного пакета. Если сейчас 2 часа ночи, всё в порядке. Если уже следующий день после обеда, а ветка всё ещё пуста, посмотрите, действительно ли репозиторий находится в списке отслеживаемых.

Коммиты отсутствуют в манифесте. Почти всегда это проблема разрешений или вебхука. Убедитесь, что установка GitHub App включает конкретный репозиторий (установки на уровне организации часто предоставляют «выбранные репозитории» и затем пропускают один), и что у приложения всё ещё есть активное подключение. Перепроверьте /api/statusCount/{user}/{repo} после следующего ночного запуска.

Страница статуса приватного репозитория не загружается. Приватные репозитории добавляют к URL зашифрованный HMAC, и этот HMAC специфичен для экземпляра сервера. Скопируйте аутентифицированную ссылку значка со страницы Repository Connected вместо того, чтобы конструировать URL вручную — усечённый или не соответствующий экземпляру HMAC не сработает.

Развёртывание Docker не запускается. Проверьте, что в файле Compose точно указаны rue1401/timestampgit:prod и valkey/valkey:8, что порт 8080 не занят, и что ./data существует и доступен для записи контейнеру. docker compose logs -f timestampgit обычно прямо назовёт сбойную зависимость. Если приложение запускается, но мастер настройки не может достучаться до GitHub, ищите причину в конфигурации OAuth.

FAQ

Нужно ли устанавливать что-либо на машины разработчиков? Нет. Timestamp GIT — это управляемый GitHub App, который работает на инфраструктуре GitHub и наших серверах. Разработчики просто коммитят как обычно; никаких CLI-инструментов или локального ПО не требуется.

Можно ли ставить временные метки на коммиты в приватных репозиториях? Да. Приватные репозитории поддерживаются на платных планах (Pro Agency или Enterprise ZK). Приложение читает только хеши коммитов, никогда ваш исходный код, а доказательства хранятся в выделенной ветке или теневом репозитории.

Сколько времени занимает, пока временная метка станет неизменяемой? После ночного пакета корень Меркла привязывается к транзакции Bitcoin. Подтверждение обычно занимает около 3 часов, после чего временная метка неизменяема и поддаётся проверке.

Независимо ли доказательство от поставщика? Да. Доказательство использует только SHA-256 и данные блока Bitcoin через протокол OpenTimestamps. Вы можете проверить его офлайн стандартными инструментами OpenTimestamps, даже если Timestamp GIT перестанет существовать.

Что фактически получает команда комплаенса? Публичную страницу статуса, скачиваемый CSV аудита, охватывающий историю репозитория, PDF-сертификат на каждую дату и квитанции .ots в репозитории. О юридической силе этих доказательств см. Is a Blockchain Timestamp Legally Valid Evidence?.

Заключение: установите один раз — доказывайте навсегда

Простановка временных меток на коммиты Git без командной строки сводится к одному решению: перестать относиться к простановке меток как к ритуалу каждого разработчика и сделать её свойством репозитория. Установите GitHub App, выберите репозитории, продолжайте коммитить. Ночной cron превращает эти коммиты в доказательства с корнем Меркла, привязанные к Bitcoin, а квитанции возвращаются в ваш собственный репозиторий, где им и место.

Начните с бесплатного плана Open Source на публичном репозитории — это ничего не стоит и занимает около пяти минут. Когда будете готовы покрыть приватный код, переходите на Pro Agency за $49/мес или на Enterprise ZK за $199/мес, если модель с GitHub Action лучше соответствует вашей модели безопасности. В любом случае: timestampgit.dev — единственный шаг установки.

Похожие статьи

EU label: AI-generated content