Transparência e atenção ao usuário: o papel do GitHub no AdGuard

No AdGuard, trabalhamos diariamente para tornar a Internet mais segura, confortável e transparente. Esse compromisso se reflete não apenas nas funcionalidades de nossos produtos e nas nossas rígidas políticas de privacidade, mas também no fato de mantermos nosso trabalho o mais aberto possível. Isso inclui interagir ativamente com nossa comunidade.

É por isso que todos os nossos produtos possuem repositórios públicos — espaços online onde qualquer pessoa pode ver em que estamos trabalhando, reportar problemas diretamente aos desenvolvedores do AdGuard e até contribuir para nossos projetos de código aberto. Os repositórios abrangem nossos aplicativos de bloqueio de anúncios, filtros, extensões de navegador, soluções DNS, ferramentas de VPN, utilitários para desenvolvedores e muito mais. Existem diferentes plataformas que oferecem essa funcionalidade, mas a mais popular de longe é o GitHub, e todos os projetos do AdGuard estão armazenados lá.

Este artigo lista os repositórios mais importantes por categoria, resume o propósito de cada um e apresenta uma explicação simples do que os usuários podem fazer em cada espaço.

O que é o GitHub e seus repositórios

De forma bem simples, você pode pensar no GitHub como uma espécie de Google Docs para código, onde várias pessoas podem trabalhar no mesmo projeto, acompanhar mudanças e ver quem fez cada atualização. Ele fornece um local central na nuvem para armazenar seu código, tornando-o acessível de qualquer lugar. Também conta com ferramentas de colaboração para revisar alterações, corrigir problemas e integrar o trabalho de todos de forma organizada.

O GitHub é amplamente utilizado para projetos de código aberto, permitindo que qualquer pessoa visualize o código, sugira melhorias e contribua.

Um repositório (ou “repo”, abreviação) é o elemento mais básico do GitHub. É um espaço onde você pode armazenar seu código, arquivos e o histórico de revisões de cada arquivo. Os repositórios podem ter múltiplos colaboradores e podem ser públicos ou privados.

Por onde começar

Você pode encontrar links para os repositórios principais neste artigo ou visitar a página geral do AdGuardTeam no GitHub para a lista completa. Na maioria dos repositórios, você pode:

• Visualizar o arquivo README na página principal: ele apresenta o produto e seu repositório
  

• Ver relatórios de bugs ou solicitações de recursos existentes, comentar e votar
  

• Criar issues para relatar bugs ou solicitar recursos
  

• Consultar releases para ver diferentes versões e seus changelogs (e instalar uma versão anterior, se necessário)
  

• Instalar qualquer versão anterior ou beta, se necessário
  

Observação: se você é novo no GitHub, precisará criar uma conta para poder criar novos issues e comentar nos existentes.

Em repositórios de código aberto, usuários avançados também podem:

• Navegar pelo código para entender a lógica do produto, as tecnologias usadas e como são implementadas
• Fazer fork e contribuir via pull requests

Seja você um usuário casual, especialista técnico ou desenvolvedor, o AdGuard acolhe a participação de toda a comunidade em seus repositórios do GitHub.

Produtos AdGuard Ad Blocker

Nesses repositórios, os usuários podem:

• Visualizar e reportar bugs ou solicitações de recursos via GitHub issues
• Consultar changelogs, acompanhar o histórico de releases e monitorar atualizações
• Baixar builds mais recentes, anteriores e beta (exceto para iOS)

AdguardForAndroid

Repositório do AdGuard para Android — aplicativo que fornece bloqueio de anúncios em todo o sistema.

AdguardForiOS

Repositório do AdGuard para iOS — bloqueador de conteúdo para Safari com DNS e filtros personalizados. Usuários também podem conferir o código aberto.

AdguardForWindows

Repositório do AdGuard para Windows. Não é open-source; o GitHub é usado apenas como rastreador de bugs aberto.

AdguardForMac

Repositório do AdGuard para Mac — bloqueador de conteúdo independente para macOS. Apenas rastreador de bugs.

AdguardBrowserExtension

Repositório da AdGuard Browser Extension — extensão que fornece bloqueio de anúncios com privacidade aprimorada para Chrome, Firefox, Opera e Edge.

AdguardForSafari

Repositório do AdGuard para Safari — extensão de bloqueio de anúncios para Safari no Mac. Usuários também podem conferir o código open-source.

AdGuardCLI

Repositório do AdGuard para Linux — interface de linha de comando para gerenciar bloqueio de anúncios.

Produtos AdGuard VPN

Nesses repositórios, os usuários podem:

