⚡ nzbfast

O baixador rápido da Usenet - manual do usuário

1 · Boas-vindas

O nzbfast baixa da Usenet tão rápido quanto sua linha, seus provedores e sua máquina permitem - e normalmente isso significa tão rápido quanto sua linha. É um único programa autossuficiente: o motor, um painel web, um navegador de mídia em mural de pôsteres, um indexador integrado, pré-visualização em tempo real, reparo PAR2 nativo e a extração de RAR nativa estão todos dentro de um único executável. Não há mais nada para instalar.

O que o torna rápido é a arquitetura, não ajustes finos:

• NNTP com pipeline - muitas solicitações de artigos trafegam por cada conexão uma atrás da outra, mantendo toda conexão em velocidade máxima em vez de esperar as idas e voltas.
• Um pipeline de passagem única - download, verificação e extração se sobrepõem. Os volumes de arquivo são extraídos no fluxo; em uma publicação típica em modo armazenamento, os arquivos RAR nunca tocam seu disco, então o trabalho precisa de 1× o tamanho do lançamento, não 2×, e termina quando o download termina.
• União multiprovedor - cada servidor configurado contribui; um artigo ausente em um backbone é buscado em outro. Servidores lentos ou mortos nunca travam a fila.
• Um orçamento de memória - o motor se adapta a uma cota de RAM limitada e degrada para disco se necessário. Ele nunca faz swap da sua máquina.

Medido contra o mercado em hardware, trabalhos e provedores idênticos, o nzbfast concluiu um download de 190 GB em cerca de 5 minutos em uma linha de 10 GbE - com as principais alternativas 30–220% atrás nos mesmos testes, quando os concluíam. Os números estão na §3.

2 · Início rápido

macOS

1. Abra nzbfast-<version>-macos.dmg e arraste o NzbFast para Aplicativos (universal: Apple Silicon + Intel).
2. Primeira abertura: o macOS avisa que o nzbfast ainda não está autenticado pela Apple. Clique com o botão direito no app → Abrir - ou abra Ajustes do Sistema → Privacidade & Segurança, role para baixo e clique em Abrir Assim Mesmo. Isso é feito uma única vez.
3. A janela do app mostra o painel com um cartão de boas-vindas - clique nele e adicione pelo menos um servidor Usenet (host, porta 563, usuário, senha). Você pode adicionar mais depois em Ajustes.
4. Solte um arquivo .nzb em qualquer lugar do painel - ou simplesmente dê duplo clique em arquivos .nzb no Finder. Os downloads chegam em ~/Downloads/nzbfast. Saia pelo menu; os downloads retomam de onde pararam.

Prefere não usar o app? O zip simples (binário + lançador Start nzbfast.command, mesmo motor) continua funcionando como antes - os passos estão abaixo em "De um terminal".

Windows

1. Execute nzbfast-setup-<version>.exe. Ele instala apenas para o seu usuário (sem senha de administrador). Como esta versão ainda não está assinada, o SmartScreen pode mostrar "O Windows protegeu seu PC" - clique em Mais informações → Executar assim mesmo.
2. O nzbfast fica na bandeja do sistema: dê duplo clique no ícone da bandeja (ou use Abrir painel no menu do botão direito) para abrir o painel, depois adicione seu servidor Usenet pelo cartão de boas-vindas. O menu da bandeja também tem Pausar/Retomar, sua pasta de downloads e Sair.
3. Dar duplo clique em um arquivo .nzb o coloca na fila. O Windows Defender pode perguntar uma vez para permitir a escuta na rede local - permita.

Prefere uma cópia portátil? O -windows-x64.zip continua funcionando: descompacte em qualquer lugar e dê duplo clique em nzbfast.exe (ou Start nzbfast.bat) para o assistente no terminal.

De um terminal (qualquer plataforma)

nzbfast setup            # interactive server setup (writes config.local.json)
nzbfast serve --open     # start the daemon and open the dashboard

3 · Como o nzbfast funciona

