Adaptación comunitaria / UmbrelOS

Zebra en UmbrelOS: tu propio nodo de Zcash

Tu servidor puede hacer algo más que guardar archivos y ejecutar aplicaciones: también puede comprobar por sí mismo lo que ocurre en una red como Zcash. A eso venimos en Refugio: a entender las herramientas que usamos y a recuperar control, una pieza cada vez.

Hemos añadido Zebra a nuestra tienda comunitaria para UmbrelOS. Es el nodo completo de Zcash desarrollado por Zcash Foundation, y lo encontrarás como Zebra (Zcash Node). Desde RefugioOS ponemos el empaquetado para que puedas llevarlo a tu homelab.

Ir a la instalación en RefugioStore

Verificar desde tu propio refugio

Zebra es una implementación independiente de un nodo completo de Zcash, escrita en Rust. Se conecta a otros nodos, comprueba bloques y transacciones siguiendo las reglas de consenso y mantiene el estado de la cadena. La Zcash Foundation explica su desarrollo y por qué disponer de implementaciones independientes ayuda a la resiliencia de la red.

Cuando consultas una cadena a través de un servicio ajeno, utilizas la infraestructura que mantiene otra persona. Con un nodo propio, tu equipo descarga los datos y aplica las reglas para comprobarlos. Esa capacidad de verificar es lo que nos interesa traer al Refugio.

También hay trabajo detrás: reservar espacio, dejar que sincronice y mantenerlo actualizado. La soberanía digital se construye con esas decisiones cotidianas. Aquí tienes una herramienta y lo que necesitas saber para decidir si encaja en tu servidor.

Qué encontrarás al abrir la aplicación

Al abrir Zebra desde Umbrel verás una respuesta de estado en /healthy. Es una interfaz sencilla: el trabajo del nodo zebrad ocurre por debajo, conectándose a la red y verificando la cadena.

Para enviar o recibir fondos necesitarás una cartera aparte. Si quieres que una wallet u otro servicio utilice tu nodo, tendrás que comprobar su compatibilidad y configurar las piezas adicionales que requiera. Instalar Zebra es poner en marcha la base.

Durante el arranque y la sincronización inicial, el nodo necesita descargar y verificar datos. Que el proceso esté en marcha no demuestra por sí solo que la cadena esté al día. Consulta el progreso y los registros antes de depender de él para otras aplicaciones.

Zebra es de Zcash Foundation. Nosotros lo acercamos a Umbrel

Detrás de Zebra está el trabajo de Zcash Foundation. Desde RefugioOS aportamos el paquete comunitario para UmbrelOS: la integración que permite instalarlo desde nuestra tienda. El paquete utiliza, según su documentación, binarios oficiales con comprobación SHA256 y sin parches al programa original.

En la revisión del 22 de septiembre de 2026, el paquete y la imagen figuran como 6.3.0-refugioos.2, basados en Zebra v6.3.0. El sufijo identifica nuestra revisión del empaquetado. La autoría de Zebra corresponde a Zcash Foundation; esta distribución comunitaria no implica una integración oficial de la Fundación con Umbrel.

Hazle sitio en tu servidor

El README del paquete indica estas referencias:

Antes de pulsar «Instalar», mira cuánto espacio y memoria te quedan de verdad. Si tu Umbrel ya mueve otras aplicaciones, tendrás que compartir esos recursos. Estas cifras son la referencia del paquete; el rendimiento dependerá de tu equipo.

La primera sincronización necesita tiempo. Deja margen en el disco y permite que el nodo haga su trabajo: la conexión, el almacenamiento y la carga del servidor marcarán el ritmo.

Cómo añadir Zebra a tu Umbrel

1. Abre App Store en el panel de UmbrelOS.
2. Entra en Community App Stores o «Tiendas de aplicaciones comunitarias».
3. Añade https://github.com/RefugioOS/umbrel-os si todavía no tienes nuestra tienda.
4. Busca Zebra (Zcash Node), revisa la ficha e instala la aplicación.
5. Deja que el nodo complete la sincronización y revisa sus registros y estado.

Si ya utilizas nuestra tienda, abre su catálogo actualizado y busca Zebra. Los nombres de los menús pueden variar entre versiones de UmbrelOS.

Conexiones y acceso al nodo

La receta de instalación publica los puertos 8233, para conexiones entre nodos, y 8232, para JSON-RPC. Los datos se conservan en el almacenamiento persistente de la aplicación.

El paquete documenta autenticación por cookie para RPC. Esa cookie es una credencial: sigue las instrucciones de configuración del proyecto y limita el acceso RPC a los equipos que deban utilizarlo. No abras ese puerto en el router para instalar la aplicación.

La vista de estado utiliza el puerto interno 48232 y el proxy del paquete desactiva la autenticación de Umbrel para esa vista. Tenlo en cuenta si publicas el acceso a tu servidor. La página de estado y el acceso RPC cumplen funciones distintas.

Más control, con los pies en el suelo

En Refugio nos interesa que sepas qué ganas con cada herramienta. Con Zebra ganas la capacidad de verificar la cadena en tu infraestructura. La privacidad de tus operaciones también depende de la cartera, del tipo de transacción y de cómo te conectas. Conviene entender cada pieza para usarla con criterio.

El paquete ya está disponible en nuestra tienda. Lo que explicamos aquí se basa en sus archivos públicos; tenemos pendiente documentar la instalación y la sincronización completas en un equipo UmbrelOS, indicando hardware y versión del sistema.

Para dudas sobre el empaquetado en Umbrel, contacta con Refugio Cibernético. Para documentación y funcionamiento del nodo, consulta The Zebra Book y el repositorio original de Zcash Foundation.

Si tienes espacio y quieres dar este paso, añade nuestra tienda a Umbrel e instala Zebra. Empieza por dejar que sincronice y aprender a leer el estado de tu nodo. Una pieza más de tu infraestructura bajo tu control.

Ver las aplicaciones de RefugioStore · Solicitar otra aplicación o adaptación

Paquetes en otras plataformas

También hay recetas publicadas para CasaOS y ZimaOS, en fase beta y pendientes de pruebas documentadas. Consulta sus estados y fuentes en el catálogo por plataforma.