Como Configurar um Bluesky PDS Auto-Hospedado em uma VPS

Você quer executar seu próprio Bluesky Personal Data Server em uma VPS em vez de usar o serviço hospedado oficial. Um PDS auto-hospedado oferece controle total sobre seus dados, moderação e infraestrutura. Este artigo mostra o processo completo de configuração usando Docker em uma VPS Ubuntu 22.04. Ao final, você terá um Bluesky PDS funcional acessível de qualquer cliente Bluesky.

O que é um Bluesky PDS e Por Que Auto-Hospedar

Um Personal Data Server é a infraestrutura central da rede Bluesky. Ele armazena os dados da sua conta, postagens e seguidores, e se comunica com outras instâncias PDS para retransmitir conteúdo. O serviço hospedado oficial em bsky.social executa um grande cluster de PDS gerenciado pela Bluesky. Auto-hospedar um PDS significa executar sua própria instância em uma VPS que você controla. Isso oferece benefícios de privacidade, pois seus dados nunca tocam os servidores da Bluesky. Você também obtém a capacidade de definir regras de moderação personalizadas e manter sua conta ativa mesmo se o serviço oficial ficar offline. A configuração requer uma VPS com IP público, um nome de domínio e familiaridade básica com a linha de comando Linux.

Pré-requisitos para a Configuração

Antes de começar, você precisa dos seguintes itens prontos:

• Uma VPS rodando Ubuntu 22.04 com pelo menos 2 GB de RAM e 20 GB de armazenamento SSD. Provedores como DigitalOcean, Linode ou Hetzner funcionam bem.
• Acesso SSH root à VPS.
• Um nome de domínio que você controla, por exemplo pds.seudominio.com. Você criará um registro DNS A apontando para o IP da sua VPS.
• Docker e Docker Compose instalados na VPS. Se não estiverem instalados, o script de configuração os instalará.
• Portas 80 e 443 abertas no firewall da VPS. A configuração usa Let’s Encrypt para obter um certificado TLS automaticamente.

Passos para Configurar um Bluesky PDS Auto-Hospedado em uma VPS

Os passos a seguir usam o script de configuração oficial do Bluesky PDS. Este script baixa a imagem Docker, cria arquivos de ambiente e configura o Caddy como proxy reverso com HTTPS automático. Você executará todos os comandos como um usuário não root com privilégios sudo.

Passo 1: Conecte-se à Sua VPS e Atualize o Sistema

1. Abra uma conexão SSH
   Execute ssh root@ip-da-sua-vps no seu terminal local. Substitua ip-da-sua-vps pelo endereço IP real da sua VPS.
2. Atualize as listas de pacotes e atualize os pacotes existentes
   Execute apt update && apt upgrade -y. Isso garante que todos os pacotes do sistema estejam atualizados.
3. Reinicie a VPS se o kernel foi atualizado
   Execute reboot e reconecte após o servidor voltar ao ar.

Passo 2: Configure o DNS para Seu Domínio

1. Acesse o painel de controle do seu registrador de domínio ou provedor DNS
   Vá para o painel de gerenciamento DNS do seu domínio.
2. Crie um registro A
   Defina o hostname como pds ou qualquer subdomínio de sua preferência. Defina o valor como o endereço IP público da sua VPS. Defina o TTL para 300 segundos ou o menor valor permitido.
3. Aguarde a propagação do DNS
   Use uma ferramenta como dig pds.seudominio.com do seu computador local para verificar se o registro resolve para o IP da sua VPS. A propagação geralmente leva alguns minutos.

Passo 3: Clone o Repositório do Bluesky PDS

1. Instale o git se ainda não estiver instalado
   Execute apt install git -y.
2. Clone o repositório oficial do PDS
   Execute git clone https://github.com/bluesky-social/pds.git. Isso cria um diretório chamado pds no seu diretório de trabalho atual.
3. Entre no diretório pds
   Execute cd pds.

Passo 4: Execute o Script de Configuração

1. Torne o script de configuração executável
   Execute chmod +x setup.sh.
2. Execute o script de configuração
   Execute sudo ./setup.sh. O script solicitará várias informações.