Um vocabulário rápido para que o restante do manual seja de leitura fácil:

O pipeline executa download → decodificação → verificação → extração de forma concorrente. O cartão Pipeline do painel mostra as três faixas se movendo ao mesmo tempo. Quando chega o último byte, a verificação já está pronta e o arquivo já está extraído; o tempo de "pós-processamento" de um trabalho típico é zero. Se o reparo for necessário, só então os volumes são materializados em disco, reparados no lugar pelo motor GF(2¹⁶) nativo (dados ofuscados renomeados ou deslocados em bytes são encontrados e adotados por uma varredura deslizante de blocos) e reextraídos - tudo automático.

Downloads interrompidos (travamento, queda de energia, kill -9) retomam a partir do diário de artigos: os bytes já em disco nunca são buscados duas vezes. O diário registra onde os bytes de cada artigo pousaram fisicamente - até os bytes que foram extraídos diretamente no arquivo final - de modo que uma retomada reconstrói a partir do disco local e reverifica tudo que restaurou contra o mapa de blocos PAR2 antes de confiar nele.

Como isso se compara

Medido contra o SABnzbd 5.0.4 e o NZBGet 26.2 na mesma máquina, os mesmos provedores e os mesmos NZBs, cronometrado até um arquivo utilizável - download, verificação, reparo e extração todos incluídos, porque é aí que o trabalho realmente termina:

A diferença é o pós-processamento que os outros ainda têm de fazer depois que o último byte chega. Ambos os concorrentes foram ajustados para a comparação, não deixados no padrão - o SABnzbd em particular vem com o pipeline de solicitações desligado, o que lhe custa caro, então ele foi ligado.

Duas diferenças importam tanto quanto os tempos:

• Espaço em disco. Uma passagem única precisa de 1× o tamanho do lançamento; clientes que escrevem os volumes de arquivo e depois os extraem precisam de 2×. Em uma máquina de teste com 97 GB livres, um trabalho de 87 GB terminou aqui em 3 min 08 s e os outros dois não conseguiram rodar de jeito nenhum.
• Memória. No trabalho de 190 GB, o pico de uso foi de 3,9 GB contra os 9,3 GB do SABnzbd - e o nzbfast fará o mesmo trabalho em cerca de 1 GB se for mandado (veja Orçamento de memória).

4 · O painel

Abra http://localhost:6789 (ou o endereço da sua máquina a partir de outro dispositivo - o layout do celular se adapta automaticamente). Tudo é atualizado ao vivo, uma vez por segundo. Os cartões, de cima para baixo:

Barra de cabeçalho

• Menu de limite de velocidade - tetos fixos, auto · ceder à LAN (um modo regulado por RTT que recua quando outra pessoa na casa precisa da linha) ou ilimitado.
• Pausar por… - pausa tudo por 15 min/30 min/1 h/3 h com retomada automática, ou use o botão Pausar para uma pausa sem prazo. A pausa é imediata: a transferência ativa para em segundos e retoma depois a partir do diário, sem perder nada. (Trabalhos com prioridade Forçar continuam baixando, ao estilo SABnzbd.)
• Um banner de atualização aparece aqui quando uma nova versão está disponível (veja Atualizações).

Vazão

MB/s ao vivo com um gráfico deslizante; as marcas d'água tracejadas indicam os pontos alto/baixo desta sessão, e a linha tênue é uma média móvel. Abaixo dele, um histograma mostra como as amostras de velocidade da sessão se distribuem - típico vs pico. Alargue a janela e os gráficos mostram mais histórico (até uma hora).

Blocos de estatísticas

Baixado nesta sessão, profundidade da fila, contagens de concluídos/falhados, velocidade de pico da sessão.

Recursos - uma máquina, quatro tetos

CPU, RAM (contra o orçamento de memória do nzbfast), taxa de escrita em disco e rede em um único gráfico normalizado, com valores reais na legenda e um aviso de pouco espaço em disco. Nenhum outro cliente NZB mostra isto; existe para provar um ponto - o nzbfast vai saturar sua linha, não sua máquina.

