Acesso à biblioteca

O acesso à biblioteca permite que dispositivos confiáveis se conectem à versão para computador por uma rede privada. O app exibe esta configuração como “Acesso à biblioteca”; esta documentação usa o mesmo nome.

Ativar o acesso à biblioteca

Acesse Configurações → Rede → Acesso à biblioteca.
Ative “Acesso remoto”.
Ative pelo menos “Rede local” ou “Tailscale”.
Aguarde o estado mudar para “Disponível”.
Se desejar, altere o nome do dispositivo e salve.

O menu da conta também oferece o atalho “Remoto” e a entrada “Conectar dispositivo móvel”. Ao desativar o acesso remoto, os dispositivos pareados não poderão mais se conectar; a Biblioteca local do computador não será afetada.

Conexão pela rede local

A rede local é indicada para dispositivos na mesma rede doméstica ou do escritório. A porta padrão é 43127; a conexão usa TLS, e a descoberta de serviços ajuda os clientes a localizar o XiaDown.

Ative apenas em uma rede privada confiável.
O dispositivo e o computador precisam se comunicar na mesma rede local.
No Windows, a primeira ativação pode solicitar permissão para o XiaDown atravessar o firewall de redes privadas.
Depois de mudar a porta, salve e aguarde o estado voltar a “Disponível”.

Conexão pelo Tailscale

O Tailscale conecta dispositivos do mesmo tailnet mesmo que não estejam na mesma rede local. Por padrão, o XiaDown usa a porta HTTPS 443 e o caminho /xiadown.

Antes de usar, confirme que o Tailscale está instalado e conectado no computador e que o Tailscale Serve está ativado. O XiaDown só oferece acesso no tailnet privado; ele não usa o Funnel para publicar a Biblioteca na Internet.

Se o estado indicar “Não instalado” ou “Indisponível”, confira se o Tailscale está aberto, conectado à conta e com o Serve disponível. Depois, atualize o estado no XiaDown.

Emparelhar dispositivos

Quando pelo menos um método de conexão estiver disponível:

Clique em “Emparelhar dispositivo” ou abra “Conexão móvel” pelo menu da conta.
Clique em “Novo pareamento”.
Escaneie o código QR em um dispositivo confiável ou copie e abra nele o link de pareamento.
Conclua a conexão em cinco minutos. Se expirar, clique em “Atualizar código QR”.

O código QR e o link contêm credenciais privadas de uso único. Não os envie a outras pessoas nem os inclua em capturas, logs ou relatos públicos.

Gerenciar permissões

Por padrão, um dispositivo novo só pode “Ver biblioteca” e “Ver tarefas”. Abra os detalhes em “Dispositivos emparelhados” para ajustar cada permissão:

Escopo	Permissões disponíveis
Biblioteca	Ver a Biblioteca.
Música	Ver a biblioteca de músicas; atualizar favoritos e reprodução; gerenciar playlists e membros do índice musical.
RSS	Ver feeds; atualizar o estado de leitura; gerenciar feeds públicos; obter feeds públicos compartilhados explicitamente.
Tarefas	Ver, criar e controlar tarefas.

Conceda apenas as permissões realmente necessárias. Cada dispositivo ativo precisa manter pelo menos uma.

Revogar um dispositivo

Os detalhes mostram a data do último uso. Se você perder um dispositivo, parar de usá-lo ou não reconhecer sua origem:

Abra os detalhes dele.
Clique em “Revogar acesso”.
Confirme a revogação.

As credenciais antigas deixam de funcionar imediatamente. O mesmo dispositivo poderá ser pareado novamente usando um novo código QR.

Problemas frequentes

Situação	O que verificar
Acesso remoto indisponível	Confirme que está ativado e que Rede local ou Tailscale aparecem como “Disponível”.
Não conecta pela rede local	Confirme que ambos estão na mesma rede privada e verifique a porta e o firewall de rede privada do Windows.
Tailscale indisponível	Verifique se está instalado, aberto e conectado e se o Serve está ativado.
Código QR expirado	Clique em “Atualizar código QR” e pareie usando o novo link em até cinco minutos.
Uma ação não tem permissão	Confira as permissões de Biblioteca, Música, RSS ou Tarefas nos detalhes do dispositivo.

Consulte Dados e privacidade para proteger credenciais, backups e capturas.