Introducción

0. Introducción

¿Para qué son estos tutoriales?

Esta serie de tutoriales guía a comunidades activistas y organizaciones bajo presión autoritaria en el despliegue de una infraestructura completa de pagos privados y resistentes a la censura, basada en Bitcoin, Lightning Network y Cashu.

Al completar todos los tutoriales, tu comunidad dispondrá de un sistema de pagos soberano: sin custodios, sin vigilancia financiera y capaz de funcionar incluso bajo condiciones adversas de red.

Cómo se usa la infraestructura

La infraestructura está compuesta por varios servicios que trabajan juntos. A continuación se describe la función de cada servicio y su lugar en el uso diario:

Lightning Network Daemon (LND)

Es el nodo base de la infraestructura. Se conecta a la red Lightning y gestiona los canales de pago. Todos los pagos en sats que entran y salen de la infraestructura pasan por LND. La comunidad no interactúa directamente con él, pero es el motor que hace posible la mayoría de los demás servicios.

LNbits

Es la capa de gestión de fondos. Permite crear múltiples billeteras sobre el saldo del nodo LND, segmentando el dinero por propósito (comisiones, reservas, pagos de servicios). El administrador de la comunidad lo usa para controlar quién tiene acceso a qué fondos y para monitorear los pagos.

Mint de Cashu (Nutshell)

Es el corazón del sistema de privacidad. El Mint emite tokens Cashu (ecash) respaldados por sats de Lightning. Los miembros de la comunidad reciben y envían estos tokens sin dejar rastro en la blockchain. Las transacciones entre miembros son completamente privadas, incluso para el operador del Mint.

Lightning Terminal (LIT)

Es el panel de control del nodo Lightning. El administrador lo usa para gestionar la liquidez de los canales (Loop In/Out), revisar el estado del nodo y conectarse de forma remota y segura mediante Lightning Node Connect.

Nginx Proxy Manager (NPM)

Es la puerta de entrada segura a todos los servicios. Gestiona los certificados SSL y permite acceder a cada herramienta mediante un subdominio propio (por ejemplo: lnbits.tudominio.com, mint.tudominio.com). Sin él, los servicios no serían accesibles desde Internet de forma segura.

Orchard

Es el panel de administración del Mint de Cashu. Permite al administrador configurar el Mint, revisar el estado de la base de datos, gestionar los keysets y monitorear la actividad sin necesidad de acceder a la línea de comandos.

Tor

Añade una capa extra de privacidad enrutando las conexiones del nodo LND a través de la red Tor. Esto oculta la IP real del servidor y dificulta la vigilancia o el bloqueo de la infraestructura.

Requisitos previos

Antes de comenzar con el Tutorial 1, asegúrate de contar con lo siguiente:

Dominio de Internet

Necesitas un dominio DNS válido (por ejemplo: tudominio.com) que soporte la creación de subdominios. Cada servicio de la infraestructura se publica bajo un subdominio propio:

  • lnbits.tudominio.com
  • mint.tudominio.com
  • orchard.tudominio.com
  • npm.tudominio.com
  • lit.tudominio.com

Puedes obtener un dominio en Namecheap o GoDaddy. El Nginx Proxy Manager (Tutorial 3) se encargará de gestionar los certificados SSL automáticamente.

Servidor VPS

Necesitas un servidor virtual privado (VPS) con sistema operativo Debian o Ubuntu. Se recomiendan los siguientes planes de Hostinger (con descuento mediante los enlaces del proyecto):

Conocimientos básicos

Los tutoriales están diseñados para ser seguidos paso a paso, pero es útil tener familiaridad básica con:

  • Terminal de Linux (comandos básicos: ls, cd, nano)
  • Gestión de DNS (crear registros A para subdominios)
  • Docker (útil pero no imprescindible; todos los comandos se explican paso a paso)
Importante: Los tutoriales deben seguirse en orden. Cada servicio depende de los anteriores para funcionar correctamente.

Video tutorial

Este video muestra la infraestructura en funcionamiento y los casos de uso prácticos para comunidades: