Dagoland: Como compilar e instalar o uBlock Origin manualmente no Google Chrome no Debian e derivados

O uBlock Origin é um poderoso bloqueador de anúncios, mas o YouTube tem implementado medidas para detectar e bloquear seu uso. Este tutorial mostra como baixar, compilar e instalar a versão completa do uBlock Origin (Manifest V2) a partir do código-fonte no Debian, permitindo que você bloqueie anúncios no Chrome. Incluímos também uma etapa opcional para adicionar filtros específicos contra a detecção do YouTube. Siga os passos abaixo!

1. Faça o download do código-fonte

Baixe o repositório do uBlock Origin diretamente do GitHub usando o wget:

Então, você deve executar o seguinte comando:

wget -c -O uBlock-master.zip https://codeload.github.com/gorhill/uBlock/zip/refs/heads/master

O parâmetro -c continua o download se for interrompido, e -O define o nome do arquivo como uBlock-master.zip.

Então, você deve executar o seguinte comando:

2. Extraia os arquivos compactados

Descompacte o arquivo ZIP e remova-o para manter o diretório limpo:

unzip uBlock-master.zip && rm uBlock-master.zip

Isso cria a pasta uBlock-master com o código-fonte.

3. Acesse o diretório raiz do projeto

Entre na pasta extraída:

cd uBlock-master

Agora você está no diretório principal do projeto.

4. Verifique as dependências

Certifique-se de que o Node.js e o npm estão instalados no seu sistema Debian:

node --version
npm --version

Esses comandos mostram as versões instaladas. Se aparecerem, pule para o passo 6.

5. Instale as dependências (se necessário)

Se o Node.js ou npm não estiverem instalados, atualize o sistema e instale-os:

sudo apt update
sudo apt install nodejs npm

Isso garante que você tenha as ferramentas necessárias para compilar o projeto.

6. Compile o projeto

No diretório raiz (uBlock-master), instale as dependências do projeto e compile a extensão:

Instale as dependências listadas em package.json:

npm install

Isso baixa bibliotecas necessárias para a compilação.

Compile para o Chrome usando o Makefile
:

make chromium

O comando gera os arquivos da extensão na pasta dist/build/uBlock0.chromium/.Nota: O repositório não usa npm run build como padrão, então ignore essa opção mencionada anteriormente.

Verifique o resultado:

ls dist/build

Você deve ver a pasta uBlock0.chromium (ex.: dist/build/uBlock0.chromium/).

7. Localize os arquivos gerados

Confirme que a compilação foi bem-sucedida:

ls dist/build/uBlock0.chromium/

Se o arquivo manifest.json estiver presente, essa é a pasta que você usará no Chrome.

8. Carregue a extensão no Chrome

Instale a extensão manualmente no Google Chrome:

Abra o Chrome.
Digite chrome://extensions/ na barra de endereço e pressione Enter.
Ative o "Modo de desenvolvedor" (chave no canto superior direito).
Clique em "Carregar sem compactação" (ou "Load unpacked").
Selecione a pasta dist/build/uBlock0.chromium/ (ex.: /home/dagoland/uBlock-master/dist/build/uBlock0.chromium/).
A extensão será carregada e aparecerá como "uBlock Origin development build".

Teste no YouTube para verificar se os anúncios são bloqueados.

Opcional: Adicione filtros específicos para o YouTube

Se o YouTube ainda exibir o aviso "Bloqueadores de anúncios violam os Termos de Serviço", adicione filtros personalizados para contornar a detecção:

Clique no ícone do uBlock Origin na barra de extensões do Chrome.
Clique na engrenagem para abrir o painel de controle.
Vá até a aba "Meus filtros".

Insira filtros recomendados pela comunidade (exemplo):

||youtube.com##+js(set, yt.config_.EXPERIMENT_FLAGS, {ad_blocker_detection: false})
||youtube.com##+js(nano-setInterval-booster, ytplayer.config.experiments, adBlockerDetected, 0)

Esses filtros tentam desativar a detecção de bloqueadores pelo YouTube.

Clique em "Aplicar alterações" e teste novamente no YouTube.

Fonte dos filtros: Comunidades como /r/uBlockOrigin no Reddit ou Issues no GitHub (https://github.com/gorhill/uBlock/issues).

Notas finais

Aviso do Manifest V2: O Chrome exibirá uma notificação sobre o Manifest V2 ser obsoleto, mas a extensão funciona em modo desenvolvedor até meados de 2025.
Atualizações: Para manter o uBlock funcional, repita o processo com uma nova versão do código-fonte do GitHub periodicamente.
Alternativa: Se o YouTube continuar detectando, considere usar o Firefox com o uBlock Origin, que ainda suporta o Manifest V2 por mais tempo.

Pronto! Agora você tem o uBlock Origin compilado e instalado. Teste e ajuste conforme necessário. Boa sorte!