Pipeline - as etapas se sobrepõem

Três faixas: download, verificação (blocos PAR2 verificados), extração. Em um trabalho saudável, as três se movem juntas.

Provedores

Taxa ao vivo por servidor, utilização das conexões, participação no tráfego, GB da sessão e uma pontuação de compleção de artigos acumulada (colorida quando um servidor cai abaixo de 98%). Um gráfico de área empilhada mostra a contribuição de cada provedor ao longo do tempo. As linhas se reordenam por desempenho ao vivo a cada 10 s (configurável em Ajustes → Interface) para que seu provedor mais rápido esteja sempre no topo.

Fila

• Arraste as linhas para reordenar (dentro de uma faixa de prioridade - Forçar/Alta ainda baixam primeiro); altere a prioridade na própria linha.
• Clique em uma linha para a gaveta de detalhes: barras de progresso por arquivo, contagens de blocos verificados e quanto cada servidor contribuiu para este trabalho.
• Emblemas mostram estados especiais: adiado (lento), pré-carregando, pausado (veja Ferramentas de desempenho).
• Um gráfico de contagem regressiva acompanha o total de GB restantes em toda a fila.

Explorar índice

Pesquise tudo o que o indexador integrado catalogou dos seus grupos monitorados (veja Automação) e baixe com um clique - sem necessidade de indexador externo. A linha de status mostra o progresso da varredura; Varrer agora força uma passagem.

Lista de acompanhamento

Adicione títulos pelo nome - inclusive os ainda não publicados. Quando um lançamento correspondente aparece no índice, ele é capturado automaticamente, com preferências de qualidade e regras de melhoria (uma cópia melhor substitui uma pior).

Histórico

Downloads recentes com status, tamanho, local; trabalhos que falharam oferecem Repetir (retoma a partir do diário). Arquivos criptografados mostram um controle de desbloqueio 🔑 - digite a senha e o trabalho termina no lugar. A faixa de saúde da verificação plota os blocos PAR2 defeituosos por download - uma cauda crescente indica que os artigos chegam danificados.

Uso de dados

Barras diárias por provedor e totais de Hoje / 7 dias / 30 dias - essencial para contas medidas e de bloco. Contas de bloco mostram o uso acumulado contra seu tamanho.

Log, Benchmark do sistema, Ajuste de conexões, Diversidade de servidores

Um visualizador de log na página e as três ferramentas de automedição descritas em Ferramentas de desempenho.

5 · Adicionar downloads

Categorias, prioridades, senhas

• Categorias são rótulos livres; cada uma vira uma subpasta da sua pasta de downloads, e as Pastas inteligentes (veja §10) podem atribuí-las por regra.
• Prioridades: Forçar > Alta > Normal > Baixa. Forçar ignora a pausa e a cota.
• Senhas para arquivos criptografados são detectadas automaticamente a partir de <meta type="password"> dentro do NZB ou de um nome de arquivo Name{{password}}.nzb, e podem ser fornecidas por trabalho pela API ou depois pelo Histórico (🔑).

6 · O mural de pôsteres

Clique em 🎬 mural no cabeçalho. O mural transforma seu índice em um navegador de mídia: cada filme e lançamento de TV reconhecido como um bloco de pôster com nota, ano, gêneros, elenco e sinopse - seus newsgroups, navegáveis como um catálogo.

