Sobre

Tecnologia e segurança

Para quem tem curiosidade técnica: como o Neruz Bot funciona por dentro e o que foi feito para ele ser seguro e estável. Você não precisa saber nada disso para usar o bot.

Arquitetura em 30 segundos

1
Comando
O Discord envia o comando, como mensagem (n!tocar …) ou como comando de barra (/tocar).
2
Adaptador
Faz o comando digitado se comportar como um comando de barra. Assim, os mesmos comandos atendem os dois estilos.
3
TrackResolver
Transforma o texto ou o link em músicas: YouTube, Spotify, SoundCloud, arquivo.
4
GuildPlayer
Cada servidor tem o seu: conexão de voz, fila e estado. As operações são feitas uma de cada vez, para evitar conflitos como dois “pular” ao mesmo tempo.
5
AudioStream
Extrai e decodifica o áudio. A biblioteca de voz codifica em Opus, criptografa e envia para o Discord.
6
Sob demanda
Músicas do Spotify são procuradas no YouTube na hora de tocar, e a próxima da fila já fica pré-carregada.

Tecnologias

Camada	Tecnologia
Linguagem	TypeScript em modo estrito, Node.js 24, módulos ES
API do Discord	discord.js 14: gateway, comandos de barra, botões, menus e autocompletar
Voz	@discordjs/voice com criptografia de ponta a ponta DAVE, obrigatória no Discord desde março de 2026
Extração de áudio	yt-dlp, atualizado automaticamente a cada 24 horas
Processamento de áudio	FFmpeg, decodificando para PCM 48 kHz estéreo, e codificação Opus
Spotify	Página pública de embed e Web API oficial
Validação de configuração	zod
Logs	pino
Testes	vitest, com 100 testes automatizados
Empacotamento	Docker, com imagem multi-etapa e usuário sem privilégios

Onde roda

O bot roda 24 horas por dia em um servidor dedicado, dentro de um container Docker com reinício automático.
O container tem privilégios removidos e limites de memória, CPU e processos.
O bot só faz conexões de saída. Nenhuma porta dele fica aberta ao público.

Segurança

Dependências auditadas
npm audit sem vulnerabilidades conhecidas.
Links validados
Só internet pública, com bloqueio de endereços internos, só sites de uma lista permitida e anexos só do CDN do Discord.
Sem shell
Nenhum comando é executado via shell. O que o usuário digita nunca vira argumento solto.
Limite de uso
Intervalo mínimo entre comandos por pessoa, contra spam.
Nunca marca ninguém
O bot não menciona usuários, nem @everyone que apareça no título de uma música.
Executável verificado
O extrator de áudio é conferido por checksum SHA-256 antes de ser usado.
Segredos protegidos
Chaves ficam só em variáveis de ambiente e são ocultadas nos logs.

Código-fonte

O código-fonte do bot é privado. Este site e a documentação são mantidos pela Fonte Dev, de Bruno Lucas.