• Visualizar e reportar bugs ou solicitações de recursos via GitHub issues
• Consultar changelogs, acompanhar histórico de releases e monitorar atualizações
• Baixar builds mais recentes, anteriores e beta (exceto para iOS)

AdGuardVPNForiOS

Repositório do AdGuard VPN para iOS. Serve como rastreador aberto de bugs.

AdGuardVPNForAndroid

Repositório do AdGuard VPN para Android. Serve como rastreador aberto de bugs.

AdGuardVPNForWindows

Repositório do AdGuard VPN para Windows. Serve como rastreador aberto de bugs.

AdGuardVPNForMac

Repositório do AdGuard VPN para Mac — aplicativo desenvolvido para macOS.

AdGuardVPNExtension

Repositório da extensão AdGuard VPN para navegadores.

AdGuardVPNCLI

Repositório do AdGuard VPN para Linux — interface de linha de comando para gerenciar a conexão VPN. O repositório funciona como rastreador de bugs.

Produtos de DNS

AdGuardDNS

Repositório open-source usado também para rastrear bugs e problemas relacionados ao serviço AdGuard DNS. Os usuários podem:

• Visualizar e reportar problemas de DNS
• Sugerir melhorias

AdGuardHome

Repositório do AdGuard Home — software gratuito para toda a rede que bloqueia anúncios e rastreadores via DNS. Os usuários podem:

• Verificar e enviar relatórios de bugs ou solicitações de recursos
• Revisar ou contribuir com o código
• Baixar e instalar releases

Documentação e bases de conhecimento

As bases de conhecimento ajudam os usuários a entender melhor e utilizar o AdGuard. Elas descrevem cada produto em detalhe: desde visão geral das funcionalidades e guias de resolução de problemas até manuais avançados e documentação de APIs. Nos repositórios, os usuários podem:

• Sugerir correções ou edições nos artigos da base de conhecimento
• Propor novos artigos
• Testar ou executar a versão local

KnowledgeBase

Documentação central do AdGuard Ad Blocker e tecnologias relacionadas.

KnowledgeBaseDNS

Visão detalhada das funcionalidades, guias de resolução de problemas e documentação do AdGuard DNS (Público e Privado), AdGuard Home e tudo relacionado.

KnowledgeBaseVPN

Visão detalhada das funcionalidades e guias de resolução de problemas do AdGuard VPN.

KnowledgeBaseMail

Visão detalhada das funcionalidades e guias de resolução de problemas do AdGuard Mail.

Bibliotecas principais

AdGuardCoreLibs

Motor de filtragem multiplataforma do AdGuard, usado em produtos Android, Windows e Mac. Os usuários podem:

• Explorar a lógica de filtragem e o gerenciamento de DNS
• Reportar bugs e sugerir funcionalidades via issues, contribuir com código via pull requests

DNSLibs

Biblioteca de DNS usada pelo CoreLibs e AdGuard Home. Os usuários podem:

• Revisar e contribuir com a implementação de baixo nível de DNS
• Sugerir otimizações

VPNLibs

Base de código compartilhada usada nos produtos AdGuard VPN para implementação do protocolo AdGuard VPN. Os usuários podem:

• Contribuir com o comportamento da pilha VPN
• Reportar ou visualizar problemas de desempenho e bugs

Tecnologias principais de bloqueio de anúncios e filtragem

AdguardFilters

Contém as listas de filtros principais do AdGuard. Os usuários podem:

• Visualizar e baixar listas de filtros
• Criar issues para reportar falsos positivos ou sugerir novas regras
• Acompanhar atualizações na lógica de filtragem

AdGuardSDNSFilter

Repositório do filtro DNS do AdGuard — lista principal de bloqueio em nível DNS usada no AdGuard DNS e recursos de filtragem DNS. Os usuários podem:

• Inspecionar o conjunto de regras atual
• Propor alterações ou adições

AGLint

Linter para sintaxe de listas de filtros de adblock. Os usuários podem:

• Instalar o AGLint para verificar problemas nas suas listas
• Contribuir com regras de lint

Scriptlets

Helpers em JavaScript usados nas regras de filtragem. Os usuários podem:

• Explorar os scriptlets disponíveis
• Enviar pull requests para novos scriptlets

tsurlfilter

Biblioteca em TypeScript para bloqueio de conteúdo em extensões de navegador. Os usuários podem:

• Explorar como a lógica de filtragem é implementada
• Contribuir com correções e novas funcionalidades

Tem mais

Acima, listamos 27 repositórios públicos principais do AdGuard, de um total de 96. Se você quiser explorar mais, pode encontrar o restante na página do AdGuardTeam no GitHub.

Esperamos pelo seu feedback lá! Fique seguro online e offline.