RepoPicks Radar

Atualizado todo dia por volta das 02:00 UTC

Guias

Todos os guias

Como achar o repositório oficial de um projeto do GitHub e fugir de cópias falsas

Muitos programas de código aberto moram no GitHub, e é lá que muita gente vai buscar o instalador. Só que qualquer pessoa pode criar uma conta e publicar um repositório com o mesmo nome de um projeto famoso. Muitas dessas cópias são só para estudo ou teste; algumas existem para espalhar um arquivo diferente do original.

Este guia mostra como chegar ao repositório certo, o que conferir antes de baixar e quais sinais pedem mais cuidado. Nada aqui exige saber programar.

Por que existem cópias

Quanto mais famoso um projeto fica, mais cópias aparecem. Os caminhos mais comuns são três:

Ter forks não é sinal de má intenção. Muitos existem para corrigir um erro, traduzir o programa ou manter vivo um projeto abandonado. A pergunta que importa é outra: de qual repositório você está baixando?

Comece pelo site oficial

O caminho mais curto até o repositório oficial costuma ser o site do próprio projeto. Projetos conhecidos têm um site que leva ao GitHub, em geral por um botão ou pelo ícone do GitHub no topo ou no rodapé. Seguir esse link é melhor do que confiar no primeiro resultado da busca.

O caminho inverso também ajuda. Na coluna da direita do repositório, na parte “About”, fica o endereço do site do projeto. No oficial, os dois apontam um para o outro: o site leva ao repositório, e o repositório leva ao site.

Se o projeto não tem site, procure o repositório citado na documentação, em notícias de fontes conhecidas ou nos gerenciadores de programas que aparecem mais abaixo.

Confira o dono

O endereço de um repositório tem sempre o formato github.com/dono/projeto. O dono pode ser uma conta pessoal ou uma organização, que é a conta usada por equipes e empresas. Três coisas valem a conferência:

Veja se é um fork

Logo abaixo do nome de um fork, o GitHub mostra a etiqueta “forked from”, seguida do repositório de onde ele veio. Se você chegou a um repositório com essa etiqueta achando que era o original, clique no nome que vem depois de “forked from”: é lá que está o projeto de origem.

Uma cópia feita por fora, baixando os arquivos e subindo tudo de novo numa conta nova, não mostra essa etiqueta. Por isso ela ajuda, mas não basta sozinha: o dono e a página de downloads também precisam bater.

Confira a página de Releases

Os programas prontos para instalar costumam ficar na página de Releases, que aparece na coluna da direita do repositório. O endereço dela segue o formato github.com/dono/projeto/releases. Confira que o dono no endereço é o mesmo do repositório oficial. Uma cópia pode reaproveitar o texto do README, que é a apresentação do projeto, e levar você para a página de Releases de outra conta.

Repare também na história. Projetos estabelecidos costumam ter várias versões publicadas ao longo do tempo, cada uma com notas sobre o que mudou. Uma única versão, publicada há poucos dias por uma conta nova, é motivo para olhar com mais calma.

Sinais de alerta comuns

Nenhum destes sinais prova nada sozinho, mas cada um é um bom motivo para parar e conferir:

O que fazer na dúvida

Se alguma coisa não bateu, há caminhos simples para tirar a dúvida antes de instalar:

Se mesmo assim a dúvida continuar, não instale. Esperar um dia e procurar de novo custa bem menos do que limpar um computador.

Para continuar

Os projetos em alta no início já vêm com a ficha de cada um, os sinais encontrados e o link para o repositório. Na hora de baixar, o guia Como instalar um programa do GitHub sem saber programar mostra qual arquivo escolher no seu sistema.