⚡ nzbfast

El descargador de Usenet rápido - manual de usuario

1 · Bienvenida

nzbfast descarga de Usenet tan rápido como lo permiten tu línea, tus proveedores y tu máquina - y normalmente eso significa tan rápido como tu línea. Es un único programa autocontenido: el motor, un panel web, un explorador multimedia con muro de pósteres, un indexador integrado, vista previa en tiempo real, reparación PAR2 nativa y extracción RAR nativa van todos dentro de un solo ejecutable. No hay nada más que instalar.

Lo que lo hace rápido es la arquitectura, no los retoques:

• NNTP con pipelining - muchas peticiones de artículos viajan encadenadas por cada conexión, manteniendo todas las conexiones a plena velocidad en lugar de esperar los viajes de ida y vuelta.
• Un pipeline de una sola pasada - descarga, verificación y extracción se solapan. Los volúmenes de archivo se extraen en el propio flujo; en una publicación típica en modo store los archivos RAR nunca tocan tu disco, así que el trabajo necesita 1× el tamaño del lanzamiento, no 2×, y termina cuando termina la descarga.
• Unión multiproveedor - todos los servidores configurados contribuyen; un artículo que falta en un backbone se obtiene de otro. Los servidores lentos o caídos nunca atascan la cola.
• Un presupuesto de memoria - el motor se adapta a una asignación de RAM acotada y degrada a disco si hace falta. Nunca pone tu máquina a hacer swap.

Medido contra la competencia con hardware, trabajos y proveedores idénticos, nzbfast ha terminado una descarga de 190 GB en unos 5 minutos por una línea 10 GbE - con las alternativas líderes un 30–220% por detrás en las mismas pruebas, cuando llegaban a completarlas. Las cifras están en §3.

2 · Inicio rápido

macOS

1. Abre nzbfast-<version>-macos.dmg y arrastra NzbFast a Aplicaciones (universal: Apple Silicon + Intel).
2. Primer arranque: macOS avisa de que nzbfast aún no está notarizado por Apple. Haz clic derecho en la app → Abrir - o abre Ajustes del Sistema → Privacidad y seguridad, baja hasta el final y pulsa Abrir igualmente. Es un paso único.
3. La ventana de la app muestra el panel con una tarjeta de bienvenida - haz clic en ella y añade al menos un servidor Usenet (host, puerto 563, usuario, contraseña). Puedes añadir más después en Ajustes.
4. Suelta un .nzb en cualquier parte del panel - o simplemente haz doble clic en los archivos .nzb en el Finder. Las descargas quedan en ~/Downloads/nzbfast. Sal desde el menú; las descargas se reanudan donde quedaron.

¿Prefieres prescindir de la app? El zip básico (binario + lanzador Start nzbfast.command, el mismo motor) sigue funcionando como siempre - pasos más abajo en «Desde un terminal».

Windows

1. Ejecuta nzbfast-setup-<version>.exe. Se instala solo para tu usuario (sin contraseña de administrador). Como esta versión aún no está firmada digitalmente, SmartScreen puede mostrar «Windows protegió tu PC» - haz clic en Más información → Ejecutar de todas formas.
2. nzbfast vive en la bandeja del sistema: haz doble clic en el icono de la bandeja (o usa Abrir panel en su menú contextual) para abrir el panel, y añade tu servidor Usenet desde la tarjeta de bienvenida. El menú de la bandeja también tiene Pausar/Reanudar, tu carpeta de descargas y Salir.
3. Hacer doble clic en un archivo .nzb lo pone en cola. Windows Defender puede pedir permiso una vez para escuchar en la red local - permítelo.

¿Prefieres una copia portátil? El -windows-x64.zip sigue funcionando: descomprímelo donde quieras y haz doble clic en nzbfast.exe (o Start nzbfast.bat) para el asistente en el terminal.

Desde un terminal (cualquier plataforma)

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

3 · Cómo funciona nzbfast

Un vocabulario rápido para que el resto del manual se lea con fluidez:

