Timestamp GIT

← Todos os artigos

2026-10-19

Timestamps Git Auto-Hospedados: Guia de Configuração Docker e Licenciamento

Timestamps Git Auto-Hospedados: Guia de Configuração Docker e Licenciamento
timestamp git blockchain proof

Timestamps Git Auto-Hospedados: Guia de Configuração Docker e Licença

Você já viu como o GitHub App ancora cada commit no Bitcoin durante a noite. Agora vem a questão de aquisição: você deixa o Timestamp GIT hospedar o pipeline, ou executa a imagem Docker dentro da sua própria rede e gerencia a licença por conta própria?

Este guia foi escrito para a decisão de compra, não para a criptografia. Se você está ponderando entre uma licença auto-hospedada do Timestamp GIT Docker e os planos gerenciados, veja o que cada opção realmente oferece, como é a configuração e para onde leva o caminho de upgrade.

A Decisão de Compra: Quando Auto-Hospedar Timestamps Git Faz Sentido

Ambos os modos de implantação produzem os mesmos recibos .ots prontos para tribunais, ancorados no Bitcoin. A decisão é operacional, não criptográfica — você está escolhendo onde o pipeline de processamento é executado, não qual prova ele produz.

A auto-hospedagem tende a vencer em três situações:

  • Redes isoladas ou restritas. Sua infraestrutura de build não tem rota para SaaS de terceiros, mas consegue alcançar uma saída controlada para tráfego de Bitcoin e calendários.
  • Indústrias regulamentadas. Equipes de compliance querem que hashes de commits — até mesmo hashes — permaneçam dentro de um perímetro definido com um fluxo de dados documentado.
  • Requisitos de residência de dados. Uma política que diz “nenhum metadado sai da região” é mais fácil de cumprir quando o serviço roda no seu próprio rack.

Há um equívoco comum aqui que vale esclarecer: auto-hospedar não significa que sua equipe executa o protocolo de timestamping manualmente. Você não está instalando ferramentas nas máquinas dos desenvolvedores, e não está criando scripts contra a blockchain. A imagem Docker empacota todo o fluxo gerenciado — detecção de commits, agrupamento noturno, construção de árvore Merkle, ancoragem no Bitcoin — atrás de um assistente de configuração. O jeito difícil seria ensinar uma CLI de protocolo para cada desenvolvedor; o jeito do produto é um único arquivo Docker Compose.

Se sua equipe ainda está decidindo se vale a pena comprar prova criptográfica, comece com O Que É Prior Art Criptográfico? Um Guia para Equipes de Software e volte aqui para as contas de licenciamento.

O Que Você Recebe em Cada Plano: Open Source, Pro Agency, Enterprise ZK e Docker Auto-Hospedado

Plano Preço O que você recebe
Open Source Grátis Repositórios públicos, instalação do GitHub App, ancoragem noturna automática
Pro Agency $49/mês Repositórios privados, selos de verificação, acesso à REST API, downloads de CSV de auditoria e certificado PDF
Enterprise ZK $199/mês Uma GitHub Action de 12 linhas envia apenas o hash do commit da sua infraestrutura
Docker Auto-Hospedado Licença necessária O mesmo produto como imagem Docker, com uma licença de demonstração por tempo limitado para avaliação

O plano Open Source é o caminho honesto de avaliação. Instale o GitHub App em um repositório público, veja a ancoragem noturna acontecer e avalie se o fluxo se encaixa na sua equipe antes de qualquer dinheiro trocar de mãos.

Pro Agency é o plano em que a maioria das agências e empresas de produto se estabelece: repositórios privados, o selo e a superfície de REST API, e os artefatos de conformidade para download — o CSV do livro-razão de auditoria e o certificado PDF por data — que as equipes jurídicas e de compras solicitam.

Enterprise ZK é o meio-termo entre nuvem e auto-hospedado. Uma pequena GitHub Action roda nos seus runners e envia apenas o hash do commit para a API do Timestamp GIT. O serviço nunca tem acesso de leitura ao repositório de código-fonte, então seu código permanece dentro do seu perímetro enquanto o pipeline de ancoragem permanece gerenciado.

Para os detalhes de instalação — fluxo OAuth, seleção de repositório, permissões — consulte Configuração de Timestamp Blockchain do GitHub App: Instale Uma Vez, Timestamp Para Sempre. Este artigo foca na licença auto-hospedada e em como ela se compara.

