Migrar uma conta do Bluesky para um Personal Data Server (PDS) auto-hospedado exige preparação cuidadosa. Uma única configuração incorreta pode causar downtime, perda de dados ou bloqueio permanente da conta. Testar a configuração do PDS com uma conta dummy evita esses riscos. Este artigo explica como validar cada componente do seu PDS antes de mover seu handle e dados reais.
Principais Conclusões: Validando seu PDS Antes da Migração do Bluesky
- Crie uma conta de teste temporária no PDS: Use a API de administração ou um código de convite de teste para simular um usuário real sem afetar sua conta principal.
- Verifique DNS e certificados SSL: Confirme que seu domínio resolve corretamente e que HTTPS está ativo antes da janela de migração.
- Execute um ciclo completo de exportação e importação de dados: Use a ferramenta de exportação do Bluesky para fazer backup da sua conta real e teste a restauração desses dados na conta dummy do PDS.
Por que Testar um PDS Antes da Migração é Importante
Um PDS do Bluesky é um servidor auto-hospedado que armazena dados da sua conta, postagens e chaves criptográficas. Ao migrar, os dados da sua conta existente devem ser transferidos para o novo PDS e o handle do domínio deve ser redirecionado. Se o PDS estiver mal configurado, o processo de migração pode falhar no meio, deixando sua conta em um estado quebrado, onde nem o servidor original nem o novo conseguem servir seus dados.
Pontos de falha comuns incluem registros DNS incorretos, certificados SSL ausentes, bloqueios de firewall nas portas necessárias e esgotamento de espaço em disco. Testar com uma conta descartável detecta esses problemas sem arriscar seus seguidores reais ou histórico de postagens. O teste também verifica se o PDS suporta o tamanho do banco de dados e o volume de requisições da sua conta real.
O que Você Precisa Antes de Testar
Você precisa de um nome de domínio que controle, um servidor com pelo menos 2 GB de RAM e 20 GB de armazenamento, e Docker instalado. Você também precisa do software PDS do Bluesky configurado conforme a documentação oficial. Para a conta de teste, você pode gerar um código de convite pelo painel de administração do PDS ou usar a ferramenta de linha de comando pdsadmin para criar um usuário diretamente.
Passos para Testar uma Configuração de PDS com uma Conta Dummy
- Crie um usuário de teste no PDS
Acesse seu servidor PDS via SSH. Executesudo pdsadmin account createe insira um handle temporário comotestuser.seudominio.com. A ferramenta retorna uma senha e um DID. Salve ambos em um gerenciador de senhas. Esse usuário é totalmente isolado da sua conta real. - Verifique a resolução DNS para o handle de teste
Confirme que o domínio do handle de teste resolve para o IP do seu PDS. Usedig testuser.seudominio.comde uma máquina fora da sua rede. A resposta deve mostrar um registro A ou AAAA apontando para seu servidor. Se retornar um IP diferente, atualize seu arquivo de zona DNS. - Confirme que o certificado SSL cobre o domínio de teste
Abrahttps://testuser.seudominio.comem um navegador. O ícone de cadeado deve aparecer sem avisos de certificado. Se usar um certificado curinga, certifique-se de que ele cobreseudominio.come todos os subdomínios. Se o certificado estiver ausente, executesudo certbot --nginx -d seudominio.com -d seudominio.com. - Faça login na conta de teste pelo aplicativo oficial do Bluesky
Abra o aplicativo ou cliente web do Bluesky. Clique em Configurações > Avançado > PDS Personalizado. Insira o domínio do seu PDS (ex.:pds.seudominio.com) e o handle e senha do usuário de teste. O aplicativo deve carregar a timeline, perfil e configurações sem erros. - Realize uma exportação de dados da sua conta real
Faça login na sua conta real do Bluesky. Vá em Configurações > Privacidade e Segurança > Exportar Meus Dados. Baixe o arquivo ZIP. Esse arquivo contém suas postagens, curtidas, seguidores e mídia. Armazene-o em um local seguro fora do PDS. - Importe os dados exportados para a conta de teste
No servidor PDS, executesudo pdsadmin account importcom o DID do usuário de teste e o caminho para o arquivo ZIP. Aguarde a conclusão da importação. Verifique os logs do PDS comsudo journalctl -u pdsem busca de erros. A importação deve terminar em alguns minutos para contas com menos de 100 MB. - Verifique os dados importados na conta de teste
Faça login na conta de teste novamente. Navegue pela timeline, confira se suas postagens antigas aparecem e se os números de seguidores estão corretos. Se faltar algum dado, execute novamente a importação após corrigir o erro mostrado nos logs. - Teste a resolução do handle para o domínio de teste
Use a API pública do Bluesky para resolver o handle de teste:curl https://api.bsky.app/xrpc/com.atproto.identity.resolveHandle?handle=testuser.seudominio.com. A resposta deve retornar o DID do usuário de teste. Se retornar um erro, sua configuração de DNS ou PDS está incorreta. - Simule uma reinicialização do servidor e verifique a persistência
Reinicie o servidor PDS comsudo reboot. Após o servidor voltar, faça login na conta de teste novamente. Todas as postagens, seguidores e configurações devem estar intactos. Se houver perda de dados, verifique se seus volumes Docker estão montados em armazenamento persistente, não em um sistema de arquivos temporário. - Exclua a conta de teste após a validação
Executesudo pdsadmin account deletecom o DID do usuário de teste. Isso libera espaço em disco e remove os dados de teste. Mantenha o arquivo ZIP de exportação para a migração real.
Problemas Comuns Durante o Teste de PDS e Como Corrigi-los
A conta de teste não consegue fazer login pelo aplicativo oficial
Se o aplicativo mostrar “Handle ou senha inválidos”, verifique se a URL do PDS Personalizado no aplicativo corresponde exatamente ao hostname do PDS. Não inclua https:// no campo de PDS personalizado. Confirme também que a porta 443 está aberta no firewall do servidor. Execute sudo ufw status para verificar.
A importação de dados falha com erro “Disco cheio”
O PDS armazena dados em volumes Docker localizados em /pds por padrão. Verifique o uso de disco com df -h. Se o volume estiver cheio, redimensione o disco ou mova o volume para uma partição maior. Após liberar espaço, reinicie o serviço PDS com sudo systemctl restart pds e tente a importação novamente.
A resolução do handle retorna um DID diferente
Isso significa que seu DNS possui um registro TXT desatualizado ou incorreto. Remova quaisquer registros TXT _atproto antigos da sua zona DNS. O PDS gerencia o mapeamento DID-para-handle internamente. Apenas o registro A ou AAAA é necessário. Aguarde a propagação do DNS, que pode levar até 24 horas.
Conta de Teste vs Conta Real: Tabela Comparativa
| Item | Conta de Teste | Conta Real |
|---|---|---|
| Handle | Subdomínio temporário (ex.: test.seudominio.com) | Seu handle real (ex.: seunome.bsky.social) |
| Dados | Importados da conta real para validação | Dados originais ao vivo com postagens, seguidores e mídia |
| Risco | Nenhum; pode ser excluída após o teste | Perda permanente se a migração falhar |
| Alterações DNS | Apenas registros de subdomínio modificados | Registros do domínio raiz devem ser atualizados |
| Código de convite necessário | Gerado pelo administrador do PDS | Já possui conta no PDS existente |
Testar com uma conta dummy é a única maneira segura de confirmar que seu PDS lida com autenticação, importação de dados e resolução DNS. Depois que cada etapa passar, você pode prosseguir com a migração real usando o mesmo arquivo de exportação e a mesma configuração do PDS.