El pipeline ejecuta descarga → decodificación → verificación → extracción de forma concurrente. La tarjeta Pipeline del panel muestra los tres carriles avanzando a la vez. Cuando llega el último byte, la verificación ya está hecha y el archivo ya está extraído; el tiempo de «posprocesado» de un trabajo típico es cero. Si hace falta reparar, solo entonces se materializan los volúmenes en disco, se reparan in situ con el motor nativo GF(2¹⁶) (los datos ofuscados renombrados o desplazados a nivel de byte se localizan y adoptan mediante un escaneo de bloques deslizante) y se vuelven a extraer - todo automático.

Las descargas interrumpidas (cuelgue, corte de luz, kill -9) se reanudan desde el diario de artículos: los bytes ya en disco nunca se descargan dos veces. El diario registra dónde aterrizaron físicamente los bytes de cada artículo - incluso los bytes extraídos directamente al archivo final - de modo que una reanudación reconstruye desde el disco local y vuelve a verificar todo lo restaurado contra el mapa de bloques PAR2 antes de fiarse de ello.

La comparación

Medido contra SABnzbd 5.0.4 y NZBGet 26.2 en la misma máquina, con los mismos proveedores y los mismos NZB, cronometrado hasta el archivo usable - descarga, verificación, reparación y extracción incluidas, porque ese es el momento en que el trabajo está realmente terminado:

La diferencia es el posprocesado que los demás aún tienen que hacer después de que aterrice el último byte. Ambos competidores se ajustaron para la comparación, no se dejaron con los valores por defecto - SABnzbd en particular viene de fábrica con el pipelining de peticiones desactivado, lo que le cuesta caro, así que se activó.

Dos diferencias importan tanto como los tiempos:

• Espacio en disco. Una sola pasada necesita 1× el tamaño del lanzamiento; los clientes que escriben los volúmenes de archivo y luego los desempaquetan necesitan 2×. En una máquina de prueba con 97 GB libres, un trabajo de 87 GB terminó aquí en 3 m 08 s y los otros dos no pudieron ejecutarse siquiera.
• Memoria. En el trabajo de 190 GB, el pico de uso fue de 3.9 GB frente a los 9.3 GB de SABnzbd - y nzbfast hace el mismo trabajo en aproximadamente 1 GB si se le pide (ver Presupuesto de memoria).

4 · El panel

Abre http://localhost:6789 (o la dirección de tu máquina desde otro dispositivo - el diseño para el teléfono se adapta automáticamente). Todo se actualiza en vivo, una vez por segundo. Las tarjetas, de arriba abajo:

Barra superior

• Menú de Límite de velocidad - topes fijos, auto · cede a la LAN (un modo regulado por RTT que se retira cuando alguien más en casa necesita la línea), o sin límite.
• Pausar durante… - pausa todo durante 15 min/30 min/1 h/3 h con reanudación automática, o usa el botón Pausar para una pausa indefinida. La pausa es inmediata: la transferencia activa se detiene en segundos y se reanuda después desde el diario, sin perder nada. (Los trabajos con prioridad Forzar siguen descargando, al estilo SABnzbd.)
• Aquí aparece un aviso de actualización cuando hay una versión nueva disponible (ver Actualizaciones).

Velocidad

MB/s en vivo con un gráfico deslizante; las marcas de agua discontinuas señalan el máximo/mínimo de esta sesión, la línea tenue es una media móvil. Debajo, un histograma muestra cómo se distribuyen las muestras de velocidad de la sesión - típico vs pico. Ensancha la ventana y los gráficos muestran más historia (hasta una hora).

Mosaicos de estadísticas

Descargado esta sesión, profundidad de la cola, recuentos de completadas/fallidas, velocidad pico de la sesión.

Recursos - una máquina, cuatro techos

CPU, RAM (contra el presupuesto de memoria de nzbfast), tasa de escritura en disco y red en un gráfico normalizado, con los valores reales en la leyenda y un aviso de poco espacio en disco. Ningún otro cliente NZB te enseña esto; existe para demostrar algo - nzbfast saturará tu línea, no tu máquina.

Pipeline - las etapas se solapan

Tres carriles: descarga, verificación (bloques PAR2 comprobados), extracción. En un trabajo sano los tres avanzan a la vez.

Proveedores

Velocidad en vivo por servidor, utilización de conexiones, cuota de tráfico, GB de la sesión y una puntuación de compleción de artículos de por vida (coloreada cuando un servidor baja del 98%). Un gráfico de áreas apiladas muestra la contribución de cada proveedor a lo largo del tiempo. Las filas se reordenan por rendimiento en vivo cada 10 s (configurable en Ajustes → Interfaz) para que tu proveedor más rápido esté siempre arriba.

Cola

• Arrastra las filas para reordenar (dentro de una banda de prioridad - Forzar/Alta siguen yendo primero); cambia la prioridad en línea.
• Haz clic en una fila para el panel de detalle: barras de progreso por archivo, recuentos de bloques verificados y qué servidor aportó cuánto a este trabajo.
• Las insignias muestran estados especiales: aplazado (lento), precargando, en pausa (ver Herramientas de rendimiento).
• Un gráfico de cuenta atrás sigue los GB totales restantes en toda la cola.

Explorar índice

Busca en todo lo que el indexador integrado ha catalogado de tus grupos vigilados (ver Automatización) y descarga con un clic - sin necesidad de indexador externo. La línea de estado muestra el progreso del escaneo; Escanear ahora fuerza una pasada.

Lista de seguimiento

Añade títulos por nombre - incluidos los que aún no se han publicado. Cuando un lanzamiento coincidente aparece en el índice se captura automáticamente, con preferencias de calidad y reglas de mejora (una copia mejor reemplaza a una peor).

Historial

Descargas recientes con estado, tamaño y ubicación; los trabajos fallidos ofrecen Reintentar (reanuda desde el diario). Los archivos cifrados muestran un control de desbloqueo 🔑 - introduce la contraseña y el trabajo termina in situ. La franja de salud de verificación grafica los bloques PAR2 dañados por descarga - una cola ascendente indica que los artículos llegan dañados.

Uso de datos

Barras diarias por proveedor y totales de Hoy / 7 días / 30 días - esencial para cuentas medidas y de bloque. Las cuentas de bloque muestran el uso acumulado contra su tamaño.

Registro, Benchmark del sistema, Ajuste de conexiones, Diversidad de servidores

Un visor de registro integrado en la página, y las tres herramientas de automedición descritas en Herramientas de rendimiento.

5 · Añadir descargas

Categorías, prioridades, contraseñas

• Las categorías son etiquetas libres; cada una se convierte en una subcarpeta de tu carpeta de descargas, y las Carpetas inteligentes (ver §10) pueden asignarlas por regla.
• Prioridades: Forzar > Alta > Normal > Baja. Forzar se salta la pausa y la cuota.
• Las contraseñas de los archivos cifrados se recogen automáticamente de <meta type="password"> dentro del NZB o de un nombre de archivo Name{{password}}.nzb, y pueden facilitarse por trabajo a través de la API o después desde el Historial (🔑).

6 · El muro de pósteres

Haz clic en 🎬 muro en la barra superior. El muro convierte tu índice en un explorador multimedia: cada película y lanzamiento de TV reconocido como un mosaico de póster con valoración, año, géneros, reparto y sinopsis - tus newsgroups, navegables como un catálogo.