• Separadores de Filmes / Séries / Outros, pesquisa instantânea e sete ordenações: Para você, Publicações mais recentes, Ano de lançamento, Mais bem avaliados, Título A–Z, Maiores e Mais publicados.
• Somente correspondidos vem ligado por padrão, ocultando lixo não identificado; um chip "+N não correspondidos" o revela.
• Clique em um bloco para a folha de detalhes: sinopse, nota e votos do IMDb, elenco - e ▶ Reproduzir (pré-visualize na hora, veja §7) ou ⬇ Baixar.
• ✎ Corrigir correspondência - se um título correspondeu à série ou filme errado, escolha o certo entre pôsteres candidatos, ou digite título/ano/tipo manualmente. O texto manual nunca é sobrescrito pelo enriquecedor. ↻ Atualizar metadados rebusca um título; Ajustes → Indexação pode atualizar todos ou apagar/reconstruir o índice inteiro.
• Os metadados são sem chave por padrão - TVmaze, iTunes, conjuntos de dados do IMDb, Wikidata, Wikipédia e AniList não precisam de contas. Uma chave OMDb (grátis, cadastro só com e-mail - há um ajudante de cadastro em Ajustes → Indexação) melhora a correspondência de filmes; uma chave TMDB é respeitada se você já tiver uma.
• Para você ordena o mural por um perfil de gostos construído nesta máquina a partir do seu próprio histórico concluído e da sua watchlist: géneros preferidos, se pende para cinema ou séries, e mais ou menos que época. Os títulos que já tem descem para o fim em vez de desaparecerem, e uma legenda «Porque você vê …» diz em que se baseou. Sem histórico, recai em Mais publicados, por isso o separador nunca está vazio. Nada disto sai do daemon.
• Sem interesse num cartão esconde esse título, e esconder alguns parecidos ensina o mural: ele propõe um filtro que aceita com um clique («Esconder todos os títulos de Reality a partir de agora?»). Tudo o que escondeu, e cada filtro aprendido, está em Ocultos e filtros e pode ser desfeito aí.
• Um pequeno ponto de disponibilidade num cartão é o veredito do oráculo (§13): um «?» âmbar significa incerto nos seus fornecedores, vermelho que as partes continuam a faltar. Grupos que estão a ser varridos levam um emblema varrido.

7 · Prévia e verificação

Você não precisa esperar um download terminar para saber se é o arquivo certo. Abra-o enquanto ele baixa, confira se o conteúdo, o idioma e a qualidade são o que você esperava, e cancele cedo se não forem - em vez de descobrir depois do download completo.

• ▶ Reproduzir no mural (ou /m3u/<id>) entrega ao seu reprodutor multimídia uma URL; o daemon inicia ou reaproveita o download por trás dela.
• O endpoint /stream/<nzo_id> serve o arquivo com suporte completo a intervalos HTTP enquanto ele baixa. Conferir qualquer ponto funciona: confira direto o minuto 40 e os artigos daquela região são promovidos para o início da fila de download - ele abre ali em alguns segundos em vez de minutos. O início e o fim do arquivo são buscados primeiro para que os reprodutores encontrem seus dados de índice imediatamente.
• Modo biblioteca: categorias listadas em library_cats viram entradas instantâneas apenas de metadados - um arquivo .strm aparece na hora, a disponibilidade é verificada em segundo plano e o download real começa quando você o abre pela primeira vez.

8 · Servidores Usenet

Ajustes → Servidores Usenet é o editor completo: adicionar, editar, remover, reordenar e colocar ou tirar do pool qualquer servidor. Cada servidor tem:

Outras duas opções por servidor ainda não têm controlo no painel: acrescente-as à mão na entrada desse servidor em config.local.json (ver §17) e reinicie.

• A marca ao lado de cada servidor é o seu interruptor: marcada, o servidor está no pool de download; desmarcada, está desativado. Um servidor desativado mantém as credenciais e as definições e continua a poder ser testado; apenas nunca lhe são pedidos artigos. A linha esbate-se, a contagem do cabeçalho (2 de 3 ativos) desce e a alteração aplica-se a partir do próximo download. Útil para poupar uma conta de blocos que estás a guardar, ou para provar que um fornecedor está na origem de um problema sem o apagar.
• Testar faz uma conexão + TLS + login reais e informa o tempo de ida e volta.
• Importar do SABnzbd / NZBGet… varre os locais de instalação usuais, mostra o que encontrou e copia os servidores (ignorando duplicados).
• As edições de servidor se aplicam a partir do próximo download - sem reiniciar.

9 · Referência de ajustes

Quase tudo é configurável a partir do painel, em ⚙ Ajustes; as quatro exceções estão no fim desta secção. Os valores marcados live aplicam-se de imediato; os restart, no arranque seguinte. Cada alteração feita aqui fica guardada em settings.json e sobrevive a reinícios (os valores da interface ganham às opções de linha de comandos).

Velocidade e agendamento ao vivo

Próximo download ao vivo

Conexões (por servidor), janela (profundidade de pipeline por conexão), decodificadores (threads de decodificação em paralelo). Amostrados quando cada trabalho começa. Os padrões são adequados para a maioria das linhas; use as ferramentas de ajuste antes de aumentar às cegas.

Verificação rápida (CRC32) (ligada por omissão) reivindica os blocos PAR2 por CRC32 enquanto o download ainda decorre, o que é 2-3x mais rápido num CPU lento. A soma de verificação de cada artigo continua a ser verificada, e a passagem final usa sempre MD5 completo: não se troca nada em correção. Desmarque para calcular também MD5 por bloco durante o download.

Disco e cota ao vivo

Espaço livre mínimo (pausa novos trabalhos abaixo dele), cota de download por dia ou mês (UTC; trabalhos Forçar a ignoram), limite de memória - o orçamento de RAM do motor (padrão: ¼ da RAM, com limite; aumente-o em uma máquina com muita RAM para velocidade máxima em trabalhos enormes, e veja o que a pouca memória custa antes de reduzi-lo) reiniciar.

Mover concluídos para: após desempacotar, limpar e renomear, os downloads concluídos são movidos para cá - um compartilhamento NAS, uma unidade de mídia, onde quer que viva a sua biblioteca. A estrutura de categorias é mantida (um trabalho que terminou sob tv/ chega sob tv/ no destino), e o histórico acompanha a mudança, então os aplicativos conectados importam e excluem no novo local. Se o destino estiver inacessível quando um trabalho termina (compartilhamento offline, sem espaço), os arquivos ficam na pasta de downloads e o trabalho é concluído normalmente mesmo assim. Vazio = desligado. Os Destinos por categoria mandam categorias específicas para outro lugar (tv=/Volumes/NAS/TV, movies=/Volumes/NAS/Movies); cada caminho listado é a pasta daquela categoria, então nenhuma subpasta de categoria extra é criada dentro dele. As categorias não listadas seguem Mover concluídos para.

Profundidade de arquivos aninhados (5 por omissão) é quantas camadas de arquivo-dentro-de-arquivo são descompactadas automaticamente: um conjunto RAR que contém um 7z que contém outro RAR é normal na Usenet, e o nzbfast segue a cadeia sem uma segunda passagem. No limite, o arquivo mais profundo fica simplesmente onde está, por descompactar, e o download termina à mesma. Só aumente para releases invulgarmente profundas.

Renomeação automática e limpeza live

Renomear downloads concluídos (ligado por omissão) dá à pasta e ao ficheiro principal um nome limpo e informativo: um filme passa a Example Movie (2024) e as séries mantêm Show - S01E02. Nomes ofuscados ou não reconhecidos ficam exatamente como foram publicados, em vez de adivinhados.

Todo o grupo corre depois da reparação e da descompactação e antes de Mover concluídos para, e é saltado por completo num trabalho ainda à espera de palavra-passe. Os dois passos de apagamento aplicam-se apenas a releases reconhecidas como filme ou série: uma carga de software ou um conjunto não classificável (ofuscado) nunca é varrido.

Pastas e processamento

Pasta de downloads reiniciar, pasta monitorada, script de pós-processamento (executado após cada trabalho com argumentos compatíveis com o SABnzbd e ambiente SAB_* - scripts SAB existentes funcionam sem alteração), extensões de limpeza (arquivos de lixo excluídos após a conclusão), Pastas inteligentes e arquivamento de TV (veja §10).

Indexação ao vivo

Biblioteca, Segurança, Interface

