newsboxone
NewsBoxOne es un lector RSS y Atom autocontenido diseñado para el uso local en homelab. Permite seguir feeds RSS y Atom sin depender de una plataforma externa, con almacenamiento persistente, autenticación por contraseña y opciones opcionales de inteligencia artificial.
Ficha actualizada 23 sept 2026, 10:37 · upstream 23 sept 2026, 10:09 · release sin release detectada
Qué es newsboxone
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
NewsBoxOne es un servicio de lectura de noticias RSS y Atom que funciona como contenedor único para mantener sus fuentes actualizadas en un entorno local. Su arquitectura está diseñada para el uso en homelab, ofreciendo almacenamiento persistente en disco, protección de autenticación mediante contraseña obligatoria, integración opcional con IA generativa para resumir artículos y recomendar fuentes, y una interfaz web unificada.
La herramienta se construye como un contenedor monolítico que sirve tanto la interfaz frontend como el backend API desde una sola imagen Docker. Esto simplifica la gestión del entorno de desarrollo y reduce la complejidad operativa en entornos locales. El sistema actualiza automáticamente los feeds RSS y Atom al iniciar, y permite configuraciones periódicas para mantenerlos sincronizados.
Además, NewsBoxOne incluye un motor de extracción de texto completo que puede generar resúmenes concisos cuando se configura con una API compatible con OpenAI. También ofrece recomendaciones inteligentes basadas en el contenido de los feeds existentes, permitiendo al usuario revisar y confirmar cada sugerencia antes de añadirla a sus fuentes.
Un componente destacado es la integración con Karakeep, que permite guardar artículos directamente desde las tarjetas del feed mediante un botón de bookmark o una acción táctil en dispositivos móviles. Esta funcionalidad opera completamente en el frontend sin necesidad de configurar variables de entorno adicionales en el servidor.
- Seguir múltiples feeds RSS y Atom desde una sola interfaz web
- Convertir newsletters en formato legible mediante extracción automática
- Desarrollo personal: mantener noticias, blogs y fuentes de interés localmente
- Homelab: ejecutar servicios de lectura de noticias sin depender de plataformas externas
- Integración con inteligencia artificial para resumir artículos y recomendar fuentes
- Gestión segura de contenido: usar contraseñas obligatorias y evitar dependencias en la nube
- Funciona como un contenedor único que sirve tanto la interfaz web como el backend API desde una sola imagen Docker
- Almacenamiento persistente en SQLite dentro del contenedor, sin necesidad de montar volúmenes externos
- Integración con OpenAI-compatible APIs para generar resúmenes y recomendaciones basadas en contenido existente
- Configuración segura por defecto: autenticación obligatoria y restricciones sobre fetches remotos
- API RESTful completa que permite consumir el servicio desde cualquier cliente programático
- No soporta múltiples usuarios simultáneos; solo un usuario puede acceder al contenedor a la vez
- No tiene soporte nativo para servidores de noticias en la nube (como Substack o Ghost)
- La extracción de texto completo puede generar peticiones HTTP adicionales hacia páginas web externas, lo que introduce riesgos de seguridad como SSRF si no se configuran restricciones adecuadas
- El almacenamiento persiste en el disco local del contenedor; un reinicio del servidor borrará los datos
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para desplegar NewsBoxOne en un entorno homelab, se recomienda usar Docker Compose. Se crea un archivo YAML con la imagen oficial de GitHub Container Registry (ghcr.io/paulstaab/newsboxone:latest) y se exponen las peticiones HTTP a los puertos 8000 para el frontend y 8001 para el backend interno. Es obligatorio configurar variables de entorno USERNAME y PASSWORD, además de establecer FEED_UPDATE_FREQUENCY_MIN para definir la frecuencia mínima de actualización automática de feeds. Se recomienda montar el volumen /app/data al disco local del contenedor para preservar los datos entre reinicios. Si se prefiere construir desde fuente, se puede usar docker build con la imagen local. En producción, es aconsejable exponer el servicio a través de un proxy inverso (como Nginx) y restringir el acceso mediante reglas de firewall o políticas de seguridad.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.