Custo, Benefício e ROI: Por Que a Prova Criptográfica É Mais Barata Que Litígio

Uma licença auto-hospedada é um item de linha que você pode orçar. Uma disputa de PI não é.

Compare a licença com o pior cenário: reivindicações de patent trolls em que você implementou a tecnologia meses antes do pedido, mas não tem nada além de logs internos editáveis; disputas de autoria de funcionários em que a única evidência é um argumento de “ele disse, ela disse” sobre quando um recurso foi concebido; e defesas de clean-room de concorrentes que alegam desenvolvimento independente. Um timestamp de 18 meses atrás é um muro contra o qual essas reivindicações batem.

Duas propriedades tornam a prova durável o suficiente para valer o investimento:

  • Independência do fornecedor. A prova depende apenas de SHA-256 e dados de blocos do Bitcoin. Ela permanece verificável offline mesmo que o fornecedor desapareça. Isso é algo genuinamente raro de se poder dizer a uma equipe de compras avessa a riscos.
  • Segurança zero-knowledge. No modo Docker auto-hospedado, todo o pipeline roda na sua infraestrutura. No modo Enterprise ZK, apenas o hash do commit sai do seu ambiente. O código-fonte nunca é lido, copiado ou armazenado pelo serviço.

Há também uma linha de custo que a maioria das equipes esquece de verificar: ferramentas por assento. O Timestamp GIT não exige nada instalado nas máquinas dos desenvolvedores. Sem CLI para distribuir, sem plugin de IDE para manter, sem interrupção de fluxo de trabalho para retreinar — o que significa que o custo real é a licença, não a implantação.

Configuração Docker Auto-Hospedada: Início Rápido para Equipes Isoladas e On-Prem

Uma configuração rápida de Docker Compose se parece com isto:

services:
  timestampgit:
    image: rue1401/timestampgit:prod
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
    restart: unless-stopped
  valkey:
    image: valkey/valkey:8
    restart: unless-stopped

Dois serviços: a imagem da aplicação e o armazenamento chave-valor usado para a fila de hashes. Depois, suba tudo:

docker compose pull
docker compose up -d
docker compose logs -f timestampgit

Assim que o contêiner estiver saudável, o app estará disponível em http://localhost:8080. Na primeira inicialização, um assistente de configuração orienta você na conexão do seu GitHub App e na configuração da instância — sem edição manual de arquivo de configuração.

Dois detalhes importam para operação não assistida:

  • A montagem de volume. ./data:/app/data é onde vive o armazenamento persistente de provas. Faça backup disso com o mesmo rigor dos dados do seu repositório; é o que torna sua instância reproduzível após uma falha de host.
  • A política de reinício. restart: unless-stopped mantém o worker cron noturno vivo entre reinicializações, o que faz a promessa de “configure e esqueça” realmente se sustentar.

Para avaliar antes de se comprometer com uma licença de produção, envie o formulário de solicitação na página de Licença Docker com seu nome, empresa, e-mail e telefone opcional. Um arquivo de licença de demonstração por tempo limitado está disponível para download, para que você possa executar uma instância real contra um repositório real primeiro.

Auto-Hospedado vs. Nuvem Gerenciada: Escolhendo Seu Caminho de Upgrade

Caminho SaaS gerenciado. Instale o GitHub App uma vez. Os commits são detectados via webhooks, agrupados pelo worker cron da meia-noite e ancorados automaticamente. Manifestos e arquivos de recibo .ots são enviados de volta para um branch dedicado de timestamps ou um repositório shadow. Selos, o painel de status e a REST API estão incluídos.

Caminho Enterprise ZK. A mesma automação, mas o envio do hash do commit se origina da sua própria GitHub Action. O serviço requer acesso de leitura e escrita apenas ao repositório de destino — sem acesso de leitura ao repositório de código-fonte.

Caminho Docker auto-hospedado. A mesma automação novamente, com o pipeline de processamento rodando inteiramente na sua infraestrutura para controle máximo.