• Pestañas de Películas / Series / Otros, búsqueda instantánea y siete ordenaciones: Para ti, Más recientes, Año de estreno, Mejor valorados, Título A–Z, Más grandes y Más publicados.
• Solo emparejados está activado por defecto y oculta la morralla sin identificar; un chip «+N sin emparejar» la revela.
• Haz clic en un mosaico para la ficha de detalle: sinopsis, valoración y votos de IMDb, reparto - y ▶ Reproducir (vista previa inmediata, ver §7) o ⬇ Descargar.
• ✎ Corregir coincidencia - si un título se emparejó con la serie o película equivocada, elige la correcta entre los pósteres candidatos, o introduce título/año/tipo a mano. El texto manual no lo sobrescribe nunca el enriquecedor. ↻ Actualizar metadatos vuelve a obtener un título; Ajustes → Indexación puede actualizarlos todos o borrar/reconstruir el índice entero.
• Los metadatos van sin clave por defecto - TVmaze, iTunes, los datasets de IMDb, Wikidata, Wikipedia y AniList no requieren cuentas. Una clave OMDb (gratis, alta solo con correo - hay un asistente de alta en Ajustes → Indexación) mejora el emparejado de películas; una clave TMDB se respeta si ya la tienes.
• Para ti ordena el muro según un perfil de gustos construido en esta máquina a partir de tu propio historial completado y tu lista de seguimiento: géneros favoritos, si te inclinas por cine o por series, y aproximadamente qué época. Los títulos que ya tienes se hunden al final en lugar de desaparecer, y un pie «Porque ves …» dice en qué se ha fijado. Sin historial vuelve a Más publicados, así que la pestaña nunca está vacía. Nada de esto sale del daemon.
• No me interesa en cualquier ficha oculta ese título, y ocultar unos cuantos parecidos le enseña al muro: te ofrece un filtro de un solo clic («¿Ocultar todos los títulos de Telerrealidad a partir de ahora?»). Todo lo oculto, y cada filtro aprendido, aparece en Ocultos y filtros y se puede deshacer allí.
• Un pequeño punto de disponibilidad en una ficha es el veredicto del oráculo (§13): un «?» ámbar significa incierto en tus proveedores; rojo, que sus partes siguen faltando. Los grupos que se están purgando llevan una insignia de purgado.

7 · Vista previa y verificación

No hace falta esperar a que termine una descarga para saber si es el archivo correcto. Ábrelo mientras se descarga, comprueba que el contenido, el idioma y la calidad son los que esperabas, y cancélala pronto si no lo son - en vez de descubrirlo después de la descarga completa.

• ▶ Reproducir en el muro (o /m3u/<id>) entrega a tu reproductor multimedia una URL; el daemon inicia o reutiliza la descarga que hay detrás.
• El endpoint /stream/<nzo_id> sirve el archivo con soporte completo de rangos HTTP mientras se descarga. Comprobar cualquier punto funciona: comprueba directamente el minuto 40 y los artículos de esa región se promueven al frente de la cola de descarga - se abre ahí en un par de segundos en lugar de minutos. La cabeza y la cola del archivo se obtienen primero para que los reproductores encuentren de inmediato sus datos de índice.
• Modo biblioteca: las categorías listadas en library_cats se convierten en entradas instantáneas solo de metadatos - aparece al momento un archivo .strm, la disponibilidad se verifica en segundo plano y la descarga real empieza cuando lo abres por primera vez.

8 · Servidores Usenet

Ajustes → Servidores Usenet es el editor completo: añadir, editar, eliminar, reordenar y meter o sacar del pool cualquier servidor. Cada servidor tiene:

Otras dos opciones por servidor todavía no tienen control en el panel: añádelas a mano en la entrada de ese servidor dentro de config.local.json (véase §17) y reinicia.

• La casilla junto a cada servidor es su interruptor: marcada, el servidor está en el pool de descarga; sin marcar, está desactivado. Un servidor desactivado conserva sus credenciales y ajustes y se puede seguir probando; simplemente nunca se le piden artículos. Su fila se atenúa, el recuento del encabezado (2 de 3 activos) baja y el cambio se aplica desde la siguiente descarga. Útil para reservar una cuenta de bloque que estás guardando, o para demostrar que un proveedor causa un problema sin borrarlo.
• Probar hace una conexión real + TLS + inicio de sesión e informa del tiempo de ida y vuelta.
• Importar de SABnzbd / NZBGet… escanea las ubicaciones de instalación habituales, muestra lo que encontró y copia los servidores (omitiendo duplicados).
• Los cambios de servidor se aplican desde la próxima descarga - sin reiniciar.

9 · Referencia de ajustes

Casi todo se configura desde el panel, en ⚙ Ajustes; las cuatro excepciones están al final de esta sección. Los valores marcados live se aplican al momento; los restart, en el siguiente arranque. Cada cambio hecho aquí se guarda en settings.json y sobrevive a los reinicios (los valores de la interfaz ganan a las opciones de línea de comandos).

Velocidad y programación en directo

Próxima descarga en directo

Conexiones (por servidor), ventana (profundidad de pipelining por conexión), decodificadores (hilos de decodificación en paralelo). Se muestrean al empezar cada trabajo. Los valores por defecto son correctos para la mayoría de las líneas; usa las herramientas de ajuste antes de subirlos a ciegas.

Verificación rápida (CRC32) (activada por defecto) reclama los bloques PAR2 por CRC32 mientras la descarga sigue en marcha, lo que es 2-3x más rápido en una CPU lenta. La suma de comprobación propia de cada artículo se sigue verificando, y la pasada final siempre usa MD5 completo: no se sacrifica exactitud. Desmárcala para calcular también MD5 por bloque durante la descarga.

Disco y cuota en directo

Espacio libre mínimo (pausa los trabajos nuevos por debajo), cuota de descarga por día o mes (UTC; los trabajos Forzar la omiten), presupuesto de memoria - el tope de RAM del motor (por defecto: ¼ de la RAM, acotado; súbelo en una máquina con mucha RAM para máxima velocidad en trabajos enormes, y consulta lo que cuesta la memoria escasa antes de bajarlo) tras reiniciar.

Mover las completadas a: tras desempaquetar, limpiar y renombrar, las descargas terminadas se mueven aquí - un recurso NAS, un disco multimedia, donde viva tu biblioteca. La estructura de categorías se conserva (un trabajo que terminó bajo tv/ llega bajo tv/ en el destino), y el historial sigue al movimiento, así que las aplicaciones conectadas importan y borran en la nueva ubicación. Si el destino no está accesible cuando termina un trabajo (recurso sin conexión, sin espacio), los archivos se quedan en la carpeta de descargas y el trabajo se completa igualmente con normalidad. Vacío = desactivado. Los Destinos por categoría envían categorías concretas a otro lugar (tv=/Volumes/NAS/TV, movies=/Volumes/NAS/Movies); cada ruta listada es la carpeta de esa categoría, así que dentro no se crea ninguna subcarpeta de categoría extra. Las categorías no listadas siguen Mover las completadas a.

Profundidad de archivos anidados (5 por defecto) es cuántas capas de archivo-dentro-de-archivo se descomprimen automáticamente: un conjunto RAR que contiene un 7z que contiene otro RAR es normal en Usenet, y nzbfast sigue la cadena sin una segunda pasada. En el límite, el archivo más profundo simplemente se deja donde está, sin descomprimir, y la descarga termina igualmente. Súbelo solo para releases inusualmente profundas.

Renombrado automático y limpieza live

Renombrar las descargas terminadas (activado por defecto) le da a la carpeta y al archivo principal un nombre limpio e informativo: una película pasa a ser Example Movie (2024) y las series mantienen Show - S01E02. Los nombres ofuscados o no reconocidos se dejan exactamente como se publicaron en lugar de adivinarlos.

Todo el grupo actúa después de reparar y descomprimir y antes de Mover las completadas a, y se salta por completo en un trabajo que aún espera contraseña. Los dos pasos de borrado se aplican solo a releases reconocidas como cine o series: una carga de software o un conjunto inclasificable (ofuscado) no se limpia nunca.

Carpetas y procesado

Carpeta de descargas tras reiniciar, carpeta vigilada, script de posprocesado (se ejecuta tras cada trabajo con argumentos compatibles con SABnzbd y entorno SAB_* - los scripts de SAB existentes funcionan sin cambios), extensiones de limpieza (archivos residuales borrados al terminar), Carpetas inteligentes y archivado de TV (ver §10).

Indexación en directo

Biblioteca, Seguridad, Interfaz