3. Forneça os valores solicitados quando solicitado
   Digite seu nome de domínio (por exemplo pds.seudominio.com), um endereço de e-mail de administrador para notificações do Let’s Encrypt e uma senha de administrador forte. O script também perguntará pelo domínio de handle do serviço. Este é o domínio usado para seus handles do Bluesky. Pode ser o mesmo que seu domínio PDS ou um domínio diferente, como bsky.seudominio.com.
4. Aguarde o script terminar
   O script instala Docker e Docker Compose se necessário, configura variáveis de ambiente e inicia o contêiner PDS. Ele também configura o Caddy para lidar com HTTPS automaticamente.

Passo 5: Verifique se o PDS Está Funcionando

1. Verifique o status do contêiner Docker
   Execute docker ps. Você deve ver um contêiner chamado pds com o status Up.
2. Teste o endpoint de saúde do PDS
   Execute curl https://pds.seudominio.com/xrpc/_health. Você deve receber uma resposta JSON com {"version":"0.4.0"} ou um número de versão similar.
3. Crie sua primeira conta no PDS
   Use um cliente Bluesky como o aplicativo oficial ou um cliente de terceiros. Ao se inscrever, insira seu domínio PDS como a URL do servidor. Por exemplo, no aplicativo oficial do Bluesky, toque nos três pontos no canto superior direito, selecione Avançado e insira https://pds.seudominio.com como a URL do servidor. Em seguida, crie sua conta com o handle desejado, por exemplo @seuhandle.pds.seudominio.com.

Problemas Comuns Após Configurar um PDS Auto-Hospedado

Falha na Geração do Certificado HTTPS

Se o certificado Let’s Encrypt não for emitido, a causa mais comum é que a porta 80 não está acessível pela internet. Verifique se o firewall da sua VPS permite tráfego de entrada na porta 80. Verifique também se o registro DNS A aponta para o IP correto da VPS. Execute curl -v http://pds.seudominio.com/.well-known/acme-challenge/test de outra máquina para confirmar que o domínio está acessível na porta 80.

Contêiner Docker Sai Imediatamente

Se o contêiner PDS sair logo após iniciar, verifique os logs com docker logs pds. A causa mais frequente é uma variável de ambiente ausente ou incorreta no arquivo .env. Abra o diretório pds e edite o arquivo .env. Verifique se PDS_HOSTNAME corresponde exatamente ao seu domínio, PDS_ADMIN_PASSWORD não está vazio e PDS_SERVICE_HANDLE_DOMAIN está definido para um domínio válido. Após editar, reinicie o contêiner com docker-compose down && docker-compose up -d.

Não é Possível Criar Conta a Partir de um Cliente

Se o cliente mostrar um erro ao tentar criar uma conta, certifique-se de que o PDS está funcionando e que a URL do servidor inserida está correta. Alguns clientes exigem a URL completa com o prefixo https://. Confirme também que o domínio de handle configurado corresponde à parte do domínio do handle que você está tentando criar. Por exemplo, se seu domínio de handle é pds.seudominio.com, seu handle deve ser @usuario.pds.seudominio.com.

PDS Auto-Hospedado vs Serviço Oficial do Bluesky

Item	PDS Auto-Hospedado	Serviço Oficial Bluesky
Armazenamento de dados	Sua própria VPS	Servidores da Bluesky
Esforço de configuração	Requer conhecimento de Linux e Docker	Nenhuma configuração necessária
Custo	Custo de hospedagem VPS (geralmente $5-$20 por mês)	Gratuito
Controle sobre moderação	Controle total via API de administração	Limitado às políticas de moderação da Bluesky
Responsabilidade pelo uptime	Você gerencia o servidor	Bluesky gerencia o uptime
Formato do handle	Handle de domínio personalizado	Handle bsky.social

Executar seu próprio PDS oferece soberania total sobre os dados e a capacidade de definir suas próprias regras de moderação. A contrapartida é que você precisa manter o servidor, aplicar atualizações de segurança e monitorar o espaço em disco. Se você prefere uma experiência sem preocupações, o serviço oficial continua sendo uma boa escolha. Para usuários que desejam máxima privacidade e controle, um PDS auto-hospedado em uma VPS é o caminho correto.