Biblioteca: categorias tratadas como entradas de biblioteca instantâneas + intervalo de reverificação. Segurança: a chave de API completa (tudo) e a chave NZB (apenas adição - segura para dar a sites indexadores), ambas rotacionáveis ao vivo. Interface: sons de clique, notificações da área de trabalho na conclusão, intervalo de reordenação de provedores.

Unidades de velocidade live decide como cada velocidade é mostrada no painel: megabytes (MB/s, a norma dos gestores de downloads, o valor por omissão) ou megabits (Mb/s, como os ISP anunciam as linhas). Os tamanhos de ficheiro ficam em bytes. É uma propriedade do daemon, não do seu navegador, por isso aplica-se a todos os dispositivos que olham para esta instalação.

Avançado: ajustes sem controlo no painel

Quatro ajustes não têm controlo na interface nem opção de linha de comandos. Defina-os pela API (§16), p. ex. /api?mode=config&name=verify_mode&value=lean&apikey=…. Como todos os outros, ficam guardados em settings.json.

10 · Automação

Lista de acompanhamento

A automação mais simples: adicione um título no painel, defina as preferências de qualidade, pronto. Novos lançamentos são capturados conforme aparecem nos seus grupos indexados; cópias de melhor qualidade substituem capturas anteriores; uma visão de calendário mostra o que está por vir.

Feeds RSS

Ajustes → RSS: qualquer URL RSS newznab/indexador com intervalo por feed, categoria e regras de filtro (padrões de título, limites de tamanho). Os itens correspondentes são baixados automaticamente.

Pastas inteligentes

Regras avaliadas quando um trabalho é adicionado: correspondência por padrão/palavras-chave e tamanho, atribuir uma categoria (a primeira correspondência vence). Com o arquivamento de TV ligado, episódios de TV concluídos são renomeados e arquivados como Show/Season 01/Show - S01E02.mkv - prontos para Plex/Jellyfin sem uma ferramenta externa.

Agendador

O agendamento semanal (veja §9) automatiza pausar/retomar/velocidade por hora do dia.

Scripts

Um script de pós-processamento recebe os argumentos posicionais do SABnzbd e as variáveis de ambiente SAB_* - o grande ecossistema de scripts SAB roda como está.

11 · Sonarr, Radarr e companhia

O nzbfast fala a API do SABnzbd nativamente, então todo *arr funciona de imediato - e ele também pode atuar como indexador deles.

Como cliente de download

1. No Sonarr/Radarr: Settings → Download Clients → adicione SABnzbd.
2. Host: sua máquina nzbfast · Porta: 6789 · Chave de API: sua chave de API completa (Ajustes → Segurança; o controle de QR/copiar fica ao lado dela).
3. Categoria conforme desejado (ex.: tv / movies). Test → check verde → Save.

Fila, histórico, status por trabalho, "remover e excluir", repetição e roteamento por categoria se comportam como os *arrs esperam.

Como indexador (newznab)

1. Settings → Indexers → adicione Newznab.
2. URL: http://<host>:6789/ · Caminho da API: /api · chave: sua chave de API.
3. O nzbfast serve consultas caps, search, tvsearch e movie a partir de seu próprio índice dos seus grupos monitorados, e /getnzb/<id> devolve o NZB.

12 · Celular e apps remotos

O nzbfast implementa ambos os principais protocolos de controle remoto, então quase todo app de celular/tablet funciona. Escolha o protocolo que seu app suportar:

Apps que falam NZBGet (nzb360, LunaSea, NZB Unity…)

Toda a superfície JSON-RPC que esses apps usam é servida: status, fila com reordenar/pausar/excluir, histórico, adicionar-NZB, limite de velocidade, pausar/retomar, log.

Apps que falam SABnzbd

O painel no seu celular

Basta abrir http://<machine>:6789 em um navegador de celular - todo o painel e o mural têm um layout de toque. O painel Ajustes → Acesso remoto mostra as URLs exatas e um código QR para escanear.

13 · Ferramentas de desempenho

