Guia

Seu próprio servidor de música em um Raspberry Pi

Um Raspberry Pi é um jeito silencioso e econômico de manter toda a sua coleção de música em casa e transmiti-la para qualquer lugar. Este guia monta um com o Navidrome, um servidor de música gratuito e de código aberto que roda tranquilo em um Pi, e conecta o Audex a ele. Conte com cerca de 30 minutos, a maior parte esperando downloads.

Cerca de 30 minutos Raspberry Pi 3, 4 ou 5 Navidrome + Docker

O que você precisa

Um Raspberry Pi 4 ou 5 (um Pi 3 também serve). O Navidrome precisa de muito pouco; 2 GB de memória sobram.
Um cartão microSD de 16 GB ou mais, e a fonte do Pi. Para uma coleção grande, um SSD USB é melhor do que o cartão.
Uma conexão de rede. Um cabo até o roteador é o mais confiável; o Wi-Fi também funciona.
Um computador para preparar o cartão e copiar sua música, na mesma rede que o Pi.
Seus arquivos de música (MP3, FLAC, M4A, OGG, Opus e parecidos) e o Audex no seu celular.

Prefere assistir antes?

Este vídeo mostra o Navidrome sendo instalado em um Raspberry Pi 5, e depois como corrigir as tags das músicas e adicionar rádio pela internet. Os passos abaixo seguem a instalação oficial do Navidrome com Docker, então os comandos são um pouco diferentes dos do vídeo; os dois terminam com o mesmo servidor. (O vídeo está em inglês.)

O Navidrome é instalado a partir de 4:29. Vídeo de Jeffs Pi in the Sky, sem ligação com o Audex. Nada carrega do YouTube até você apertar o play. Assistir no YouTube

1. Prepare o Raspberry Pi

Grave o Raspberry Pi OS no cartão
Instale o Raspberry Pi Imager no computador, escolha o modelo do seu Pi e depois Raspberry Pi OS Lite (64-bit) em "Raspberry Pi OS (other)". Você não precisa de área de trabalho em um servidor.
Baixar o Raspberry Pi Imager
Preencha as configurações antes de gravar
Quando o Imager oferecer personalizar o sistema, defina um nome de host como audex-pi, um usuário e uma senha, seu Wi-Fi se não for usar cabo, e ative o SSH com login por senha. Depois grave o cartão, coloque-o no Pi e ligue. A primeira inicialização leva alguns minutos.
Conecte-se ao Pi pelo computador
Abra um terminal (PowerShell no Windows, Terminal no macOS ou Linux) e entre com o usuário que você escolheu:
```
ssh yourname@audex-pi.local
```
Se audex-pi.local não for encontrado, use o endereço IP do Pi que aparece na lista de aparelhos do seu roteador.

Atualize o sistema

sudo apt update && sudo apt full-upgrade -y

2. Instale o Navidrome

Instale o Docker
O Docker roda o Navidrome em um contêiner fácil de atualizar. Isto usa o script de instalação oficial do Docker e depois permite que seu usuário o use sem sudo:
```
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER
```
Digite exit e entre de novo com ssh para a mudança valer.
Crie pastas para o Navidrome e para sua música
```
mkdir -p ~/navidrome/data ~/music
```
Copie sua música para o Pi
Em um terminal no seu computador (não no Pi), copie uma pasta de música. Repita para cada pasta ou copie a biblioteca inteira de uma vez:
```
scp -r "Path/To/Your Music Folder" yourname@audex-pi.local:music/
```
Uma biblioteca grande é copiada mais rápido de um pendrive ou HD USB ligado ao Pi. Mantenha uma pasta por artista ou álbum; o Navidrome lê as tags dentro dos arquivos de qualquer forma.
Descreva o servidor em um arquivo Compose
De volta ao Pi, abra um arquivo novo:
```
nano ~/navidrome/compose.yaml
```
Cole isto, salve com Ctrl+O, Enter, e feche com Ctrl+X:
```
services:
  navidrome:
    image: navidrome/navidrome:latest
    user: 1000:1000
    ports:
      - "4533:4533"
    restart: unless-stopped
    volumes:
      - ./data:/data
      - ../music:/music:ro
```
1000:1000é o primeiro usuário do Raspberry Pi OS, o que você criou. A pasta de música é montada como somente leitura, então o Navidrome nunca pode alterar seus arquivos.
Inicie
```
cd ~/navidrome
docker compose up -d
```
A primeira inicialização baixa o Navidrome. restart: unless-stopped o traz de volta sozinho sempre que o Pi reiniciar.
Crie sua conta no Navidrome
Em um navegador no computador, abra http://audex-pi.local:4533 e crie o primeiro usuário; ele vira o administrador. Depois o Navidrome analisa sua pasta de música sozinho, e os álbuns aparecem em poucos minutos.
Dê ao Pi um endereço fixo
Descubra o endereço do Pi com hostname -I e reserve-o nas configurações do roteador (geralmente chamado de reserva DHCP ou IP estático). Assim, o endereço que você passa ao Audex nunca muda.