Biblioteca: categorías tratadas como entradas de biblioteca instantáneas + intervalo de reverificación. Seguridad: la clave API completa (todo) y la clave NZB (solo añadir - segura para dársela a sitios de indexadores), ambas rotables en caliente. Interfaz: sonidos de pulsación, notificaciones de escritorio al terminar, intervalo de reordenación de proveedores.

Unidades de velocidad live decide cómo se muestra cada velocidad del panel: megabytes (MB/s, la norma de los gestores de descargas, el valor por defecto) o megabits (Mb/s, como los ISP anuncian las líneas). Los tamaños de archivo siguen en bytes. Es una propiedad del daemon, no de tu navegador, así que se aplica a todos los dispositivos que miran esta instalación.

Avanzado: ajustes sin control en el panel

Cuatro ajustes no tienen control en la interfaz ni opción de línea de comandos. Configúralos por la API (§16), p. ej. /api?mode=config&name=verify_mode&value=lean&apikey=…. Como todos los demás, quedan guardados en settings.json.

10 · Automatización

Lista de seguimiento

La automatización más simple: añade un título en el panel, fija las preferencias de calidad y listo. Los lanzamientos nuevos se capturan según aparecen en tus grupos indexados; las copias de mejor calidad mejoran capturas anteriores; una vista de calendario muestra lo que viene.

Feeds RSS

Ajustes → RSS: cualquier URL RSS newznab/de indexador con intervalo por feed, categoría y reglas de filtrado (patrones de título, límites de tamaño). Los elementos que coinciden se descargan automáticamente.

Carpetas inteligentes

Reglas evaluadas al añadir un trabajo: coincidencia por patrón/palabras clave y tamaño, asignación de categoría (gana la primera coincidencia). Con el archivado de TV activado, los episodios de TV terminados se renombran y archivan como Show/Season 01/Show - S01E02.mkv - listos para plex/Jellyfin sin herramienta externa.

Programador

La programación semanal (ver §9) automatiza pausa/reanudación/velocidad según la hora del día.

Scripts

Un script de posprocesado recibe los argumentos posicionales de SABnzbd y las variables de entorno SAB_* - el amplio ecosistema de scripts de SAB funciona tal cual.

11 · Sonarr, Radarr y compañía

nzbfast habla la API de SABnzbd de forma nativa, así que todos los *arr funcionan de serie - y también puede actuar como su indexador.

Como cliente de descarga

1. En Sonarr/Radarr: Settings → Download Clients → añade SABnzbd.
2. Host: tu máquina con nzbfast · Puerto: 6789 · Clave API: tu clave API completa (Ajustes → Seguridad; el control de QR/copiar está al lado).
3. La categoría, a tu gusto (p. ej. tv / movies). Test → marca verde → Save.

Cola, historial, estado por trabajo, «quitar y borrar», reintentos y enrutado por categorías: todo se comporta como esperan los *arr.

Como indexador (newznab)

1. Settings → Indexers → añade Newznab.
2. URL: http://<host>:6789/ · ruta de la API: /api · clave: tu clave API.
3. nzbfast sirve las consultas caps, search, tvsearch y movie desde su propio índice de tus grupos vigilados, y /getnzb/<id> devuelve el NZB.

12 · Móvil y apps remotas

nzbfast implementa los dos grandes protocolos de control remoto, así que casi cualquier app de móvil/tableta funciona. Elige el protocolo que soporte tu app:

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

Se sirve toda la superficie JSON-RPC que usan estas apps: estado, cola con reordenar/pausar/borrar, historial, añadir NZB, límite de velocidad, pausa/reanudación, registro.

Apps que hablan SABnzbd

El panel en tu teléfono

Basta con abrir http://<machine>:6789 en un navegador móvil - el panel entero y el muro tienen un diseño táctil. El panel de Ajustes → Acceso remoto muestra las URLs exactas y un código QR para escanear.

13 · Herramientas de rendimiento

Benchmark del sistema