Benchmark do sistema

Um clique mede seus três tetos - vazão de rede (uma sondagem real de 8 segundos com múltiplas conexões), taxa de verificação da CPU e velocidade de escrita em disco - e apresenta a resposta: sua velocidade máxima de download esperada e qual teto é o limite. A barra mais curta é seu gargalo; as outras mostram sua folga. Agende-o (a cada 6 horas → semanal) e cada execução é registrada em uma tabela de histórico, para que você possa ver quando seu provedor, provedor de internet ou hardware mudou de comportamento. Execuções agendadas só acontecem enquanto a fila está ociosa.

Ajuste de conexões

Mede um provedor com números crescentes de conexões e recomenda a configuração - mais sockets ajudam até o provedor ou sua linha saturar, e alguns provedores punem quem pede demais. Testar todos compara cada provedor, depois dispara todos juntos para checar se o conjunto satura sua linha.

Diversidade de servidores

Amostra artigos por STAT em diferentes idades em cada servidor e agrupa provedores por lacunas compartilhadas: provedores com ~100% de artigos ausentes compartilhados são o mesmo backbone (redundantes para recuperação); os independentes realmente ampliam sua cobertura. Termina com uma recomendação em linguagem simples.

Inteligência automática da fila

• Adiar automaticamente: um download arrastando-se em um único servidor lento enquanto outros trabalhos esperam é estacionado no fim (o diário mantém seu progresso) e repetido quando a fila está livre.
• Pré-carga em servidor ocioso: servidores que não podem ajudar o trabalho ativo (suas cópias sumiram) começam a baixar o próximo trabalho da fila enquanto isso. Nenhum outro cliente faz sobreposição entre trabalhos.
• Absorção entre trabalhos: enquanto a cauda de um trabalho concluído (verificação/extração) termina no disco, o download do próximo trabalho já domina a linha.

O oráculo de disponibilidade

As remoções são a principal razão para um download de Usenet falhar, e são previsíveis: a mesma release desaparece de um backbone enquanto outro ainda a tem. O nzbfast mantém um pequeno registo do que os seus próprios fornecedores serviram de facto, e gasta um orçamento mínimo de sondagens STAT em repouso (algumas centenas por hora e por servidor, nunca durante um download) para o manter atual. Nunca descarrega carga útil para isso.

O que ganha com isso:

• Um veredito de disponibilidade nos cartões do mural e nas linhas do índice (§6): «?» âmbar para incerto nos seus fornecedores, vermelho para perdido com confiança. Sem marca, parece estar bem.
• Um emblema varrido nos grupos onde as publicações recentes já estão a ser retiradas, para distinguir um grupo a morrer de uma release azarada.
• Pular provedores que o oráculo dá como perdidos (Ajustes, desligado por omissão, experimental): quando a verificação tem a certeza de que o backbone de um fornecedor perdeu uma release, salta-o já nesse download em vez de esperar que falhe. Nunca saltará o seu último fornecedor.

O veredito é uma previsão a partir de indícios, não uma garantia. Para uma resposta firme sobre um NZB, nzbfast check (§15) conta os artigos reais.

Orçamento de memória - e o que a pouca memória custa

Todos os caches do motor compartilham um orçamento (padrão ¼ da RAM física, limitado a 256 MB–16 GB). Defina-o explicitamente com o Limite de memória em Ajustes, ou --mem-limit na linha de comando.

O nzbfast é construído para saturar sua rede e seu disco ao mesmo tempo, e a RAM é o que permite fazer os dois em uma única passagem: os artigos são decodificados, verificados e escritos direto em seus deslocamentos finais, de modo que os volumes de arquivo nunca precisam tocar o disco. Prive-o de memória e nada quebra - cada cache tem um caminho de spill, e o motor degrada para mais E/S de disco em vez de fazer swap ou falhar. Mas esse spill não é grátis, e em trabalhos grandes você consegue medi-lo.