3. Conecte o Audex

Adicione o servidor
No Audex, abra Configurações → Servidores de mídia → Adicionar servidor e escolha Subsonic / OpenSubsonic / Navidrome. (Servidores Jellyfin, Emby e Kodi aparecem sozinhos em Nesta rede; o Navidrome não se anuncia na rede, então você o adiciona pelo endereço.)
Digite o endereço e seu login
Use o endereço e a porta do Pi, por exemplo http://192.168.1.50:4533, com o usuário e a senha do Navidrome que você acabou de criar. O Audex testa a conexão antes de salvar, então você sabe na hora que funciona.
Ative Transmitir na qualidade original
No mesmo formulário (ou depois, na página do servidor em Configurações → Servidores de mídia), ative Transmitir na qualidade original. O Pi passa a enviar seus arquivos como estão, sem convertê-los, o que o mantém frio e rápido. Fora de casa isso usa mais dados móveis, então deixe desligado se o seu plano de dados for pequeno.
Toque alguma coisa
Escolha o servidor no seletor de fontes, no topo da Biblioteca. Álbuns, artistas, gêneros e playlists aparecem do jeito que o Navidrome organiza, e tudo pode ser baixado para ouvir off-line.

Opcional: ouça fora de casa

Seu Pi só é acessível na rede de casa até você adicionar um jeito de entrar de fora. O mais simples e seguro é uma VPN privada como o Tailscale, que não exige mudanças no roteador:

Instale o Tailscale no Pi e entre
```
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
```
Abra o link que ele mostra para entrar e depois instale o app do Tailscale no celular com a mesma conta.
Baixar o Tailscale
Adicione como segundo endereço do servidor
Edite o servidor no Audex e coloque o endereço Tailscale do Pi (começa com 100., mais :4533) em Segundo endereço (opcional). Em casa, o Audex usa o endereço de casa; quando ele não responde, muda sozinho para o segundo.

Usando HTTPS com certificado autoassinado? Na primeira vez, o Audex mostra os detalhes do certificado e a impressão digital SHA-256 para você confiar exatamente naquele certificado. Se ele mudar algum dia, o Audex para e pergunta antes de se conectar de novo.

Se algo não funcionar

O Navidrome abre, mas a biblioteca está vazia

O Navidrome não consegue ler a pasta de música. Torne seu usuário dono dela e reinicie o Navidrome:

sudo chown -R 1000:1000 ~/music ~/navidrome/data
cd ~/navidrome && docker compose restart

O Audex não consegue se conectar ao servidor

Confira se o celular está no mesmo Wi-Fi que o Pi e se o endereço no Audex inclui :4533. No Pi, docker compose ps (dentro de ~/navidrome) deve mostrar o Navidrome rodando. Se o endereço do Pi mudou, reserve-o no roteador como no passo 2.

Como atualizo o Navidrome depois?

No Pi:

cd ~/navidrome
docker compose pull && docker compose up -d

Sua conta e suas configurações ficam em ~/navidrome/data e são mantidas.

Posso usar o Jellyfin no Pi?

Sim. O Jellyfin roda bem para música em um Pi 4 ou 5, e o Audex se conecta a ele do mesmo jeito (porta 8096), geralmente encontrando-o sozinho em Nesta rede. Para vídeo, use formatos que seus aparelhos tocam direto, porque um Pi não converte vídeo rápido. O Navidrome é a opção mais leve se você só precisa de música.

Ainda com problemas? Escreva para audex@kymonic.com: uma pessoa de verdade lê cada mensagem.