Como hospedar sua própria instância do Piped

O Piped é um front-end alternativo e de código aberto para o YouTube, focado em privacidade. Sem rastreamento do Google, sem anúncios (nem nos vídeos que normalmente têm anúncios que não dá para pular), e funciona perfeitamente com o SponsorBlock e o DeArrow. Hospedar sua própria instância com Docker é incrivelmente fácil e leva menos de 20 minutos.

Introdução

O Piped é um front-end alternativo e de código aberto para o YouTube, focado em privacidade. Sem rastreamento do Google, sem anúncios (nem nos vídeos que normalmente têm anúncios que não dá para pular), e funciona perfeitamente com o SponsorBlock e o DeArrow.

Hospedar sua própria instância com Docker é incrivelmente fácil e leva menos de 20 minutos.

Requisitos

  • Um domínio (ou subdomínio)
  • Uma VPS KVM barata com suporte a Docker (evite OpenVZ — kernel antigo)
  • ~US$ 3–6/mês é mais que suficiente (1 CPU, 1–2 GB de RAM)

Ótimos provedores baratos em 2025:

Passo 1: Proteja e prepare sua VPS

(Só chaves SSH, firewall etc. — faça isso primeiro!)

Depois, instale o Docker (exemplo para Ubuntu/Debian):

apt update && apt upgrade -y
apt install -y ca-certificates curl gnupg lsb-release

# Add Docker repo
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" > /etc/apt/sources.list.d/docker.list

apt update
apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

Passo 2: Implante o Piped com a configuração oficial em Docker

cd /opt
git clone https://github.com/TeamPiped/Piped-Docker
cd Piped-Docker
./configure-instance.sh

Durante o script:

  • Escolha o Caddy como proxy reverso (o mais fácil, com SSL automático)

  • Informe seu domínio e os subdomínios:

    • Frontend → piped.yourdomain.com
    • API do backend → pipedapi.yourdomain.com
    • Proxy → pipedproxy.yourdomain.com

Passo 3: Aponte o DNS para sua VPS

Crie três registros A no seu provedor de DNS:

piped.yourdomain.com        → VPS_IP
pipedapi.yourdomain.com     → VPS_IP
pipedproxy.yourdomain.com   → VPS_IP

Passo 4: Suba tudo

docker compose up -d

Pronto! Depois que o DNS propagar (normalmente em menos de 10 minutos), o seu YouTube privado estará no ar em:

https://piped.yourdomain.com

O Caddy cuida automaticamente do SSL gratuito do Let’s Encrypt — sem precisar mexer no certbot manualmente.

Passo 5: (Opcional) Confira os logs

Bash

# See what Caddy is doing
docker logs -f caddy

# Or any other container
docker logs -f piped-frontend

Dicas bônus

  • Quer deixar pública? É só compartilhar a URL — qualquer pessoa pode usar a sua instância.
  • Quer deixar privada? Bloqueie com regras de firewall do Cloudflare ou com autenticação básica no Caddy.
  • Use junto com o app LibreTube (Android) para ter a experiência completa sem Google.

Agora você tem o seu próprio YouTube sem anúncios, sem rastreamento e com SponsorBlock — totalmente sob o seu controle.

Obrigado pela leitura!

Criado com Hugo
Tema Stack desenvolvido por Jimmy