Un clic mide tus tres techos - velocidad de red (una sonda multiconexión real de 8 segundos), tasa de verificación de la CPU y velocidad de escritura en disco - y abre con la respuesta: tu velocidad máxima de descarga esperada y qué techo es el límite. La barra más corta es tu cuello de botella; las demás muestran su margen. Prográmalo (de cada 6 h a semanal) y cada ejecución queda registrada en una tabla de historial, de modo que puedes ver cuándo cambió el comportamiento de tu proveedor, tu ISP o tu hardware. Las ejecuciones programadas solo ocurren con la cola inactiva.

Ajuste de conexiones

Mide un proveedor con números de conexiones crecientes y recomienda el ajuste - más sockets ayudan hasta que el proveedor o tu línea se saturan, y algunos proveedores castigan pedir de más. Probar todos compara cada proveedor y luego los lanza todos juntos para comprobar si el conjunto satura tu línea.

Diversidad de servidores

Muestrea artículos con STAT en distintas antigüedades en cada servidor y agrupa los proveedores por huecos compartidos: los proveedores con ~100% de artículos ausentes compartidos son el mismo backbone (redundante para la recuperación); los independientes amplían de verdad tu cobertura. Termina con una recomendación en lenguaje llano.

Inteligencia automática de la cola

• Aplazamiento automático: una descarga que renquea en un único servidor lento mientras otros trabajos esperan se aparca al final (el diario conserva su progreso) y se reintenta cuando la cola queda libre.
• Precarga en servidores inactivos: los servidores que no pueden ayudar al trabajo activo (sus copias ya no existen) empiezan a descargar entretanto el siguiente trabajo en cola. Ningún otro cliente solapa trabajos entre sí.
• Solape entre trabajos: mientras el tramo final de un trabajo terminado (verificación/extracción) se completa en disco, la descarga del siguiente trabajo ya es dueña de la línea.

El oráculo de disponibilidad

Las retiradas son el motivo principal de que falle una descarga de Usenet, y son predecibles: la misma release desaparece de un backbone mientras otro todavía la tiene. nzbfast lleva un pequeño registro de lo que tus propios proveedores han servido de verdad, y gasta un presupuesto mínimo de sondeos STAT en reposo (unos cientos por hora y servidor, nunca durante una descarga) para mantenerlo al día. Nunca descarga carga útil para averiguarlo.

Lo que sacas de ello:

• Un veredicto de disponibilidad en las fichas del muro y en las filas del índice (§6): «?» ámbar para incierto en tus proveedores, rojo para perdido con seguridad. Sin marca, tiene buena pinta.
• Una insignia de purgado en los grupos donde las publicaciones recientes ya se están retirando, para distinguir un grupo agonizante de una release con mala suerte.
• Omitir los proveedores que el oráculo da por perdidos (Ajustes, desactivado por defecto, experimental): cuando la comprobación tiene la certeza de que el backbone de un proveedor ha perdido una release, se lo salta directamente en esa descarga en lugar de esperar a que falle. Nunca omitirá tu último proveedor.

El veredicto es una predicción a partir de indicios, no una garantía. Para una respuesta firme sobre un NZB, nzbfast check (§15) cuenta los artículos reales.

Presupuesto de memoria - y lo que cuesta la memoria escasa

Todas las cachés del motor comparten un presupuesto (por defecto ¼ de la RAM física, acotado a 256 MB–16 GB). Fíjalo explícitamente con Presupuesto de memoria en Ajustes, o con --mem-limit en la línea de comandos.

nzbfast está hecho para saturar tu red y tu disco al mismo tiempo, y la RAM es lo que le permite hacer ambas cosas en una sola pasada: los artículos se decodifican, verifican y escriben directamente en sus offsets finales, de modo que los volúmenes de archivo no necesitan tocar el disco jamás. Escatímale memoria y nada se rompe - cada caché tiene una vía de desbordamiento, y el motor degrada a más E/S de disco en lugar de hacer swap o fallar. Pero ese desbordamiento no es gratis, y en trabajos grandes se puede medir.

Medido en una máquina y una línea (M1 Ultra, 10 GbE), los mismos archivos con cada presupuesto. Todas las ejecuciones produjeron un resultado correcto, totalmente verificado y extraído:

El pico de memoria sigue al presupuesto, no al trabajo: esa descarga de 190 GB se completa en aproximadamente 1.1 GB de RAM. Lo que se paga a cambio es tiempo - y solo en trabajos grandes.

• Hasta ~35 GB, la memoria escasa sale gratis. El conjunto de trabajo cabe de todos modos, así que una máquina de 4 GB termina un trabajo así tan rápido como una de 64 GB.
• Pasados los ~87 GB pagas un 20–40% - pero solo cuando tu línea supera a tu disco. Los bloques de verificación y los volúmenes de archivo que se habrían quedado en RAM se escriben y se vuelven a leer, y eso solo cuesta tiempo si la red puede entregar más rápido de lo que el disco puede absorber el tráfico extra. El 20–40% de arriba se midió en 10 GbE; el mismo trabajo de 87 GB con los mismos presupuestos en una línea de ~2.4 Gbps no mostró penalización alguna (de −1 a +7%, dentro del ruido entre ejecuciones). La penalización es función de cuánto supera la línea al disco, no del tamaño del trabajo - en una conexión doméstica típica un presupuesto pequeño sale casi gratis incluso en trabajos muy grandes.
• La penalización se estabiliza. Cuando un trabajo es lo bastante grande para desbordar, todos los presupuestos restringidos desbordan más o menos lo mismo - las ejecuciones de 2 GB, 1 GB y 256 MB releyeron esencialmente el mismo número de bloques del disco y terminaron dentro del ruido entre sí. Así que un poco más de RAM por debajo del umbral que evita el desbordamiento por completo no recompra el coste: dale lo suficiente para mantener el trabajo en memoria, o la cifra exacta apenas importa.

En un NAS pequeño, baja también las Conexiones (2–4) junto con el presupuesto. Con un presupuesto de 256 MB y 2 conexiones, el pico de memoria se queda cerca de 190 MB - holgadamente dentro de lo que le sobra a un NAS de 2 GB. Ten en cuenta que en ese punto lo que te limita es el número de conexiones, no la memoria: el mismo trabajo de 35 GB tardó 286 s en vez de 65 s. Esa es la forma honesta del compromiso - siempre terminará, y terminará correctamente; simplemente no saturará la línea.

Los benchmarks se repiten en cada versión; el método y las cifras por máquina se publican junto a los resultados.

14 · Actualizaciones

• Las actualizaciones son solo aviso: nzbfast nunca descarga ni reemplaza su propio binario, y no contiene código capaz de hacerlo. Cuando existe una versión nueva, la cabecera muestra ⬆ v X disponible - descargar; el chip lleva a la página de descargas oficial (el enlace está fijado en la aplicación, nunca viene del manifiesto de actualizaciones). Instala la versión nueva igual que instalaste la actual.
• nzbfast comprueba si hay versiones nuevas dos veces al día. Desactiva Comprobar actualizaciones (Ajustes) y no contactará en absoluto con el manifiesto de actualizaciones; una URL de comprobación vacía hace lo mismo.

15 · Línea de comandos

Todo lo que hace el daemon también se puede automatizar con scripts. Los comandos del día a día:

También disponibles: inspect, probe, bench, bench-cpu, soak, fetch, spots/spot-search/spot-get (Spotnet), make-release-nzb/make-test-nzb (fixtures de prueba). Todos los comandos aceptan --config y --help. A ellos se suma post: sube archivos como artículos yEnc y escribe el NZB correspondiente. Es una herramienta de operación, exige un --post-server explícito y nunca elige un servidor por ti.

16 · Resumen de la API

Endpoint base: http://host:6789/api?mode=…&apikey=…&output=json - compatible con SABnzbd, así que las integraciones SAB existentes funcionan sin cambios. Dos claves: la clave API (control total) y la clave NZB (solo añadir: addfile/addurl).

17 · Archivos y ubicaciones

18 · Solución de problemas

nzbfast - este manual acompaña a cada versión. Los ajustes, endpoints y valores por defecto aquí referenciados corresponden a la versión con la que se distribuyó.