Medido em uma máquina e uma linha (M1 Ultra, 10 GbE), os mesmos arquivos em cada orçamento. Cada execução produziu um resultado correto, totalmente verificado e extraído:

O pico de memória acompanha o orçamento, não o trabalho: aquele download de 190 GB termina em cerca de 1,1 GB de RAM. O que você troca por isso é tempo - e só em trabalhos grandes.

• Até ~35 GB, pouca memória é de graça. O conjunto de trabalho cabe de qualquer forma, então uma máquina de 4 GB termina esse trabalho tão rápido quanto uma de 64 GB.
• Acima de ~87 GB você paga 20–40% - mas só quando sua linha supera seu disco. Blocos de verificação e volumes de arquivo que teriam ficado na RAM são escritos e lidos de volta, e isso só custa tempo se a rede puder entregar mais rápido do que o disco consegue absorver o tráfego extra. Os 20–40% acima foram medidos em 10 GbE; o mesmo trabalho de 87 GB nos mesmos orçamentos em uma linha de ~2,4 Gbps não mostrou penalidade nenhuma (−1 a +7%, dentro do ruído entre execuções). A penalidade é função de quanto a linha supera o disco, não do tamanho do trabalho - em uma conexão doméstica típica, um orçamento pequeno é quase de graça mesmo em trabalhos muito grandes.
• A penalidade se estabiliza. Uma vez que um trabalho seja grande o bastante para dar spill, todo orçamento limitado dá spill de mais ou menos a mesma quantidade - as execuções de 2 GB, 1 GB e 256 MB leem de volta essencialmente o mesmo número de blocos do disco e terminam dentro do ruído umas das outras. Então um pouco mais de RAM abaixo do limiar que evita o spill por completo não recompra o custo: dê o suficiente para manter o trabalho na memória, ou o número exato quase não importa.

Em um NAS pequeno, reduza também as Conexões (2–4) junto com o orçamento. Com um orçamento de 256 MB e 2 conexões, o pico de memória fica perto de 190 MB - confortavelmente dentro do que um NAS de 2 GB tem de sobra. Saiba que, nesse ponto, a contagem de conexões, não a memória, é o que limita você: o mesmo trabalho de 35 GB levou 286 s em vez de 65 s. Essa é a forma honesta da troca - sempre terminará, e terminará corretamente; só não vai saturar a linha.

Os benchmarks são refeitos a cada versão; método e números por máquina são publicados junto com os resultados.

14 · Atualizações

• As atualizações são apenas aviso: o nzbfast nunca baixa nem substitui o próprio binário, e não há nele código capaz disso. Quando existe uma versão nova, o cabeçalho mostra ⬆ v X disponível - baixar; o chip leva à página de download oficial (o link é fixo no aplicativo, nunca vem do manifesto de atualização). Instale a versão nova do mesmo jeito que instalou a atual.
• O nzbfast verifica novas versões duas vezes por dia. Desligue Verificar atualizações (Configurações) e ele não contata mais o manifesto de atualização; uma URL de verificação vazia faz o mesmo.

15 · Linha de comando

Tudo o que o daemon faz também é programável por script. Os comandos do dia a dia:

Também disponíveis: inspect, probe, bench, bench-cpu, soak, fetch, spots/spot-search/spot-get (Spotnet), make-release-nzb/make-test-nzb (fixtures de teste). Cada comando aceita --config e --help. Junta-se-lhes post: carrega ficheiros como artigos yEnc e escreve o NZB correspondente. É uma ferramenta de operação, exige um --post-server explícito e nunca escolhe um servidor por si.

16 · Visão geral da API

Endpoint base: http://host:6789/api?mode=…&apikey=…&output=json - compatível com o SABnzbd, então integrações SAB existentes funcionam sem alteração. Duas chaves: a chave de API (controle total) e a chave NZB (apenas adição: addfile/addurl).

17 · Arquivos e locais

18 · Solução de problemas

nzbfast - este manual acompanha cada versão. Ajustes, endpoints e padrões aqui referenciados correspondem à versão com que ele foi entregue.