Ganso/refugiOS 是一个托管在 GitHub 上的开源项目，主要使用 Python 编写，采用 GNU Affero General Public License v3.0 许可证，目前获得 648 个 Star、55 次 Fork。
仓库全名
Ganso/refugiOS
README 摘要
refugiOS - Tu Refugio Digital y Biblioteca de Supervivencia 🇬🇧🇺🇸 Read this in English [!WARNING] Estado del Proyecto: refugiOS se encuentra actualmente en su primera versión Beta. Es un proyecto en desarrollo activo y aún queda camino por delante: corrección de errores y la implementación de funciones detalladas en el roadmap. [!IMPORTANT] refugiOS no es una distribución Linux al uso. No se instala en tu disco…
Estado del Proyecto: refugiOS se encuentra actualmente en su primera versión Beta. Es un proyecto en desarrollo activo y aún queda camino por delante: corrección de errores y la implementación de funciones detalladas en el roadmap.
Important 重要
refugiOS no es una distribución Linux al uso. No se instala en tu disco duro ni reemplaza tu sistema operativo. Es un sistema portátil que arranca desde un USB y funciona de forma completamente autónoma, sin instalar nada en el ordenador anfitrión. Solo necesitas un USB de 16 GB o más.
¿Qué es refugiOS?
refugiOS es un sistema operativo portátil pensado para funcionar sin conexión a Internet en situaciones de emergencia o de resiliencia personal. Se instala en un USB y arranca en cualquier PC de 64 bits (con soporte dual tanto para UEFI moderno como para BIOS tradicional) o Raspberry Pi, llevando contigo Wikipedia completa, mapas offline de todo el mundo, una IA privada local, cifrado de archivos personales y guías de supervivencia, todo funcionando sin depender de ningún servidor ni nube.
La idea es sencilla: prepáralo hoy en casa, úsalo cuando no haya Internet.
Última actualización de las imágenes: 25 de octubre de 2026 (versión 0.27). Si descargaste una imagen anterior a esta fecha, sustitúyela para contar con todas las correcciones, el actualizador, el traductor y la nueva biblioteca.
Descomprime el .zip antes de grabarlo: en Windows, clic derecho → Extraer todo; en Linux o macOS, unzip refugios-base-16G-es.img.zip. Obtendrás el fichero .img que se graba en el USB.
Tip 提示
Comprueba que la descarga llegó entera. Son varios gigabytes y con una conexión inestable el fichero puede quedar incompleto, con el único síntoma de un pendrive que no arranca. Descarga SHA256SUMS.txt en la misma carpeta que el .zip y comprueba la suma antes de grabarlo:
sha256sum --ignore-missing -c SHA256SUMS.txt # Linux
shasum -a 256 --ignore-missing -c SHA256SUMS.txt # macOS
En Windows, desde PowerShell: Get-FileHash refugios-base-16G-es.img.zip -Algorithm SHA256, y compara el resultado con la línea correspondiente del fichero. Debe responder OK o coincidir carácter a carácter; si no, descarga el .zip de nuevo.
Necesitas un USB de al menos 16 GB. La partición del sistema se expandirá automáticamente al tamaño completo del USB en el primer arranque.
[!NOTE]
¿Por qué no se ofrece una imagen completamente configurada de antemano?
Ofrecer una imagen lista con todos los contenidos posibles (Wikipedia completa con imágenes, múltiples modelos de IA local, cartografía de todo el mundo, etc.) exigiría un archivo de descarga descomunal de más de 150 GB. Por eso se distribuye una imagen base ligera que el usuario debe configurar en un entorno controlado (no de emergencia) con una buena conexión a Internet. De este modo, en el momento de una emergencia real, el dispositivo tendrá exactamente la información y recursos específicos que necesites.
Pulsa F12, F8 o Esc durante el arranque para seleccionar el USB como dispositivo de inicio.
El sistema arrancará automáticamente en el escritorio XFCE con el usuario refugios (sin contraseña).
4. Completa la instalación
Important 重要
Toda la instalación inicial (incluyendo ejecutar este asistente) debe realizarse en un entorno controlado y con conexión a Internet ANTES de que ocurra una emergencia. Una vez finalizados todos los pasos y comprobado que el sistema funciona correctamente, tu dispositivo estará listo para operar de forma 100% offline.
En el escritorio encontrarás el icono “Completar instalación de refugiOS”. Haz doble clic sobre él, conéctate a Internet cuando te lo pida, y el asistente se encargará de descargar e instalar todo el contenido según la capacidad de tu USB.
La elección del dispositivo físico (pendrive, SSD, adaptador) condiciona el rendimiento y la durabilidad de tu refugiOS. Consulta la Guía de Elección del Medio antes de comprar.
Métodos Alternativos
La imagen pregenerada es la forma más rápida y sencilla, pero si lo necesitas, también puedes montar refugiOS de otras maneras:
💻 Montar refugiOS sobre un Live-USB de Xubuntu
Si prefieres usar una ISO de Xubuntu como base, puedes crear un USB live con persistencia y después instalar refugiOS sobre él. Este método ofrece un esquema dual alternativo (sistema inmutable + capa de persistencia). (Nota: la imagen pregenerada oficial de refugiOS ya incluye soporte nativo tanto para UEFI como para BIOS tradicional).
Si necesitas control total sobre la imagen base o quieres preparar múltiples unidades idénticas, puedes generar una imagen desde cero con Debian Trixie + XFCE:
Si quieres probar refugiOS antes de grabarlo en un USB, puedes arrancar cualquiera de las imágenes (pregenerada o construida por ti) en una máquina virtual con QEMU o VirtualBox. Esto funciona para x86 (PC y Xubuntu); la Raspberry Pi requiere hardware real.
# Con QEMU y aceleración KVM (Linux)
sudo qemu-system-x86_64 -enable-kvm -m 4G \
-bios /usr/share/ovmf/OVMF.fd \
-drive file=refugios-base-16G-es.img,format=raw
Consulta la Guía de Virtualización para instrucciones completas con QEMU, VirtualBox y métodos para probar imágenes de Xubuntu.
Características Principales
⚡ Arranca en cualquier PC: Conectas el USB, enciendes y tu refugio digital funciona. No installs nada en el ordenador anfitrión.
🍓 Soporte nativo para Raspberry Pi: Instalación certificada en Raspberry Pi 3B+.
📚 Conocimiento Universal Offline: Wikipedia, enciclopedia médica, guías de emergencia y supervivencia, reparaciones, energía, diccionario y libros, organizados por categorías.
🤖 Inteligencia Artificial Privada: Asistente que funciona 100% en local, sin Internet.
🗺️ Mapas y Navegación GPS: Mapas offline de todo el mundo con Organic Maps, con los países más habituales listos desde el instalador.
Traductor sin conexión: Más de 40 idiomas con los modelos neuronales de Firefox.
Actualizable sin riesgo: Un icono pone al día libros, mapas, IA y aplicaciones, y no borra nada antiguo hasta verificar lo nuevo.
Comprobación sin conexión: Un icono revisa que libros, IA, mapas y bóvedas están completos e intactos antes de necesitarlos.
🔒 Bóveda de Archivos Segura: Cifrado profesional LUKS para proteger documentos sensibles.
🌐 Adaptado a tu Idioma: El sistema se configura automáticamente en español o inglés.
WikEM retirado del catálogo: El archivo ZIM de WikEM no está publicado en los servidores de Kiwix (receta en pausa por bloqueos de origen), evitando fallos en la instalación. Se conservan WikiMed y los manuales de medicina de campaña.
Corregido
Mensaje de componente ZIM no encontrado: Mensaje en i18n.py clarificado (“No fue posible encontrar ninguna edición publicada de…”), eliminando el término erróneo “rastreador”.
[0.27] - 2026-10-25
Añadido
Actualizador integrado (Actualizar refugiOS): Búsqueda y descarga atómica de nuevas ediciones de libros, motor llamafile, modelos de IA y regiones de mapa; la versión antigua solo se sustituye cuando la nueva está descargada y verificada.
Traductor neuronal offline (LocalTranslate): Traducción entre más de 40 idiomas de forma 100% autónoma y privada gracias a modelos integrados.
Biblioteca organizada por categorías: Nuevos catálogos de salud y medicina, supervivencia y emergencias, conocimiento práctico y reparaciones, y educación/libros, accesibles desde la carpeta Biblioteca refugiOS.
Auditoría de integridad (Comprobar refugiOS): Script de autodiagnóstico sin red que verifica la integridad de libros, IA, mapas y bóvedas con opción de recálculo de sumas criptográficas.
Descargas verificadas por defecto: Descarga mediante metalinks multimirror y BitTorrent con verificación SHA-256 de cada recurso.
Corregido
Soporte de Flatpaks en Raspberry Pi: Permite instalar Organic Maps y LocalTranslate vía Flatpak en ARM64 si no hay paquete APT nativo disponible.
Retirada de light-locker: Previene bloqueos accidentales de sesión por inactividad en usuarios con autologin sin contraseña.
Estimaciones de espacio exactas: Ajustadas a mediciones reales de la imagen base y paquetes compartidos.
→ Consulta el CHANGELOG.md para el detalle completo de esta versión.
[0.26] - 2026-09-10
Corregido
Arranque universal limpio: Retirada de módulos DKMS propietarios en la imagen base que provocaban bloqueos en Loading initial ramdisk en máquinas virtuales y equipos sin GPU NVIDIA reciente.
Herramientas de instalación preinstaladas en la imagen: Se incluyen de serie dialog, aria2, jq, rsync, etc., evitando fallos si se ejecuta el instalador sin red.
Presets de IA adaptados a la RAM: El instalador ya no recomienda modelos pesados a equipos con menos de 6 GB de RAM.
Añadido
Instalación asistida de drivers NVIDIA: Detección interactiva para aceleración CUDA opcional.
→ Consulta el CHANGELOG.md para el detalle completo de esta versión.
Corrección del enlace de autoexpansión de partición en primer arranque y validador de imágenes tests/verify_image.sh.
[0.23] - 2026-07-28
Carpeta media/ con todo el material gráfico y documentación de la suite de tests en doc/.
[0.22] - 2026-07-28
Revisión crítica de scripts: confirmación de contraseña en bóvedas LUKS, reanudación de descargas parciales, corrección de Developer Mode y suite de tests automáticos.
[0.21] - 2026-06-30
Robustez en diálogos latin-1 (sanitize_for_dialog) y comprobación previa de scripts de despliegue.
→ Consulta el CHANGELOG.md para el historial completo de versiones.
Material Gráfico
La carpeta media/ reúne todo el material gráfico del proyecto:
Logotipo en PNG, PDF vectorial y fuente de Illustrator, más el fondo de escritorio que aplica el instalador. Diseño de Felipe Monge “PlayOnRetro”; cítalo siempre que lo uses.
Capturas de pantalla — cuarenta capturas de las aplicaciones principales funcionando, en español y en inglés, tomadas sobre el sistema real.
(refugiOS es una iniciativa de código abierto para la resiliencia digital. Actualmente en fase Beta, buscamos colaboradores para internacionalizar la documentación y pulir la experiencia de usuario según nuestro Roadmap).
-purple.svg)
评论