As expectativas de tempo são idênticas nos três casos: o worker noturno agrupa os hashes pendentes, constrói uma árvore Merkle nativamente, cria provas usando calendários OTS públicos e ancora a raiz Merkle no Bitcoin. A confirmação do Bitcoin geralmente leva cerca de três horas, então a gravação da prova é concluída algumas horas após a execução do cron. Nada para ficar esperando acordado.

Verificação, Selos e Artefatos de Auditoria Após a Compra

A verificação é local e zero-knowledge. A página de verificação baseada em navegador em /verification/{user}/{repo}/{date} calcula a cadeia Merkle passo a passo, com toda a computação acontecendo no navegador. Ninguém vê o que você verifica. Para o passo a passo criptográfico em si, leia Como Verificar uma Prova de Timestamp Bitcoin Localmente — esta seção é sobre os artefatos que você recebe após a compra.

  • Painel de status público (/status/{user}/{repo}): longevidade da prova, data de ancoragem mais antiga, regularidade diária, dados de bloco e transação do Bitcoin, e um mapa de calor de calendário.
  • CSV do livro-razão de auditoria: extraia o livro-razão completo para revisão de conformidade.
curl -o audit.csv "https://timestampgit.dev/api/audit/your-user/your-repo"
  • Certificado PDF por data: baixe um certificado de um único dia para revisão jurídica.
curl -o certificate.pdf "https://timestampgit.dev/api/report/your-user/your-repo/2026-10-18"
  • Selos Shields.io para o seu README, com pré-visualização ao vivo durante a configuração em /connected/{user}/{repo} e trechos de markdown de /api/badgeLink/{user}/{repo}. Repositórios privados anexam um HMAC criptografado à URL do selo, para que apenas usuários autorizados possam ver o status.

Endpoints de status públicos como /api/statusSummary/{user}/{repo} são o que alimenta o selo, então uma incorporação pode mostrar uma ancoragem verificada sem expor mais nada.

FAQ

Preciso executar comandos do OpenTimestamps por conta própria se eu auto-hospedar a imagem Docker? Não. A imagem Docker empacota todo o fluxo gerenciado — detecção de commits, agrupamento noturno, construção de árvore Merkle e ancoragem no Bitcoin via calendários OTS públicos. Você a configura através do assistente de configuração e recebe recibos .ots automaticamente. O protocolo subjacente permanece oculto, exatamente como no SaaS gerenciado.

Como obtenho uma licença para a implantação Docker auto-hospedada? Envie o formulário de solicitação na página de Licença Docker com seu nome, empresa, e-mail e telefone opcional. Um arquivo de licença de demonstração por tempo limitado está disponível para download, para que você possa avaliar a instância antes de se comprometer com uma licença de produção.

Auto-hospedar significa que meu código-fonte fica exposto ao fornecedor? Não. No modo Docker auto-hospedado, todo o pipeline roda na sua infraestrutura. No modo Enterprise ZK gerenciado, uma GitHub Action de 12 linhas envia apenas o hash do commit, então o serviço nunca tem acesso de leitura ao seu repositório de código-fonte. O código-fonte nunca sai do seu ambiente em nenhum dos casos.

Auto-hospedar muda o peso legal da prova? Não. A prova é baseada em Bitcoin. Recibos .ots e arquivos de manifesto verificam contra dados de blocos do Bitcoin independentemente de qual implantação os produziu, então o modo de implantação é uma escolha operacional, não probatória.

O que acontece com minhas provas se eu parar de usar o serviço? Seus arquivos de recibo .ots e arquivos de manifesto vivem no seu repositório ou repositório shadow e permanecem verificáveis offline usando ferramentas padrão do OpenTimestamps contra a blockchain do Bitcoin. A prova depende apenas de SHA-256 e dados de blocos do Bitcoin, então permanece válida mesmo que o fornecedor desapareça.

Conclusão

Auto-hospede a imagem Docker quando conformidade, isolamento de rede ou residência de dados exigirem. Escolha Enterprise ZK quando quiser ancoragem gerenciada mas sem acesso de leitura ao repositório. Fique nos planos gerenciados quando a simplicidade operacional valer mais que o controle de perímetro. Nos três casos, o recibo que você acaba segurando é o mesmo.

Pronto para avaliar? Solicite uma licença de demonstração por tempo limitado, suba a instância com o arquivo Compose acima e veja sua primeira ancoragem noturna acontecer algumas horas após o cron.

Posts relacionados

EU label: AI-generated content